IPITrib na NF-e: conferir cálculo percentual e por quantidade
<IPITrib>det › imposto › IPI › IPITribRevisão editorial em 27 de set. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
IPITrib representa o ramo de IPI que contém CST, parâmetros de uma modalidade de cálculo e valor do imposto. O leitor precisa identificar a modalidade já definida para a operação antes de conferir números: percentual sobre uma base e valor por unidade usam campos e unidades diferentes.
Nesta página: sequência, exemplo percentual, exemplo por quantidade, formatos e diagnóstico.
CST, um par de cálculo e valor do IPI
O XPath é /nfeProc/NFe/infNFe/det/imposto/IPI/IPITrib, no namespace http://www.portalfiscal.inf.br/nfe. No pai IPI, IPITrib é alternativa exclusiva a IPINT. O enquadramento cEnq fica no pai, antes do ramo; não dentro de IPITrib. XSD, TIpi
IPITrib começa por um CST do domínio 00, 49, 50 ou 99. Depois vem um dos pares abaixo e, por fim, vIPI, obrigatório em ambas as alternativas. MOC, p. 51
| Modalidade definida | Sequência após CST | Conta aritmética de conferência |
|---|---|---|
| Percentual | vBC, pIPI, vIPI |
Base × percentual ÷ 100 |
| Por quantidade | qUnid, vUnid, vIPI |
Quantidade padrão × imposto por unidade |
Não combine os quatro parâmetros em um só ramo. Não use somente base com quantidade ou percentual com valor por unidade: são metades de alternativas diferentes. Os pares são estruturais, não campos intercambiáveis.
O nome do ramo e seu domínio não escolhem CST, incidência, base, alíquota, pauta por unidade ou direito a crédito. Esses parâmetros devem vir da definição fiscal e da documentação do item. O resultado zero não transforma automaticamente IPITrib em IPINT.
Exemplo percentual com base e alíquota fornecidas
Suponha uma operação fictícia já definida como CST 50, cálculo percentual, base de R$ 1.200,00 e percentual de 4,50%. A origem e o enquadramento foram definidos fora do exemplo. Esses números ilustram a conta, sem indicar alíquota legal.
O cálculo é 1200.00 × 4.50 ÷ 100 = 54.00. O percentual no XML é 4.50; o fator usado matematicamente é 0.045. Confundir esses dois números muda o imposto em cem vezes.
O trecho abaixo mostra somente IPITrib; omite IPI/cEnq e o restante da nota. É sintético, parcial e não está pronto para transmissão.
<IPITrib xmlns="http://www.portalfiscal.inf.br/nfe">
<CST>50</CST>
<vBC>1200.00</vBC>
<pIPI>4.50</pIPI>
<vIPI>54.00</vIPI>
</IPITrib>
O exemplo não afirma que a base seja igual ao preço do produto ou que outra base, como II ou ICMS, possa ser copiada. A composição deve ser conferida na memória fiscal específica do item.
Exemplo por quantidade com unidade correspondente
Em outra operação fictícia, já definida para cálculo por quantidade, suponha CST 50, 24 unidades padrão de tributação e R$ 1,2500 de imposto por unidade. A conferência é 24 × 1.2500 = 30.00.
Este segundo fragmento também é sintético e parcial, omite IPI/cEnq e não está pronto para transmissão.
<IPITrib xmlns="http://www.portalfiscal.inf.br/nfe">
<CST>50</CST>
<qUnid>24</qUnid>
<vUnid>1.2500</vUnid>
<vIPI>30.00</vIPI>
</IPITrib>
vUnid representa imposto por unidade, não preço de venda nem percentual de 1,25%. A unidade da quantidade precisa ser a mesma do valor por unidade. Se a venda estiver em caixas e a tributação em outra unidade padrão, a conversão deve estar documentada. A tag não contém o nome da unidade nem fornece, sozinha, um fator de conversão.
A página de qUnid detalha essa relação, e vUnid explica o parâmetro monetário por unidade.
Precisões que não podem ser uniformizadas
No XSD oficial arquivado PL 010d v1.03, as facetas são distintas:
| Campo | Tipo | Inteiros máximos | Fração quando presente |
|---|---|---|---|
vBC, vIPI |
TDec_1302 | 13 dígitos | Exatamente 2 casas |
pIPI |
TDec_0302a04 | 3 dígitos | 2 a 4 casas |
qUnid |
TDec_1204v | 12 dígitos | 1 a 4 casas |
vUnid |
TDec_1104 | 11 dígitos | Exatamente 4 casas |
Os tipos admitem inteiro e zero, mas não número negativo, vírgula, símbolo de percentual ou separador de milhar. Assim, pIPI=4.50, qUnid=24, vUnid=1.2500 e vIPI=30.00 atendem às facetas históricas; vUnid=1.25 não atende a TDec_1104. Tipos básicos
A precisão do resultado não é a mesma dos fatores. Não arredonde todos os parâmetros para duas casas apenas porque o imposto é monetário. A origem da precisão e do tratamento de resultados deve ser preservada na memória de cálculo; o formato do XML não define uma tolerância fiscal universal.
O pacote 010d é 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 qualquer transmissão.
Conferência do resultado e das condições de presença
Verifique o CST e o enquadramento definidos, o par efetivamente gerado, a origem dos parâmetros e as unidades. Em seguida, confira a conta e a representação de vIPI. Se a conta estiver diferente, investigue uso de fator no lugar de percentual, quantidade comercial no lugar da padrão, preço de venda no lugar do imposto por unidade ou perda de precisão.
Para totalização, W12-10 compara o total de IPI com a soma de O14 dos itens, é facultativa para modelo 55 e tem retorno 538. Se os dois exemplos fossem itens da mesma nota, a soma de seus impostos seria 54.00 + 30.00 = 84.00. Não acrescente bases ou valores unitários a essa soma e não misture impostoDevol/IPI/vIPIDevol com IPITrib/vIPI. MOC, p. 121 vIPI trata dessa diferença.
A regra obrigatória O01-10, retorno 742, trata da presença do pai IPI em NFC-e ou NF-e com DANFE Simplificado Tipo 2, tpImp=6. A extensão ao Tipo 2 consta do cronograma de produção de 03/08/2026. Alterar a modalidade de cálculo não elimina a presença do grupo. NT 2026.002, pp. 3 e 17
A RTC também exige contexto: B25-80 restringe tributos antigos em notas de crédito/débito ou tpOperGov=2, com exceção para crédito 03/04/06 e débito 07. A alteração que incluiu crédito 06 tem produção em 03/08/2026. A nova exceção de IPI em débito 06, pagamento antecipado, consta da versão 1.51 com produção prevista para 05/10/2026, ainda futura no corte de 27/09/2026. Essa exceção não deve ser presumida para qualquer nota e não significa extinção geral de IPI. NT 2025.002, pp. 5–6 e 33
As contas desta página conferem hipóteses fornecidas. A escolha dos parâmetros da operação, da modalidade e do tratamento fiscal deve continuar fundamentada pelo responsável fiscal.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/det/imposto/IPI/IPITrib- 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:complexType
- 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.