# 📘 Change Log - API Conta Azul

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.

## V2.1.2025.12.02 – [2025-12-02]

## 🛠️ Mudança no canal de suporte aos desenvolvedores

### 🔄 O que mudou?

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**.

### 📆 Período de transição

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.

### 💬 Como abrir chamados daqui pra frente?

1. Acesse o **Portal do Desenvolvedor**.
2. Clique no ícone de suporte no canto inferior direito.
3. Envie sua dúvida técnica ou abra um chamado diretamente pelo portal.


Screenshot 2025-12-02 at 12.38.34.png
### ⚠️ Importante

- 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.


### 🎯 Por que fizemos isso?

- 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.


## V2.1.2025.11.19 – [2025-11-19]

### 🔄  Alterado

[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**.

## V2.1.2025.11.14 - [2025-11-14]

### 🚀 Adicionado

[Endpoint] [Retornar as notas fiscais por filtro](https://developers.contaazul.com/open-api-docs/open-api-invoice/v1/obternotasfiscaisporfiltro)

[O que?] Novo filtro

[Por que?] Permitir a busca de notas fiscais por meio do ID de uma venda.

[Exemplo]

image copy 12.png
## V2.1.2025.11.12 - [2025-11-12]

### 🔄 Alterado

[Endpoint] [Retornar os produtos por filtro](https://developers.contaazul.com/open-api-docs/open-api-inventory/v1/retornarlistagemdeprodutos)

[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_de` e `data_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]

apiprodutos-skudata.png
## V2.1.2025.11.11 - [2025-11-11]

### 🚀 Adicionado

[Endpoint] [Retornar o próximo número do contrato disponível](https://developers.contaazul.com/docs/contracts-apis-openapi/v1/getnextcontractnumber)

[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]

image copy 9.png
## V2.1.2025.11.07 - [2025-11-07]

### 🔄 Alterado

[Endpoint] [Retornar as parcelas pelo id do evento financeiro](https://developers.contaazul.com/docs/financial-apis-openapi/v1/getinstallmentsbyeventid)

[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

image copy 6.png
Mapeado novos status

image copy 10.png
### 🔄 Alterado

[Endpoint] [Retornar a parcela por id](https://developers.contaazul.com/docs/financial-apis-openapi/v1/getinstallmentbyid)

[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

image copy 7.png
Mapeado novos status

image copy 11.png
### 🔄 Alterado

[Endpoint] [Retornar as receitas por filtro](https://developers.contaazul.com/docs/financial-apis-openapi/v1/searchinstallmentstoreceivebyfilter)

[O que?] Adicionado objeto de renegociação

[Por que?] Necessidade de disponibilizar a informações de renegociação dentro da parcela

[Exemplo]

image copy 8.png
## V2.1.2025.11.05 - [2025-11-05]

### 🚀 Adicionado

[Endpoint] [Retornar as pessoas por filtro](https://developers.contaazul.com/open-api-docs/open-api-person/v1/retornapessoasporfiltros)

[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]

image copy 5.png
## V2.1.2025.11.04 – [2025-11-04]

### 🚀 Adicionado

[Endpoint] [Retornar as vendas por filtro](https://developers.contaazul.com/docs/sales-apis-openapi/v1/searchvendas)

[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]

image copy 4.png
## V2.1.2025.10.23 – [2025-10-23]

### 🚀 Adicionado

[Endpoint] [Retorna receitas por filtro](https://developers.contaazul.com/docs/financial-apis-openapi/v1/searchinstallmentstoreceivebyfilter) e [Retorna despesas por filtro](https://developers.contaazul.com/docs/financial-apis-openapi/v1/searchinstallmentstopaybyfilter)

[O que?] Novo filtro

[Por que?] Possibilitar a busca de receitas e despesas pela data de alteração da parcela

[Exemplo]

image copy 2.png
### 🚀 Adicionado

[Endpoint] [Retornar os itens de uma venda pelo id da venda](https://developers.contaazul.com/docs/sales-apis-openapi/v1/getvendaitens)

[O que?] Novo campo retornado

[Por que?] Retornar o valor do custo do item da venda

[Exemplo]

image copy 3.png
## V2.1.2025.10.10 – [2025-10-10]

### 🚀 Adicionado

[Endpoint] [Buscar saldo atual da conta financeira](https://developers.contaazul.com/docs/financial-apis-openapi/v1/searchbalancebyfinancialaccountid)

[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]

image.png
### 🚀 Adicionado

[Endpoint] [Retorna a estrutura completa de categorias DRE](https://developers.contaazul.com/docs/financial-apis-openapi/v1/searchdrecategories)

[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]

image copy.png
## V2.1.2025.08.27 [2025-08-27] – Inclusão de informações sobre rateio, centros de custo e categoria financeira

### 🔄  Alterado

[Endpoint]  [Retornar parcela por id](https://developers.contaazul.com/docs/financial-apis-openapi/v1/getinstallmentbyid)

[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]

Busca-parcela-por-ID.png
## [2025-06-11] – Adição da sessão de FAQ e Change Log

### 🚀 Adicionado

[O que?] Inclusão de duas novas sessões no Portal do Desenvolvedor:

- [**FAQ**](https://developers.contaazul.com/faq), consolidando as dúvidas mais comuns dos desenvolvedores.
- [**Change Log**](https://developers.contaazul.com/changelog), 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.