pDif do IBS municipal: percentual e efeito da alíquota zero
<pDif>det › imposto › IBSCBS › gIBSCBS › gIBSMun › gDif › pDifRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
pDif em gIBSMun/gDif é o percentual do diferimento da parcela municipal. Ele age sobre o IBS municipal calculado pela fórmula, não sobre o IBS estadual, a CBS ou diretamente sobre o preço do produto.
- Onde localizar esta ocorrência
- O que significa diferir uma parcela municipal zero
- Como distinguir pDif de outros percentuais
- Obrigatoriedade e fragmento do campo
- Como verificar a origem do percentual
Onde localizar esta ocorrência
XPath completo: /nfeProc/NFe/infNFe/det/imposto/IBSCBS/gIBSCBS/gIBSMun/gDif/pDif. 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.
O que significa diferir uma parcela municipal zero
A conta de UB42-10 é vBC × (pIBSMun/100) × (pDif/100), usando a efetiva do ramo se existir gRed. Com alíquota municipal conhecida como zero, qualquer percentual hipotético dessa demonstração mantém o resultado monetário em zero. Isso não torna os percentuais equivalentes como dados fiscais: o parâmetro ainda precisa representar o tratamento confirmado.
UB37-10 prevê zero para 2025/2026 nas condições da regra. Não substitua a alíquota municipal pela estadual para obter um diferimento positivo. Também não conclua que um percentual zero deve substituir o percentual confirmado só porque vDif será zero.
Fontes: NT 2025.002 v1.52 — p. 19 UB41/UB42; p. 45 UB37-10; p. 46 UB40-10/20 e UB42-10, tipos RTC — PL_010f_v1.04.
Como distinguir pDif de outros percentuais
pIBSMun é a alíquota do IBS municipal; pDif é a fração percentual diferida do tributo; gRed/pRedAliq reduz a alíquota. A redução, quando aplicável, entra antes da conta do diferimento por meio de pAliqEfet. Cada campo responde a uma pergunta diferente.
Em um exercício para período/operação com alíquota confirmada de 0,05%, base de R$ 2.000,00 e diferimento hipotético de 40%, o tributo inicial é R$ 1,00 e a parcela diferida R$ 0,40. 40.0000 representa 40%; 0.4000 representa 0,40%. Esses parâmetros não prescrevem aplicação em uma emissão de 2026.
Fontes: NT 2025.002 v1.52 — p. 19 UB41/UB42; p. 45 UB37-10; p. 46 UB40-10/20 e UB42-10, tipos RTC — PL_010f_v1.04.
Obrigatoriedade e fragmento do campo
pDif e vDif são obrigatórios dentro de gDif. O grupo depende de ind_gDif: UB40-10/1044 trata da falta quando exigido e UB40-20/1083 da presença vedada, para 55/65.
Fragmento parcial sintético do grupo municipal com alíquota zero conhecida fora do trecho:
<gDif xmlns="http://www.portalfiscal.inf.br/nfe">
<pDif>40.0000</pDif>
<vDif>0.00</vDif>
</gDif>
O tipo percentual admite até três dígitos inteiros e de duas a quatro casas quando houver decimal, com ponto e sem %. O fragmento não define enquadramento nem equivale a nota completa.
Fontes: NT 2025.002 v1.52 — p. 19 UB41/UB42; p. 45 UB37-10; p. 46 UB40-10/20 e UB42-10, tipos RTC — PL_010f_v1.04.
Como verificar a origem do percentual
Compare o percentual do XML à definição fiscal documentada para a operação, ao cadastro/regra do emissor e ao ramo municipal usado no cálculo. Uma rotina que compartilha pDif entre tributos ainda precisa preservar cada caminho e seus valores próprios.
Se UB42-10/1045 apontar divergência, confira também alíquota efetiva, base e arredondamento do resultado monetário; há tolerância de R$ 0,01 nessa comparação. Se o fundamento do percentual estiver ausente, reúna data, classificação e documentos da operação com o responsável fiscal. Não ajuste o percentual apenas para coincidir com um valor em reais.
Fontes: NT 2025.002 v1.52 — p. 19 UB41/UB42; p. 45 UB37-10; p. 46 UB40-10/20 e UB42-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/pDif- 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_0302_04RTC · 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,4}|[1-9]{1}[0-9]{0,2}(\.[0-9]{2,4})?- whiteSpace
preserve