vDif de IBS municipal no total: conciliar o diferimento dos itens

vDif em /nfeProc/NFe/infNFe/total/IBSCBSTot/gIBS/gIBSMun/vDif é o total monetário de diferimento do IBS municipal. Não é o percentual pDif nem o valor vIBSMun da componente municipal após o cálculo.

Identidade técnica: tag; XPath /nfeProc/NFe/infNFe/total/IBSCBSTot/gIBS/gIBSMun/vDif.

Para consultas XPath com prefixos, associe n a http://www.portalfiscal.inf.br/nfe em cada elemento. Em XML cuja raiz é NFe, retire o ancestral nfeProc da consulta; não remova namespaces do documento original.

Nesta página:

• Origem e formato de um valor totalizado
• Exemplo com diferimento já calculado e uma comparação útil
• Diagnóstico de 1081 e origem do cálculo
• Exemplo XML e hipóteses do fragmento
• Versão e cronograma: o que conferir no ambiente
• Leituras relacionadas

Origem e formato de um valor totalizado

A origem correspondente nos itens é det/imposto/IBSCBS/gIBSCBS/gIBSMun/gDif/vDif. W43-10, rejeição 1081, p.70 da NT 2025.002 v1.52, compara o total municipal de diferimento com a soma desses valores. No XSD PL 010f v1.04, o campo é obrigatório dentro de gIBSMun total e usa TDec1302RTC, sem sinal, até 13 inteiros e duas casas quando fracionário.

A classificação e o indicador de diferimento do item devem estar documentados antes da totalização. Não se cria diferimento no total para compensar um erro de alíquota ou de valor de IBS.

Exemplo com diferimento já calculado e uma comparação útil

Considere valores sintéticos de diferimento municipal já apurados em dois itens: R$ 0,03 e R$ 0,02. A soma é R$ 0,05, com recorte parcial <vDif>0.05</vDif> no gIBSMun total. O exemplo não escolhe alíquota, base ou percentual de diferimento para uma operação real.

Se um item tiver pDif=50, esse número indica percentual, e não R$ 50,00 a somar. Se a nota também tiver vDif estadual de R$ 0,10, ele continua em gIBSUF/vDif; a igualdade de nome não permite produzir R$ 0,15 no municipal. Da mesma forma, a parcela diferida já considerada no cálculo do item não deve ser descontada novamente de vIBSMun total.

Diagnóstico de 1081 e origem do cálculo

Compare os campos exatos dos itens com o total. Confira se o cálculo usou pIBSMun ou a alíquota efetiva quando há redução, e o percentual pDif confirmado. UB42-10, p.46 da NT 2025.002 v1.52, trata do cálculo do diferimento do item e distingue essa alíquota; não transfira a tolerância desse cálculo para qualquer somatório sem previsão.

Investigue troca de campos estaduais/municipais, percentual somado como dinheiro, duplicação e valores de rascunho diferentes do XML. Se a origem material estiver indefinida, reúna classificação, operação e documentos para confirmação. Corrija a causa comprovada no cálculo ou na serialização e preserve o documento autorizado.

Exemplo XML e hipóteses do fragmento

O valor sintético soma R$0,03 e R$0,02 de diferimento municipal já apurado. O campo é parcial a gIBSMun total e não inclui o diferimento estadual.

<vDif xmlns="http://www.portalfiscal.inf.br/nfe">0.05</vDif>

A validação desse fragmento é estrutural e limitada à declaração do seu caminho. Não equivale à validação da nota completa, à assinatura ou à autorização.

Versão e cronograma: o que conferir no ambiente

A estrutura descrita foi conferida no PL 010f v1.04. O snapshot da ficha pode oferecer PL 010e v1.02; uma afirmação sobre o pacote mais novo não deve ser atribuída automaticamente a todo arquivo histórico.

A NT 2025.002 v1.52 é a edição de setembro de 2026, publicada no catálogo em 1º/10/2026. O aviso ENCAT de 5/10/2026 adiou as alterações dessa rodada para 26/10/2026 em homologação e 16/11/2026 em produção. Essas datas não suspendem todas as regras anteriores nem tornam ativas as regras que continuam marcadas como implementação futura. Em 14/10/2026, os dois novos marcos ainda eram futuros.

Separe a existência de uma tag no schema, a condição fiscal da operação e a ativação da regra de negócio. A condição legal não se deduz da ausência de rejeição, e o cronograma não comprova implantação em cada autorizadora. Registre data, modelo, ambiente, pacote usado e retorno para interpretar uma divergência concreta.

Leituras relacionadas

O imposto municipal já calculado não recebe a dedução do diferimento novamente. vIBSMun — /nfeProc/NFe/infNFe/total/IBSCBSTot/gIBS/gIBSMun/vIBSMun.