NCM Buscador
CAMPO DO XML · NF-E Grupo 2 posições 5 regras

gIBSUF

Totalização do IBS de competência da UF

✓ Conferido · 02 de outubro de 2026Esquema XML da NF-e (leiaute) — enums oficiais de campo — Pacote de Liberação PL_010f_v1.04, publicado em 31/08/2026 (NT 2025.002 v1.50 e NT 2026.007 v1.00) · Receita Federal / ENCAT

Onde fica no arquivo

No documento

  • NFe/infNFe/total/IBSCBSTot/gIBS/gIBSUF

    Obrigatório, uma vez

  • NFe/infNFe/det/imposto/IBSCBS/gIBSCBS/gIBSUF

    Obrigatório, uma vez

    Grupo de informações do IBS na UF

O caminho até aqui, nível a nível

  1. NFe — Nota Fiscal Eletrônica
  2. └ infNFe — Informações da Nota Fiscal eletrônica
  3. └ total — Dados dos totais da NF-e
  4. └ IBSCBSTot — Valores totais da NF com IBS / CBS
  5. └ gIBS — Totalização do IBS
  6. └ gIBSUF — você está aqui

Dentro do grupo gIBS , totalização do IBS

O que o arquivo aceita neste campo

Ocorrência
1-1
Tamanho
—
Tipo no esquema
grupo
Formato base
grupo

As regras que verificam este campo — 5

O manual cita a tag pelo caminho no XML. Cada regra devolve um código de rejeição, e a ficha do código traz a mensagem que o autorizador exibe.

1029 gIBSUF

Se CST possui indicador que não permite o uso de diferimento (ind_gDif = 0): - Grupo de Diferimento informado (grupo: gIBSUF/gDif) Observação : Consultar Tabela de Indicadores de CST do IBS e CBS

Mensagem: CST do IBS/CBS informado não permite informação de diferimento Estadual

1030 gIBSUF

Se informado grupo gIBSCBS (id: UB15, grupo: imposto/IBSCBS/gIBSCBS): - Se CST possui indicador que exige o uso de diferimento (ind_gDif = 1): -Grupo de Diferimento não informado (grupo: gIBSUF/gDif) Observação : Consultar Tabela de Indicadores de CST do IBS e CBS

Mensagem: CST do IBS/CBS informado obriga informação de diferimento Estadual

1032 gIBSUF

Se CST possui indicador que não permite o uso de redução de alíquota (ind_gRed = 0): - Grupo de Redução de Alíquota informado (grupo: gIBSUF/gRed) Exceção : Se Percentual de redução da alíquota em compra governamental (tag:gCompraGov/pRedutor) informado e gIBSUF/gRed/pRedAliq igual a zero. Observação : Consultar Tabela de Indicadores de CST do IBS e CBS

Mensagem: CST do IBS/CBS informado não permite informação de redução de alíquota estadual

1033 gIBSUF

Se informado grupo gIBSCBS (id: UB15, grupo: imposto/IBSCBS/gIBSCBS): - Se CST possui indicador que exige o uso de redução de alíquota (ind_gRed = 1), ou foi informado o grupo de compras governamentais informado (tag:gCompraGov) - Grupo de Redução de Alíquota Estadual não informado (grupo: gIBSUF/gRed) Observação : Consultar Tabela de Indicadores de CST do IBS e CBS.

Mensagem: Não informado o grupo de redução de alíquota Estadual

1142 gIBSUF

Se grupo gTribCompraGov informado: - Soma dos valores de IBS e CBS do grupo gTribCompraGov (vTribIBSUF + vTribIBSMun + vTribCBS) difere do resultado de tag:gIBSUF/vIBSUF + tag:gIBSMun/vIBSMun + tag:gCBS/vCBS. Observação: Aceitar uma tolerância de 0,04 a mais ou a menos

Mensagem: Soma dos valores de IBS e CBS em compras governamentais divergente

O mesmo nome em outros documentos fiscais — 7

gIBSUF aparece no leiaute de outros documentos, e isso não quer dizer que seja o mesmo campo: cada um tem manual, regra e às vezes tipo próprios. Aplicar a regra de um documento no outro é o erro que esta lista existe para evitar. Cada linha traz o caminho no arquivo daquele documento, que é onde a diferença aparece primeiro.

