Manual Prático - Cadastro de Produtos

Versão compacta e operacional, baseada no comportamento real do ERP.

1) Finalidade

O cadastro de produtos concentra:

• dados comerciais (preço de compra e venda, margem, status);
• dados de estoque (disponibilidade, kardex, filtros de ativo/inativo);
• dados fiscais (NCM, CEST, grupo fiscal);
• utilitários de rotina (importação CSV, clone, exportação para balança, upload de imagem).

2) Permissões e pré-requisitos

Permissões verificadas no fluxo:

• Produtos - Acesso: para abrir a listagem.
• Produtos - Dados: para criar/editar/importar/ajustar preço.
• Produtos - Excluir: para remover registro.

Dependências exigidas no cadastro:

• Regime tributário do licenciado configurado.
• Grupo cadastrado.
• NCM cadastrado.
• CEST cadastrado.
• Grupo fiscal cadastrado.

3) Fluxo rápido (uso diário)

1. Entrar em Cadastro > Produtos.
2. Usar abas Ativos/Inativos e, quando existir, filtro de Combustíveis.
3. Clicar em Novo Registro para cadastrar.
4. Preencher dados comerciais/fiscais e salvar.
5. Se necessário, usar:

• Importar CSV para carga em lote;
• Clone para acelerar cadastro semelhante e reduzir digitação;
• Kardex para conferência de movimentação;
• Ajustar preço de venda para correções pontuais.

4) O que existe na tela de listagem

A listagem possui:

• colunas de status, nome, estoque, preço de venda e categoria (grupo/subgrupo);
• alternância Ativo/Inativo por botão;
• clique na linha para abrir edição;
• ações de importação CSV, exportação para balança e verificação de CEST pendente.

5) Ações práticas na tela de Edição

Ao abrir um produto para editar, estes botões costumam ser os mais úteis no dia a dia:

• Clonar: cria uma cópia do produto atual para acelerar novos cadastros parecidos.
• Recalcular Estoque: refaz os saldos do produto com base nas movimentações já registradas. Use quando houver divergência de estoque.
• Inventário Express: abre um modal simples para lançar contagem rápida (data/hora + quantidade contada). O sistema cria e processa o inventário automaticamente.
• Ficha Kardex: abre o histórico de movimentações do item para conferência de entradas, saídas, inventários e saldo.
• Relatório Kardex (na tela de Kardex): gera a ficha em PDF para auditoria, conferência e compartilhamento.

Como usar o Clone com segurança

Quando usar:

• para produtos da mesma família (mudando apenas nome, embalagem, preço ou grupo);
• para ganhar velocidade em cadastros com muitos campos fiscais parecidos.

O que o sistema já faz ao clonar:

• abre uma cópia pronta para edição;
• define GTIN como SEM GTIN na copia;
• inclui sufixo de cópia no nome e na referência.

Boas práticas após clonar:

• revisar nome e referência antes de salvar;
• informar o GTIN correto se o novo produto possuir código de barras próprio;
• revisar preço de compra, preço de venda e fator de conversão;
• conferir grupo/subgrupo e dados fiscais (NCM, CEST e grupo fiscal).

GTIN na prática (visão de usuário)

No cadastro de produto, o campo Código de Barras aceita:

• um GTIN válido;
• ou SEM GTIN, quando o item não possui código.

Comportamento esperado na tela:

• ao sair do campo GTIN com um código válido, o sistema tenta consultar base externa;
• se houver retorno, é possível aceitar o preenchimento automático de nome, NCM, CEST e outros dados auxiliares;
• se o código for inválido, o sistema orienta corrigir ou usar SEM GTIN.

Dica de operação:

• se o item já estiver com etiqueta do fornecedor, prefira informar o GTIN real;
• se ainda não houver código definido, salve com SEM GTIN e ajuste depois.

Complementos úteis da edição:

• Fator de Conversão: ajuste importante para itens comprados em embalagem e vendidos fracionados.
• Histórico mensal de estoque: ajuda a investigar variações por referência (mês/ano).
• Reprocessamento por referência (quando disponível no quadro de histórico): recalcula uma competência específica.

6) Regras de negócio importantes

• Criação/edição aplica normalização de URI (slug do nome).
• Quando usa GTIN com serviço externo, sistema pode sugerir dados como NCM e CEST para agilizar o cadastro.
• Se produto usa margem e há preço de compra, margem é recalculada no ajuste de preço de venda.
• Importação CSV roda em job assíncrono (não bloqueia a tela).
• Exportação para balança gera formato diferente para Filizola e Toledo.

7) Problemas comuns e como resolver

• Sem acesso a tela: validar permissao de perfil (Produtos - Acesso / Dados / Excluir).
• Aviso para configurar módulo Licenciado: preencher regime tributário.
• Não abre cadastro novo por falta de base: cadastrar Grupo, NCM, CEST e Grupo Fiscal.
• Estoque incoerente após vínculo de item de entrada: usar recalc de estoque do produto.
• Divergência após contagem física: usar Inventário Express e depois validar na Ficha Kardex.

8) Guia ultra-curto para treinamento interno

• Cadastrar: Novo Registro > preencher obrigatórios > Salvar.
• Duplicar rapidamente: Editar produto base > Clonar > ajustar nome, GTIN, preços e fiscal.
• Corrigir preço: abrir produto > ajustar preço/margem.
• Trocar status: usar botão Ativo/Inativo na grade.
• GTIN: usar código válido quando existir; se não existir, usar SEM GTIN.
• Carga em lote: Importar CSV.
• Conferir movimento: Ficha Kardex e relatório em PDF.
• Corrigir divergência rápida: Inventário Express.