Administrator: Importacão de dados via API

2023-06-01T15:55:36Z

Importacão de dados via API

Página nova

{{toc depth="3"/}}

= 1. Finalidade =

Auxiliar o usuário no cadastro dos seus produtos no SupraMais.

= 2. Acesso aos cadastros =

O cadastro de produtos pode ser acessado através do menu Cadastros > Produtos:

(% style="text-align:center" %)
[[image:image-20200414155640-1.png||height="298" width="232"]]

ou pelo ícone destacado abaixo:

(% style="text-align:center" %)
[[image:image-20200414155703-2.png||height="74" width="202"]]

Após clicar em uma das duas opções acima será exibida a seguinte tela:

(% style="text-align:center" %)
[[image:image-20200414155720-3.png||height="340" width="565"]]

=== 2.1. Colunas de Visualização ===

As colunas de visualização podem ser padronizadas de acordo com o perfil de usuário (acessos liberados) e a disponibilização pode ser configurada em Ferramentas > Configuração de Lista de Seleção > Produto/Mat. Consumo/Mat. Prima/Serviço/Patrimônio.

(% style="text-align:center" %)
[[image:image-20200414155756-4.png||height="276" width="399"]]

(% style="text-align:center" %)
[[image:image-20200414155810-5.png||height="389" width="512"]]

Ao clicar em pesquisar e selecionar a Lista Padrão será exibida a seguinte tela:

(% style="text-align:center" %)
[[image:image-20200414155848-6.png||height="391" width="518"]]

A ordem informada na coluna ‘’Nome da coluna’’ é a mesma que será apresentada no cadastro de produtos, material de consumo, matéria prima, serviço e patrimônio.

A ordenação pode ser alterada clicando com o botão direito do mouse na linha do grid e mover para baixo ou para cima. Podendo também incluir ou excluir colunas exibidas.

(% style="text-align:center" %)
[[image:image-20200414155944-7.png||height="168" width="546"]]

Já a ordenação padrão para exibição da lista de produtos, é definida arrastando a linha do grid de cima para o de ‘’Ordenação dos dados’’.

Exemplo: ao selecionar a linha **Nome** os produtos serão apresentados por ordem alfabética na lista do cadastro e o filtro virá selecionado na opção Nome.

(% style="text-align:center" %)
[[image:image-20200414160017-8.png||height="203" width="315"]]

O sistema também da a opção de restringir ou não os usuários que terão acesso ao cadastro de produtos com aquela padronização de colunas.

(% style="text-align:center" %)
[[image:image-20200414160046-9.png||height="174" width="326"]]

=== 2.2. Filtros ===

Todas as colunas exibidas na lista de produtos estão disponíveis para serem utilizadas como filtros e nos mesmos pode-se pesquisar produtos que **contém** a palavra digitada ou **iniciado** por ela.

(% style="text-align:center" %)
[[image:image-20200414160136-10.png||height="145" width="558"]]

Após digitar o valor desejado, o usuário seleciona a tecla **Filtrar**.

O SupraMais permite filtrar também pela lista dos produtos. Basta clicar na coluna do grid (qual se quer utilizar de parâmetro de busca) e digitar o que se procura em ‘’Localizar’’.

(% style="text-align:center" %)
[[image:image-20200414160202-11.png||height="158" width="491"]]

=== 2.3. Cadastro ===

Ao acessar um dos produtos da lista, na aba ‘’Cadastro’’, são exibidas as seguintes informações:

(% style="text-align:center" %)
[[image:image-20200414160234-12.png||height="395" width="655"]]

