vUnTrib na NF-e: valor unitário tributável e rejeição 630
<vUnTrib>det › prod › vUnTribRevisã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
- MOC 7.0 — Anexo I — 7.00; p.19 I14a; p.93 I11-20; p.140(*4).
- Schemas NF-e/NFC-e — PL_010c_NT2022_002v1.30; prod/vUnTrib TDec_1110v e tiposBasico.
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