nNF em refNF: número da nota anterior, limites e zeros à esquerda

nNF de refNF é o número da nota modelo 1/1A ou 2 que está sendo referenciada. A informação deve vir do documento original. Ela é distinta de ide/nNF, número da NF-e atual, e de identificadores internos de cadastro, pedido ou importação. MOC, BA09, p. 12

O XPath completo é /nfeProc/NFe/infNFe/ide/NFref/refNF/nNF, no namespace http://www.portalfiscal.inf.br/nfe. O campo é obrigatório no grupo e usa o tipo TNF, que representa valores de 1 a 999999999, sem zero inicial na forma XML. Schema, refNF e TNF

O número vem do documento anterior

Identifique o número fiscal no original e confira que ele corresponde ao emitente, modelo e série que estão na mesma referência. Não copie o número da nota atual só porque ambas as tags se chamam nNF.

Um ID do sistema pode servir para localizar um cadastro, mas não vira número fiscal. A diferença precisa ser mantida na integração: o registro interno relaciona a referência ao original; o conteúdo da tag declara o número do documento anterior.

Da mesma forma, protocolo, código numérico de chave e número de pedido têm outros significados. Não reduza uma chave de 44 posições a um número de até nove dígitos e não crie uma numeração local para substituir uma origem ausente.

O tipo TNF exige um inteiro positivo sem zero inicial

O padrão do XSD é [1-9]{1}[0-9]{0,8}: primeiro dígito entre 1 e 9, seguido de zero a oito outros dígitos. Tipos básicos, TNF

O preenchimento visual do papel pode mostrar zeros à esquerda. Se a conferência documental confirma que o número fiscal é 1234, a representação do inteiro nesse campo é 1234. Isso não autoriza retirar letras ou cortar um identificador sem primeiro confirmar o significado da origem.

A parte de número numa chave eletrônica costuma ocupar nove posições fixas, incluindo preenchimento posicional. Esse formato da chave não é o tipo do campo individual refNF/nNF. Copiar nove caracteres de outra estrutura sem tratar o contexto pode produzir 000001234, que não corresponde a TNF.

Não use zero quando o número está desconhecido, nem corte um conteúdo longo para fazê-lo caber. Nesses casos, recupere o original e confira se houve importação de ID, protocolo, chave ou campo comercial errado.

Número e série identificam a nota em conjunto

serie é um campo separado. O MOC determina informar zero quando a série não é utilizada; o número da nota continua positivo. Ausência de série não significa ausência de número. MOC, BA08/09

Fragmento parcial e sintético, para leitura de referência histórica, sem documento completo ou autorização:

<refNF xmlns="http://www.portalfiscal.inf.br/nfe">
  <cUF>35</cUF>
  <AAMM>2508</AAMM>
  <CNPJ>12345678000195</CNPJ>
  <mod>01</mod>
  <serie>0</serie>
  <nNF>1234</nNF>
</refNF>

O exemplo pressupõe original modelo 1/1A sem série utilizada, número 1234, emitido em agosto de 2025. serie=0 representa a condição documentada; nNF=1234 identifica seu número. O CNPJ é sintético com DV coerente, sem comprovação cadastral.

A ordem do grupo é UF, período, CNPJ, modelo, série e número. Colocar série e número em uma única tag, como 1/1234, perde a separação definida pelo leiaute. Schema, refNF

Repetição do número não basta para o diagnóstico

A antiga BA03-10/681, facultativa no modelo 55, compara CNPJ, modelo, série e número. Dois registros com nNF=1234 não são automaticamente duplicados se os outros componentes diferem. Mas cada referência precisa ter documento original que comprove a identidade declarada. MOC, p. 79

Se os quatro componentes são iguais, mudar só o ano/mês não altera a combinação de duplicidade dessa regra. Se o mesmo original foi importado duas vezes, a investigação é do vínculo repetido; não se renumera a nota anterior para fazê-la parecer diferente.

A interpretação de 681 também muda com a versão: a NT 2026.002 v1.10a passa a proibir refNF, de forma obrigatória. O critério antigo de duplicidade é riscado na nova redação. Um único número correto não supera a proibição. NT 2026.002, p. 9

Conferência do número antes de alterar a origem

A mudança de BA03-10 tem teste em 01/09/2026 e produção prevista para 05/10/2026, futura no corte de 26/09/2026. Guarde ambiente e data do retorno para distinguir diagnóstico antigo de duplicidade e novo de vedação. NT 2026.002, p. 3

Para erro de número:

1. Localize o número fiscal no original, separado de série, ID comercial e protocolo.
2. Compare o valor armazenado no vínculo com o conteúdo de refNF/nNF.
3. Confira representação positiva, ausência de zero inicial, máscara e comprimento.
4. Examine todos os componentes da referência e possíveis importações repetidas.
5. Registre código/motivo, modelo atual, UF, ambiente e data antes de concluir a causa.

Quando houver erro comprovado de cópia ou serialização, corrija a origem do gerador preservando o número verdadeiro. A validação do XSD é uma etapa de conferência, não prova de existência da nota nem de autorização.

Se a origem real não se enquadra nesse tipo documental ou uma regra veda a referência, reúna o original, modelo, série, número, motivo da emissão, UF e data para confirmar a representação e a operação com o responsável contábil. Não invente número, não altere finalidade e não edite XML fiscal assinado ou autorizado.

Veja série da nota referenciada e refNF — identificação completa.