Cadastro de NF-e de Entrada

Módulo: Fiscal Caminho na aplicação: Menu > Fiscal > NF-e de Entrada > "Nova" (upload XML) ou ícone Editar na lista Última atualização: 20/04/2026

Para que serve

Tela operacional central do fluxo de entrada de mercadorias. Gerencia o ciclo de vida completo de uma NF-e de entrada: importação do XML, resolução de pendências de cadastro (fornecedor e produtos), conferência de itens com validação de quantidades e custos, gerenciamento de duplicatas (contas a pagar), e confirmação — que gera a movimentação de estoque e as contas a pagar. Também permite cancelar (antes da confirmação) ou estornar (após a confirmação, revertendo o estoque).

O fluxo segue as seguintes situações em sequência:

Upload/Importação
      ↓
IMPORTADA / PENDENTE_CADASTROS  →  resolver fornecedor + vincular produtos
      ↓
EM_CONFERENCIA  →  conferir itens, custos e duplicatas
      ↓ (opção)
DIVERGENTE  →  registrar divergência e resolver
      ↓
CONFIRMADA  →  estoque movimentado + contas a pagar geradas
      ↓ (reversão)
ESTORNADA

Quem pode usar

Usuários com acesso ao módulo Fiscal.

Como usar (passo a passo)

1. Importar uma NF-e nova

Via upload de XML

1. Na Lista de NF-e de Entrada, clique em Upload de XML.
2. Selecione o arquivo procNFe.xml do fornecedor.
3. O sistema valida o destinatário do XML:
   • Se identificar a filial pelo CNPJ do <dest>, preenche automaticamente o campo Filial destinatária e exibe alerta de sucesso.
   • Se não identificar a filial, bloqueia a importação e exibe alerta de erro com o CNPJ encontrado no XML.
4. Selecione o Depósito de entrada e confirme a Data de entrada.
5. Defina se deve Gerar contas a pagar das duplicatas (padrão: sim).
6. Clique em Importar.

Via Documentos Destinados

1. Na Lista de Documentos Destinados, acesse o documento (deve ter manifestação de ciência e situação "autorizada").
2. Inicie o fluxo de importação a partir do documento destinado.
3. Preencha os dados de entrada (filial, depósito, data) e clique em Importar.

Após importar, o sistema navega para o detalhe da nota recém-criada.

---

2. Resolver pendências (situações IMPORTADA / PENDENTE_CADASTROS)

Se a nota ficou em PENDENTE_CADASTROS, há pendências a resolver antes de avançar para conferência.

Cadastrar fornecedor ausente

1. O alerta "Fornecedor X não está cadastrado" aparece no topo.
2. Clique em Cadastrar no alerta.
3. No modal, selecione a Empresa, ajuste o nome/nome fantasia e a inscrição estadual se necessário.
4. Clique em OK. O fornecedor é criado usando os dados do XML e vinculado à nota.

Vincular produtos ausentes

1. O alerta "X item(ns) sem produto do sistema vinculado" aparece no topo.
2. Opção A — Vincular em lote: clique em Vincular em lote para associar todos os itens sem produto de uma só vez.
3. Opção B — Item a item: na aba Itens, clique em Vincular na linha do item sem produto.
4. No modal de vinculação, escolha entre:
   • Vincular a existente: busque o produto no sistema pelo nome ou SKU e ative "Criar alias" para reconhecimento automático nas próximas notas.
   • Criar novo: preencha empresa, unidade padrão (unidade de controle de estoque) e controles de estoque/lote/venda/compra; o sistema cria o produto com os dados do XML e cadastra automaticamente uma unidade transacional a partir do uCom do XML (com fator_estoque e fator_preco iguais à quantidade comercial lida, podendo ser ajustados depois na aba Unidades do produto).

Cadastrar transportadora (opcional)

1. Se o XML contiver transportadora não cadastrada, aparece alerta informativo (não bloqueia o avanço).
2. Clique em Cadastrar no alerta para criar o cadastro com os dados do XML.

