Navegar na documentação

Entender o resultado

Cenários e alíquotas

O cenário reúne as hipóteses da simulação. Você pode ter vários, escolher o padrão e usar um diferente em cada webhook.
A calculadora oficial só traz alíquotas de referência para 2026 (o ano de teste). De 2027 em diante, as alíquotas vêm do cenário. Toda empresa começa com um cenário ilustrativo: revise-o com o seu time tributário.

Exemplo

cenário (JSON)
{
  "nome": "Base 2033 com IBS de SP maior",
  "anos": [2026, 2027, 2029, 2033],
  "aliquotas": {
    "2027": { "cbs": 8.8, "ibsEstadual": 0.05, "ibsMunicipal": 0.05 },
    "2029": { "cbs": 8.8, "ibsEstadual": 1.0,  "ibsMunicipal": 0.8 },
    "2033": {
      "cbs": 8.8, "ibsEstadual": 10.0, "ibsMunicipal": 7.7,
      "porUf": { "SP": 10.5 },
      "porMunicipio": { "3550308": 7.9 }
    }
  },
  "classificacao": {
    "SKU-ARROZ": "200003",
    "22030000": "000001",
    "122011200": "200028"
  },
  "impostoSeletivo": { "adValoremPadrao": 10, "porNcm": { "22030000": 12 } },
  "transicao": { "2027": { "ipi": 1 } },
  "creditosAtuais": { "icms": true, "ipi": false, "pisCofins": "cumulativo" }
}

Campos

CampoObrigatórioO que é
anossimAnos a simular, de 2026 a 2033.
aliquotasde 2027 em diantePor ano, em %: cbs, ibsEstadual e ibsMunicipal. Opcionais: porUf (sigla) e porMunicipio (código IBGE), aplicados pelo destino da operação.
classificacaonãocClassTrib por código do produto, NCM ou NBS.
impostoSeletivonãoAlíquota ad valorem padrão e por NCM para os itens sujeitos ao IS.
transicaonãoAjuste do cronograma por ano e tributo (fração de 0 a 1). Ex.: IPI mantido para a Zona Franca.
simplesNacionalpara emitente do SimplesAlíquota efetiva atual do DAS, pCBSSN/pIBSSN por ano, atividade e crédito estimado das compras. Ver Simples Nacional.
creditosAtuaisnãoCréditos dos tributos atuais nas compras: icms booleano (padrão true), ipi booleano (padrão false) e pisCofins: cumulativo (padrão, sem crédito) ou nao-cumulativo (estimativa de 9,25% sobre o valor dos itens).

Créditos dos tributos atuais

Edite o bloco creditosAtuais no JSON do cenário conforme o regime da empresa compradora. Omitir o bloco equivale a ICMS habilitado, IPI desabilitado e PIS/Cofins cumulativo. A validação recusa valores que não sejam booleanos para ICMS/IPI ou uma das duas opções para PIS/Cofins.

Essas escolhas valem para “hoje” e para os anos simulados, aplicando o cronograma de extinção e os ajustes de transicao. CBS/IBS das compras são calculados independentemente desse bloco. Veja as regras de créditos das compras.

Como o item é classificado

O cClassTrib de cada item segue esta ordem. Vale o primeiro que existir:

  1. o informado no próprio item (só na entrada JSON);
  2. o do código do produto no cenário;
  3. o que a nota já destaca no grupo IBSCBS (obrigatório desde 2026);
  4. o do NCM ou da NBS no cenário;
  5. 000001 (tributação integral), com um aviso no item.

Para montar o mapa de classificação, comece pelo diagnóstico do cadastro: ele aponta os códigos com tratamento específico disponível para cada NCM/NBS.

PróximoResultados e premissas