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

nSeqAdic na NF-e: sequência do item de importação com até 5 dígitos

<nSeqAdic>det › prod › DI › adi › nSeqAdic

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

nSeqAdic informa o número sequencial do item no detalhamento DI/adi do produto da NF-e. O campo é obrigatório uma vez em cada adi e, no leiaute atualizado pela NT 2023.004, tem de 1 a 5 dígitos. Não é necessário restringi-lo ao antigo limite de três dígitos registrado no MOC de 2020. NT 2023.004 v1.11, p. 8, I27

A sequência pertence ao item de importação

A sequência deve conservar a referência do item na origem da importação. Confira a ligação entre o produto da NF-e, a declaração indicada em nDI e o item detalhado em adi. Não crie o número apenas contando grupos no XML.

Há três identificações diferentes:

Identificação Contexto
det/@nItem Número do item da NF-e
nAdicao Número da adição da importação
nSeqAdic Número sequencial do item no detalhamento da importação

Esses números podem diferir. Não copie automaticamente o atributo nItem para nSeqAdic nem o número da adição para a sequência. A descrição oficial de nSeqAdic é “Número sequencial do item”; a origem precisa sustentar qual item está sendo referenciado. NT, I26/I27

No arquivo processado:

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

O namespace é http://www.portalfiscal.inf.br/nfe. Se o arquivo não tem o envoltório nfeProc, a consulta começa por NFe. Cada adi presente exige sua própria sequência, mas essa exigência não torna o grupo DI obrigatório em toda operação.

O limite atualizado é de cinco dígitos

O schema oficial 010d v1.03 utiliza:

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

Isso permite valores de 1 a 99999, sem zero inicial, sinal, máscara ou separador decimal. Schema, nSeqAdic

Valor Resultado de formato
7 Compatível
1045 Compatível com o limite atualizado
99999 Limite superior do padrão
0 ou 0007 Primeiro dígito inválido
100000 Mais de cinco dígitos
1.045 Ponto não faz parte do formato

O MOC 7.0 documenta 1 a 3 dígitos. A NT 2023.004 posterior documenta 1 a 5, e o cronograma da versão 1.11 informa implantação do schema em produção em 06/05/2024. Essa atualização explica a diferença; não existe uma pendência que obrigue adotar 999 como limite conservador do campo. MOC, p. 20; NT, pp. 3 e 8

O intervalo é uma restrição de formato. Um número como 1045 pode ser estruturalmente aceito e ainda estar errado se não corresponde ao item de origem.

Exemplos com adição e com DUImp

Em um cenário sintético com adição 3 e item sequencial 7, o grupo selecionado seria:

<adi>
  <nAdicao>3</nAdicao>
  <nSeqAdic>7</nSeqAdic>
  <cFabricante>FAB-007</cFabricante>
</adi>

O 3 identifica a adição; o 7 identifica o item. A ordem dos elementos segue o leiaute: nAdicao, quando presente, antecede nSeqAdic, que antecede cFabricante.

No caso de DUImp, a NT determina que nAdicao não deve ser preenchido, mas mantém nSeqAdic obrigatório. Um exemplo sintético de estrutura seria:

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

A sequência de quatro dígitos cabe no leiaute. O exemplo não estabelece um número real nem como elaborar a DUImp; mostra a manutenção do campo no XML da NF-e. A página de nAdicao explica a omissão naquele contexto. NT, pp. 7–8

Os dois fragmentos omitem outros elementos da declaração e a NF-e; não estão prontos para transmissão.

Diagnóstico de formato e associação

Se uma sequência com quatro ou cinco dígitos falha no emissor, compare a versão do validador utilizado com o schema atualizado. Um limite de interface ou um XSD antigo de três dígitos pode explicar o erro antes de qualquer rejeição da autorizadora.

Para uma falha estrutural, confira ausência do campo, tag vazia, zeros à esquerda, espaços, pontuação e ordem dos elementos. Analise a mensagem completa e o caminho indicado; não presuma um código específico de rejeição apenas pelo nome do campo.

Se o formato passa, mas a sequência não confere, rastreie a associação entre os registros de importação e o produto da NF-e. Verifique se o sistema usou o contador do produto, a posição do grupo ou uma sequência de outra declaração. A próxima etapa é recuperar a referência correta, sem renumerar a origem para se adequar ao XML.

Referências e alcance

Conferência em 26/09/2026, com NT 2023.004 v1.11, MOC 7.0 histórico e schema oficial 010d v1.03 arquivado e lido. O artigo trata da leitura técnica da NF-e, sem criar ou alterar declaração aduaneira e sem definir tributação.

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/det/prod/DI/adi/nSeqAdic
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
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,4}
whiteSpace
preserve