gIBSUF no item: parcela estadual do IBS e seus campos
<gIBSUF>det › imposto › IBSCBS › gIBSCBS › gIBSUFRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
gIBSUF, dentro de gIBSCBS, organiza o IBS de competência estadual do item. O grupo separa alíquota, modificadores e valor da UF; não é ICMS, DIFAL ou a soma completa do IBS.
- Onde localizar esta ocorrência
- Qual é a sequência de informações do ramo
- Como conferir a alíquota por data e condição
- Como valor, redução e diferimento se relacionam
- Como separar as causas de uma rejeição estadual
Onde localizar esta ocorrência
XPath completo: /nfeProc/NFe/infNFe/det/imposto/IBSCBS/gIBSCBS/gIBSUF. 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.
Qual é a sequência de informações do ramo
No tipo TCIBS_NFe, gIBSUF ocorre uma vez quando o ramo gIBSCBS é utilizado. A sequência é pIBSUF, gDif se aplicável, gDevTrib se admitido pelas RV, gRed se aplicável e vIBSUF. A alíquota e o valor estadual são obrigatórios dentro desse grupo.
O grupo municipal é separado em gIBSMun, e a CBS em gCBS. O vIBS do item tem regra própria de soma das parcelas estadual e municipal, com dedução de crédito presumido quando o indicador correspondente determinar. Não agregue a CBS em vIBSUF ou confunda seu valor com o total do IBS.
Fontes: NT 2025.002 v1.52 — p. 19 UB17–UB35; pp. 43–45 UB18-10, UB22/23/24/26/28/35; p. 47 UB54a-10, tipos RTC — PL_010f_v1.04.
Como conferir a alíquota por data e condição
UB18-10 prevê 0,10% para documentos de 2025/2026, 0,05% para 2027/2028 e alíquota de referência ou específica a publicar para períodos posteriores, nas condições documentadas. A divergência é associada a 1026, nos modelos 55/65.
Há exceção de zero quando a classificação possui indicador de tributação regular e de não aplicação para devolução de mercadoria (finNFe=4) ou notas de crédito 03, 04 ou 06. A data e essas condições precisam ser lidas na nota real; a regra não seleciona enquadramento ou finalidade para o leitor.
Fontes: NT 2025.002 v1.52 — p. 19 UB17–UB35; pp. 43–45 UB18-10, UB22/23/24/26/28/35; p. 47 UB54a-10, tipos RTC — PL_010f_v1.04.
Como valor, redução e diferimento se relacionam
UB35-10 calcula vIBSUF = vBC × (pIBSUF/100) − vDif − vDevTrib, substituindo a alíquota por gIBSUF/gRed/pAliqEfet quando houver redução. A divergência corresponde a 1041, com tolerância de R$ 0,01 para mais ou menos. Diferimento e redução dependem de indicadores de CST e das condições próprias.
O schema contém devolução, mas UB24-10 rejeita gIBSUF/gDevTrib com 1111 nos modelos 55/65. A parcela aparecer em uma fórmula não libera seu grupo. Fragmento parcial sintético, supondo base de R$ 1.000,00, alíquota de 0,10% confirmada e ausência de modificadores:
<gIBSUF xmlns="http://www.portalfiscal.inf.br/nfe">
<pIBSUF>0.1000</pIBSUF>
<vIBSUF>1.00</vIBSUF>
</gIBSUF>
O trecho não representa nota completa nem prescreve alíquota para uma operação particular.
Fontes: NT 2025.002 v1.52 — p. 19 UB17–UB35; pp. 43–45 UB18-10, UB22/23/24/26/28/35; p. 47 UB54a-10, tipos RTC — PL_010f_v1.04.
Como separar as causas de uma rejeição estadual
Confira primeiro o item e a mensagem real: 1026 aponta alíquota; 1029/1030, presença do diferimento; 1031, conta do diferimento; 1041, valor estadual. Compare a memória de cálculo aos campos efetivamente serializados, preservando o ramo e a precisão dos percentuais.
Não use alíquota municipal ou de ICMS para preencher o IBS estadual. Se faltar fundamento para base, enquadramento ou modificadores, reúna operação, produto, partes, período e classificação com o responsável fiscal. A correção técnica deve representar a definição confirmada, sem editar XML assinado ou forçar valores para obter aceitação.
Fontes: NT 2025.002 v1.52 — p. 19 UB17–UB35; pp. 43–45 UB18-10, UB22/23/24/26/28/35; p. 47 UB54a-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/gIBSUF- 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.