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

vUnTrib na NF-e: valor unitário tributável e rejeição 630

<vUnTrib>det › prod › vUnTrib

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

vUnTrib é o valor unitário do produto expresso na unidade tributável uTrib. Fica em /nfeProc/NFe/infNFe/det/prod/vUnTrib. É obrigatório e deve ser lido junto a qTrib e uTrib. A palavra “tributável” não significa uma alíquota, o valor do imposto ou a base de cálculo de um tributo.

O valor pertence à unidade declarada

O preço comercial vUnCom se refere a uCom. Quando a unidade tributável é a mesma e os demais dados correspondem, os preços podem coincidir. Quando há conversão, copiar o preço comercial sem convertê-lo pode produzir uma multiplicação incorreta.

Num exercício de duas caixas com doze unidades cada, preço comercial R$ 120,00 por caixa e bruto R$ 240,00, a quantidade tributável é 24 unidades se essa conversão está documentalmente confirmada. O valor unitário tributável correspondente é 240÷24=10. Se vUnTrib receber 120, o produto 24×120=2.880 não representa o mesmo bruto.

O fator precisa vir da apresentação real e dos documentos, não de um NCM ou de uma aproximação por nome comercial. Peso variável exige dados próprios. Uma quantidade tributável desconhecida ou igual a zero não permite obter preço por divisão; a aceitação estrutural de zero não elimina essa dependência matemática.

Precisão do preço e arredondamento do bruto

O tipo TDec_1110v consultado aceita zero ou valor positivo com até onze dígitos inteiros e até dez casas decimais. O preço unitário pode conservar casas necessárias à relação quantitativa, enquanto vProd é monetário com duas casas quando decimal. Não limite automaticamente vUnTrib a duas casas por usar um componente de moeda na interface.

Num exercício em que três unidades correspondem a bruto R$ 1,00, o quociente 1÷3 é periódico. Representar vUnTrib 0.3333333333 resulta 0.9999999999 antes do arredondamento do produto para 1.00. O exemplo mostra precisão; não determina preço ou distribuição para uma operação real.

Rejeição 630 e limite da tolerância

I11-20/630, facultativa nos modelos 55/65, compara vProd a qTrib×vUnTrib quando finNFe=1, nota normal. A nota(*4) orienta arredondar o resultado da multiplicação para duas casas e considerar R$ 0,01 para mais ou menos nessa comparação. A regra 629 faz comparação distinta com os dados comerciais. MOC, I11-20 e nota(*4).

A tolerância não deve ser usada como margem para alterar valores verdadeiros ou escolher unidade. Confira primeiro os números serializados e a conversão. Um fator de doze ou de mil na divergência costuma exigir investigar a grandeza antes dos centavos.

Exemplo de preço convertido

Fragmento sintético e parcial do exercício das caixas, com identificação e parâmetros fiscais omitidos. Não é 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>

Ponto decimal, ausência de símbolo monetário e preservação das casas necessárias são requisitos de serialização. Preço com vírgula ou separador de milhar não é o formato XML correspondente.

Diagnóstico de preço errado ou precisão perdida

Localize o item retornado e escreva os dois conjuntos com unidades. Compare documentação, preço por embalagem, fator e bruto. Confira se a integração copiou vUnCom, preço líquido após desconto, valor de outra apresentação ou preço arredondado antes da conversão.

Calcule com os valores efetivamente presentes no XML. Quando a causa é transferência ou precisão demonstravelmente incorretas, corrija a origem e confira as duas multiplicações. Quando falta unidade ou fator, obtenha essa informação específica sem ajustar qTrib ou vUnTrib até fechar. Não estime tributação nem edite XML assinado.

Fontes oficiais

Leitura relacionada

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/det/prod/vUnTrib
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
TDec_1110v · string
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.

pattern
0|0\.[0-9]{1,10}|[1-9]{1}[0-9]{0,10}|[1-9]{1}[0-9]{0,10}(\.[0-9]{1,10})?
whiteSpace
preserve