* **Código: **O código do produto pode ser gerado automaticamente ou manualmente (de acordo com a parametrização inicial do sistema).
* **Data de Cadastro: **data que o produto está sendo cadastrado no sistema. Preenchida automaticamente, porém, pode ser alterada há qualquer momento.
* **Código do Fabricante: **código do produto junto ao fabricante.
* **Padrão Código de Barras: **um identificador para itens comerciais, desenvolvido e controlado pela GS1. Seleciona-se o padrão de acordo com a quantidade de dígitos do código.
* **Código de Barras: **Seguindo o item anterior este campo destina-se ao preenchimento do código.
* **Nome: **Nome do produto e nome contábil, geralmente são semelhantes. O contábil é o nome apresentado na nota fiscal eletrônica.
* **Classificação: **qual grupo, família, etc o produto se enquadra, importante para uso em relatórios. Para selecionar, deve-se clicar na mãozinha. As classificações são cadastradas em: Tabelas > Controle de estoque > Classificações.
* **Fabricante: **onde é informado** **o fabricante do produto, importante para uso em relatórios. Também é selecionado através da mãozinha que exibe a lista valor com os fabricantes cadastrados Tabelas > Controle de estoque > Marcas - Fabricantes.
* **Descrição: **utilizada para detalhamento do produto em questão e também para inserção de informações técnicas relevantes. Quando necessário, o conteúdo poderá ser capturado no item da proposta de venda, pedido, licitação ou mesmo na emissão da NF-e.

**Ex.**:

(% style="text-align:center" %)
[[image:image-20200414160319-13.png||height="179" width="318"]]

* **Estoque: **Resumo das principais informações do Estoque (item 2.8), campos não editáveis, são atualizados de acordo com o que se encontra na aba “Estoque”.
* **Preço: **Resumo das informações da aba Cálculo de Preço, os campos não são editáveis, sendo assim, se atualizam quando as informações da aba “Cálculo de Preços” são alteradas.

=== 2.4. D. Adicionais 1 ===

Na aba D. Adicionais 1 existem as seguintes opções de preenchimento:

(% style="text-align:center" %)
[[image:image-20200414160515-14.png||height="395" width="664"]]

* **Produto Referência: **Este campo é utilizado para vincular um produto similar ao do cadastro (produtos que possuem a mesma finalidade, porém, são comprados de fabricantes diferentes). A ferramenta auxilia na hora da venda (pedido) e compra (Ordem de compra) pois permite ao usuário a visualização de informações dos produtos vinculados ao que se deseja vender/comprar.

**Obs.**: é importante que se estipule apenas um produto referência e o mesmo seja colocado nos similares, não fazer a amarração dos produtos aleatoriamente.

* **Equipamento: **Quando o produto é utilizado em algum equipamento sua referência é feita nesse campo.

Seu cadastro é feito em Cadastros > Equipamentos.

* **Serial: **Campo utilizado para os produtos que necessitam ser rastreados através do número de série. Caso haja o controle do número de série no produto, em todas as movimentações de estoque será requerido o tal número, individualmente.

Para visualizar os seriais cadastrados para o produto, clique com o botão direito do mouse na área cinza do cadastro > menu pop-up Serial.

No menu Logística é possível rastrear as operações (Entrada e Saída) realizadas por número de série.

(% style="text-align:center" %)
[[image:image-20200414160605-15.png||height="189" width="211"]]

* **Habilitar: **Campo para habilitar ou desabilitar o produto nas rotinas:(((
(% style="text-align:center" %)
[[image:image-20200414160628-16.png||height="155" width="163"]]
)))

* **Cadastro: **Campo para determinar se o cadastro que está sendo efetuado será ou não disponibilizado para as rotinas descriminadas:

(% style="text-align:center" %)
[[image:image-20200414160704-17.png||height="149" width="164"]]

* **Opção:**

(% style="text-align:center" %)
[[image:image-20200414160721-18.png||height="151" width="344"]]

**Produção própria: **utilizado para produtos que são de produção própria. Ao marcar é habilitada a aba composição:

(% style="text-align:center" %)
[[image:image-20200414160819-19.png||height="243" width="685"]]

A aba composição deverá ser alimentada com os itens (Matéria-prima) e quantidades necessárias para produzir o produto final.

