gIBS no total: separar IBS estadual, municipal e créditos da nota

gIBS em /nfeProc/NFe/infNFe/total/IBSCBSTot/gIBS consolida o IBS da nota. Ele separa a competência estadual e municipal e mantém valores de crédito em campos próprios. Não é o grupo gIBSCBS do item nem inclui automaticamente a CBS.

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

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:

• Dois grupos de competência e três valores
• Exemplo de organização das grandezas
• Qual conferência corresponde a cada valor
• Exemplo XML e hipóteses do fragmento
• Crédito suspensivo de IBS não segue o marco da CBS
• Versão e cronograma: o que conferir no ambiente
• Leituras relacionadas

Dois grupos de competência e três valores

gIBS é opcional em IBSCBSTot, mas, quando informado, exige gIBSUF, gIBSMun, vIBS, vCredPres e vCredPresCondSus, nessa ordem. Cada grupo de competência exige vDif, vDevTrib e seu imposto (vIBSUF ou vIBSMun). Fonte: XSD PL 010f v1.04, TIBSCBSMonoTot/gIBS; NT 2025.002 v1.52, p.29–30 W36–W49.

vIBS é o valor total do imposto; vCredPres é crédito presumido; vCredPresCondSus é crédito em condição suspensiva. Não são parcelas equivalentes. gMono possui seus próprios totais monofásicos e gEstornoCred possui estornos: copiá-los para gIBS mistura ramos distintos.

Exemplo de organização das grandezas

Considere uma hipótese didática de dois itens já calculados, sem créditos, devolução de IBS ou monofasia: IBS estadual de R$ 0,60 e R$ 0,30; municipal de R$ 0,40 e R$ 0,20; IBS comum de R$ 1,00 e R$ 0,50. A consolidação tem gIBSUF/vIBSUF=0,90, gIBSMun/vIBSMun=0,60 e vIBS=1,50. Os créditos apurados como inexistentes aparecem como zero, sem transformá-los em campos omitidos.

O exemplo não sugere proporção estadual/municipal ou alíquotas reais. Ele mostra por que a soma de vIBSUF não substitui vIBS e por que a CBS não entra nesse grupo.

Qual conferência corresponde a cada valor

W41-10/1080 compara IBS UF; W46-10/1084, IBS municipal; W47-10/1085, vIBS dos itens; W48-10/1086, crédito presumido de IBS. As regras constam nas p.70–71 da NT 2025.002 v1.52. Em W48-10, o texto da mensagem cita IBS UF, mas o campo e a regra tratam crédito presumido do IBS total; não crie um filho vCredPres dentro de gIBSUF.

Para investigar, liste os valores por item e por competência, preservando caminhos completos. Campos vDevTrib existem nos totais, mas os grupos de devolução de IBS dos itens estão vedados em UB24-10 e UB43-10 na edição conferida. A estrutura não comprova permissão fiscal. Corrija o cálculo ou mapeamento demonstradamente errado, sem escolher crédito ou alterar XML autorizado.

Exemplo XML e hipóteses do fragmento

A hipótese é a soma já demonstrada de IBS estadual R$0,90 e municipal R$0,60, com IBS dos itens somando R$1,50. Diferimento, devolução e créditos foram apurados como inexistentes. O grupo é completo em si e parcial à nota; não sugere proporção legal ou alíquota.

<gIBS xmlns="http://www.portalfiscal.inf.br/nfe">
  <gIBSUF>
    <vDif>0.00</vDif>
    <vDevTrib>0.00</vDevTrib>
    <vIBSUF>0.90</vIBSUF>
  </gIBSUF>
  <gIBSMun>
    <vDif>0.00</vDif>
    <vDevTrib>0.00</vDevTrib>
    <vIBSMun>0.60</vIBSMun>
  </gIBSMun>
  <vIBS>1.50</vIBS>
  <vCredPres>0.00</vCredPres>
  <vCredPresCondSus>0.00</vCredPresCondSus>
</gIBS>

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.

Crédito suspensivo de IBS não segue o marco da CBS

UB126-10/1056, p.66 da NT 2025.002 v1.52, restringe vCredPresCondSus de IBS no item: considera indevido quando o ano de emissão for anterior a 2033 ou o crédito presumido for diferente do código 4. A observação prevê informação somente a partir de 2033. O marco não é 2027, que pertence à regra da CBS. A presença obrigatória do filho no total gIBS permite representar uma soma conhecida igual a zero, sem criar crédito suspensivo no item em 2026. O grupo gCredPresOper também é vedado à NFC-e em UB120-10/1049; classificação e permissão precisam ser conferidas na operação real antes da totalizaçã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 componente municipal possui estrutura e regras próprias. gIBSMun — /nfeProc/NFe/infNFe/total/IBSCBSTot/gIBS/gIBSMun.

O componente estadual é consolidado separadamente. gIBSUF — /nfeProc/NFe/infNFe/total/IBSCBSTot/gIBS/gIBSUF.