TributoClaro

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.