Centralizar informações e esclarecer dúvidas sobre:
- A nova API Conta Azul e seus recursos;
- O processo de descontinuação da API legada;
- Os procedimentos de suporte e atendimento;
- As principais dúvidas técnicas e processuais mapeadas até o momento.
A Conta Azul está evoluindo seu ecossistema de integrações para oferecer uma API muito mais completa e aderente às necessidades financeiras dos negócios.
| Versão | Escopo | Indicação |
|---|---|---|
| API Atual (Legada) | Integra produtos, serviços, clientes, fornecedores e vendas. Não cobre módulo Financeiro. | Ideal para sincronização básica de cadastros e vendas. |
| Nova API (Completa) | Integra cadastros, vendas e todo o módulo Financeiro, incluindo contas a pagar/receber, conciliações, cobranças, contratos e centros de custo. | Ideal para automação ponta a ponta — da venda ao fechamento contábil e fiscal. |
- E-mail: api@contaazul.com
- Tempo de resposta: até 24 horas úteis
Para acelerar o suporte, inclua:
- client_id (para validação da credencial);
- Informações técnicas completas:
- Payload
- Headers
- Body
- Status code
- Comando CURL
- Endpoint utilizado
- Prints de tela ou exemplos de erro.
1. A API legada será descontinuada?
Sim. A nova API substituirá completamente a antiga, oferecendo maior cobertura e estabilidade.
2. Existe prazo para migração?
Novembro de 2025 a API Legada será desativada3. Meu app precisa de adequações?
Sim — endpoints, autenticação e payloads foram atualizados. Recomenda-se revisar o mapeamento atual antes de migrar. Consulte as nossas documentações aqui dispostas.
4. Como migrar dados da API antiga para a nova?
Não existe uma migração de dados, apenas o mapeamento de transformação deve ser feito no tratamento entre a nova API e a base do integrador. Existe uma paridade de informações com a principal diferença, sendo que as respostas da API nova tem campos em PT-BR (Português - Brasil)
6. Recebi comunicação sobre desativação da v1. O que fazer?
Acesse nossa documentação da API Pública, nela você encontrará toda orientação para nova API. Caso tenha dúvida, entre em contato com o nosso time de suporte técnico pelo e-mail:api@contaazul.com
| Área | API Legada | Nova API |
|---|---|---|
| Produtos/Serviços | ✅ | ✅ |
| Clientes/Fornecedores | ✅ | ✅ + Transportadoras |
| Vendas | ✅ | ✅ + Orçamentos + Ordens de Serviço |
| Financeiro | ❌ | ✅ Contas a pagar/receber, conciliações, cobranças |
| Notas Fiscais | ❌ | ✅ Consulta de NF de produto |
| Contratos/Centros de Custo | ❌ | ✅ Gestão completa |
| Categorias e Lançamentos | ❌ | ✅ Inclusos |
- Para qualquer dúvida, problema ou necessidade de assistência durante a migração ou o desenvolvimento com a nova API, entre em contato com nosso time pelo e-mail api@contaazul.com . Nosso time oferecerá suporte e garantirá que você tenha todo o apoio necessário durante o processo.
Além disso, você também pode acessar o nosso Chat pelo Portal do Desenvolvedor para tirar dúvidas e obter orientações sobre o uso das APIs.