Este registro documenta mudanças importantes na API da Conta Azul, como novos endpoints, atualizações de comportamento, alterações de contrato e descontinuações. Siga este changelog para manter suas integrações atualizadas e compatíveis.
Estamos realizando uma transição do canal de suporte aos desenvolvedores.
O atendimento que antes ocorria pelo e-mail api@contaazul.com passará a ser feito exclusivamente pelo Portal do Desenvolvedor.
O e-mail api@contaazul.com será gradativamente descontinuado até meados de janeiro/2026.
Durante esse período, o e-mail ainda poderá ser utilizado, mas recomendamos fortemente abrir chamados diretamente pelo novo canal.
Após a descontinuação, o e-mail deixará de ser monitorado.
- Acesse o Portal do Desenvolvedor.
- Clique no ícone de suporte no canto inferior direito.
- Envie sua dúvida técnica ou abra um chamado diretamente pelo portal.
- A partir de meados de janeiro, e-mails enviados para api@contaazul.com não serão mais atendidos.
- O Portal do Desenvolvedor passa a ser o canal oficial e exclusivo para suporte técnico.
- Melhor organização e rastreabilidade do atendimento.
- Centralização do histórico e mais agilidade na resolução.
- Experiência mais consistente para parceiros desenvolvedores.
[Configuração] Rate limit da API
[O que?] O limite de requisições foi atualizado para 600 por minuto e 10 por segundo, agora aplicado por conta conectada do ERP, e não mais por aplicação.
[Por que?] Com as recentes liberações dos filtros por data de atualização (Pessoas, Vendas, Receitas e Despesas), é possível consultar apenas os dados que foram alterados, reduzindo o volume desnecessário de requisições.
Essa mudança torna o consumo mais eficiente e permite ampliar o limite de contas conectadas do ERP em uma mesma aplicação, sem comprometer a estabilidade da API.
[Endpoint] Retornar as notas fiscais por filtro
[O que?] Novo filtro
[Por que?] Permitir a busca de notas fiscais por meio do ID de uma venda.
[Exemplo]
[Endpoint] Retornar os produtos por filtro
[O que?] Foram adicionados novos filtros aos parâmetros de consulta:
sku: permite busca exata por código de identificação do produto.data_alteracao_deedata_alteracao_ate: possibilitam filtrar produtos com base no período de alteração.
[Por que?] Esses filtros aumentam a precisão e a eficiência na consulta de produtos, facilitando a localização dos dados desejados conforme critérios específicos.
[Exemplo]
[Endpoint] Retornar o próximo número do contrato disponível
[O que?] Novo endpoint
[Por que?] Este endpoint tem como objetivo disponibilizar o próximo número do contrato para ser possível criar contratos de forma automatizada
[Exemplo]
[Endpoint] Retornar as parcelas pelo id do evento financeiro
[O que?]
Adicionado objeto de renegociação
Mapeado novos status:
- "RENEGOCIADO"
- "RECEBIDO_PARCIAL"
- "ATRASADO"
- "PERDIDO"
[Por que?] Necessidade de disponibilizar a informações de renegociação dentro da parcela. Exibir outras opções de status da parcela
[Exemplo]
Adicionado objeto de renegociação
Mapeado novos status
[Endpoint] Retornar a parcela por id
[O que?]
Adicionado objeto de renegociação
Mapeado novos status:
- "RENEGOCIADO"
- "RECEBIDO_PARCIAL"
- "ATRASADO"
- "PERDIDO"
[Por que?] Necessidade de disponibilizar a informações de renegociação dentro da parcela. Exibir outras opções de status da parcela
[Exemplo]
Adicionado objeto de renegociação
Mapeado novos status
[Endpoint] Retornar as receitas por filtro
[O que?] Adicionado objeto de renegociação
[Por que?] Necessidade de disponibilizar a informações de renegociação dentro da parcela
[Exemplo]
[Endpoint] Retornar as pessoas por filtro
[O que?] Novo filtro e novos campos retornados
[Por que?] Possibilitar a busca de pessoas pela data de/até da alteração da pessoa
[Exemplo]
[Endpoint] Retornar as vendas por filtro
[O que?] Novo filtro e novo campo retornado
[Por que?] Possibilitar a busca de vendas pela data de/até da alteração da venda
[Exemplo]
[Endpoint] Retorna receitas por filtro e Retorna despesas por filtro
[O que?] Novo filtro
[Por que?] Possibilitar a busca de receitas e despesas pela data de alteração da parcela
[Exemplo]
[Endpoint] Retornar os itens de uma venda pelo id da venda
[O que?] Novo campo retornado
[Por que?] Retornar o valor do custo do item da venda
[Exemplo]
[Endpoint] Buscar saldo atual da conta financeira
[O que?] Novo endpoint
[Por que?] Este endpoint tem como objetivo disponibilizar, de forma simples e direta, o saldo atual de uma conta financeira específica, identificada pelo id da conta financeira.
[Exemplo]
[Endpoint] Retorna a estrutura completa de categorias DRE
[O que?] Novo endpoint
[Por que?] Este endpoint tem como objetivo listar a estrutura completa de categorias da Demonstração do Resultado do Exercício (DRE), composta por categorias principais e subcategorias hierárquicas
[Exemplo]
[Endpoint] Retornar parcela por id
[O que?] Agora o endpoint passa a retornar também informações de rateio, centros de custo e categoria financeira associadas à parcela.
[Por que?] Para fornecer uma visão mais completa dos detalhamentos financeiros, permitindo análises mais precisas e integração mais rica por parte dos desenvolvedores.
[Exemplo]
[O que?] Inclusão de duas novas sessões no Portal do Desenvolvedor:
- FAQ, consolidando as dúvidas mais comuns dos desenvolvedores.
- Change Log, permitindo acompanhar facilmente todas as alterações, inclusões e evoluções das APIs e recursos da plataforma.
[Por que?] Para melhorar a navegação, facilitar a consulta e aumentar a autonomia dos desenvolvedores ao utilizar as APIs.