Para desenvolvedores

Integre com qualquer ERP em minutos

API RESTful documentada com OpenAPI 3.1. Importe balancetes, consulte conciliações e automatize workflows do fechamento contábil via endpoints padronizados.

Primeira requisição

Do zero a primeira importação em 3 linhas

Autentique com sua API key, envie o arquivo CSV do balancete e o Topo cuida do resto — validação de estrutura, detecção de divergências e criação automática das conciliações.

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

Construída para integração robusta

Cada detalhe pensado para que sua integração funcione em produção sem surpresas.

Idempotencia nativa

Envie a mesma requisição varias vezes sem duplicar dados. Ideal para retries automáticos.

Paginação por cursor

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

Webhooks configurados

Receba notificações quando conciliações mudam de status, importações finalizam ou erros ocorrem.

Sandbox completo

Ambiente isolado com dados fictícios para testar integrações antes de ir para produção.

Rate limiting transparente

Headers claros informam limites e janelas. Sandbox: 100 req/min. Produção: 1.000 req/min.

OpenAPI 3.1

Específicação 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 importação em menos de 5 minutos.