Quando todas as pendências obrigatórias estiverem resolvidas (fornecedor + todos os itens vinculados), o botão Avançar p/ conferência é habilitado.

---

3. Avançar para conferência

1. Clique em Avançar p/ conferência.
2. O sistema calcula os custos sugeridos de cada item (custo bruto, líquido, com rateio, custo médio novo) e muda a situação para EM_CONFERENCIA.
3. Uma mensagem de sucesso é exibida e os dados são recarregados.

---

4. Calcular / Recalcular custos

O botão Calcular custos aparece para notas que ainda não foram confirmadas e que tenham ao menos um item com produto vinculado.

1. Clique em Calcular custos.
2. Se os custos já foram calculados, o sistema pergunta se deseja recalcular (sobrescreve os valores aprovados).
3. Confirme para recalcular ou cancele para manter os valores atuais.
4. Uma mensagem informa quantos itens foram calculados.

---

5. Conferir itens (situação EM_CONFERENCIA ou DIVERGENTE)

Na aba Itens, os itens com produto vinculado exibem o botão Conferir.

1. Clique em Conferir na linha do item.
2. No modal de conferência, o painel esquerdo exibe os dados do XML (qtd, valor, custos sugeridos).
3. Preencha os campos de conferência:
   • Quantidade conferida: quantidade física contada.
   • Valor conferido: valor efetivamente recebido.
   • Tipo de divergência: se houver diferença (ex.: quantidade, preço).
   • Observação da divergência.
   • Custo de reposição aprovado: custo que será gravado no produto (sugerido ou ajustado).
   • Preço de venda aprovado: novo preço de venda sugerido pelo sistema.
   • Escrituração divergente e Observação de escrituração: para casos em que o registro contábil difere do físico.
   • Número do lote, Data de fabricação, Data de validade: para produtos com controle de lote.
4. Clique em Salvar conferência.

---

6. Registrar divergência geral

1. Clique em Marcar divergência (disponível em EM_CONFERENCIA).
2. No modal, informe o motivo geral (mínimo 3, máximo 500 caracteres).
3. Clique em Registrar. A nota passa para DIVERGENTE.

Para resolver:

1. Após tratar a divergência, clique em Resolver divergência e confirme.
2. A nota retorna para EM_CONFERENCIA.

---

7. Gerenciar duplicatas

Na aba Duplicatas, as duplicatas originadas do XML e as adicionadas manualmente são listadas.

• Importar do XML: remove as duplicatas atuais (sem conta a pagar gerada) e reimporta do XML original.
• Adicionar duplicata: cria manualmente uma duplicata com número, vencimento, valor, forma de pagamento e observações.
• Editar duplicata: clique no ícone de lápis. Disponível apenas para duplicatas sem conta a pagar gerada.
• Remover duplicata: clique no ícone de lixeira. Disponível apenas para duplicatas sem conta a pagar gerada.

---

8. Confirmar a NF-e

1. Clique em Confirmar (disponível em EM_CONFERENCIA).
2. Confirme no pop-up ("Registra estoque, cria lotes, gera contas a pagar").
3. O sistema:
   • Registra a entrada no estoque no depósito selecionado.
   • Cria registros de lote para produtos com controle de lote.
   • Gera Contas a Pagar a partir das duplicatas (se habilitado).
4. A situação passa para CONFIRMADA.

---

9. Cancelar a NF-e (antes da confirmação)

1. Clique em Cancelar.
2. No modal, informe o motivo (mínimo 3, máximo 500 caracteres).
3. Clique em Cancelar NF-e. A situação passa para CANCELADA.

---

10. Estornar a NF-e (após confirmação)

1. Clique em Estornar.
2. Leia o aviso: "Reverte a movimentação de estoque e cancela contas a pagar sem baixa".
3. Informe o motivo (mínimo 10, máximo 500 caracteres).
4. Clique em Estornar NF-e. A situação passa para ESTORNADA.