**Loja virtual: **a marcação de tal opção disponibiliza produto para a comercialização em B2B ou B2C (Loja Virtual).

É habilitada a aba Loja Virtual:

(% style="text-align:center" %)
[[image:image-20200414160933-20.png||height="389" width="655"]]

Esta aba é preenchida com os dados que são transmitidos automaticamente para o B2B ou B2C (e-commerce): preço de venda, promoção, porcentagem do estoque físico a disponibilizar, frete (emitente ou destinatário) e descrição do produto.

**Supra Mobile: **sua marcação disponibiliza o produto no Força de Vendas (Mobile).

**Medicamento: **habilita a aba Medicamentos.

(% style="text-align:center" %)
[[image:image-20200414161020-21.png||height="392" width="655"]]

A aba deve ser completada com informações referentes ao medicamento: princípio ativo, posologia, categoria, isenção, portaria, preço PMC (usado no cálculo de Substituição Tributária), fabricante, alíquota ABC farma, repasse, concentração e forma farmacêutica. Campos específicos para a distribuição de medicamentos e produtos afim.

**Obs**: O cadastramento de Princípio Ativo deve ser antecipado no menu: Tabelas > Controle de Estoque > Princípio Ativo.

**Controle de Lote: **Deve ser marcado quando a Anvisa requer a rastreabilidade do produto através do controle do lote. A lista dos lotes do produto podem ser visualizados na aba Estoque> Disponibilidade.

(% style="text-align:center" %)
[[image:image-20200414161413-23.png||height="198" width="655"]]

**Obs.:** A marcação da opção controle de lote só será possível caso o produto não possua estoque (zerado).

**Validade Indeterminada: **Quando o produto tiver validade indeterminada, a marcação deste campo, viabiliza a disponibilização da informação na DANFE.

(% style="text-align:center" %)
[[image:image-20200414161442-24.png||height="101" width="670"]]

Com a marcação vai o texto Validade Indeterminada.

Sem a marcação, na DANFE é apresentada a data de validade presente no lote.

(% style="text-align:center" %)
[[image:image-20200414161507-25.png||height="87" width="674"]]

**Comodato: **o comodato é um empréstimo do bem para uso por um certo período de tempo a outrem. Caso a empresa utilize de tal recurso, para que o produto esteja disponível para tal operação, essa opção deve estar marcada.

Produtos comodatados são controlados por uma tabela e para que ele seja enviado para a mesma a operação no tipo de pedido (presente em Tabelas> Comercial> Tipos de pedido) usado no pedido deve estar marcada comodato.

(% style="text-align:center" %)
[[image:image-20200414161620-26.png||height="440" width="655"]]

**Advertência: **campo utilizado para colocar informações pertinentes ao produto que devem servir como uma advertência para o usuário que fizer a utilização de tal em qualquer operação no sistema:

(% style="text-align:center" %)
[[image:image-20200414161650-27.png||height="184" width="337"]]

Se possuir essa advertência, ao selecionar o produto para venda, por exemplo, a seguinte tela de advertência é apresentada:

(% style="text-align:center" %)
[[image:image-20200414161704-28.png||height="385" width="500"]]

**Observação: **a observação informada no produto é de caráter apenas informativo, não é usada em outro local no sistema.

**Histórico: **O histórico informado nesse campo pode ser utilizado na impressão de Proposta de Licitação.

Proposta de Licitação > Impressão > Licitação:

(% style="text-align:center" %)
[[image:image-20200414161742-29.png||height="347" width="655"]]

(% style="text-align:center" %)
[[image:image-20200414161841-31.png||height="117" width="700"]]

**Endereço Web – URL: **Campo utilizado na impressão de etiquetas por Código Bidimensional.

(% style="text-align:center" %)
[[image:image-20200414161859-32.png||height="287" width="500"]]

