Grupo UB da NF-e: como informar IBS, CBS e cClassTrib no XML
O grupo UB é o bloco do XML da NF-e e da NFC-e criado pela Nota Técnica 2025.002 para receber o IBS, a CBS e o Imposto Seletivo. Ele é informado item a item, dentro de det/imposto, e convive com os grupos antigos de ICMS, IPI, PIS e Cofins durante a transição.
Estrutura básica
<det nItem="1">
<imposto>
<IBSCBS>
<CST>200</CST>
<cClassTrib>200028</cClassTrib>
<gIBSCBS>
<vBC>1200.00</vBC>
<gIBSUF>
<pIBSUF>0.05</pIBSUF>
<gRed><pRedAliq>60.00</pRedAliq><pAliqEfet>0.02</pAliqEfet></gRed>
<vIBSUF>0.24</vIBSUF>
</gIBSUF>
<gIBSMun>...</gIBSMun>
<vIBS>0.48</vIBS>
<gCBS>
<pCBS>8.80</pCBS>
<gRed><pRedAliq>60.00</pRedAliq><pAliqEfet>3.52</pAliqEfet></gRed>
<vCBS>42.24</vCBS>
</gCBS>
</gIBSCBS>
</IBSCBS>
</imposto>
</det>
Valores ilustrativos, reproduzidos do exemplo da documentação oficial da Calculadora de Tributos da Receita Federal (serviço de educação com redução de 60%). Não use as alíquotas acima como referência para 2027.
O que cada campo significa
| Campo | O que informa |
|---|---|
CST | Situação tributária do IBS e da CBS, com três dígitos. Veja a tabela de CST. |
cClassTrib | Classificação tributária, com seis dígitos. Os três primeiros repetem o CST. |
gIBSCBS | Grupo de cálculo, exigido nos CSTs com tributação (000, 010, 011, 200, 220, 221, 222, 510, 515, 550 e 830). |
vBC | Base de cálculo do IBS e da CBS. |
gIBSUF e gIBSMun | Parcela estadual e parcela municipal do IBS, cada uma com alíquota e valor. |
gCBS | CBS, com alíquota e valor. |
gRed | Redução de alíquota. Traz o percentual de redução (pRedAliq) e a alíquota efetiva resultante (pAliqEfet). Exigido nos CSTs 011, 200 e 515. |
Outros CSTs usam grupos próprios. A monofasia (CST 620) usa gIBSCBSMono, a transferência de crédito (CST 800) usa gTransfCred e o diferimento (CSTs 510 e 515) acrescenta gDif. Isenção, imunidade e tributação em documento específico (CSTs 400, 410 e 820) dispensam o grupo de cálculo.
Obrigatoriedade
O preenchimento do grupo UB segue o cronograma das notas técnicas do Portal Nacional da NF-e, que já foi alterado mais de uma vez. Para empresas do Simples Nacional e MEI, a obrigatoriedade dos campos de IBS e CBS na NF-e e na NFC-e está prevista para janeiro de 2027. Confira sempre a versão vigente da NT 2025.002 antes de configurar o emissor.
Em cada página de código deste site há um exemplo do trecho do grupo UB montado para aquele cClassTrib. Comece pela tabela completa.