Dúvidas sobre o funcionamento do campo nNF na nota fiscal

40 views
Skip to first unread message

Roberto Ribeiro

unread,
Nov 2, 2025, 8:53:55 AM (5 days ago) Nov 2
to NFePHP
Bom dia, espero que estejam bem,

Senhores, estou desenvolvendo um emissor de notas e, no momento atual, fiz uma tabela Controle com o id da NFe a ser emitida, id da Empresa relacionada, Modeloserie, nNf.
 
Estou fazendo o registro dos dados da nota fiscal a ser emitida e salvando numa tabela Nfe_Emit. Nesse local ficam os dados da nota fiscal que será enviada para o sefaz e na Controle os dados relacionados.

A minha dúvida se encontra em como esse campo deve se comportar e como devo relacionar ele com os outros campos. 

Devo ter uma sequência de 1, 2, 3, 4 em relação ao meu emitente ou a cada nota que tentei emitir? por exemplo, tentei emitir uma nota, (id_nfe = 1, empresa=1, modelo=55 serie=1, nNf=1) mas tive um problema qualquer e o sefaz não autorizou (independente do retorno). Dai, vou fazer o cadastro de outra Nfe, os campos informados podem ser  (id_nfe = 2, empresa=1, modelo=55 serie=1, nNf=1),  apenas alterando o id da nota?  Ou o sequencial deve ser mantido de acordo com a empresa emitente. 

Nesses dois cenários, a diferença principal é que para cada tentativa de emitir uma nota o sequencial pode ser determinado pelo id da nota: Sequência de (1,2,3,4,...) no campo nNf para o mesmo id da nota e o mesmo id da empresa, Caso tivesse outra tentativa de emitir nota, id_nota = 2 e geraria outra sequência  (1,2,3,4,...) com essa nota sem interferir na sequencia anterior.
  
Ou pela empresa, onde para cada série e empresa teria um sequencial único, e sendo os casos tratados de acordo com os erros recebidos do sefaz e, reutilizando, ou não, o mesmo número sequencial de acordo com o retorno do sefaz

Poderiam me dar um norte nesse cenário ou um explicação mais detalhada?

Agradeço desde já!

Juliana Apolo

unread,
Nov 2, 2025, 9:17:16 AM (5 days ago) Nov 2
to nfe...@googlegroups.com
O número da nota fiscal é sequencial e por cnpj emitente. A série também é sequencial.

Exemplo: 
cnpj x - serie 1 - nf 1
cnpj x - serie 1 - nf 2 ... 99999999

A série é incrementada sempre que estoura a quantidade de números da nota fiscal (ele tem 8 posições).

O fluxo é seguinte:
- Gera o xml
- assina o xml
- envia pra sefaz
- Se aprovado salva os dados do protocolo no xml e salva o xml em um arquivo .xml
- Se for rejeitada, arruma-se o erro reportado no xml e faz o reenvio da mesma mantendo o número e a série da nota.

Não se pode pular números.
Você precisará desse número para um possível cancelamento da mesma além da chave da Nota Fiscal que é usada para acessar a nf na sefaz. Essa chave é gerada com base no cnpj, número e série, além de outros dados. A chave precisa ser salva no seu banco de dados também.

Dica: salve os números gerados em homologação também para não gerar problemas.

--
--
Você recebeu esta mensagem porque está inscrito no Grupo "NFePHP".
Para Postar: nfe...@googlegroups.com
Para Sair do Grupo: nfephp+un...@googlegroups.com
Link: http://groups.google.com.br/group/nfephp?hl=pt-BR
-------
Repositórios: https://github.com/nfephp-org
---
You received this message because you are subscribed to the Google Groups "NFePHP" group.
To unsubscribe from this group and stop receiving emails from it, send an email to nfephp+un...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/nfephp/f148464e-78d6-4b4d-b042-887215e616d3n%40googlegroups.com.

Juliana Apolo

unread,
Nov 2, 2025, 9:24:15 AM (5 days ago) Nov 2
to nfe...@googlegroups.com
Só uma correção.. numero da nota fiscal são 9 posições e não 8.

Roberto Ribeiro

unread,
Nov 2, 2025, 9:50:45 AM (5 days ago) Nov 2
to NFePHP
Muito obrigado Juliana, era exatamente isso que queria sanar. 

Kalmon V.

unread,
Nov 2, 2025, 10:15:18 AM (5 days ago) Nov 2
to NFePHP
Sobre a rejeição, SEMPRE e bom armazenar, a SEFAZ pode rejeitar e mesmo assim a nota fiscal ter sido protocolada e aceita (vai entender).
Casos comuns, rejeitar e na próxima emissão a sefaz retorna "539 - Duplicidade de NF-e, com diferença na Chave de Acesso", ja vi isso acontecer em:
  • 999 - Erro não catalogado.
  • 778: Informado NCM inexistente.
  • Timeout - Sefaz caiu ou problema na conexão. 
Reply all
Reply to author
Forward
0 new messages