---

Campos da tela

Formulário de importação (nova nota)

Campo	Obrigatório	O que preencher	Observações
Arquivo XML	Sim (upload)	Arquivo procNFe.xml	Apenas para upload manual; não necessário ao importar de documento destinado
Filial destinatária	Sim	Selecione a filial	Preenchida automaticamente pelo CNPJ do XML quando reconhecida
Depósito de entrada	Sim	Selecione o depósito	Filtrado pela filial selecionada
Data de entrada	Sim	Data DD/MM/AAAA	Padrão: data atual
Gerar contas a pagar	Não	Sim / Não	Padrão: Sim; determina se as duplicatas geram Contas a Pagar na confirmação

Card "Dados da NF-e" (detalhe — view-only)

Campo	Descrição
Chave	Chave de acesso de 44 dígitos, copiável
Emitente	Razão social do fornecedor
CNPJ	CNPJ do emitente formatado
UF	UF do emitente
Natureza	Natureza da operação (natOp)
Emissão	Data de emissão da NF-e
Entrada	Data de entrada informada no sistema
Filial	Filial destinatária
Depósito	Depósito de entrada
Fornecedor	Nome do fornecedor no sistema (ou "pendente" se não vinculado)
Valor produtos	Soma dos produtos
Frete	Valor do frete
Valor total	Valor total da NF-e

Aba Itens

Coluna	Descrição
#	Número de ordem do item no XML
Produto	Descrição do XML, cProd, EAN, NCM, CFOP e vínculo com produto do sistema
Un.	Unidade transacionada (vinda do uCom do XML). Vinculada a uma unidade cadastrada do produto com fator_estoque_snapshot/fator_preco_snapshot gravados no momento da confirmação
Qtd.	Quantidade do XML e quantidade conferida (se preenchida)
Valor un.	Valor unitário
Total	Valor total do item
Divergência	Tipo de divergência identificado na conferência
Ações	"Vincular" (pendente) ou "Conferir" (em conferência/divergente)

Modal de conferência de item

Campo	Obrigatório	O que preencher	Observações
Quantidade conferida	Não	Quantidade física contada	Padrão: quantidade do XML
Valor conferido	Não	Valor efetivamente recebido	—
Tipo de divergência	Não	Selecione o tipo	Preenchido se houver diferença
Observação da divergência	Não	Texto livre	—
Custo de reposição aprovado	Não	Valor monetário R$	Custo que será gravado no produto
Preço de venda aprovado	Não	Valor monetário R$	Sugestão de novo preço
Escrituração divergente	Não	Checkbox	—
Observação de escrituração	Não	Texto livre	—
Número do lote	Não	Código do lote	Para produtos com controle de lote
Data de fabricação	Não	Data DD/MM/AAAA	—
Data de validade	Não	Data DD/MM/AAAA	—

Aba Tributação (view-only)

Coluna	Descrição
#	Ordem do item
Descrição	Descrição do produto
CFOP	CFOP do item
NCM	NCM do item
CST/CSOSN	Código de situação tributária
BC ICMS	Base de cálculo do ICMS
vICMS	Valor do ICMS
vST	Valor do ICMS-ST
vIPI	Valor do IPI
vPIS	Valor do PIS
vCOFINS	Valor do COFINS

Aba Transportadora (view-only)

Campo	Descrição
Modalidade de frete	CIF, FOB, terceiros, próprio por conta do remetente/destinatário ou sem frete
Transportadora	Nome e CNPJ (ou "Pendente de cadastro")
Placa do veículo	—
UF do veículo	—
Quantidade de volumes	—
Espécie dos volumes	—
Peso bruto (kg)	—
Peso líquido (kg)	—
Valor do frete	—

Aba Duplicatas

