Skip to content

📊 Relatório Analítico de Transações

Gera uma visão consolidada do fluxo financeiro, agrupando dados por categoria, banco e evolução temporal.

Endpoint: GET /backoffice/reports/transactions


📥 Parâmetros de Entrada (Query)

Aceita os mesmos filtros de filtragem do endpoint de Listagem:

  • account_id, type_id, created_by, date_from, date_to.

📤 Retorno de Sucesso (200 OK)

json
{
    "overview": {
        "total_value": 155000.40,
        "total_count": 850
    },
    "by_type": [
        { "type_id": 1, "count": 600, "total_value": 120000.00, "type": { "name": "PIX_IN" } }
    ],
    "by_bank": [
        { "bank_id": 1, "count": 400, "total_value": 80000.00 }
    ],
    "daily_evolution": [
        { "date": "2024-04-19", "total_value": 15000.00, "count": 45 },
        { "date": "2024-04-20", "total_value": 22000.00, "count": 68 }
    ]
}

❌ Erros Comuns

CódigoDescrição
401Não Autorizado: Token ausente ou inválido.
500Erro Interno: Falha ao processar agregação massiva de dados (timeout ou memória).

FastGivr API Documentation