Documentação da API
Integre os cálculos da Reforma Tributária ao seu ERP ou sistema contábil. A API está disponível para escritórios com o módulo API de Integração. Cada chamada conta no limite mensal do plano e fica registrada no histórico do escritório.
Autenticação
Gere a chave em Área do contador › API e envie em todas as requisições no cabeçalho X-API-Key.
X-API-Key: sc_live_xxxxxxxxxxxxxxxxxxxxxxxx
Endpoints
POST
/api/v1/regime-regular/calcularCBS, IBS e IS por itemPOST
/api/v1/regime-regular/base-calculoBase unificada NF-e / NFS-ePOST
/api/v1/simples-nacional/calcularIBS/CBS no Simples (NT 2026.005)POST
/api/v1/danfseGera o PDF do DANFSeGET
/api/v1/usoConsumo do mês e limitesRegime Regular
Envie a operação no campo operacao. Use "modo":"estrito" para rejeitar a operação inteira no primeiro erro. Os campos opcionais client_id e title organizam o histórico.
POST /api/v1/regime-regular/calcular
{
"title": "NF 1532",
"operacao": {
"id": "6194602ea71cbf9431c236de4409d920", "versao": "1.0.0",
"dhFatoGerador": "2027-03-10T10:00:00-03:00", "municipio": 4314902, "uf": "RS",
"itens": [{
"numero": 1, "nbs": "122011200", "cst": "200", "cClassTrib": "200028", "baseCalculo": 1200.00,
"aliquotasNominais": { "cbs": 8.8, "ibsEstadual": 0.05, "ibsMunicipal": 0.05 }
}]
}
}
A resposta traz id (registro no histórico), warning (cálculo simulado) e result com objetos por item e total.
Simples Nacional
POST /api/v1/simples-nacional/calcular
{ "operacao": { "id": "x1", "versao": "2.0.0", "data": "2027-03-15", "tpDoc": "55", "CRT": "1",
"itens": [{ "numero": 1, "cAtivSN": "01", "cClassTrib": "000001", "baseCalculo": "950.00",
"valorImpostoSeletivo": "0.00", "pIBSSN": "1.25", "pCBSSN": "2.75" }] } }
DANFSe
POST /api/v1/danfse
{ "xml": "<NFSe ...>...</NFSe>", "stc": "0", "canhoto": true }
→ application/pdf
Erros
401chave ausente ou inválida402limite do plano atingido, teste encerrado ou assinatura suspensa403módulo não contratado422operação rejeitada (modo estrito) ou XML inválido503motor de cálculo temporariamente indisponível