Documento O que o leiaute dele diz Caminho lá
BP-e Grupo de informações do IBS na UF BPeTA/infBPe/imp/IBSCBS/gIBSCBS/gIBSUF
CT-e Grupo de informações do IBS na UF CTeSimp/infCte/imp/IBSCBS/gIBSCBS/gIBSUF
CT-e OS Grupo de informações do IBS na UF CTeOS/infCte/imp/IBSCBS/gIBSCBS/gIBSUF
NF3e Grupo de informações do IBS na UF NF3e/infNF3e/NFdet/det/detItem/imposto/IBSCBS/gIBSCBS/gIBSUF
NFAg Grupo de informações do IBS na UF NFAg/infNFAg/det/imposto/IBSCBS/gIBSCBS/gIBSUF
NFCom Grupo de informações do IBS na UF NFCom/infNFCom/det/imposto/IBSCBS/gIBSCBS/gIBSUF
NFGas Grupo de informações do IBS na UF NFGas/infNFGas/det/gNormal/imposto/IBSCBS/gIBSCBS/gIBSUF

Os campos dos doze documentos fiscais, com filtro →

O que vai dentro deste grupo — 7

gIBSUF é um grupo: ele não carrega valor próprio, agrupa os campos abaixo. A obrigatoriedade de cada um vale dentro do grupo — campo obrigatório num grupo opcional só é exigido quando o grupo é informado.

Campo O que é Ocorrência
gDevTrib Grupo de Informações da devolução de tributos Opcional, no máximo uma vez
gDif Grupo de campos do Diferimento Opcional, no máximo uma vez
gRed Grupo de campos da redução de aliquota Opcional, no máximo uma vez
pIBSUF Aliquota do IBS de competência das UF (em percentual) Obrigatório, uma vez
vDevTrib Total de devoluções de tributos Obrigatório, uma vez
vDif Total do Diferimento Obrigatório, uma vez
vIBSUF Valor total do IBS Estadual Obrigatório, uma vez

Campos do mesmo grupo — 4

São os campos que ficam ao lado deste no arquivo, dentro de NFe/infNFe/total/IBSCBSTot/gIBS. Quem preenche um costuma precisar dos outros na mesma passada.

Perguntas frequentes

O que é o campo gIBSUF do NF-e?

Totalização do IBS de competência da UF No XML ele fica em NFe/infNFe/total/IBSCBSTot/gIBS/gIBSUF. É um grupo: não carrega valor próprio, agrupa outros campos. Obrigatório, uma vez.

O que vai dentro do grupo gIBSUF do NF-e?

7 campos: gDevTrib, gDif, gRed, pIBSUF, vDevTrib, vDif, vIBSUF. Grupo não carrega valor próprio — ele existe para agrupar esses campos, e a obrigatoriedade de cada um vale dentro dele.

gIBSUF aparece em quantos lugares do NF-e?

Em 2 posições do esquema oficial: NFe/infNFe/total/IBSCBSTot/gIBS/gIBSUF, NFe/infNFe/det/imposto/IBSCBS/gIBSCBS/gIBSUF. A mesma tag em posições diferentes tem ocorrência própria em cada lugar — o que vale no grupo do emitente não vale automaticamente no do destinatário.

Que rejeição gIBSUF pode causar no NF-e?

5 regras do manual citam este campo, disparando os códigos 1029, 1030, 1032, 1033, 1142. ⚠ O número da rejeição não é único entre documentos fiscais: o mesmo código costuma existir na NF-e querendo dizer outra coisa.

gIBSUF no NF-e é o mesmo campo dos outros documentos fiscais?

O nome se repete no leiaute de 7 outros documentos (BP-e, CT-e, CT-e OS, NF3e, NFAg, NFCom, NFGas), e isso não quer dizer que seja o mesmo campo: cada documento tem manual próprio, regra própria e às vezes tipo diferente. Aplicar a regra de um no outro é erro comum e caro.

De onde vem esta descrição do NF-e?

Do esquema XML oficial (PL_010f_v1.04). O Buscador NCM lê a árvore do próprio arquivo: tipo, tamanho, ocorrência e domínio saem sem interpretação. O manual manda na REGRA de validação; o esquema manda no CAMPO.

Voltar ao topo