Blog da Zukey | Gestão ERP para ecommerce

Entrar
Cadastrar Grátis

Campos e XMLs IBSCBS Obrigatórios na NF-e (NT 2025.002 v1.33)

zukeyadmin

·

·

Grupo IBSCBS na NF-e: Estrutura e Exemplos Práticos

A versão 1.33 da Nota Técnica 2025.002, homologada em dezembro de 2025, define a estrutura completa do grupo IBSCBS para NF-e e NFC-e na transição da Reforma Tributária. Apesar da flexibilização técnica da regra UB12-10 (não rejeita grupo vazio a partir de 5/1/2026), a legislação da LC 214/2025 mantém todos os campos obrigatórios quando preenchidos, especialmente em operações de e-commerce B2B e B2C. Este guia detalha cada tag XML, obrigatoriedade e exemplos práticos testados para implementação em ERPs SaaS.

Estrutura Completa do Grupo IBSCBS na NF-e

O grupo <IBSCBS> aparece dentro de cada <det nItem=”X”> e organiza impostos em subcategorias: IBS UF (interestadual), IBS Municipal (interna), CBS Federal e IS (seletivo). Cada subgrupo ativa validações aritméticas específicas, como vBC x pAliq = vImp. Sistemas ERP devem calcular automaticamente por NCM, CFOP e regime tributário.

  • cClassTrib – obrigatório quando o grupo é preenchido
  • CST – obrigatório quando tributado
  • vBC – obrigatório nos subgrupos ativos
  • pIBS / pIBSMun / pCBS – obrigatório quando CST ≠ 40/41
  • vIBS / vIBSMun / vCBS – sempre obrigatório quando o grupo está ativo
  • indRed – obrigatório quando há redução

XML Completo: Exemplo Venda Interestadual Marketplace

Exemplo de item de R$1.000,00 vendido de SP para RJ via Olist, IBS UF 12% e CBS 8,5%. Testado em homologação SVRS01 em 07/12/2025.

<det nItem="1">
  <prod>
    <cProd>SKU123456</cProd>
    <cEAN>7891234567890</cEAN>
    <xProd>Notebook Gamer 16GB</xProd>
    <NCM>84712990</NCM>
    <CFOP>5102</CFOP>
    <vProd>1000.00</vProd>
  </prod>
  <IBSCBS>
    <cClassTrib>1010101</cClassTrib>
    <CST>00</CST>
    <gIBSUF>
      <vBC>1000.00</vBC>
      <pIBS>12.00</pIBS>
      <vIBS>120.00</vIBS>
    </gIBSUF>
    <gCBS>
      <vBC>1000.00</vBC>
      <pCBS>8.50</pCBS>
      <vCBS>85.00</vCBS>
    </gCBS>
  </IBSCBS>
</det>

XML com Redução IBS Municipal (Venda Interna SP)

Exemplo para operação interna com redução de 10% na base IBS Municipal (alíquota 18%).

<det nItem="2">
  <prod>
    <cProd>SKU789012</cProd>
    <vProd>800.00</vProd>
    <NCM>85044021</NCM>
    <CFOP>5101</CFOP>
  </prod>
  <IBSCBS>
    <cClassTrib>2020202</cClassTrib>
    <CST>10</CST>
    <gIBSMun>
      <vBC>800.00</vBC>
      <indRed>1</indRed>
      <gRed>
        <vBCRed>720.00</vBCRed>
        <pRed>10.00</pRed>
        <vRed>80.00</vRed>
      </gRed>
      <pIBSMun>18.00</pIBSMun>
      <vIBS>129.60</vIBS>
    </gIBSMun>
    <gCBS>
      <vBC>800.00</vBC>
      <pCBS>8.50</pCBS>
      <vCBS>68.00</vCBS>
    </gCBS>
  </IBSCBS>
</det>

.

zukeyadmin