gIBSUF no total: IBS estadual, diferimento e devolução separados

gIBSUF em /nfeProc/NFe/infNFe/total/IBSCBSTot/gIBS/gIBSUF consolida valores do IBS de competência estadual. Ele não informa a sigla da UF e não é o grupo ICMSUFDest de partilha do ICMS.

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

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:

• Três valores em ordem fixa
• Exemplo do grupo com devolução inexistente
• Como conciliar o componente estadual
• Versão e cronograma: o que conferir no ambiente
• Cronologia específica da restrição de devolução
• Leituras relacionadas

Três valores em ordem fixa

O grupo é obrigatório dentro do total gIBS. Contém vDif, vDevTrib e vIBSUF, todos obrigatórios e TDec1302RTC. O grupo estadual do item possui alíquota e subgrupos de cálculo; o total apenas consolida grandezas correspondentes. Fonte: XSD PL 010f v1.04, TIBSCBSMonoTot/gIBS/gIBSUF; NT 2025.002 v1.52, p.29 W37–W41.

As origens no ramo comum são gIBSCBS/gIBSUF/gDif/vDif, gIBSCBS/gIBSUF/gDevTrib/vDevTrib quando admissível, e gIBSCBS/gIBSUF/vIBSUF. O componente municipal é separado em gIBSMun; CBS e monofasia não entram automaticamente neste grupo.

Exemplo do grupo com devolução inexistente

Suponha valores didáticos já apurados: diferimento estadual total de R$ 0,10, IBS estadual de R$ 0,90 e inexistência confirmada de devolução estadual. Grupo completo em si e parcial em relação à nota:

<gIBSUF xmlns="http://www.portalfiscal.inf.br/nfe">
  <vDif>0.10</vDif>
  <vDevTrib>0.00</vDevTrib>
  <vIBSUF>0.90</vIBSUF>
</gIBSUF>

UB24-10/1111, p.44 da NT 2025.002 v1.52, considera indevido o grupo gIBSUF/gDevTrib dos itens, para modelos 55 e 65. A existência de vDevTrib no total não autoriza criar essa devolução no item. O zero do exemplo reflete uma parcela efetivamente inexistente, e não uma escolha fiscal inferida pelo artigo.

Como conciliar o componente estadual

W38-10/1077 compara diferimento; W39-10/1078, devolução; W41-10/1080, IBS estadual, na NT 2025.002 v1.52, p.70. Cada comparação tem sua própria origem. Somar vDif, vDevTrib e vIBSUF entre si não produz um valor a preencher novamente em cada filho.

Para divergência, liste valores estaduais por item, mantendo separado o município. Confira primeiro a admissibilidade do grupo de origem quando houver devolução. Para erro estrutural, examine ordem, filhos obrigatórios e namespace. Uma diferença de cálculo não se resolve trocando ICMSUFDest por gIBSUF: são tributos e contextos distintos. Preserve o XML original e corrija somente a causa demonstrada.

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.

Cronologia específica da restrição de devolução

UB24-10, UB43-10 e UB62-10 foram incluídas na versão 1.40. O histórico da NT 2025.002 v1.52, p.5, prevê essa rodada até 1º/07/2026 em homologação e 3/08/2026 em produção. Nas pp. 44, 46 e 49, essas regras não estão marcadas como implementação futura. Portanto, em 14/10/2026 são restrições com cronograma documental anterior ao corte, e não regras adiadas pelo aviso relativo às mudanças da v1.52. Isso distingue a previsão oficial da comprovação operacional: a aplicação efetiva em uma autorizadora concreta deve ser confirmada pelo ambiente e retorno; não foi realizado teste de transmissão para esta explicação.

Leituras relacionadas

O total de devolução estadual não comprova permissão do grupo de origem. vDevTrib — /nfeProc/NFe/infNFe/total/IBSCBSTot/gIBS/gIBSUF/vDevTrib.