Nota Gateway
Tax Engine · Reforma Tributária

IBS e CBS calculados no checkout, antes de a nota existir

Seu ERP ou e-commerce envia a venda no layout Nota Gateway. O Tax Engine classifica cada item, aplica as alíquotas do ano de referência e devolve os valores por fora, para produto ou serviço, B2B ou B2C.

Altere o cenário abaixo e veja o cálculo e o JSON se refazerem na hora.

Quem compra

O que vende

loja.exemplo.com.br/checkoutTax Engine

Resumo do pedido

Finalizar compra

Maria Aparecida Silva

386.186.997-72 · Belo Horizonte/MG

Consumidor final

  • Geladeira Brastemp Frost Free Inverse 443 L

    1 × R$ 5.000,00 (UN) · NCM 8418.10.00 · cClassTrib 000001

    Produto

    R$ 5.000,00

    IBS 17,7%

    R$ 885,00

    CBS 8,8%

    R$ 440,00

    Total item

    R$ 6.325,00
  • Micro-ondas Brastemp 32 L Inox

    2 × R$ 899,90 (UN) · NCM 8516.50.00 · cClassTrib 000001

    Produto

    R$ 1.799,80

    IBS 17,7%

    R$ 318,56

    CBS 8,8%

    R$ 158,38

    Total item

    R$ 2.276,74
Valor dos produtos
R$ 6.799,80
IBS (Estados e Municípios) · 17,7%
R$ 1.203,56
CBS (Federal) · 8,8%
R$ 598,38
Total a pagar
R$ 8.601,74

Preço transparente ao consumidor

IBS e CBS são destacados por fora do preço e informados na NFC-e/NF-e. O consumidor final não toma crédito; a carga efetiva é de 26,5%.

ICMS, ISS, PIS e COFINS extintos. Só IBS e CBS, ambos por fora.

Integração

O que o seu sistema envia

JSON no layout Nota Gateway. O Tax Engine classifica, calcula e devolve os valores prontos para a nota.

  1. Venda enviada

    POST /v2/documentos · NF-e · idExterno pedido-48213

  2. Classificação

    2 item(ns) → cClassTrib 000001 · CST IBS/CBS 000

  3. Cálculo por fora

    IBS 17,7% + CBS 8,8% sobre a base sem tributos

  4. Resposta

    vIBS 1.203,56 · vCBS 598,38 · consumidor final

Requisiçãoitens[] · sem valores de imposto

{  "tipo": "NF-e",  "idExterno": "pedido-48213",  "ambienteEmissao": "Producao",  "naturezaOperacao": "Venda de mercadoria",  "consumidorFinal": true,  "indicadorPresencaConsumidor": "OperacaoInternet",  "cliente": {    "tipoPessoa": "F",    "nome": "Maria Aparecida Silva",    "email": "maria.silva@email.com.br",    "cpfCnpj": "38618699772",    "endereco": {      "pais": "Brasil",      "uf": "MG",      "cidade": "Belo Horizonte",      "logradouro": "Rua Sergipe",      "numero": "1014",      "cep": "30130174"    }  },  "itens": [    {      "codigo": "BRE57AK",      "descricao": "Geladeira Brastemp Frost Free Inverse 443 L",      "ncm": "84181000",      "cest": "2100100",      "cfop": "6102",      "unidadeMedida": "UN",      "quantidade": 1,      "valorUnitario": 5000,      "ibsCbs": {        "cst": "000",        "cClassTrib": "000001"      }    },    {      "codigo": "BMS45CR",      "descricao": "Micro-ondas Brastemp 32 L Inox",      "ncm": "85165000",      "cfop": "6102",      "unidadeMedida": "UN",      "quantidade": 2,      "valorUnitario": 899.9,      "ibsCbs": {        "cst": "000",        "cClassTrib": "000001"      }    }  ],  "taxEngine": {    "calcularIbsCbs": true,    "anoReferencia": 2033  }}

Resposta do Tax Engine200 OK · 38 ms

{  "status": "calculado",  "documento": "NF-e",  "anoReferencia": 2033,  "itens": [    {      "codigo": "BRE57AK",      "IBSCBS": {        "CST": "000",        "cClassTrib": "000001",        "gIBSCBS": {          "vBC": 5000,          "gIBS": {            "pIBS": 17.7,            "vIBS": 885          },          "gCBS": {            "pCBS": 8.8,            "vCBS": 440          }        }      },      "vTotalItem": 6325    },    {      "codigo": "BMS45CR",      "IBSCBS": {        "CST": "000",        "cClassTrib": "000001",        "gIBSCBS": {          "vBC": 1799.8,          "gIBS": {            "pIBS": 17.7,            "vIBS": 318.56          },          "gCBS": {            "pCBS": 8.8,            "vCBS": 158.38          }        }      },      "vTotalItem": 2276.74    }  ],  "totais": {    "vProd": 6799.8,    "vIBS": 1203.56,    "vCBS": 598.38,    "vNF": 8601.74  },  "consumidorFinal": true,  "creditoDestinatario": null,  "baseLegal": [    "LC 214/2025, art. 12 (cálculo por fora)",    "LC 214/2025, arts. 343-346 (transição)",    "NT 2025.002 (grupo IBSCBS na NF-e)"  ]}

Cálculo por fora, em tempo real

IBS e CBS não integram a própria base nem a base um do outro (LC 214/2025, art. 12). O engine recebe o valor da operação e devolve base, alíquotas e valores por item, prontos para o grupo IBSCBS da NF-e e da NFS-e.

B2B e B2C com a regra certa

Para empresa contribuinte, o crédito é integral e aparece na resposta. Para consumidor final, o preço é transparente: tributos destacados, sem crédito. O mesmo JSON de venda serve para os dois casos.

Transição 2026 → 2033 embutida

Alíquotas de teste em 2026, CBS plena em 2027, redução gradual de ICMS/ISS a partir de 2029 e regime pleno em 2033. Você informa o ano de referência (ou deixa o engine usar a data da operação).

Quer ver com os seus produtos?

O simulador classifica NCM/CEST, calcula a carga atual (ICMS, DIFAL, ST, PIS/COFINS) e projeta IBS/CBS para um cenário real de venda em três etapas.