# API de Extrato – Nova Propriedade uuid

### Visão Geral

A partir de **17/12/2025**, o endpoint **`GET /v2/report/statement`** passou a retornar um novo campo chamado **`uuid`** em cada objeto do array de resposta.

Esse campo representa um **identificador único do item de extrato**, permitindo que cada registro seja tratado, referenciado e rastreado individualmente.

***

### O que mudou

#### Antes

Os objetos retornados pelo endpoint não possuíam um identificador único próprio. A identificação dependia de combinações de campos, como datas, operação ou `uuid_charge`.

#### Agora

Cada item do extrato possui um campo **`uuid`**, garantindo unicidade e facilitando integrações e tratamentos posteriores.

***

### Nova Propriedade

| Campo  | Tipo            | Descrição                                                                                   |
| ------ | --------------- | ------------------------------------------------------------------------------------------- |
| `uuid` | `string (UUID)` | Identificador único do item de extrato. É estável e exclusivo para cada registro retornado. |

***

### Exemplo de Retorno

```json
[
   {
      "uuid":"8a3f5c2e-1b4d-4e9a-b7c1-3d6f9e2a1c5b",
      "execution_date":"2025-12-15",
      "charge_paid_date":"2025-12-15T17:35:23.851Z",
      "uuid_charge":"123e4567-e89b-12d3-a456-426614174000",
      "operacao":"ESTORNO",
      "payment_method":"text",
      "entrada_bruta":1,
      "saida_bruta":1,
      "entrada_liquida":1,
      "saida_liquida":1,
      "taxa_operacao":"text",
      "bandeira":"text"
   }
]
```

***

### Casos de Uso

A nova propriedade `uuid` pode ser utilizada para:

* Identificar unicamente um item do extrato em sistemas externos;
* Evitar duplicidade de registros em processos de ingestão ou conciliação;
* Referenciar um item específico em logs, auditorias ou suporte;
* Facilitar operações de cache e controle de estado no frontend.

***

### Compatibilidade

* ✅ Alteração **retrocompatível**
* ❌ Nenhum campo existente foi removido ou alterado
* ➕ Apenas a adição do novo atributo `uuid`

Não é necessária nenhuma ação imediata para integrações existentes, a menos que desejem utilizar o novo identificador.

***

### Observações

* O valor do `uuid` é gerado pelo sistema e não deve ser inferido ou construído a partir de outros campos.
* O mesmo `uuid` sempre representará o mesmo item de extrato.

***

Em caso de dúvidas, entre em contato com o time de integração ou consulte a documentação completa da API.