Para desenvolvedores

Integre com qualquer ERP em minutos

API RESTful documentada com OpenAPI 3.1. Importe balancetes, consulte conciliacoes e automatize workflows do fechamento contabil via endpoints padronizados.

Primeira requisicao

Do zero a primeira importacao em 3 linhas

Autentique com sua API key, envie o arquivo CSV do balancete e o Topo cuida do resto — validacao de estrutura, deteccao de divergencias e criacao automatica das conciliacoes.

Importar balancetecurl
curl -X POST https://api.topocontabil.com.br/v1/trial-balances/import \
  -H "Authorization: Bearer {api_key}" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@balancete-jan-2026.csv" \
  -F "companyId=cmp_abc123" \
  -F "periodId=per_202601"
Recursos da API

Construida para integracao robusta

Cada detalhe pensado para que sua integracao funcione em producao sem surpresas.

Idempotencia nativa

Envie a mesma requisicao varias vezes sem duplicar dados. Ideal para retries automaticos.

Paginacao por cursor

Navegue por grandes volumes de dados com performance consistente, sem os problemas de offset.

Webhooks configurados

Receba notificacoes quando conciliacoes mudam de status, importacoes finalizam ou erros ocorrem.

Sandbox completo

Ambiente isolado com dados ficticios para testar integracoes antes de ir para producao.

Rate limiting transparente

Headers claros informam limites e janelas. Sandbox: 100 req/min. Producao: 1.000 req/min.

OpenAPI 3.1

Especificacao completa para gerar SDKs, validar payloads e importar no Postman ou Insomnia.

Pronto para integrar?

Crie sua conta sandbox, gere uma API key e faca sua primeira importacao em menos de 5 minutos.