Grupo UB na NF-e — O que É e Como Preencher em 2026
Por [NOME_AUTOR · CRC-XX 000000/O-0]
A Nota Técnica 2025.002-RTC (NT 2025.002) introduziu um novo bloco no XML da Nota Fiscal Eletrônica (NF-e): o Grupo UB. Este é o coração técnico da Reforma Tributária nos documentos fiscais — é onde ficam os campos do Imposto sobre Bens e Serviços (IBS), da Contribuição sobre Bens e Serviços (CBS) e do Imposto Seletivo (IS).
Para contadores, desenvolvedores de sistemas e responsáveis pela emissão de NF-e, entender a estrutura do Grupo UB é essencial. Sem o preenchimento correto desse grupo, as notas fiscais serão rejeitadas pela SEFAZ a partir de 2026. Este guia explica o que é o Grupo UB, quais são seus campos, o que é obrigatório agora e o que muda em 2027.
O que é o Grupo UB e por que foi criado?
O Grupo UB (cujo identificador técnico no XML é o prefixo UB) é um novo grupo de campos adicionado ao schema da NF-e pela NT 2025.002-RTC, publicada no Portal Nacional da NF-e. O nome "UB" vem da identificação de grupo na Nota Técnica — ele é o grupo destinado exclusivamente às informações tributárias do IBS, CBS e Imposto Seletivo.
Antes da Reforma Tributária, a NF-e já continha grupos para os tributos existentes: grupo ICMS, grupo IPI, grupo PIS, grupo COFINS e grupo ISSQN. Com a criação do IBS e da CBS pela LC 214/2025 como substitutos do ICMS, ISS, PIS e COFINS, tornou-se necessário adicionar um novo grupo ao XML para acomodar esses novos tributos.
O Grupo UB foi projetado para coexistir com os grupos de tributos existentes durante todo o período de transição da Reforma Tributária (2026–2032). Isso significa que, por vários anos, uma mesma NF-e terá simultaneamente o grupo ICMS (com CST do ICMS, base de cálculo e alíquota do ICMS) e o Grupo UB (com cClassTrib, base de cálculo e alíquota do IBS/CBS).
Estrutura XML do Grupo UB
O Grupo UB aparece dentro da tag <imposto> de cada item (<det>) da NF-e. Sua estrutura principal se divide em dois subgrupos:
<IBS_CBS>: campos do IBS e da CBS<ImpSeletivo>: campos do Imposto Seletivo (apenas para produtos afetados)
Veja um exemplo da estrutura XML completa:
<det nItem="1">
<prod>...</prod>
<imposto>
<!-- Grupos existentes -->
<ICMS>...</ICMS>
<PIS>...</PIS>
<COFINS>...</COFINS>
<!-- NOVO: Grupo UB -->
<IBS_CBS>
<CSTIBS>110</CSTIBS>
<cClassTrib>110000</cClassTrib>
<pRedIBS>0.00</pRedIBS>
<pRedCBS>0.00</pRedCBS>
<vBCIBS>1500.00</vBCIBS>
<pIBS>0.1700</pIBS>
<vIBS>255.00</vIBS>
<vBCCBS>1500.00</vBCCBS>
<pCBS>0.0900</pCBS>
<vCBS>135.00</vCBS>
</IBS_CBS>
<!-- Somente para produtos com Imposto Seletivo -->
<ImpSeletivo>
<CSTIS>110</CSTIS>
<cClassTribIS>IS110000</cClassTribIS>
<vBCIS>1500.00</vBCIS>
<pIS>5.00</pIS>
<vIS>75.00</vIS>
</ImpSeletivo>
</imposto>
</det>
Tabela completa dos campos do Grupo UB
Subgrupo IBS_CBS
| Campo | Tipo | Descrição | Obrigatório 2026 | Obrigatório 2027 | Obs |
|-------|------|-----------|-----------------|-----------------|-----|
| CSTIBS | AN (3) | CST IBS/CBS (3 dígitos) | Sim | Sim | = 3 primeiros dígitos do cClassTrib |
| cClassTrib | AN (6) | Código de Classificação Tributária (6 dígitos) | Sim | Sim | Tabela da NT 2025.002 |
| pRedIBS | N (5,4) | Percentual de redução da base IBS (%) | Sim | Sim | 0,00 se não houver redução |
| pRedCBS | N (5,4) | Percentual de redução da base CBS (%) | Sim | Sim | 0,00 se não houver redução |
| vBCIBS | N (15,2) | Valor da base de cálculo do IBS | Sim | Sim | Base após redução |
| pIBS | N (5,4) | Alíquota do IBS (%) | Sim | Sim | Alíquota vigente por UF |
| vIBS | N (15,2) | Valor do IBS | Sim | Sim | vBCIBS × pIBS / 100 |
| vBCCBS | N (15,2) | Valor da base de cálculo da CBS | Sim | Sim | Base após redução |
| pCBS | N (5,4) | Alíquota da CBS (%) | Sim | Sim | Alíquota federal |
| vCBS | N (15,2) | Valor da CBS | Sim | Sim | vBCCBS × pCBS / 100 |
| dispLeg | AN (255) | Dispositivo legal que fundamenta tratamento diferenciado | Condicional | Condicional | Obrigatório quando há redução |
Subgrupo ImpSeletivo (apenas para produtos com IS)
| Campo | Tipo | Descrição | Obrigatório 2026 | Obrigatório 2027 | Obs |
|-------|------|-----------|-----------------|-----------------|-----|
| CSTIS | AN (3) | CST do Imposto Seletivo | Sim (se IS) | Sim (se IS) | Indica tributação ou isenção do IS |
| cClassTribIS | AN (7) | Código de Classificação Tributária do IS | Sim (se IS) | Sim (se IS) | Tabela específica do IS |
| vBCIS | N (15,2) | Valor da base de cálculo do IS | Sim (se IS) | Sim (se IS) | Geralmente = valor do produto |
| pIS | N (5,4) | Alíquota do IS (%) | Sim (se IS) | Sim (se IS) | Alíquota por categoria de produto |
| vIS | N (15,2) | Valor do Imposto Seletivo | Sim (se IS) | Sim (se IS) | vBCIS × pIS / 100 |
Calendário de obrigatoriedade: o que é exigido em cada fase
A NT 2025.002-RTC define um calendário de implementação faseada do Grupo UB na NF-e:
2026 — Fase de alíquotas de teste
A partir da data definida por cada SEFAZ estadual em 2026, o Grupo UB passa a ser obrigatório em todas as NF-es. Os campos CSTIBS, cClassTrib e demais campos do subgrupo IBS_CBS devem ser preenchidos com as alíquotas de teste definidas para o período.
Durante a fase de teste:
- As alíquotas do IBS e CBS ainda não têm efeito financeiro real para o contribuinte
- O objetivo é validar tecnicamente os sistemas emissores e receptores
- Erros de preenchimento ainda geram rejeição, mas o impacto financeiro é reduzido
- O
ImpSeletivotambém deve ser preenchido para produtos afetados
2027 — CBS em transição
A partir de 1º de janeiro de 2027, a CBS começa a ter efeito fiscal real com alíquotas em fase de transição. O Grupo UB passa a ter impacto direto na apuração dos tributos e no direito ao creditamento do adquirente.
Nesta fase:
- Erros no
cClassTribpodem resultar em perda de crédito de CBS para o comprador - A alíquota
pCBSreal (não de teste) deve ser informada - O
pIBSainda pode ser de transição, com alíquota crescendo gradualmente
2033 — IBS pleno
Com a extinção progressiva do ICMS e ISS ao longo do período 2027–2032, em 2033 o IBS atinge sua alíquota plena e os grupos ICMS, PIS e COFINS deixam de ser obrigatórios na NF-e. O Grupo UB torna-se o único grupo tributário relevante para IBS, CBS e IS.
Erros comuns de rejeição SEFAZ relacionados ao Grupo UB
Com base nas regras de validação da SEFAZ publicadas no Portal NF-e, os erros mais frequentes são:
Ausência do Grupo UB (erro mais comum em 2026)
A partir da data de obrigatoriedade, toda NF-e deve conter o grupo IBS_CBS. NF-es sem o Grupo UB geram rejeição automática com código de erro específico. Sistemas emissores que não foram atualizados com a NT 2025.002 são a principal causa.
CSTIBS incompatível com cClassTrib
O CSTIBS deve ser idêntico aos 3 primeiros dígitos do cClassTrib. Qualquer inconsistência entre os dois campos gera rejeição imediata. Este erro ocorre quando o ERP preenche os campos de forma independente sem validação cruzada.
cClassTrib fora da tabela vigente
O código cClassTrib deve constar obrigatoriamente na tabela oficial da NT 2025.002-RTC vigente. Versões antigas da tabela ou códigos digitados manualmente sem consulta à tabela atualizada são a principal causa desse erro.
Campos de valor zerados para CST tributado
Quando o CSTIBS é 110 (tributação plena), os campos vBCIBS, pIBS e vIBS não podem ser zero. Isso indicaria que um produto tributado tem IBS/CBS de valor zero, o que é inconsistente.
Campos de valor não zerados para CST isento
Quando o CSTIBS é 400 (isenção) ou 500 (imunidade), os campos de valor do IBS/CBS devem ser zero. Informar valores não zero com esses CSTs gera inconsistência e rejeição.
ImpSeletivo ausente para produto sujeito ao IS
Produtos sujeitos ao Imposto Seletivo que não tiverem o subgrupo ImpSeletivo preenchido geram rejeição. O sistema deve identificar automaticamente quais NCMs exigem o IS com base na tabela atualizada da NT 2025.002.
Como validar um XML existente
Para verificar se uma NF-e está com o Grupo UB preenchido corretamente antes de transmiti-la:
-
Validação no emissor: Os principais sistemas emissores de NF-e (tanto softwares como serviços online) devem ser atualizados com a NT 2025.002 e ter rotinas de validação que verificam a consistência do Grupo UB antes da transmissão.
-
Validação pelo schema XSD: O schema XSD oficial da NF-e, disponível no Portal NF-e, foi atualizado para incluir o Grupo UB. Você pode validar localmente o XML contra o XSD usando ferramentas como o xmllint ou validadores online.
-
Ferramentas de verificação: Nossa plataforma (/ferramentas — requer cadastro) oferece verificação de NF-e e classificação automática de produtos com base na tabela RT atualizada.
Onde baixar o XSD oficial do Grupo UB
O arquivo XSD atualizado com o Grupo UB é o DFeTiposBasicos_v1.00.xsd e suas variações, disponíveis no Portal Nacional da NF-e na seção de Notas Técnicas, dentro da NT 2025.002-RTC.
Os arquivos XSD relevantes para o Grupo UB são:
nfe_v4.00.xsd(atualizado com Grupo UB)DFeTiposBasicos_v1.00.xsd(tipos básicos incluindo campos IBS/CBS)- Schemas auxiliares da NT 2025.002-RTC
Desenvolvedores de sistemas emissores devem baixar a versão mais recente dos schemas e garantir que seus parsers e validadores estejam atualizados.
Checklist para implementar o Grupo UB no seu ERP
Se você é contador ou responsável pela implementação de sistemas fiscais, use este checklist:
- [ ] Atualizar a versão da NT 2025.002-RTC no sistema emissor
- [ ] Carregar a tabela
cClassTribatualizada com todos os NCMs e códigos RT - [ ] Configurar a regra de derivar o
CSTIBSautomaticamente docClassTrib - [ ] Implementar validação de consistência entre
CSTIBSecClassTrib - [ ] Configurar os campos de alíquota de IBS por UF (tabela específica por estado)
- [ ] Configurar os campos de alíquota de CBS (tabela federal)
- [ ] Identificar os produtos sujeitos ao IS e configurar o subgrupo
ImpSeletivo - [ ] Testar emissão de NF-e com rejeição e autorização no ambiente de homologação da SEFAZ
- [ ] Capacitar a equipe sobre as novas obrigações fiscais da Reforma Tributária
Perguntas Frequentes
O Grupo UB aparece na DANFE impressa?
Não necessariamente no layout padrão. A DANFE (Documento Auxiliar da NF-e) é apenas uma representação simplificada do XML. Fornecedores de sistemas podem optar por exibir os valores de IBS, CBS e IS na DANFE, mas não há obrigatoriedade de layout específico determinada pela NT 2025.002 para a DANFE.
Empresas do Simples Nacional também precisam preencher o Grupo UB?
As regras definitivas para o Simples Nacional no contexto da Reforma Tributária estão sendo regulamentadas. As microempresas e empresas de pequeno porte optantes pelo Simples Nacional terão tratamento diferenciado no IBS e CBS, mas a tendência é que o Grupo UB seja obrigatório também para essas empresas, com campos de alíquota refletindo o tratamento simplificado.
A NF-e de devolução também precisa ter o Grupo UB?
Sim. Toda NF-e (de venda, devolução, remessa, bonificação, etc.) que tenha itens de produto sujeitos ao IBS/CBS deve incluir o Grupo UB. No caso de devolução, os campos do Grupo UB devem espelhar os valores originais da NF-e devolvida, com os ajustes aplicáveis.
Como fica o Grupo UB para NF-e de serviço?
Serviços estão sujeitos ao IBS e CBS. As NF-es de serviço (quando emitidas como NF-e) devem incluir o Grupo UB com os campos de IBS e CBS aplicáveis ao serviço. A tabela de cClassTrib para serviços é específica e diferente da tabela de mercadorias.
Artigo baseado na NT 2025.002-RTC v1.33 e na Lei Complementar nº 214/2025. Download do XSD e documentação técnica oficial: Portal NF-e. Texto legal: Planalto.gov.br.
Classifique NCM e cClassTrib em lote com IA
Aplique NCM, cClassTrib, CEST e Imposto Seletivo automaticamente em centenas de produtos. Teste grátis, sem cartão de crédito.