Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Produtos e serviços

nItem em DFeReferenciado: número do item da nota original

<nItem>det › DFeReferenciado › nItem

Revisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.

nItem, dentro de DFeReferenciado, informa qual item do documento original está relacionado à linha atual da NF-e. Ele corresponde ao atributo nItem do det da nota referenciada, e não à posição dessa linha na nota nova.

O caminho desta ocorrência é /nfeProc/NFe/infNFe/det/DFeReferenciado/nItem. det/@nItem é outro dado, com outro papel. A NT 2025.002, Grupo VC e o XSD distinguem esses identificadores.

Como encontrar o número correto

Abra o XML original identificado por DFeReferenciado/chaveAcesso. Localize o produto e o det correspondente, considerando código, descrição, quantidade e demais elementos da operação. Leia seu atributo nItem. Não deduza o número pela ordem em uma planilha, pelo código do produto ou pela linha visual do DANFE.

Exemplo: a nota original tem um produto no det nItem="7". A nota atual contém somente esse produto e o coloca no det nItem="1". A referência continua sendo DFeReferenciado/nItem=7. Renumerar ambos para 1 apontaria para outra linha do original.

Formato e obrigatoriedade condicional

No PL 010f v1.04, nItem é opcional no grupo, mas, quando enviado, deve representar um inteiro de 1 a 990, sem sinal, ponto decimal ou zeros à esquerda. 0, 007, 7.0 e 991 não correspondem ao padrão dessa declaração. A chave é obrigatória sempre que o grupo existir. Esquemas oficiais.

Há duas situações principais nas regras VC03:

Situação documentada Tratamento do número original Retorno relacionado
tpNFDebito=03, débito de notas não processadas na apuração nItem não deve ser enviado VC03-10: 1039 se presente
Referência por item, fora desse débito 03 nItem precisa ser informado VC03-20: 1048 se ausente

O primeiro cenário representa vínculo com o documento. Não substitua a ausência por zero; omitir o elemento e escrever <nItem>0</nItem> são operações diferentes. A escolha do tipo de débito deve estar confirmada pela operação, não pelo desejo de dispensar um campo.

Exemplo de referência à linha 7

Trecho sintético parcial, com chave fictícia, para leitura; não representa nota autorizada ou pronta para transmissão:

<DFeReferenciado xmlns="http://www.portalfiscal.inf.br/nfe">
  <chaveAcesso>35261012345678000195550010000001231123456780</chaveAcesso>
  <nItem>7</nItem>
</DFeReferenciado>

O grupo contém o número original como elemento XML. O número atual é um atributo do det que contém esse grupo. Nenhum desses números informa quantidade: devolver duas unidades do item 7 não transforma nItem em 2 nem exige escrever duas referências idênticas.

Duplicidade, modelo e outras restrições

A VC02-20 compara a combinação chave/item e prevê 1072 quando ela é repetida. Quando nItem não existe, considera somente a chave. Antes de juntar linhas ou retirar uma referência, confira por que o mesmo item original foi dividido e qual representação cabe à operação; não remova informação verdadeira para contornar a regra.

NFC-e 65 não pode usar o grupo (708). Na NF-e 55, misturá-lo com referência por nota em NFref gera 1010. Notas de crédito têm restrição com exceção do tipo 06 de retorno por recusa parcial; os débitos 03/04 e esse crédito 06 têm exigência própria do grupo. A falta da chave, portanto, não é o mesmo problema que a falta de nItem. NT 2025.002, pp.69–70.

Devolução e cronograma em 2026

A versão 1.52 documenta a VC02-14, que exige vínculo por item na devolução e proíbe usar refNFe como substituto. A data de 03/11/2026 registrada nela deve ser lida com o aviso ENCAT de 05/10, que postergou o pacote para 26/10 em homologação e 16/11 em produção. Em 13/10/2026, a mudança ainda não estava nesse marco de implantação.

O número original continua tendo o mesmo significado estrutural. O cronograma altera a exigência de uso em certos cenários; não altera o item efetivamente documentado na nota anterior.

Conferência antes de corrigir

Para 1039, confirme se o tipo de débito 03 é verdadeiro e se o emissor enviou o elemento indevidamente. Para 1048, confira a chave, obtenha o XML original e recupere a numeração exata. Para 1072, compare todos os pares da nota atual. Em erro de schema, confira faixa e representação textual antes de investigar regras fiscais.

Faça a correção na origem do dado ou no mapeamento e gere novamente pelo emissor. Se não houver acesso ao original, registre essa dependência: não existe número de item seguro para adivinhar. O responsável fiscal precisa confirmar a operação, o documento e a finalidade antes de uma nova emissão; o artigo não escolhe esses parâmetros.

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/det/DFeReferenciado/nItem
Namespace
http://www.portalfiscal.inf.br/nfe
Leiaute
4.00 · PL_010e_v1.02
Ocorrências no XSD
0–1 no contexto do elemento pai
Tipo
inline:xs:string · 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,1}|[1-8]{1}[0-9]{2}|[9]{1}[0-8]{1}[0-9]{1}|[9]{1}[9]{1}[0]{1}
whiteSpace
preserve