Coluna	Descrição
Número	Número da duplicata
Vencimento	Data de vencimento
Valor	Valor da parcela
Forma de pagamento	Forma de pagamento vinculada
Origem	XML (importada do XML) ou Manual
Conta a Pagar	Número do documento da conta a pagar gerada (após confirmação)
Ações	Editar (lápis) e Remover (lixeira) — desabilitados se já tem Conta a Pagar

Modal de duplicata (adicionar/editar)

Campo	Obrigatório	O que preencher	Observações
Número	Sim	Identificador da duplicata (máx. 60 caracteres)	—
Vencimento	Sim	Data DD/MM/AAAA	Padrão: hoje + 30 dias ao adicionar
Valor	Sim	Valor em R$	Mínimo R$ 0,01
Forma de pagamento	Não	Selecione	Opcional
Observações	Não	Texto livre (máx. 500 caracteres)	—

Aba Auditoria (view-only)

Coluna	Descrição
Data	Data e hora do evento
Ação	Descrição da ação realizada
De	Situação anterior
Para	Situação nova
Usuário	Nome do usuário responsável
Motivo	Motivo informado (cancelamento, estorno etc.)

Modal cadastrar fornecedor

Campo	Obrigatório	O que preencher	Observações
Empresa	Sim	Selecione a empresa	Empresa interna à qual o fornecedor será vinculado
Nome	Não	Nome do fornecedor	Padrão: razão social do XML
Nome fantasia	Não	Nome fantasia	—
Inscrição estadual	Não	IE do emitente	Sugerida pelo XML

Modal cadastrar transportadora

Campo	Obrigatório	O que preencher	Observações
Empresa	Sim	Selecione a empresa	O cadastro usa os dados da transportadora do XML

Modal divergência geral

Campo	Obrigatório	O que preencher	Observações
Motivo geral	Sim	Mínimo 3, máximo 500 caracteres	—

Modal cancelar

Campo	Obrigatório	O que preencher	Observações
Motivo	Sim	Mínimo 3, máximo 500 caracteres	—

Modal estornar

Campo	Obrigatório	O que preencher	Observações
Motivo	Sim	Mínimo 10, máximo 500 caracteres	—

Validações e regras

• O botão Importar fica desabilitado no upload se o XML não tiver sido carregado ou se o CNPJ destinatário não corresponder a nenhuma filial cadastrada.
• O botão Avançar p/ conferência só é habilitado quando não há pendência de fornecedor e todos os itens estão com produto vinculado.
• O botão Confirmar só aparece em situação EM_CONFERENCIA.
• O botão Estornar só aparece em situação CONFIRMADA.
• O botão Cancelar aparece em todas as situações exceto CONFIRMADA, CANCELADA e ESTORNADA.
• Duplicatas com Conta a Pagar gerada não podem ser editadas ou removidas.
• O cálculo de custos fica disponível enquanto a nota não estiver CONFIRMADA, CANCELADA ou ESTORNADA, desde que haja ao menos um item com produto vinculado.
• Se os custos já foram calculados e o usuário clicar em Calcular custos novamente, o sistema exibe confirmação antes de sobrescrever.

Mensagens de erro e o que fazer

