nNF: número da NF-e ou NFC-e no XML

ide/nNF é o número do documento fiscal que está sendo emitido. Ele fica em NFe/infNFe/ide/nNF, é obrigatório e admite inteiro de 1 a 999999999, sem zeros à esquerda. Não é a chave de acesso, o código numérico cNF, o número do protocolo ou o identificador interno do sistema. MOC 7.0, Anexo I, B08, página 9.

Nesta página: Número precisa ser lido junto com série, modelo e emitente, XML sem zeros à esquerda e chave com posições fixas, A mesma tag pode pertencer a um documento referenciado, A formação particular na Nota Fiscal Fácil, Como investigar número incorreto ou aparente duplicidade.

Número precisa ser lido junto com série, modelo e emitente

Uma empresa pode ter documento número 42 na série 1 e outro número 42 na série 2. Outra empresa também pode emitir número 42. Por isso, um número isolado não identifica com segurança uma nota nem basta para localizá-la em uma integração.

Compare ao menos o estabelecimento emitente, o modelo (mod=55 ou 65), a série e o número, além da chave de acesso quando disponível. A chave contém outras informações e tem 44 posições; nNF representa apenas o componente numérico da nota. Um ID de banco pode coincidir por acaso com o número fiscal, mas essa coincidência não é um contrato: confira qual identificador a tela, API ou consulta está pedindo antes de buscar o documento.

O número deve vir do controle de numeração do emissor, no contexto da série e do processo de emissão. Não derive o próximo número pelo maior ID de banco ou por contagem de registros: documentos em outros estados ou processos podem participar do controle. Este campo também não informa se um número já foi autorizado, cancelado ou inutilizado; esses estados precisam ser conferidos por seus registros e retornos próprios.

XML sem zeros à esquerda e chave com posições fixas

O tipo TNF tem o padrão [1-9]{1}[0-9]{0,8}. Isso aceita 1, 42 e 999999999; rejeita 0, 00042, números negativos, decimais, separadores e números com mais de nove dígitos. Não use a formatação visual de um relatório como representação da tag. Confira ide/nNF e TNF no pacote oficial PL_010c.

Exemplo sintético parcial, com os demais dados de identificação omitidos:

<ide xmlns="http://www.portalfiscal.inf.br/nfe">
  <mod>55</mod>
  <serie>1</serie>
  <nNF>42</nNF>
</ide>

No componente de nove posições da chave de acesso, esse número é representado como 000000042. As duas representações têm finalidades distintas: preencher posições na chave não autoriza escrever <nNF>000000042</nNF>. A chave não deve ser remontada manualmente para “corrigir” um XML já assinado. A tabela de composição e a formação especial de NFF estão na NT 2021.002 v1.12, página 5.

A mesma tag pode pertencer a um documento referenciado

Em uma nota processada, o caminho principal é nfeProc/NFe/infNFe/ide/nNF. Há também nNF em grupos de documentos referenciados, como ide/NFref/refNF/nNF e ide/NFref/refNFP/nNF. Esses campos identificam outro documento relacionado, não a nota atual. O MOC descreve os campos BA09 e BA18 na página 12. MOC, Grupo BA.

Se uma busca por <nNF> retorna várias ocorrências, confira o pai e os ancestrais de cada uma. Não use uma extração genérica que pega a última ocorrência ou qualquer tag com esse nome. Para localizar a nota atual, selecione exatamente ide/nNF; a leitura dos documentos referenciados deve usar caminhos próprios.

A existência desses grupos no leiaute não decide quando é permitido referenciá-los. A NT 2026.002 v1.10a altera as regras BA03-10 e BA10-10, com cronograma de produção em 05/10/2026 para esse conjunto de alterações. A explicação do homônimo é estrutural e não uma orientação para usar referências sem conferir a regra vigente. NT 2026.002 v1.10a, cronograma, página 3.

A formação particular na Nota Fiscal Fácil

Na NFF, a NT 2021.002 v1.12 documenta geração e controle pelo aplicativo, com o espaço de nNF usado para dois dígitos do dia, dois do mês, um dígito do tipo de identificação do emissor e quatro dígitos do número sequencial diário. O espaço de série também tem formação própria. Não transplante essa composição para o emissor convencional: é uma regra do processo NFF. NT 2021.002 v1.12, seção 2.1, página 5.

Para interpretar um número incomum, confirme procEmi e a origem do documento antes de tratá-lo como uma sequência convencional. O artigo de série delimita diferenças e divergências documentais desse processo.

Como investigar número incorreto ou aparente duplicidade

Compare o XML efetivamente enviado, o pedido de emissão e o controle de numeração da mesma empresa/modelo/série. Se o valor difere apenas por zeros de apresentação, verifique o formato de cada artefato antes de concluir que são notas diferentes. Se há mais de um nNF no arquivo, confira se um deles é referência.

Antes de tentar emitir outra nota por aparente duplicidade ou falta de retorno, consulte a chave e o resultado da transmissão anterior. Um timeout não prova que a SEFAZ não autorizou o documento. Trocar o número e reenviar por tentativa pode criar outro documento, em vez de recuperar o resultado existente.

Se o problema for estrutural, corrija a serialização do inteiro ou o dado de origem comprovadamente errado e confira o XML gerado. Não renumere um documento autorizado por edição de arquivo. Uma lacuna na sequência, isoladamente, não determina neste artigo cancelamento ou inutilização: a decisão depende do histórico de cada número e do procedimento fiscal aplicável.