nNF em refNFP: o número da nota de produtor referenciada
<nNF>ide › NFref › refNFP › nNFRevisão editorial em 27 de set. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
nNF em ide/NFref/refNFP é o número do documento anterior do produtor. O campo não recebe o número da NF-e atual, um protocolo de autorização, uma chave de acesso ou um identificador interno do sistema.
Seu XPath é /nfeProc/NFe/infNFe/ide/NFref/refNFP/nNF. O MOC identifica-o como BA18: obrigatório dentro do grupo, com faixa de 1 a 999999999. A existência do filho obrigatório não obriga o uso de refNFP em toda operação. MOC 7.0, Grupo BA, p. 12.
O número vem da nota anterior
Localize a identificação da nota de produtor que se pretende referenciar e confira seu número juntamente com emitente, modelo e série. Se houver um registro digital dessa referência, compare-o com o documento, porque um ID de cadastro pode coincidir numericamente com o número fiscal sem representar a mesma informação.
| Informação | Onde procurar no XML |
|---|---|
| Número da NF-e atual | ide/nNF |
| Número do documento anterior de produtor | NFref/refNFP/nNF |
| Série do documento anterior | NFref/refNFP/serie |
| Chave completa de uma NF-e anterior | NFref/refNFe |
O número fiscal possui no máximo nove dígitos; uma chave de acesso completa possui 44 caracteres. Não corte uma chave para tentar convertê-la em número de documento.
Faixa e escrita do número
O tipo TNF do pacote 010d v1.03 usa a expressão [1-9]{1}[0-9]{0,8}. Ela representa um inteiro positivo com até nove posições, começando por dígito diferente de zero.
| Entrada | Conferência técnica |
|---|---|
123 |
Forma compatível, se esse for o número real |
000123 |
Não corresponde à forma lexical do tipo TNF |
0 |
Fora da faixa |
123.0 ou 123,0 |
Fração/separador não pertencem ao número |
1000000000 |
Tem dez posições, acima do limite |
Se a impressão apresenta zeros de preenchimento, preserve a imagem ou o documento original e represente o número no XML conforme o tipo. Isso não permite trocar a identidade nem extrair uma parcela de outro identificador. Se o documento não oferece um número identificável, a informação precisa ser esclarecida na origem; zero não é um substituto para ausência.
O número não identifica sozinho uma referência
A verificação histórica BA10-10 do MOC usa IE, modelo, série e número para detectar duplicidade de nota de produtor referenciada. A regra é facultativa para modelo 55 e associa a mensagem 682.
Considere dois documentos sintéticos do mesmo produtor, ambos modelo 04: série 1/número 123 e série 2/número 123. São combinações diferentes. Repetir série 1/número 123 com a mesma IE e modelo em duas ocorrências reproduz a identidade examinada pela regra.
Assim, não elimine uma referência apenas por encontrar o mesmo nNF em outro grupo. Compare a tupla completa e os documentos. Não invente um novo número para evitar duplicidade. MOC, BA10-10, p. 79.
Exemplo parcial comentado
Hipótese: documento anterior modelo 04, série 2, número 123. Fragmento sintético para demonstrar esses identificadores; faltam UF, período, CNPJ ou CPF, IE e o restante da nota. Não está pronto para transmissão.
<refNFP xmlns="http://www.portalfiscal.inf.br/nfe">
<mod>04</mod>
<serie>2</serie>
<nNF>123</nNF>
</refNFP>
A leitura resulta em número 123 da série 2 do documento anterior. Ela não permite descobrir o número da NF-e atual nem comprovar autorização fiscal.
Conferência da origem e mudança na mensagem 682
Se o número divergir, confira:
- a ocorrência de referência apontada pelo retorno;
- o número e a série no documento anterior;
- o registro do qual o gerador leu o dado;
- eventual mapeamento que copiou
ide/nNFpara a referência; - a forma produzida no XML, inclusive zeros iniciais ou formatação local.
Corrija apenas a causa comprovada e confira o novo XML gerado, sem editar documento assinado.
A NT 2026.002 v1.10a muda BA10-10 para proibição de referenciar refNFP, mantendo código 682. O cronograma prevê produção em 05/10/2026 e homologação em 01/09/2026. No corte de 26/09/2026, a data de produção ainda é futura. Portanto, código, descrição, ambiente e data precisam ser lidos juntos: 682 não terá sempre o significado histórico de duplicidade. NT 2026.002, pp. 3 e 9.
A hipótese legal de referência não é decidida pelo número nem por este guia. Para organizar a conferência, o grupo refNFP apresenta os demais dados do documento anterior.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/ide/NFref/refNFP/nNF- Namespace
http://www.portalfiscal.inf.br/nfe- Leiaute
- 4.00 · PL_010e_v1.02
- Ocorrências no XSD
- 1–1 no contexto do elemento pai
- Tipo
- TNF · string
- Preenchimento no catálogo
- Condicional
A ocorrência vale dentro da estrutura XML: um campo obrigatório em um grupo opcional não torna esse grupo obrigatório. A aplicação fiscal depende da operação e da versão da regra.
- pattern
[1-9]{1}[0-9]{0,8}- whiteSpace
preserve