Ao optar por enviar o endereço web na etiqueta, independentemente do tamanho selecionado, ele será a única informação a compor o conteúdo da imagem do QR Code.

* **Última de Alteração: **apenas informativo, apresentando a última data de alteração feita no cadastro desse produto e o usuário que a fez.
* **Dt. Desativação:** Recurso utilizado para desabilitar (não excluir) o produto caso o mesmo tenha sido utilizado anteriormente. Para reativar deve-se ir em Ferramentas > Reativação de Itens Desativados.
* **Garantia: **Campo destinado para informar a garantia do produto.

=== 2.5. Documentação ===

Aba destinada aos documentos oficiais ou não, pertinentes aquele produto:

(% style="text-align:center" %)
[[image:image-20200414164236-1.png||height="389" width="655"]]

* **Documentação do Produto: **campo destinado a inserção dos documentos referentes ao produto. Para inserir clica-se nos três pontinhos, ao clicar será exibida a seguinte tela para seleção:(((
(% style="text-align:center" %)
[[image:image-20200414164953-2.png||height="300" width="761"]]
)))

Ao selecionar o documento pode-se preencher com o código, data de emissão e validade.

(% style="text-align:center" %)
[[image:image-20200414165343-3.png||height="51" width="363"]]

Sendo necessário pode-se anexar, visualizar ou excluir o anexo inserido.

(% style="text-align:center" %)
[[image:image-20200414165411-4.png||height="72" width="977"]]

Tais documentos são cadastrados através do menu: Tabelas > Documentos > Produtos:

(% style="text-align:center" %)
[[image:image-20200414165807-5.png||height="342" width="655"]]

**Obrigatório no Cadastro**: define a obrigatoriedade ou não do documento no cadastro do produto. Uma vez selecionada a opção, o sistema não permite a gravação do produto que não possuir o documento. É exibida a seguinte mensagem:

(% style="text-align:center" %)
[[image:image-20200414170148-6.png||height="142" width="389"]]

**Requer Data de Validade**: Caso a opção esteja marcada não é possível, posteriormente, realizar a gravação (inclusão ou alteração) do produto que não tenha a data de validade preenchida no documento, é exibida a mensagem:

(% style="text-align:center" %)
[[image:image-20200414170217-7.png||height="182" width="800"]]

**Documento Oficial:** Marcado quando o documento é oficial.

* **Documentação Necessária no Pedido**

Nesse campo colocam-se os documentos que são obrigatórios no produto para que possa ocorrer a venda desse produto.

(% style="text-align:center" %)
[[image:image-20200414170329-8.png||height="212" width="489"]]

**Existência** quando é necessário apenas ter o documento no cadastro e **Validade** quando é necessário que o documento esteja dentro do prazo de validade.

* **Arquivos**

Se o produto possuir algum documento adicional, inclui-se nesse campo.

[[image:image-20200414170405-9.png||height="208" width="493"]]

=== 2.6. Fiscal ===

Esta aba está explicada em manual próprio. Vide **[[Cadastro de Produto – Fiscal>>doc:Manuais.Cadastro de produtos - Fiscal.WebHome]].**

(% style="text-align:center" %)
[[image:image-20200414170556-10.png||height="199" width="800"]]

=== 2.7. Cálculo de Preço ===

O conteúdo dessa aba está explicado no manual [[**Cadastro de Produto – Cálculo Preços.**>>doc:Manuais.Produto.Formação de Preços.Cadastro de produtos - Cálculo preços.WebHome]]

(% style="text-align:center" %)
[[image:image-20200414170653-11.png||height="174" width="804"]]

=== 2.8. Estoque ===

Ao acessar o cadastro de produtos e clicar na aba “Estoque” é exibida a seguinte tela:

(% style="text-align:center" %)
[[image:image-20200414170752-12.png||height="530" width="900"]]

==== 2.8.1. Geral ====

===== 2.8.1.1 Estoque: =====

