Relatórios fiscais e unificados
Endpoints que cruzam Pagar.me com dados locais para apuração financeira mensal, com exportação em Excel.
🆕 Motivação: o time financeiro do Baita precisava apurar mensalmente receitas de assinatura e PIX, sem depender de extração manual do painel Pagar.me.
POST /subscription/reports/subscriptions e /reports/pix
Cruzam dados do Pagar.me v5 com Subscription/User/Plan locais. O campo tipoMovimentacao é derivado do status do gateway (Nova Assinatura, Cancelamento, Expiração, Inadimplente, Pagamento Pendente). Suportam filtro por tipo, plano e período; as versões /export geram .xlsx sem paginação, incluindo a coluna "PDV Origem".
POST /subscription/reports/unified
Visão mais completa, unifica em uma única lista:
- 1Cartão: gateway-first (Pagar.me), enriquecido localmente; detecta renovação comparando com a subscription local anterior.
- 2PIX/cash: local-first, casado com a cobrança PIX por subscriptionIdInGateway; paymentType distingue pix/cash via metadata.payment_method.
- 3Pendentes: cobranças PIX no gateway com status 'pending' sem subscription local correspondente.
- 4Falhas: assinaturas de cartão cuja primeira cobrança falhou (sem registro local).
Retorna também counts: { cartao, pix, cash, pendente, falhas }, que provavelmente alimenta cards de resumo no Manager. Datas convertidas para horário de Brasília (toBrasiliaDateTime).
Consumidor de todos: gestores autenticados do Manager (PoliciesGuard + ReadManyPolicyHandler), sempre escopado ao whitelabelId do JWT.