NVE na NF-e: detalhamento aduaneiro e formato dos códigos
<NVE>det › prod › NVERevisão editorial em 26 de set. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
NVE significa Nomenclatura de Valor Aduaneiro e Estatística. Na NF-e aparece em /nfeProc/NFe/infNFe/det/prod/NVE, como codificação que detalha determinados NCM. É opcional na estrutura e pode ocorrer até oito vezes por produto, com duas letras maiúsculas seguidas de quatro dígitos em cada ocorrência.
A classificação principal continua sendo a NCM
NCM e NVE têm papéis diferentes. A NCM identifica a classificação da mercadoria na nomenclatura comum; a NVE acrescenta detalhamento de valor aduaneiro e estatística nas hipóteses previstas. A Receita Federal descreve a NVE nos dados da mercadoria da declaração de importação como informação detalhada por nível, atributo e especificação. Manual de importação, Aba Mercadoria.
Não se determina uma NVE apenas aplicando o formato a um produto. O código precisa corresponder à especificação real e à referência aduaneira. A indicação na declaração ou nos dados oficiais da operação fornece a origem para a integração; o formato do XML mostra como representá-la, sem escolher uma codificação pela aparência.
Uma ocorrência para cada código
O MOC admite até oito codificações principais quando a mercadoria se enquadra em mais de uma. Elas são elementos irmãos dentro de prod; não há uma lista com vírgulas dentro da mesma tag nem um campo concatenado de 12 caracteres. A ocorrência máxima aplica-se ao produto, não à nota inteira. MOC, I05a.
Fragmento sintético e parcial com códigos fictícios. Não comprova existência ou aplicação a um NCM e não está pronto para transmissão.
<prod xmlns="http://www.portalfiscal.inf.br/nfe">
<!-- Identificação e NCM omitidos -->
<NVE>AA0001</NVE>
<NVE>BB0002</NVE>
<!-- Demais campos omitidos -->
</prod>
Aqui há duas codificações do mesmo item. aa0001, AA-0001 e AA1 não respeitam o formato descrito. Um número exibido com zeros precisa conservar suas quatro posições. Quando a documentação confirma que não há codificação aplicável a representar, a tag opcional pode ser omitida. A falta de confirmação da origem não demonstra essa situação: confira a especificação aduaneira antes de concluir sobre o preenchimento, sem inventar código para atender à integração.
O que comparar entre declaração e nota
Identifique o produto pelo código e descrição, o NCM já confirmado e a especificação documental. Em uma importação com várias adições ou itens, não copie todos os códigos da declaração para todos os produtos: associe cada codificação à mercadoria que ela caracteriza.
Se a nota e a declaração têm unidades ou linhas diferentes, estabeleça a correspondência antes de transferir campos. Um único documento aduaneiro pode envolver vários produtos; a posição da linha no arquivo não é prova de identidade. Conserve também a edição da referência utilizada, pois os dados precisam corresponder à operação documentada.
Diagnóstico de erro estrutural ou código duvidoso
Quando o validador acusa o campo, veja se há duas letras maiúsculas e quatro dígitos, excesso de ocorrências, espaços ou separadores. Confira a ordem dos elementos em prod: XML bem formado pode ter filhos fora da sequência do schema.
Quando a questão é material, compare o código e a descrição aduaneira com a mercadoria efetiva. Validade no XSD não confirma que uma NVE exista ou caracterize corretamente o produto. A definição precisa da especificação cabe à avaliação da operação com os documentos oficiais, e não a uma escolha editorial desta página. Após corrigir uma transferência comprovadamente incorreta, gere o XML novamente; não edite arquivo assinado nem altere NCM para acomodar um código que veio de outra linha.
Fontes oficiais
- MOC 7.0 — Anexo I — 7.00; p.18 I05a.
- Schemas NF-e/NFC-e — PL_010c_NT2022_002v1.30; prod/NVE min 0 max 8 pattern[A-Z]{2}[0-9]{4}.
- Receita Federal — Aba Mercadoria da DI — página consultada em 26/09/2026; campo Nomenclatura de Valor Aduaneiro e Estatística da Aba Mercadoria.
Leitura relacionada
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/det/prod/NVE- Namespace
http://www.portalfiscal.inf.br/nfe- Leiaute
- 4.00 · PL_010e_v1.02
- Ocorrências no XSD
- 0–8 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
[A-Z]{2}[0-9]{4}- whiteSpace
preserve