* Estoque Físico: É a quantidade do produto em estoque, sem considerar os pedidos que ainda não foram baixados pela expedição
* Estoque Reservado: Calculado a partir dos pedidos ou empenhos que ainda não deram saída na expedição.
* Disponível: (Estoque Físico - Estoque Reservado)
* Inventário: Calculado a partir de entradas e saídas do produto com documentos fiscais.Para visualizar o estoque fiscal: botão direito do mouse na área cinza > Inventário.
* Estoque mínimo e máximo de um produto diz respeito a quantidade a ser estocada. Dias de estoque refere-se à quantidade de dias de estoque sem a necessidade de reabastecê-lo (calculado pela média de venda diária). Os valores informados nesses campos são utilizados no Relatório > Compras > Sugestão de Compras e em Ordem de Compra > Sugestão de Compras.

===== =====

===== 2.8.1.2. Unidades =====

A **unidade principal** de um produto, normalmente é aquela na qual o produto é comercializado. Uma vez utilizado em qualquer operação no sistema, não é permitida a sua alteração.

**Quant. por Embalagem** é um campo para informar qual a quantidade por embalagem referente a unidade principal.

===== 2.8.1.3. Conversão =====

Como a unidade principal não pode ser alterada, pode ser utilizado o campo de conversão para informar as demais unidades vendidas/compradas.

(% style="text-align:center" %)
[[image:image-20200414171128-13.png||height="176" width="565"]]

O cálculo da conversão é feita da seguinte forma:

* Quando a unidade principal é maior que a conversão, usa-se a divisão:

Multiplicador = Quant. por Embalagem / Quantidade necessária da unidade de conversão para formar **uma** embalagem.

* Quando a unidade principal é menor que a conversão, usa-se a multiplicação:

Multiplicador = Quantidade necessária da unidade de conversão para formar **uma** embalagem * Quant. por Embalagem

Em cada unidade é apresentado a quantidade dela em estoque físico, reservado e disponível.

//**O cadastro das unidades é realizado através do menu: Tabelas > Controle de Estoque > Unidades.**//

===== =====

===== 2.8.1.4. Unidade Principal =====

As unidades são utilizadas no cálculo de frete dos correios, além do frete, o Peso Líquido e Peso Bruto são enviados para a aba logística no pedido, empenho e nota fiscal.

Para saber sobre o cálculo de volume pode-se clicar no ícone [[image:image-20200414171430-14.png||height="25" width="25"]] presente na tela.

===== 2.8.1.5. Localização =====

Utilizado para informar o local do estoque onde o produto se encontra. Campo de preenchimento obrigatório.

O cadastro das localizações é realizado em Tabelas > Controle de Estoque > Localização:

(% style="text-align:center" %)
[[image:image-20200414171545-15.png||height="438" width="700"]]

O cadastro pode ser feito em vários níveis e com mapeamento para facilitar a procura.

No Tipo/Finalidade tem que estar marcado Picking para aparecer no cadastro de produto.

===== 2.8.1.6. Figura =====

Campo utilizado para colocar a imagem do produto, pode ser visualizado no próprio cadastro e também utilizado em impressão de propostas.

Visualização na proposta:

Comercial > Propostas > Impressão:

(% style="text-align:center" %)
[[image:image-20200414171619-16.png||height="290" width="594"]]

==== ====

==== 2.8.2. Disponibilidade ====

Quando o produto possui controle de lote é na aba disponibilidades que os mesmos são listados, juntamente com data de fabricação, validade e estoque de cada um.

(% style="text-align:center" %)
[[image:image-20200414171745-17.png||height="476" width="800"]]

Quando não possui controle de lote, na tela são exibidos apenas, resumo do estoque e localização.

A inclusão do número do lote é feita por entrada de nota, mas se necessário, pode ser cadastrado em Tabelas > Controle de Estoque > Lotes. Já a entrada ou saída do estoque dos lotes é feita por **pedido, empenho e nota de terceiros.**

