> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Release do Midaz – Ciclo 3

> O Ciclo 3 do Midaz está no ar com Transações Retroativas, Anotações de Transação, Múltiplos Saldos e melhorias no Reporter, incluindo suporte ao Relatório CCS e exportação em PDF.

19 de setembro de 2025Atualizado

Em 19 de setembro de 2025, lançamos o **Ciclo 3 do Midaz**, com novos recursos em Transações e no Reporter. Este release melhora a flexibilidade dos dados, a rastreabilidade e a personalização de relatórios para dar suporte a workflows financeiros cada vez mais sofisticados.

As principais atualizações incluem **Transações Retroativas**, **Anotações de Transação**, **Múltiplos Saldos** e melhorias no produto **Reporter**, entre elas **suporte ao Relatório CCS** e mais opções de filtro.

## Novos recursos do Midaz

***

### Transações retroativas

Agora você pode criar transações com data passada enviando o campo opcional `transactionDate` nos endpoints transacionais.

* Valores aceitos: qualquer data `< now()`.
* A data informada é armazenada em `created_at`. Se não for enviada, `created_at` assume por padrão o timestamp da requisição (como acontece hoje).

**Endpoints impactados**

* [Criar uma transação usando JSON](https://docs.lerian.studio/pt/reference/products/midaz/v1/create-transaction-json.md)
* [Criar uma transação de entrada](https://docs.lerian.studio/pt/reference/products/midaz/v1/create-transaction-inflow.md)
* [Criar uma transação de saída](https://docs.lerian.studio/pt/reference/products/midaz/v1/create-transaction-outflow.md)
* [Criar uma anotação de transação](https://docs.lerian.studio/pt/reference/products/midaz/v1/create-transaction-annotation.md)

### Anotações de transação

Introduzimos um novo tipo de transação que **não impacta os saldos das contas**.

* Permite importar **transações legadas** sem afetar os saldos.
* Permite registrar **operações não financeiras** para rastreabilidade.
* Um novo campo booleano `balanceAffected` mostra se uma transação impacta saldos.

**Novo endpoint**

* Anotação de transação: [Criar uma anotação de transação](https://docs.lerian.studio/pt/reference/products/midaz/v1/create-transaction-annotation.md)

**Respostas impactadas**

* Todos os endpoints de **Transactions** e **Operations** agora retornam `balanceAffected`.

### Múltiplos saldos

Agora as contas podem ter múltiplos saldos, o que permite separar recursos de forma lógica (por exemplo, operacional, crédito, garantia).

#### Novo endpoint

* [Criar um saldo](https://docs.lerian.studio/pt/reference/products/midaz/v2/create-additional-balance.md)

### Atualizações na criação de transações

Um novo campo `balanceKey` foi adicionado para selecionar o saldo usado em uma transação.

**Endpoints impactados**

* [Criar uma transação usando JSON](https://docs.lerian.studio/pt/reference/products/midaz/v1/create-transaction-json.md)
* [Criar uma transação de entrada](https://docs.lerian.studio/pt/reference/products/midaz/v1/create-transaction-inflow.md)
* [Criar uma transação de saída](https://docs.lerian.studio/pt/reference/products/midaz/v1/create-transaction-outflow.md)
* [Criar uma anotação de transação](https://docs.lerian.studio/pt/reference/products/midaz/v1/create-transaction-annotation.md)

### Atualizações nas respostas

* **Transactions & Operations**: novo campo `balanceKey`.
* **Balances**: novo campo `key`.

## Melhorias no Reporter

***

Estendemos o produto **Reporter** para oferecer suporte a filtros mais flexíveis e a mais recursos de relatório.

* Os filtros agora aceitam **objetos com nomes personalizados** em vários níveis (fonte de dados, tabela e campo), graças ao tratamento dinâmico de chaves via `additionalProperties`. Você pode definir filtros com base no seu schema usando chaves de objeto personalizadas.
* A filtragem está disponível na [criação do relatório](https://docs.lerian.studio/pt/reference/products/reporter/create-report.md), na [consulta](https://docs.lerian.studio/pt/reference/products/reporter/check-report-status.md) e no [download](https://docs.lerian.studio/pt/reference/products/reporter/download-report.md).
* Um novo tipo de relatório, o [Relatório CCS](https://docs.lerian.studio/pt/products/reporter/ccs-reports.md), agora tem suporte.
* Os relatórios agora podem ser exportados em **formato PDF**, além de HTML, XML, CSV e TXT.

Para orientações de implementação, consulte o [Guia do Reporter](https://docs.lerian.studio/pt/products/reporter/what-is-reporter.md) atualizado.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.