vUnid na NF-e: IPI por unidade e precisão do parâmetro

vUnid informa o valor do IPI por unidade tributável, no cálculo por quantidade. Ele é um parâmetro monetário por unidade padrão, diferente do preço de venda e da alíquota percentual. Sua precisão também difere da do imposto total do item.

Imposto por unidade, com origem fiscal definida

O XPath é /nfeProc/NFe/infNFe/det/imposto/IPI/IPITrib/vUnid, no namespace http://www.portalfiscal.inf.br/nfe. O MOC identifica O12 como valor por unidade tributável. A anotação de TIpi descreve o valor do imposto de pauta por unidade de medida. MOC, p. 51 e XSD, TIpi

O campo deve estar junto de qUnid, na alternativa por quantidade de IPITrib; depois do par vem vIPI. A alternativa percentual é vBC/pIPI. Não se escolhe um par apenas pela facilidade de cálculo ou porque produziu o mesmo resultado em um teste.

A origem de vUnid deve ser o parâmetro fiscal definido para o produto e a operação, com a unidade padrão e a data pertinentes. O valor legal por unidade, a modalidade e a incidência precisam ser confirmados pelo responsável fiscal. Um exemplo de XML não oferece uma pauta aplicável ao leitor.

O MOC documenta os valores unitários do produto em outro grupo. MOC, I10a/I14a, pp. 18–19 Ter a mesma unidade de medida não transforma preço em imposto. Da mesma forma, R$ 0,1375 por unidade não significa uma taxa de 0,1375%.

Quatro casas quando houver fração

Na referência oficial arquivada PL 010d v1.03, vUnid usa TDec_1104. Sua faceta aceita até 11 dígitos inteiros e, quando existe fração, exatamente quatro casas. A descrição resumida “até quatro casas” não traduz essa exigência específica do padrão. Tipos básicos, TDec_1104

Inteiro e zero são admitidos, mas isso não determina se são parâmetros fiscais cabíveis. Informação ausente não deve ser convertida em zero, e omitir vUnid quando a alternativa por quantidade foi escolhida deixa o par incompleto.

qUnid usa tipo distinto, com fração de uma a quatro casas quando presente. vIPI usa formato monetário de duas casas quando fracionário. Não aplique indiscriminadamente um formatador de duas casas a todos os campos do cálculo. Tipos básicos

O schema 010d citado é histórico, confrontado com notas técnicas posteriores no corte de 27/09/2026, sem declaração de pacote vigente para transmissão.

Exemplo com valor unitário fracionário

Suponha uma operação fictícia já definida para IPI por quantidade, com 40 unidades padrão e imposto de R$ 0,1375 por unidade. A quantidade e o parâmetro usam a mesma unidade.

A conta é:

40 unidades padrão × R$ 0.1375/unidade padrão = R$ 5.50

O fragmento assume CST 50 já definido, mostra somente IPITrib e omite o pai IPI/cEnq. É parcial e sintético, não está pronto para transmissão e não indica um valor legal por unidade.

<IPITrib xmlns="http://www.portalfiscal.inf.br/nfe">
  <CST>50</CST>
  <qUnid>40</qUnid>
  <vUnid>0.1375</vUnid>
  <vIPI>5.50</vIPI>
</IPITrib>

Se o parâmetro for alterado prematuramente para R$ 0,14 por unidade, a conta passa a 40 × 0.14 = 5.60. O resultado muda em R$ 0,10. Isso demonstra perda do parâmetro original; não é uma tolerância autorizada. Além disso, 0.14 não atende à faceta histórica de vUnid. Escrever 0.1400 resolve a forma textual, mas mantém a alteração do parâmetro.

A conta por quantidade não divide por 100. Dividir esse resultado por 100 trataria um valor por unidade como percentual, usando outra escala.

Diagnóstico de parâmetro, unidade e representação

Quando vIPI divergir, confira se vUnid corresponde ao imposto unitário definido, se qUnid está na unidade padrão correta e se a conversão de quantidade está documentada. Quantidade em caixas multiplicada por imposto por unidade física pode produzir uma conta correta sobre grandezas incompatíveis.

Se a falha for de formato, compare o número na origem, sua representação intermediária e o texto final. Verifique se um formatador monetário removeu as quatro casas ou se a serialização converteu o ponto em vírgula. Corrigir a representação não deve modificar a grandeza fiscal.

Se aparecerem vBC/pIPI junto de qUnid/vUnid, investigue mistura de alternativas. Se o gerador trouxe vUnCom ou vUnTrib para vUnid, o mapeamento está usando preço do produto onde o campo representa imposto por unidade.

Consulte qUnid para unidades e conversão, pIPI para a modalidade percentual e vIPI para o resultado e a soma. A conferência técnica não escolhe a pauta, a unidade fiscal ou a incidência da operação.