**Obs.: A data de fabricação e validade podem ser alteradas a qualquer momento.**

Ao clicar com o botão direito do mouse no lote apresentam-se as seguintes opções:

(% style="text-align:center" %)
[[image:image-20200414171826-18.png||height="106" width="355"]]

* Desativar Lote: Para desativar o lote deve estar sem estoque.
* Rastreabilidade de Compra e Venda: Informa as entradas e saídas do lote.

=== 2.9. Fornecedor ===

Essa aba é para controle interno da empresa, usado para inserir as informações dos fornecedores do produto. Ao inserir o fornecedor os dados de telefone são obtidos do Cadastro > Fornecedores e as informações da nota puxam da última nota de terceiro dele cadastrada para esse produto.

(% style="text-align:center" %)
[[image:image-20200414171919-19.png||height="189" width="800"]]

=== 2.10. Comissão ===

Essa aba é destinada para uma definição variada de comissão do produto, por vendedor.

(% style="text-align:center" %)
[[image:image-20200414172055-20.png||height="212" width="809"]]

=== 2.11. Campos Livres ===

Aba utilizada para inserir alguma informação do produto que não foi informada nas abas anteriores. Caso necessário, pode-se utilizar para integração com e-commerce. Para cadastrar propriedade adicional pode ir em Tabelas > Controle de Estoque > Propriedades Adicionais.

(% style="text-align:center" %)
[[image:image-20200414172336-21.png||height="199" width="832"]]

=== 2.12. Ícones no cabeçalho ===

**Impressora:** No produto eu posso escolher imprimir Tabela de Preço e Rótulos de Prateleira.

(% style="text-align:center" %)
[[image:image-20200414172417-22.png||height="137" width="856"]]

Ao clicar em tabela de preço aparece a tela ilustrada abaixo, que permite definir a composição do relatório através de filtros.

(% style="text-align:center" %)
[[image:image-20200414172548-23.png||height="402" width="400"]]

Ao selecionar Rótulo de Prateleira, aparece tela que permite informar o produto e a quantidade de etiquetas a serem impressas. Impressão feita em impressora Zebra.

(% style="text-align:center" %)
[[image:image-20200414172821-24.png||height="438" width="700"]]

**Etiqueta Código de Barras: **Impressão de etiqueta com código de barras.

(% style="text-align:center" %)
[[image:image-20200414172854-25.png||height="75" width="900"]]

Ao clicar aparece a seguinte tela para informar o produto e a quantidade de etiquetas.

(% style="text-align:center" %)
[[image:image-20200414172924-26.png||height="419" width="700"]]

Diferente da Etiqueta de Prateleira, permite selecionar a impressora, modelo de etiqueta e tem mais opções de impressão que alteram de acordo com o modelo de etiqueta.

=== 2.13. Menu Pop-Up ===

Ao clicar com o botão direto na área cinza da aba cadastro será exibido o seguinte menu pop-up:

(% style="text-align:center" %)
[[image:image-20200414173050-27.png||height="521" width="800"]]

Existem várias opções no menu pop-up, que me permitem por exemplo visualizar de forma simplificada últimas notas emitidas, de terceiros, pedidos e propostas, inventário, balanço e etc (todas as movimentações realizadas com o produto).

A única exceção ao que foi dito anteriormente é o Clonar Produto, que é utilizado quando deseja-se incluir um novo produto copiando todos os dados de outro. Nesse caso ao clica em incluir > botão direito do mouse > clonar produto, será exibida a seguinte tela para seleção do produto a ser clonado:

(% style="text-align:center" %)
[[image:image-20200414173226-28.png||height="338" width="800"]]

[[Topo>>doc:]] [[[[image:1586952510782-152.png||height="20" width="15"]]>>doc:]]

Manuais/Produto/Cadastro de produtos - Histórico de revisão

Administrator: Importacão de dados via API