Administração
Integrar o ERP pela API
Como o ERP envia o balancete ao TOPO sem planilha.
Para quem cuida da integração entre o ERP e o TOPO.
A API pública v1 recebe o balancete de uma competência com as mesmas validações da importação por arquivo. A resposta diz quantas linhas vieram, quantas entraram e por que as outras ficaram de fora, com os avisos em português. A API também tem rotas de leitura para BI.
Passo a passo
- Abra um chamado e peça a chave de API ao suporte TOPO. Diga qual sistema vai usá-la. O segredo aparece uma vez só. Guarde num lugar seguro.
- Passe a chave para quem programa a integração, junto com a Referência da API, que descreve a autenticação, cada rota, os erros e os limites.
- O ERP envia o arquivo do balancete com o CNPJ da empresa e a competência.
- Confira o balancete em "Balancetes" e libere para conciliação, como na importação de balancete.
Exemplo
O ERP da Alfa Comércio Ltda. fecha agosto no dia 03/09/2026 e envia o balancete de 08/2026 pela API. A resposta diz que 312 linhas vieram e 312 entraram. O administrador abre "Balancetes", vê o balancete e clica em "Liberar para Conciliação".
Quando der errado
- "Chave de API inválida". A chave está errada ou foi revogada. Abra um chamado e peça outra ao suporte TOPO.
- "Módulo não contratado para esta empresa". A empresa do CNPJ enviado não tem o módulo. Confira o CNPJ ou abra um chamado.
- "Envie o arquivo do balancete no campo file." O envio chegou sem o arquivo. Quem programa a integração precisa corrigir o envio.
Pontos de atenção
- A chave só alcança as empresas do próprio cliente e os módulos contratados por elas.
- Se perder a chave, abra um chamado e peça outra ao suporte TOPO. A antiga é revogada.