Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Totais

vIPI em ICMSTot: soma do IPI dos itens e rejeição 538

<vIPI>total › ICMSTot › vIPI

Revisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.

ICMSTot/vIPI é o total do Imposto sobre Produtos Industrializados informado como IPI nos itens. Ele consolida det/imposto/IPI/IPITrib/vIPI. Não representa o total de IPI devolvido do grupo impostoDevol, que possui campo próprio.

Qual valor de item entra no total

XPath completo: /nfeProc/NFe/infNFe/total/ICMSTot/vIPI. Se o arquivo contém apenas a raiz NFe, retire /nfeProc do início. Em consultas XPath, associe um prefixo, por exemplo n, ao namespace http://www.portalfiscal.inf.br/nfe e use esse prefixo em cada elemento. Buscar apenas pelo nome da última tag pode misturar item e total ou grupos tributários diferentes.

O grupo IPI pode ter alternativas tributadas e não tributadas. A soma documentada em W12-10 utiliza O14, IPITrib/vIPI, onde houver esse valor. Não some bases vBC nem alíquotas pIPI; também não transforme ausência de IPITrib em uma linha tributada artificial. Fonte: MOC 7 Anexo I — leiaute e regras de validação, grupo O e p.121.

Como calcular o total sem recalcular a tributação

A conferência do total parte dos impostos dos itens, já calculados com os parâmetros corretos. Não aplique uma única alíquota ao valor de todos os produtos: os itens podem ter cálculos e situações diferentes.

Hipótese sintética: item 1 com IPI de R$ 12,00, item 2 com R$ 8,35 e item 3 sem valor O14. A soma dos valores de IPI informados é R$ 20,35. O exemplo não define CST, incidência ou alíquota para nenhuma mercadoria. A integração deve conservar a precisão dos cálculos de origem e comparar os valores finais serializados. Fonte: MOC 7 Anexo I — leiaute e regras de validação, W12-10.

vIPI e vIPIDevol podem ser trocados?

Não. vIPI recebe O14 de det/imposto/IPI/IPITrib; vIPIDevol recebe UA04 de det/impostoDevol/IPI/vIPIDevol. Este segundo caminho é relacionado pelo MOC à devolução, finNFe=4, em operações com não contribuintes do IPI. Um total igual não torna os caminhos equivalentes. Antes de mapear uma devolução, confirme finalidade, situação do emitente e documentação original; a escolha não é determinada por uma rejeição de soma. Fonte: MOC 7 Anexo I — leiaute e regras de validação, pp.58 e 121.

Formato e posição no grupo

No PL 010f v1.04, o tipo TDec_1302 usa ponto como separador, sem R$, vírgula, espaço, sinal ou separador de milhar. Para valores com parte decimal, use duas casas, como 12.50. O padrão aceita 0.00. Zero só representa um total conhecido igual a zero; não é substituto de valor ainda não apurado. Fonte: Tipos básicos NF-e/NFC-e.

Fragmento parcial de ICMSTot para a hipótese calculada:

<vIPI xmlns="http://www.portalfiscal.inf.br/nfe">20.35</vIPI>

vIPI é obrigatório no grupo, depois de vII e antes de vIPIDevol. Se o total conhecido for zero, 0.00 pertence ao tipo, mas isso não confirma que a operação seja não tributada. Fonte: Schemas XML NF-e/NFC-e PL 010f.

Como investigar a rejeição 538

A regra W12-10 compara o total com os valores O14 de IPI dos itens; a divergência corresponde à rejeição 538, nas condições documentadas. Leia o código e a mensagem do retorno real antes de atribuir a causa. Liste os itens participantes, preserve os valores efetivamente serializados e some-os com aritmética decimal. Compare esse resultado com a tag de total, procurando item omitido, soma duplicada, ancestral errado ou alteração posterior ao cálculo.

Corrija a origem comprovada do erro no cálculo ou no mapeamento; depois gere uma nova prévia e valide novamente o campo, os itens e o XSD aplicável. Não edite XML já assinado ou autorizado para acertar a soma. O MOC indica modelo 55 e aplicação facultativa. Para um retorno de IPI devolvido, investigue W12a-10/863, que é outra comparação. A aceitação pelo XSD demonstra estrutura, não autorização nem tratamento fiscal correto. Fonte: MOC 7 Anexo I — leiaute e regras de validação.

O total de IPI devolvido aprofunda o caminho UA04 e sua condição de devolução.

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/total/ICMSTot/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
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]{2}|[1-9]{1}[0-9]{0,12}(\.[0-9]{2})?
whiteSpace
preserve