Produtos
A tela de Produtos cadastra itens vendidos, comprados ou movimentados no estoque. O cadastro tambem concentra informacoes fiscais usadas na emissao de documentos.
Para que serve
Antes de comecar
- Tenha codigo, descricao, unidade, NCM, CFOP e origem do produto.
- Confirme CST/CSOSN de ICMS, CST de PIS, COFINS e IPI.
- Para combustiveis ou produtos especificos, valide codigo ANP, CEST, GTIN e classificacao tributaria.
- Para OPME/produto para saude, tenha o registro ANVISA, classe de risco, detentor, validade e UDI-DI quando aplicaveis.
Como cadastrar um produto
- Clique em Adicionar.
- Informe codigo, descricao e unidade.
- Preencha valor unitario e, se aplicavel, valor de custo.
- Configure NCM, CFOP, origem e demais campos fiscais.
- Informe CST/CSOSN e aliquotas.
- Configure dados de estoque e pesos quando necessario.
- Marque Produto ativo.
- Clique em Salvar.
Campos principais
| Campo | Uso |
|---|---|
| Codigo Produto (CODPRO) | Codigo interno gerado pelo sistema |
| Codigo | Codigo operacional do produto |
| Codigo de barras (EAN) | Identificacao por codigo de barras |
| Descricao | Nome do produto |
| Unidade | Unidade de medida, como UN, KG ou CX |
| Medida padrao unitaria | Apresentacao fisica de uma unidade (saco 50 kg, barra 6 m, peca 30 x 60 cm). E descritiva: nao altera unidade base, estoque nem calculo fiscal |
| Codigo de referencia do fornecedor | Aba Dados Adicionais. Referencia rapida do fornecedor principal, tambem usada na busca de produtos |
| NCM | Classificacao fiscal obrigatoria |
| CEST | Obrigatorio quando aplicavel ao produto |
| CFOP | Operacao fiscal padrao |
| Origem | Origem da mercadoria |
| CST/CSOSN ICMS | Tributacao de ICMS |
| CST PIS, COFINS e IPI | Tributacao dos demais impostos |
| Valor unitario | Valor usado em operacoes comerciais |
| Estoque atual | Saldo informativo exibido no cadastro |
| Controla lote / Exige validade | Habilita lote, FEFO e rastreabilidade na nota e no estoque |
| Controla numero de serie | Habilita rastreabilidade unitaria e localizacao da unidade |
| Registro ANVISA | Registro sanitario usado nas informacoes adicionais do item da NF-e |
| Classe de risco / Detentor | Complementos regulatorios do produto para saude |
| Validade do registro | Quando preenchida e vencida, bloqueia a emissao do item |
| Isento ANVISA | Indica produto legalmente isento de registro |
| UDI-DI | Identificador do dispositivo medico informado na rastreabilidade fiscal |
Unidades de conversao (compra e venda em embalagem)
Produto que entra ou sai em embalagem diferente da unidade de estoque (piso em
M2 comprado e vendido em CX, bebida em UN vendida em FD) usa a aba **Unidades de
Conversao** do cadastro. E opcional: sem registro nessa aba o produto continua
operando 1:1 na unidade base, como sempre.
| Campo | Uso |
|---|---|
| Unidade | Unidade alternativa (CX, FD, PALLET) |
| 1 unidade = quantas <unidade base> | Fator de conversao (ex.: 1 CX = 2,05 M2) |
| Preco da unidade | Preco proprio da embalagem. Em branco, o sistema usa preco base x fator |
| Embalagem de venda | Marca a embalagem que fecha caixa na venda (uma por produto) |
| Multiplo de venda | O que fazer quando a quantidade nao fecha embalagem inteira |
O que a conversao faz automaticamente:
- Estoque: a entrada e a saida convertem quantidade e custo para a unidade
base (10 CX de 2,05 viram 20,50 M2, e o custo por CX vira custo por M2).
- Preco do item da nota: ao escolher a unidade alternativa na linha do item,
o valor unitario passa a ser o preco da embalagem (preco cadastrado, ou preco
base x fator). O campo Unidade do item vira uma lista com a unidade base e as
alternativas cadastradas.
- Quantidade multipla: com uma embalagem marcada como *Embalagem de venda*,
a quantidade da nota de saida e conferida contra o tamanho da caixa.
Politicas de multiplo de venda:
| Politica | Efeito na nota de saida |
|---|---|
| Livre (sem regra) | Padrao. Aceita qualquer quantidade (comportamento historico) |
| Avisar quando nao fechar | Mostra a quantidade que fecha embalagem, mas deixa gravar |
| Arredondar para fechar | Sobe a quantidade ate fechar a embalagem seguinte |
| Bloquear quantidade quebrada | Impede gravar a nota fora do multiplo |
Exemplo (loja de pisos): caixa com 2,05 M2 e preco base de R$ 89,90 por M2. O
item em CX sai por R$ 184,30 (2,05 x 89,90) e o cliente que precisa de 12,45 M2
e ajustado para 14,35 M2 — 7 caixas fechadas.
Fornecedores do produto (resumo)
A aba Fornecedores mostra um resumo dos fornecedores vinculados ao produto.
Para criar ou editar vinculos, importar tabelas e consultar precos, clique em
Abrir Tabelas de Fornecedores ou acesse Compras > Tabelas de Fornecedores.
O cadastro e opcional e nao movimenta estoque, financeiro, fiscal ou pedidos.
| Campo | Uso |
|---|---|
| Fornecedor | Parceiro que fornece o item |
| Codigo no fornecedor | Referencia do item no catalogo do fornecedor |
| Unidade de compra | Como o fornecedor vende (CX, FD, PALLET) |
| Fator para unidade base | Quantas unidades base cabem em 1 unidade de compra |
| Quantidade minima / Prazo de entrega | Condicoes comerciais informativas |
| Fornecedor preferencial | Apenas um por produto; marcar um desmarca o anterior |
O desligamento do vinculo e logico: o cadastro fica preservado e pode ser
reativado depois. Parceiro com produtos vinculados nao pode ser excluido.
Preco informado x compra efetiva
A tela separa tres origens que nunca se misturam:
| Coluna | De onde vem |
|---|---|
| Preco informado | Digitado no botao de precos ou trazido por importacao de tabela |
| Ultima compra | Recebimento confirmado ou NF-e de entrada autorizada, o mais recente |
| Custo efetivo | Composicao real do motor de custos daquela entrada |
Como preco informado e apenas estimativa, o sistema mostra a cadeia completa:
preco - desconto + frete + seguro + outras despesas + tributos nao recuperaveis - creditos recuperaveis = custo final estimado
Todos os componentes sao por unidade de compra; o custo por unidade base sai
dividindo o custo final estimado pelo fator de conversao. Os precos sao
separados por empresa, porque credito e regime tributario mudam por empresa.
Cada gravacao cria uma nova versao: nada e sobrescrito. Uma versao pode ser
inativada com motivo, e o historico permanece auditavel com origem, usuario e
data. O preco atual e a versao ativa mais recente cuja data de referencia ja
comecou e cuja validade ainda nao venceu.
Importar tabela de precos (CSV/XLSX)
Em Compras > Tabelas de Fornecedores, escolha a empresa e abra Importar tabela de precos.
Baixe o template, preencha e use sempre Pre-validar antes de aplicar: a
pre-validacao nao grava nada e devolve o erro de cada linha.
| Coluna | Obrigatoria | Observacao |
|---|---|---|
| codigo_produto | Sim | Codigo operacional ja cadastrado |
| codparc | Sim | Codigo do parceiro fornecedor |
| codigo_referencia | Nao | Se preenchido, precisa bater com o vinculo |
| preco_compra | Sim | Maior que zero; aceita 1.234,56 |
| moeda | Nao | Tres letras; BRL quando em branco |
| data_referencia | Sim | Formato AAAA-MM-DD |
| valido_ate | Nao | Nao pode ser anterior a data de referencia |
| unidade_compra / fator_conversao | Nao | Em branco, herda do vinculo |
| desconto, frete, seguro, outras despesas | Nao | Por unidade de compra |
| tributos_nao_recuperaveis_unitario | Nao | Estimativa que entra no custo |
| creditos_recuperaveis_unitario | Nao | Estimativa que reduz o custo |
| observacoes | Nao | Texto livre |
Regras da importacao:
- O produto e o fornecedor precisam existir e ja estar vinculados na tela central.
- Arquivo com qualquer linha invalida nao entra: ou aplica tudo, ou nada.
- O mesmo arquivo nao pode ser aplicado duas vezes na mesma empresa.
- Planilha XLSX com formula e recusada: converta em valores antes de enviar.
- Limite de 5MB e 5.000 linhas por arquivo.
Regras importantes
- Codigo, descricao, NCM, CFOP, unidade, origem, CST/CSOSN ICMS, CST PIS, CST COFINS, CST IPI e valor unitario sao obrigatorios.
- NCM deve usar apenas numeros e normalmente possui 8 digitos.
- CFOP deve usar apenas numeros e normalmente possui 4 digitos.
- Valores e aliquotas devem ser numericos e nao negativos.
- Unidade e codigos fiscais sao normalizados para maiusculas ou somente digitos quando aplicavel.
- A unidade alternativa nao pode ser igual a unidade base e o fator deve ser maior que zero.
- Apenas uma unidade por produto pode ser a embalagem de venda: marcar uma desmarca a anterior.
- Registro ANVISA vencido bloqueia a emissao; validade em branco nao e tratada como vencida.
- Para OPME, o registro e a UDI seguem em
infAdProd; lote completo segue tambem no gruporastroda NF-e. - Medida padrao unitaria e codigo de referencia do fornecedor sao descritivos e nao entram em calculo de estoque, preco ou imposto.
- Preco informado e importacao de tabela nao geram estoque, titulo financeiro, pedido nem documento fiscal.
- Preco informado nunca substitui a ultima compra: as duas informacoes convivem lado a lado na tela.
Dicas de operacao
- Cadastre tabelas fiscais antes de cadastrar muitos produtos para facilitar selecao de CFOP, CEST e CST.
- Use descricao detalhada quando o produto precisar de informacao complementar em documentos.
- Mantenha produtos inativos fora de novas operacoes, sem apagar historico.
Problemas comuns
| Situacao | Como resolver |
|---|---|
| Opcoes fiscais nao carregam | Verifique cadastros de regras fiscais e tabelas tributarias |
| Produto nao pode ser emitido em nota | Revise NCM, CFOP, origem, CST e unidade |
| Valor unitario invalido | Informe numero maior ou igual a zero |
| Caixa sai pelo preco do metro | Cadastre a unidade na aba Unidades de Conversao e escolha essa unidade na linha do item |
| Nota nao grava por quantidade quebrada | A embalagem de venda esta com politica Bloquear: use a quantidade sugerida na mensagem |
| Emissao bloqueada por ANVISA | Atualize a validade do registro ou confirme a isencao conforme a situacao regulatoria real |
| Aba Fornecedores nao mostra preco nem custo | A aba agora e um resumo; abra Compras > Tabelas de Fornecedores e selecione a empresa |
| Importacao recusa a linha por falta de vinculo | Cadastre antes o produto x fornecedor na tela Tabelas de Fornecedores |
| Importacao acusa arquivo ja aplicado | O mesmo arquivo ja foi usado nessa empresa; ajuste a planilha ou registre o preco manualmente |
| Custo efetivo aparece vazio | Ainda nao ha recebimento confirmado nem NF-e de entrada autorizada para esse fornecedor |
Telas do sistema
Capturas reais desta tela, com dados sensíveis mascarados.
