vDif do IBS municipal: cálculo próprio e rejeição 1045
<vDif>det › imposto › IBSCBS › gIBSCBS › gIBSMun › gDif › vDifRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
vDif em gIBSMun/gDif é o valor monetário do diferimento do IBS municipal do item. Ele precisa ser calculado com a alíquota municipal ou sua efetiva, mesmo quando a parcela estadual e a CBS tenham diferimentos positivos.
- Onde localizar esta ocorrência
- Como refazer a conta do ramo municipal
- O efeito de uma redução antes do diferimento
- Como reconhecer vDif e sua precisão
- Como separar a conta da presença do grupo
Onde localizar esta ocorrência
XPath completo: /nfeProc/NFe/infNFe/det/imposto/IBSCBS/gIBSCBS/gIBSMun/gDif/vDif. A informação pertence ao item det, dentro de imposto/IBSCBS/gIBSCBS. Em um XML cuja raiz é NFe, o caminho começa em /NFe, sem o invólucro nfeProc. Para consultas XPath, associe um prefixo ao namespace http://www.portalfiscal.inf.br/nfe. Preserve todos os ancestrais e o item; o nome isolado não distingue tributo, total ou grupo de referência.
Fontes: Tipos RTC — PL_010f_v1.04.
Como refazer a conta do ramo municipal
UB42-10 calcula vDif = vBC × (pIBSMun/100) × (pDif/100). Havendo gIBSMun/gRed, a alíquota efetiva desse grupo substitui a nominal. A regra aceita diferença de R$ 0,01 para mais ou menos e relaciona divergência à rejeição 1045 nos modelos 55/65.
Se a alíquota municipal confirmada é zero, base hipotética de R$ 1.000,00 e diferimento hipotético de 40% resultam em R$ 0,00. Não se deve copiar, por exemplo, um valor diferido da UF para evitar esse resultado. Zero calculado e informação ausente são situações diferentes.
Fontes: NT 2025.002 v1.52 — p. 19 UB42; p. 46 UB40-10/20 e UB42-10; p. 47 UB54-10, tipos RTC — PL_010f_v1.04.
O efeito de uma redução antes do diferimento
Exercício para período/operação em que alíquota de 0,05% esteja confirmada: com base de R$ 2.000,00, redução hipotética de 40% e diferimento hipotético de 50%, a efetiva é 0,0300%, o tributo inicial R$ 0,60 e vDif R$ 0,30. Sem devolução, o valor municipal efetivo seria R$ 0,30 pela fórmula UB54-10.
Os percentuais apenas demonstram o encadeamento; 0,05% não é indicação para emissão ordinária em 2026. A conta não define a base material nem o direito a diferimento ou redução.
Fontes: NT 2025.002 v1.52 — p. 19 UB42; p. 46 UB40-10/20 e UB42-10; p. 47 UB54-10, tipos RTC — PL_010f_v1.04.
Como reconhecer vDif e sua precisão
Fragmento parcial sintético, relativo ao cenário de alíquota municipal zero conhecida:
<gDif xmlns="http://www.portalfiscal.inf.br/nfe">
<pDif>40.0000</pDif>
<vDif>0.00</vDif>
</gDif>
vDif é obrigatório dentro do grupo e vem depois de pDif. O tipo monetário TDec1302RTC admite até 13 dígitos inteiros e duas casas se houver decimal; use ponto e sem símbolo monetário ou sinal negativo. O trecho não é um documento completo nem comprova a condição tributária.
Fontes: NT 2025.002 v1.52 — p. 19 UB42; p. 46 UB40-10/20 e UB42-10; p. 47 UB54-10, tipos RTC — PL_010f_v1.04.
Como separar a conta da presença do grupo
A rejeição 1045 trata do resultado; 1044 trata da falta de grupo exigido pelo indicador do CST e 1083 da presença de grupo vedado. Um resultado zero não dispensa o grupo automaticamente se ele for exigido por ind_gDif.
Leia o item do retorno, compare números serializados e memória de cálculo e procure uso de alíquota de outro ramo, efetiva ignorada ou arredondamento prematuro. Quando a origem dos parâmetros não estiver comprovada, reúna operação, data e classificação com o responsável fiscal. Corrija a causa no emissor sem editar XML assinado ou ajustar o valor para obter aceitação.
Fontes: NT 2025.002 v1.52 — p. 19 UB42; p. 46 UB40-10/20 e UB42-10; p. 47 UB54-10, tipos RTC — PL_010f_v1.04.
Leitura relacionada
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/det/imposto/IBSCBS/gIBSCBS/gIBSMun/gDif/vDif- 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
- TDec1302RTC · string
- 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.
- pattern
0|0\.[0-9]{2}|[1-9]{1}[0-9]{0,12}(\.[0-9]{2})?- whiteSpace
preserve