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

uTrib na NF-e: unidade tributável, NCM e rejeição 817

<uTrib>det › prod › uTrib

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

uTrib identifica a unidade em que a quantidade tributável qTrib e o valor unitário vUnTrib estão expressos. Fica em /nfeProc/NFe/infNFe/det/prod/uTrib, é obrigatória e admite texto de 1 a 6 caracteres. Não é uma alíquota e não precisa coincidir com uCom quando o produto tem conversão documentada entre apresentações.

Unidade comercial e unidade tributável

Uma caixa com doze unidades pode ser comercializada em CX e ter o conjunto tributável expresso em UN, se essa relação corresponde à apresentação e à disciplina aplicável. Na venda de duas caixas por R$ 120,00 cada, o bruto é R$ 240,00. Com essa conversão confirmada, qTrib=24 e vUnTrib=10; alterar só o texto de uTrib sem converter quantidade e preço rompe a relação.

NCM, GTIN e nome comercial não fornecem um fator universal de conversão. Peso variável, volume e apresentações diferentes exigem documentação própria. Quando a unidade necessária não está confirmada, obtenha a identificação, a apresentação, a operação e a tabela/regra aplicável; não escolha uma abreviatura apenas porque o XML aceita seis caracteres.

Comércio exterior: tabela e condição da rejeição 817

A regra I14-10, modelo 55, valida NCM e uTrib na exportação (tpNF=1 e idDest=3) e nas operações vinculadas à exportação com CFOP 1501, 2501, 5501, 5502, 5504, 5505, 6501, 6502, 6504 ou 6505. A incompatibilidade gera 817. A nota da regra orienta usar a tabela NCM/unidades tributáveis publicada em Documentos/Diversos do Portal Nacional e desconsiderar diferença de maiúsculas/minúsculas. Isso não torna a tabela de exportação uma seleção automática para toda venda interna. MOC, I14-10.

A tabela oficial publicada em 02/09/2026 traz NCM, início/fim de vigência, abreviatura e descrição da unidade de exportação. Consulte a linha do código já confirmado e a data da operação. A presença de uma linha no arquivo mais novo não significa que seu código já esteja vigente em produção.

O IT 2024.001 v2.40 inclui NCM 85181020 com homologação em 15/09/2026 e produção em 01/10/2026; a linha correspondente da tabela traz UN e início em 01/10. No corte de 26/09/2026, essa inclusão ainda é futura em produção. O exemplo demonstra vigência da tabela, não recomenda NCM ou unidade para um produto do leitor. IT 2.40, pp.3 e 6.

GLP e a regra futura de NFC-e

I13-20/854 exige uTrib igual a kg, sem distinguir maiúsculas de minúsculas, quando cProdANP=210203001, GLP, nos modelos 55/65. A condição usa esse código ANP específico; não se transfere a exigência a qualquer combustível ou mercadoria.

I13-10/735 prevê unidade válida em tabela específica para NFC-e, mas o MOC marca implementação futura. Essa previsão não deve ser apresentada como rejeição universal já ativa apenas porque aparece no manual. Preserve regra, ambiente e data ao investigar o retorno.

Exemplo e diagnóstico

Fragmento sintético e parcial de conversão comercial documentada, sem definir classificação ou incidência e sem estar pronto para transmissão.

<prod xmlns="http://www.portalfiscal.inf.br/nfe">
  <!-- Campos anteriores omitidos -->
  <uCom>CX</uCom><qCom>2.0000</qCom><vUnCom>120.00</vUnCom>
  <vProd>240.00</vProd><cEANTrib>SEM GTIN</cEANTrib>
  <uTrib>UN</uTrib><qTrib>24.0000</qTrib><vUnTrib>10.00</vUnTrib>
  <indTot>1</indTot>
</prod>

Para 817, confira primeiro se a operação satisfaz a condição de I14-10, depois NCM efetivo, vigência e unidade da linha oficial. Para 854, confira cProdANP específico e uTrib. Para erro de multiplicação 630, compare quantidade, preço e unidade tributáveis, usando os valores realmente serializados.

Uma divergência de unidade pode ser mapeamento ou parâmetro fiscal não confirmado. Corrija somente a origem comprovada e confira o conjunto novamente; não altere NCM, CFOP ou unidade para contornar a resposta, nem edite XML assinado.

Fontes oficiais

Leitura relacionada

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/det/prod/uTrib
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:TString · TString
Preenchimento no catálogo
Obrigatório

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.

maxLength
6
minLength
1
pattern
[!-ÿ]{1}[ -ÿ]{0,}[!-ÿ]{1}|[!-ÿ]{1}
whiteSpace
preserve