Grupo UB no XML da NF-e: quais campos passaram a ser obrigatórios

Quem trabalha perto do XML da nota fiscal sabe que o leiaute muda de tempos em tempos, quase sempre em incrementos pequenos. A Nota Técnica 2025.002 é diferente: ela não ajustou campo, ela acrescentou um bloco inteiro. Este texto descreve o que entrou e o que a validação passou a recusar.

O que é o grupo UB

O grupo UB é o bloco do XML que detalha os tributos criados pela reforma tributária do consumo: o IBS, imposto de competência estadual e municipal, a CBS, contribuição federal, e o IS, o Imposto Seletivo.

A característica que muda o desenho de qualquer integração é esta: o grupo é por item, não por documento. Cada produto da nota carrega o próprio detalhamento. Uma nota com quinze linhas tem quinze ocorrências do grupo.

O grupo W03 e os totais

Como os valores são calculados item a item, o leiaute precisou de um lugar para consolidar. Esse lugar é o grupo W03, que soma IBS, CBS e IS de todos os itens e apresenta os totais do documento.

Na prática, isso significa que não basta preencher o item e esquecer o total — os dois precisam existir e precisam fechar entre si. Sistema que preenche só um dos lados gera documento inconsistente.

Os campos que mais geram dúvida

Três nomes aparecem com frequência em erro de integração:

cClassTrib — o código de classificação tributária do item. Define como aquele produto específico é tributado pelo IBS e pela CBS. É o campo que mais depende de cadastro correto, porque não dá para inferir em tempo de emissão.

cIndOp — indicador da operação, que qualifica a natureza do que está sendo feito naquela linha.

pDevTrib — percentual de devolução de tributo, usado nas situações em que há devolução prevista.

Vale reforçar que esses campos convivem com o que já existia. CST, CSOSN, NCM e CFOP continuam onde estavam. Nada foi substituído; foi tudo acrescentado.

A regra de validação que rejeita

A validação que interessa é a UB12-10_1115. Ela recusa o documento que não trouxer os grupos de IBS e CBS depois do prazo aplicável ao regime do emitente.

Rejeição acontece na origem, no momento da transmissão. Isso é diferente de erro que aparece depois em conferência ou em obrigação acessória: a nota simplesmente não é autorizada. Sem autorização, não há DANFE válido e a mercadoria não circula.

Os prazos são dois:

• 3 de agosto de 2026 para empresas do regime regular, Lucro Real e Lucro Presumido.
• 4 de janeiro de 2027 para Simples Nacional e MEI.

Antes desses marcos, houve um período de flexibilização em que a ausência dos campos não causava rejeição nem penalidade. Esse período serviu para adaptação de sistema, e é o que explica por que muita empresa emitiu 2026 inteiro sem notar a mudança.

A alíquota-teste

Durante a fase de transição, o valor destacado é de 1% no total: 0,1% de IBS e 0,9% de CBS. É uma alíquota de calibragem, pensada para que emitente e fisco testem o fluxo completo com valores baixos antes de a tributação efetiva entrar.

Para quem integra sistema, isso é uma janela útil: dá para validar cálculo, arredondamento e totalização sem que um erro vire prejuízo relevante.

O que checar na sua integração

Se você mantém um integrador ou desenvolve o próprio emissor, esta é a lista mínima:

1. O grupo UB é gerado para todos os itens, não só para os tributados.
2. O grupo W03 existe e os totais batem com a soma dos itens.
3. O cClassTrib vem do cadastro do produto, não de valor fixo no código.
4. Os campos antigos continuam sendo enviados; nada foi removido do leiaute.
5. Existe teste em homologação cobrindo nota com item único e nota com muitos itens.
6. O tratamento de rejeição devolve a mensagem da Sefaz de forma legível para o usuário, e não um código cru.

O item 3 é o que mais causa retrabalho. Deixar o código chumbado no sistema funciona no primeiro teste e quebra no primeiro produto de tributação diferente.

Se você quer entender melhor esse campo específico, escrevemos um texto dedicado a ele: o que é cClassTrib e como preencher.

---

Este texto é informativo e não substitui a leitura da nota técnica oficial nem orientação do seu contador. O leiaute e os prazos vêm sendo atualizados por atos da Receita Federal e do Comitê Gestor do IBS.