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

NVE na NF-e: detalhamento aduaneiro e formato dos códigos

<NVE>det › prod › NVE

Revisã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

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