gIBSMun no item: IBS municipal, campos e alíquota zero
<gIBSMun>det › imposto › IBSCBS › gIBSCBS › gIBSMunRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
gIBSMun, dentro de gIBSCBS, organiza o IBS de competência municipal do item. Não é o ISSQN e não identifica o município por si só. O grupo contém a alíquota, eventuais modificadores admitidos e o valor municipal calculado.
- Onde localizar esta ocorrência
- Quais campos pertencem ao ramo municipal
- Por que pode haver grupo com alíquota e valor zero
- Como conferir modificadores e valor
- Como investigar inconsistências sem trocar os tributos
Onde localizar esta ocorrência
XPath completo: /nfeProc/NFe/infNFe/det/imposto/IBSCBS/gIBSCBS/gIBSMun. 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.
Quais campos pertencem ao ramo municipal
A sequência é pIBSMun, gDif quando aplicável, gDevTrib quando admitido pelas regras, gRed quando aplicável e vIBSMun. No tipo TCIBS_NFe, gIBSMun ocorre uma vez quando esse ramo de tributação gIBSCBS é usado; pIBSMun e vIBSMun são obrigatórios dentro dele.
gIBSUF registra outra parcela do IBS, e gCBS registra a contribuição federal. O vIBS do item agrega estadual e municipal, com a dedução de crédito presumido quando o indicador correspondente determinar. Portanto vIBSMun não é sinônimo de vIBS nem de total da nota.
Fontes: NT 2025.002 v1.52 — pp. 19–20 UB36–UB54a; pp. 45–47 UB37-10, UB40/42/43/45/47/54, tipos RTC — PL_010f_v1.04.
Por que pode haver grupo com alíquota e valor zero
UB37-10 prevê pIBSMun=0% para documentos emitidos em 2025/2026 e 0,05% em 2027/2028, nas condições da regra; depois disso remete à alíquota publicada. Também descreve zero quando a classificação exige tributação regular e não aplicação nas devoluções finNFe=4 e notas de crédito 03, 04 ou 06.
Se a operação confirmada usa o ramo e o resultado municipal é conhecido como zero, os campos não desaparecem só porque o valor é zero. Isso difere de um dado ainda desconhecido. Fragmento parcial sintético, sem modificadores, para leitura de um ramo municipal com zero conhecido:
<gIBSMun xmlns="http://www.portalfiscal.inf.br/nfe">
<pIBSMun>0.0000</pIBSMun>
<vIBSMun>0.00</vIBSMun>
</gIBSMun>
O trecho não define o enquadramento de uma operação nem representa a nota completa.
Fontes: NT 2025.002 v1.52 — pp. 19–20 UB36–UB54a; pp. 45–47 UB37-10, UB40/42/43/45/47/54, tipos RTC — PL_010f_v1.04.
Como conferir modificadores e valor
O diferimento depende de ind_gDif e usa o percentual municipal ou a efetiva quando houver redução. gRed contém pRedAliq e pAliqEfet, com condições de CST e compra governamental. A presença estrutural de gDevTrib merece atenção: UB43-10 rejeita esse grupo municipal nos modelos 55/65 com 1112, apesar de existir no XSD.
UB54-10 calcula vIBSMun = vBC × (pIBSMun/100) − vDif − vDevTrib, substituindo a alíquota pela efetiva se houver gRed, e associa divergência a 1052, com tolerância de R$ 0,01. A fórmula não libera o grupo de devolução vedado.
Fontes: NT 2025.002 v1.52 — pp. 19–20 UB36–UB54a; pp. 45–47 UB37-10, UB40/42/43/45/47/54, tipos RTC — PL_010f_v1.04.
Como investigar inconsistências sem trocar os tributos
Confirme o item, a data, finalidade/tipo de crédito e classificação; depois compare os campos municipais serializados com a memória de cálculo. 1036 trata da alíquota; 1044/1083 da presença de diferimento; 1052 do valor calculado. Cada código aponta uma conferência diferente.
Não use alíquota de ISSQN ou IBS estadual para completar pIBSMun. Se o parâmetro fiscal não estiver determinado, reúna operação, partes, período e classificação para confirmação com o responsável fiscal. A correção técnica deve preservar a distinção entre as competências.
Fontes: NT 2025.002 v1.52 — pp. 19–20 UB36–UB54a; pp. 45–47 UB37-10, UB40/42/43/45/47/54, 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- 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
- inline:complexType
- 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.