nDI na NF-e: número do documento de importação e Duimp

nDI é o número do documento de importação associado ao produto da NF-e. Apesar do nome, sua descrição no XSD abrange DI, DSI, DIRE e Duimp. O caminho é /nfeProc/NFe/infNFe/det/prod/DI/nDI.

Ele identifica o documento aduaneiro; não é a chave da NF-e, o número do item, o número da adição nem o código interno do exportador. Sua origem é a declaração efetivamente relacionada à mercadoria.

Limite atual e diferença para o manual antigo

O MOC 7, p.19, descreve nDI com 1 a 12 caracteres. No XSD oficial PL 010f v1.04, a declaração real do elemento usa TString, mínimo 1 e máximo 15 caracteres, incluindo expressamente a Duimp na descrição.

Para integrar, use o limite do schema compatível com o autorizador; não mantenha uma validação local de 12 apenas porque aparece na edição-base do manual. Também não corte um identificador de 15 para fazê-lo caber: isso pode apontar para outro documento ou destruir sua identidade.

O tipo é textual, não uma quantidade numérica. Preserve o identificador conforme o documento e a especificação aplicável, incluindo posições significativas. Evite armazená-lo como número de ponto flutuante ou permitir que uma planilha o transforme em notação científica. O limite de 15 não significa que qualquer texto de 15 caracteres seja uma declaração válida.

Como associar declaração e produto

Um prod admite de 0 a 100 ocorrências de DI. Em cada grupo enviado, nDI é obrigatório uma vez. Junto dele ficam dDI, xLocDesemb, UFDesemb, dDesemb, a via internacional tpViaTransp, tpIntermedio, o código interno do exportador e as adições. Há ainda dados condicionais, como AFRMM e adquirente/encomendante.

Essa estrutura permite relacionar o item a mais de um documento, mas exige conservar a associação real. O número da declaração se repete em produtos da mesma importação quando o vínculo documental assim ocorre; isso não dispensa conferir as adições e seus itens. A documentação da Receita Federal sobre Duimp é o ponto oficial para o procedimento aduaneiro, que não se confunde com a estrutura da NF-e.

Exemplo de identificador textual

Fragmento sintético parcial, com número fictício de 15 caracteres; não representa declaração existente nem nota pronta para transmissão:

<nDI xmlns="http://www.portalfiscal.inf.br/nfe">26BR00000000001</nDI>

O exemplo mostra por que o campo não deve ser convertido para inteiro. Os caracteres BR fazem parte do texto ilustrativo; não são instrução para construir um número aduaneiro. O identificador verdadeiro deve ser recuperado da declaração, sem criação por concatenação de ano, empresa ou sequência local.

Ausência de DI e rejeição 525

A regra I08-110 do MOC 7, p.92 trata, no modelo 55, de CFOP iniciado por 3 sem o grupo DI. É facultativa por UF e prevê 525, com exceções documentadas para 3201, 3202, 3503 e 3553. Ela verifica a presença do grupo no cenário definido; não escolhe o CFOP nem valida sozinha a correção de nDI.

Se o número existe no cadastro, mas não no XML, confira se o mapper gerou a ocorrência DI no item correto. Se o problema for schema, confira tamanho e caracteres antes de investigar a regra 525. Se a declaração é Duimp e o sistema recusa mais de 12 caracteres, compare a versão do schema e a validação local: o erro pode estar no emissor.

Conferência segura do identificador

Compare documento aduaneiro, valor salvo, valor enviado e item/adição relacionado. Procure truncamento, espaços nas extremidades, perda de zeros, troca entre declarações e conversão automática por planilha. Registre a versão do schema e o retorno completo.

Corrija a origem ou o mapeamento comprovadamente incorretos. Não substitua o número por uma declaração semelhante nem invente um identificador para permitir emissão. Quando não houver vínculo documental confirmado, a pendência é determinar a declaração e os itens com o responsável aduaneiro/fiscal, preservando os documentos reais da operação.