Cálculo de impostos

POST /v1/tax/calculate faz o mesmo cálculo da emissão, sem criar nota nem reservar número. Serve para orçamento, carrinho e para conferir uma integração nova.

Com uma empresa cadastrada, use companyId (as classes de imposto dela valem). Sem cadastro, informe só o regime e a UF em issuer:

POST /v1/tax/calculate

{
  "issuer": { "crt": 3, "uf": "SP" },
  "operation": "sale",
  "recipient": { "cnpj": "11444777000161", "ieIndicator": "1", "uf": "MG" },
  "items": [{
    "code": "TEN-ESP-42", "description": "Tênis esportivo nº 42", "ncm": "64041100", "origin": "0",
    "cfop": "6101", "unit": "PAR", "quantity": "20", "unitPrice": "75.00",
    "taxes": { "icms": { "cst": "00", "rate": "12" }, "ipi": { "cst": "50", "rate": "10" },
               "pis": { "cst": "01", "rate": "1.65" }, "cofins": { "cst": "01", "rate": "7.6" } }
  }]
}

A resposta traz, por item, os valores de cada imposto e as decisões do motor do IBS/CBS (que CST e classificação usou, e por quê), além de sugestões de redução pelo NCM. issueDate simula as regras de outra data, por exemplo "2027-01-01".

Tabelas da Reforma Tributária

Rota	Para quê
`GET /v1/tax/classifications?cst=200`	CST e cClassTrib oficiais do IBS/CBS, com as reduções
`GET /v1/tax/ncm/{ncm}`	Itens dos anexos da LC 214/2025 que citam o NCM (reduções) e o Imposto Seletivo
`GET /v1/tax/rules?year=2027`	Alíquotas do ano e o que o governo ainda não publicou

Uma redução só vale se o produto corresponder à descrição legal; o NCM sozinho não basta. Quando confirmar, fixe a classificação em taxes.ibsCbs ou na classe de imposto.

Esta página em Markdown, para IA: index.md