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

[
   {
      "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.