Classificar em lote

Grupo UB da NF-e: como informar IBS, CBS e cClassTrib no XML

Atualizado em 18/11/2026

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

CampoO que informa
CSTSituação tributária do IBS e da CBS, com três dígitos. Veja a tabela de CST.
cClassTribClassificação tributária, com seis dígitos. Os três primeiros repetem o CST.
gIBSCBSGrupo de cálculo, exigido nos CSTs com tributação (000, 010, 011, 200, 220, 221, 222, 510, 515, 550 e 830).
vBCBase de cálculo do IBS e da CBS.
gIBSUF e gIBSMunParcela estadual e parcela municipal do IBS, cada uma com alíquota e valor.
gCBSCBS, com alíquota e valor.
gRedReduçã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.

Fontes