vIPIDevol total: IPI devolvido, caminho UA04 e rejeição 863
<vIPIDevol>total › ICMSTot › vIPIDevolRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
ICMSTot/vIPIDevol totaliza o IPI devolvido informado nos itens em det/impostoDevol/IPI/vIPIDevol. É uma parcela distinta do IPI de IPITrib e não deve ser preenchida copiando o total vIPI.
Qual contexto o MOC documenta
XPath completo: /nfeProc/NFe/infNFe/total/ICMSTot/vIPIDevol. 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.
W12a descreve o campo para o preenchimento do grupo Tributos Devolvidos em nota com finNFe=4, em operações com não contribuintes do IPI. A finalidade da nota e a situação fiscal não devem ser escolhidas apenas para acomodar um valor. Reúna o documento original, os itens devolvidos e seus valores com o responsável contábil antes de representar o caso. Fonte: MOC 7 Anexo I — leiaute e regras de validação, p.58.
De onde vem a soma e o que não entra nela
A regra W12a-10 usa os valores UA04 dos itens, impostoDevol/IPI/vIPIDevol. O percentual de devolução pDevol é informação de item e não deve ser somado ou escrito no total monetário. O total também não recebe IPITrib/vIPI, base de IPI ou valor completo dos produtos devolvidos.
Exemplo sintético, após a determinação dos valores devolvidos por item: R$ 7,25 no primeiro e R$ 2,75 no segundo produzem R$ 10,00 em W12a. Não há neste exemplo recomendação de percentual de devolução ou de tratamento do IPI. Fonte: MOC 7 Anexo I — leiaute e regras de validação, W12a-10/UA04.
Leitura do campo total
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, sem os demais campos obrigatórios:
<vIPIDevol xmlns="http://www.portalfiscal.inf.br/nfe">10.00</vIPIDevol>
A sequência completa coloca vIPIDevol após vIPI e antes de vPIS. No XSD o campo existe obrigatoriamente em ICMSTot; a condição fiscal descrita no MOC explica a origem de um valor de IPI devolvido, sem transformar ausência de apuração em zero. Fonte: Schemas XML NF-e/NFC-e PL 010f.
Como separar a rejeição 863 de outras divergências
A regra W12a-10 compara o total com os valores UA04 de IPI devolvido dos itens; a divergência corresponde à rejeição 863, 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. A regra do MOC é facultativa para modelo 55. A rejeição 538 refere-se ao IPI O14; a 610 trata da composição de vNF. São diagnósticos diferentes. 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 devolvido também altera vNF?
W16-10 inclui vIPIDevol entre as parcelas do valor total, com condições e exceções próprias. Isso não permite duplicá-lo como vIPI ou escondê-lo em despesas acessórias. A NT 2023.004 v1.20, pp.15–16, preserva uma composição específica para faturamento direto de veículos e exceções de importação/desoneração. Ao investigar vNF, identifique primeiro qual ramo da regra se aplica; a soma correta de W12a continua sendo a soma de UA04. Fontes: MOC 7 Anexo I — leiaute e regras de validação; NT 2023.004 — Informações de Pagamentos e Outros.
A leitura do IPI de IPITrib totalizado em vIPI complementa a distinção entre imposto do item e IPI devolvido.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/total/ICMSTot/vIPIDevol- 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