Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · IPI, II e ISSQN

IPITrib na NF-e: conferir cálculo percentual e por quantidade

<IPITrib>det › imposto › IPI › IPITrib

Revisã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.