Mensagem	Causa	Como resolver
"XML sem <dest> — não foi possível identificar a quem a nota pertence"	XML inválido ou sem bloco de destinatário	Verifique se o arquivo é um procNFe.xml válido e autorizado
"NF-e não pertence a nenhuma filial cadastrada"	CNPJ do destinatário não corresponde a nenhuma filial do tenant	Verifique o arquivo ou cadastre a filial com o CNPJ correto
"Selecione o arquivo XML antes de importar."	Botão Importar clicado sem arquivo	Selecione o arquivo XML
"NF-e importada"	—	Confirmação de importação bem-sucedida
"Movida para conferência — custos sugeridos calculados"	—	Confirmação de avanço para conferência
"NF-e confirmada — estoque e contas a pagar geradas"	—	Confirmação de nota confirmada
Custos calculados em X de Y itens	—	Confirmação do cálculo de custos
"Custos ja foram calculados — X de Y itens"	Cálculo anterior já existe	Modal de confirmação exibido; escolha recalcular ou manter
"Fornecedor cadastrado e vinculado"	—	Confirmação de criação de fornecedor
"Transportadora cadastrada e vinculada"	—	Confirmação de criação de transportadora
"Produto vinculado"	—	Confirmação de vínculo de produto existente
"Produto criado e vinculado"	—	Confirmação de criação de novo produto
"Item conferido"	—	Confirmação de conferência de item
"Divergência registrada"	—	Confirmação de divergência geral
"Divergência resolvida"	—	Confirmação de resolução de divergência
"NF-e cancelada"	—	Confirmação de cancelamento
"NF-e estornada — estoque revertido"	—	Confirmação de estorno
"Duplicata adicionada"	—	—
"Duplicata atualizada"	—	—
"Duplicata removida"	—	—
"Duplicatas reimportadas"	—	Duplicatas reimportadas do XML original
"Erro ao carregar NF-e de entrada"	Falha ao buscar registro	Verifique a conectividade
⚠️ CONFIRMAR demais mensagens retornadas pela API	Validações de negócio no backend	Leia a mensagem e corrija os dados ou consulte o suporte

Integrações e dependências

• Estoque: a confirmação gera entradas de estoque no depósito selecionado. O estorno reverte essas entradas.
• Financeiro (Contas a Pagar): cada duplicata gera uma Conta a Pagar ao confirmar (quando habilitado). O estorno cancela as contas sem baixa.
• Custo do produto: ao conferir, o custo de reposição aprovado pode atualizar o custo do produto no cadastro.
• Fornecedores/Clientes: ao criar fornecedor ou transportadora, o sistema usa os dados do bloco XML (<emit> e <transp>).
• Produtos: o alias criado na vinculação permite reconhecimento automático do cProd do fornecedor nas próximas notas.
• Documentos Destinados: documentos importados via Documentos Destinados exigem manifestação de ciência prévia para liberar o XML completo na SEFAZ.
• Depende de: nfeEntradaService, filiaisService, depositosService, empresasService, produtosService, formasPagamentoService.

Dúvidas frequentes

Por que o botão "Avançar p/ conferência" não aparece? Verifique os alertas de pendência: se ainda houver fornecedor não cadastrado ou itens sem produto vinculado, o botão fica oculto. Resolva todas as pendências obrigatórias primeiro.

O que acontece se eu confirmar sem conferir todos os itens? A confirmação não exige que todos os itens tenham sido conferidos individualmente. A ação de "Conferir" é opcional por item; serve para registrar divergências e aprovar custos. Se não conferir, o sistema usa os valores do XML.

Posso alterar o depósito após importar?

O que é o "Calcular custos"? O sistema calcula para cada item: custo bruto unitário (valor do item ÷ quantidade), custo líquido (descontando créditos de ICMS/PIS/COFINS), custo com rateio de frete e despesas, e o novo custo médio sugerido para o produto. Esses valores aparecem no modal de conferência como sugestão.

Posso criar um produto novo diretamente na vinculação? Sim. No modal de vinculação de produto, selecione Criar novo e preencha os dados mínimos. O produto é criado com o nome e NCM do XML e vinculado ao item imediatamente.

As duplicatas do XML são importadas automaticamente? Sim. Ao importar o XML, o sistema lê o bloco <cobr><dup> e cria as duplicatas automaticamente. Se o XML não tiver duplicatas, uma única duplicata com o valor total é gerada. Use o botão Importar do XML na aba Duplicatas para reimportar caso precise resetar.

O estorno cancela as contas a pagar já pagas? Não. O estorno cancela apenas contas a pagar sem baixa. Contas já pagas não são afetadas.

Histórico de alterações

Data	Alteração
20/04/2026	Documento inicial criado.