nSeqAdic na NF-e: sequência do item de importação com até 5 dígitos
<nSeqAdic>det › prod › DI › adi › nSeqAdicRevisã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