nAdicao na NF-e: número da adição e omissão no caso de DUImp

nAdicao identifica o número da adição do documento de importação no detalhamento DI/adi do produto da NF-e. No leiaute atualizado pela NT 2023.004, o campo tem ocorrência de zero a uma vez. A mesma nota técnica determina expressamente que, no caso de DUImp, nAdicao não deve ser preenchido. NT 2023.004 v1.11, p. 7, I26

Essa condição responde à dúvida que surge ao comparar um MOC antigo, que mostra o campo obrigatório, com um schema posterior que permite sua ausência.

A atualização oficial e o caso de DUImp

O MOC 7.0 de 2020 apresenta nAdicao com ocorrência 1–1. A NT 2023.004 v1.11 posterior apresenta 0–1 e traz a observação específica de DUImp. O schema 010d v1.03 efetivamente lido também declara minOccurs="0". O cronograma da NT informa implantação do schema em produção em 06/05/2024. MOC, p. 20; NT, pp. 3 e 7; schema

Portanto, a diferença entre essas fontes tem uma atualização oficial identificada. Não é necessário impor um preenchimento conservador de nAdicao em toda ocorrência de adi para “conciliar” as versões.

A condição de DUImp não elimina o grupo adi nem seus outros campos obrigatórios. nSeqAdic e cFabricante continuam no detalhamento. Também não transforma este artigo em orientação para elaborar uma DUImp: aqui se explica como seu contexto é representado no XML da NF-e.

Quando existe uma adição a informar em outro contexto, o número deve corresponder ao documento de origem. A possibilidade estrutural de omissão não autoriza apagar uma referência existente nem inventar uma adição para preencher a tag.

Formato do número e origem

Quando presente, nAdicao deve atender ao padrão:

[1-9]{1}[0-9]{0,2}

São de um a três dígitos, com primeiro dígito de 1 a 9: valores de 1 a 999, sem sinal, máscara ou zeros à esquerda. Schema, nAdicao

A forma correta não demonstra que a adição existe. Compare o valor com o número no documento de importação associado ao item, preservando a ligação com nDI e nSeqAdic. Não derive nAdicao da posição do produto na NF-e, do número de ocorrências de adi ou de um contador interno sem essa associação.

No arquivo processado, localize:

/nfeProc/NFe/infNFe/det/prod/DI/adi/nAdicao

O namespace é http://www.portalfiscal.inf.br/nfe. Em arquivo sem a raiz nfeProc, a consulta começa por NFe. A tag é filha de adi, não diretamente de DI.

Exemplo: adição 12 e item 4

Considere registros sintéticos que relacionem o detalhamento à adição 12 e ao item sequencial 4:

<adi>
  <nAdicao>12</nAdicao>
  <nSeqAdic>4</nSeqAdic>
  <cFabricante>FAB-045</cFabricante>
</adi>

12 é o número da adição; 4 é a sequência do item. Não há uma obrigação de igualdade entre esses números. A página de nSeqAdic explica a sequência e sua dimensão de até cinco dígitos. NT, I26/I27

Em um segundo cenário, cuja origem foi identificada como DUImp, a estrutura selecionada omite nAdicao:

<adi>
  <nSeqAdic>1045</nSeqAdic>
  <cFabricante>FAB-045</cFabricante>
</adi>

A ausência expressa a orientação oficial; 0 ou uma tag vazia não substituem a omissão. O número 1045 é apenas uma sequência sintética compatível com o formato documentado de nSeqAdic; seu valor real depende da origem. Ambos os exemplos omitem o restante de DI e da NF-e e não estão prontos para transmissão.

Conferência de falhas e dados de origem

Se um validador exige nAdicao apesar do contexto de DUImp, confira a versão do schema utilizada pelo sistema. Um arquivo antigo pode conservar a ocorrência anterior. Compare a mensagem e o caminho indicados com o XML efetivamente gerado.

Se a tag está presente e falha, investigue zero, zeros à esquerda, quatro ou mais dígitos, espaços e conteúdo vazio. Se o XML é aceito, mas a referência parece errada, compare a declaração, o item e a adição com a fonte de dados usada na geração.

Uma falha não deve ser contornada renumerando adições ou trocando o tipo do documento. Primeiro é necessário identificar o documento real e o vínculo que o emissor deveria preservar.

Referências

Data de corte: 26/09/2026. MOC 7.0 utilizado como referência histórica; ocorrência e condição de DUImp conferidas na NT 2023.004 v1.11 e no schema oficial 010d v1.03.