vIPI na NF-e: valor do item, cálculo e soma do IPI
<vIPI>det › imposto › IPI › IPITrib › vIPIRevisão editorial em 27 de set. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
vIPI em IPITrib informa o valor do Imposto sobre Produtos Industrializados do item. O campo aparece tanto no cálculo percentual quanto no cálculo por quantidade. A conferência deve separar a apuração do item, a soma do imposto e o efeito de componentes no valor final da nota.
Nesta página: valor do item, duas contas, formato e precisão, soma e IPI devolvido e valor total da nota.
Valor do item em qualquer modalidade de IPITrib
O XPath é /nfeProc/NFe/infNFe/det/imposto/IPI/IPITrib/vIPI, no namespace http://www.portalfiscal.inf.br/nfe. O MOC identifica O14 como valor do IPI. No ramo IPITrib presente, vIPI é obrigatório e vem depois do par de cálculo escolhido: vBC/pIPI ou qUnid/vUnid. MOC, p. 51 e XSD, TIpi
A origem do valor é a memória de apuração do item, com os parâmetros e a modalidade definidos para a operação. Um número copiado de outra mercadoria ou um total global repetido em vários itens pode ter formato válido sem representar a apuração correta.
Não há vIPI em IPINT. A aceitação de zero no tipo de IPITrib não escolhe o ramo e não comprova isenção, alíquota zero ou não tributação. Essas decisões e seus códigos precisam estar fundamentados pelo responsável fiscal.
Dois exemplos com resultado em reais
Na modalidade percentual, a conta de conferência é base × percentual ÷ 100. Na modalidade por quantidade, é quantidade padrão × valor de imposto por unidade.
| Hipótese fictícia já definida | Conta | Valor do IPI |
|---|---|---|
| Base R$ 500,00 e percentual 3% | 500.00 × 3.00 ÷ 100 |
R$ 15,00 |
| 12 unidades padrão e imposto R$ 0,6250 por unidade | 12 × 0.6250 |
R$ 7,50 |
Os números são premissas de exemplos, sem indicação de alíquota ou pauta legal. No segundo, a quantidade e o valor unitário usam a mesma unidade padrão; preço de venda e quantidade comercial não são substitutos automáticos desses parâmetros.
O trecho abaixo representa somente IPITrib do primeiro exemplo, com CST 50 assumido como já definido. Omite IPI/cEnq e o restante da nota; é parcial e sintético, não está pronto para transmissão.
<IPITrib xmlns="http://www.portalfiscal.inf.br/nfe">
<CST>50</CST>
<vBC>500.00</vBC>
<pIPI>3.00</pIPI>
<vIPI>15.00</vIPI>
</IPITrib>
No segundo exemplo, o par seria qUnid 12 e vUnid 0.6250, com vIPI 7.50. Os dois pares não devem ser misturados. Um resultado igual entre modalidades não torna seus parâmetros intercambiáveis.
Formato do valor final e precisão dos fatores
No XSD oficial arquivado PL 010d v1.03, vIPI utiliza TDec_1302: até 13 dígitos inteiros e, quando houver fração, exatamente duas casas com ponto. Aceita 15, 15.00, 7.50, 0 e 0.00; não aceita 7,50, 7.5, 7.5000, sinal negativo ou separador de milhar. Tipos básicos
Não uniformize a precisão dos fatores pela precisão do imposto. pIPI, qUnid e vUnid têm facetas próprias. Preservar a precisão dos parâmetros e aplicar a memória de cálculo pertinente é diferente de apenas formatar o resultado em duas casas.
Nos exemplos, as contas resultam exatamente em centavos. Se uma operação real produzir mais casas, a memória de apuração deve registrar o tratamento aplicado ao resultado. O tipo do XML determina a representação final, sem estabelecer, sozinho, uma regra fiscal universal de arredondamento ou tolerância.
Zero confirmado, ausência de cálculo e filho omitido são situações distintas. No IPITrib presente, deixar vIPI vazio ou retirar somente esse campo não representa zero.
O pacote 010d citado é uma referência estrutural histórica, confrontada com notas técnicas posteriores no corte de 27/09/2026, sem declaração de pacote vigente para transmissão.
Soma do IPI e diferença para IPI devolvido
Se os dois exemplos corresponderem a itens de uma mesma nota, a soma do IPI será:
15.00 + 7.50 = 22.50
W12-10 compara o total de IPI, total/ICMSTot/vIPI, com a soma dos valores O14 dos itens. É facultativa para modelo 55 e tem retorno 538 quando aplicada e constatada divergência. MOC, p. 121
Na investigação, confira valores do mesmo XML, itens incluídos uma única vez, alterações entre cálculo e geração e eventual cópia de base ou valor unitário no total. Não altere o imposto documentado de um item apenas para fechar a soma.
Há outro grupo chamado IPI em det/impostoDevol/IPI, com campo vIPIDevol. Ele registra IPI devolvido e não é este IPITrib/vIPI. XSD, impostoDevol Sua totalização é tratada separadamente por W12a-10, retorno 863, facultativa para modelo 55. MOC, p. 121
Se uma hipótese contiver R$ 22,50 de IPI dos itens e R$ 5,00 de IPI devolvido em seu contexto próprio, somar 22.50 + 5.00 = 27.50 no total vIPI mistura dois registros. A destinação do valor devolvido deve seguir sua definição própria; a presença desse exemplo não indica quando uma devolução é cabível.
Total do imposto e valor total da nota
O total de IPI é diferente de vNF. W16-10 é facultativa para modelos 55/65 e tem retorno 610. Na fórmula geral da NT 2023.004 v1.11, a conferência utiliza:
vProd − vDesc − vICMSDeson + vST + vFCPST + vICMSMonoReten + vFrete + vSeg + vOutro + vII + vIPI + vIPIDevol + vServ + PIS-ST indicado + COFINS-ST indicado.
As duas últimas parcelas são, respectivamente, os valores R06 dos itens com indSomaPISST=1 e T06 dos itens com indSomaCOFINSST=1. Não são os totais do PIS e da COFINS próprios. vServ é a parcela de serviços prevista na regra. O total de IPI é uma das parcelas positivas; a fórmula não se resume a “valor do produto mais IPI”.
No faturamento direto de veículos novos, tpOp=2, a fórmula excepcional mantém vIPI, mas não contém vST, vFCPST, vICMSMonoReten nem vIPIDevol. vICMSMonoReten permanece na fórmula geral: a rasura está somente na fórmula excepcional. Nas operações de importação com CFOP iniciado por 3, W16-10 não se aplica. Essas condições impedem usar a mesma conferência indiscriminadamente em qualquer nota. NT 2023.004 v1.11, pp. 15–16
Na mesma versão, a antiga exceção 3 sobre ICMS desonerado está riscada. A exceção 4 vigente na redação da regra determina não rejeitar pela falta de subtração de vICMSDeson nos itens com indDeduzDeson=0 ou com esse indicador não preenchido. Essa condição precisa ser preservada no diagnóstico; não equivale a uma orientação geral para deixar de deduzir qualquer valor de ICMS desonerado. NT 2023.004 v1.11, p. 16
Para conferir vNF, use a memória completa de composição e as condições da operação. A soma de bases, parâmetros unitários e impostos não é um atalho válido para obter o valor final.
A regra obrigatória O01-10, retorno 742, possui outro foco: presença de IPI em NFC-e ou NF-e com DANFE Simplificado Tipo 2, tpImp=6, com ampliação ao Tipo 2 no cronograma de produção de 03/08/2026. Mudar só vIPI para zero mantém o grupo presente. NT 2026.002, pp. 3 e 17
Consulte IPITrib, pIPI e vUnid para os parâmetros. Esta conferência não escolhe modalidade, base, taxa, enquadramento ou imposto devido; verifica os valores e a representação de uma apuração já definida.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/det/imposto/IPI/IPITrib/vIPI- 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_1302 · 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
0|0\.[0-9]{2}|[1-9]{1}[0-9]{0,12}(\.[0-9]{2})?- whiteSpace
preserve