API do TributoClaro
Use a mesma simulação do site dentro do seu sistema. Autentique com a chave da sua conta no cabeçalho Authorization: Bearer ctc_... (ou X-API-Key). Sem chave, só vale a simulação gratuita única.
Simular itens
curl -X POST https://SEU-DOMINIO/api/v1/simular \
-H "Authorization: Bearer ctc_SUA_CHAVE" -H "Content-Type: application/json" \
-d '{
"data": "2026-11-17", "uf": "SP", "municipio": 3550308,
"itens": [
{"descricao":"Arroz 5 kg","ncm":"10063021","valor":"100,00","quantidade":20,"unidade":"KG","tratamento":"000001"},
{"descricao":"Consultoria","nbs":"122011200","valor":"1200,00"}
]
}'
Resposta: itens[] (CBS, IBS, carga, situação, erros), totais, avisos[] e cobranca. Cada item calculado usa 1 crédito; itens com erro de dados são estornados. A partir de 2027, envie aliquotas: {"cbs":8.8,"ibsEstadual":0.05,"ibsMunicipal":0.05} se a Receita ainda não tiver publicado as de referência.
Lote por CSV
POST /api/v1/lote
{"data":"2026-11-17","uf":"SP","municipio":3550308,"csv":"descricao;ncm;valor\nArroz;10063021;100,00\n"}
Devolve o campo csv com o resultado por linha. Máximo de 2.000 linhas por envio.
DANFSe em PDF
curl -X POST https://SEU-DOMINIO/api/v1/danfse \ -H "Authorization: Bearer ctc_SUA_CHAVE" -H "Content-Type: application/xml" \ --data-binary @nfse.xml -o danfse.pdf
Usa 3 créditos por PDF gerado. O XML não é gravado.
Consultas auxiliares (sem custo)
GET /api/v1/meta GET /api/v1/municipios?uf=SP GET /api/v1/ncm?ncm=22030000&data=2026-11-17 GET /api/v1/tratamentos?data=2026-11-17 GET /api/v1/tratamentos-aplicaveis?ncm=10063021&data=2026-11-17 GET /api/v1/conta (saldo e extrato)
Erros
Formato: {"erro":{"codigo","mensagem"}}. 402 crédito insuficiente ou simulação gratuita já usada; 422 dados recusados pela calculadora; 429 limite de uso; 502 calculadora indisponível (nada é cobrado).
Aviso
Serviço independente baseado na calculadora de código aberto da Receita Federal. Resultado informativo, sem valor fiscal.