Reporting

O Reporting agrega dados de vários domínios (pagamentos, transferências, pedidos, viagens, recebíveis) para alimentar dashboards.

Todos os valores monetários são retornados em centavos. A receita é sempre líquida (net) — o valor efetivamente recebido após taxas.

Tipos de relatório

Insights (cards de filtro)

Resumos numéricos exibidos acima das listas filtráveis.

Relatório	Campos principais
Payments	`received`, `pending`, `refunded`, `averageTicket`
Transfers	`transferred`, `processing`, `pending`, `failed`
Trips	`scheduled`, `inProgress`, `disrupted`, `occupancyRate`
Orders	`paid`, `pending`, `canceled`, `averageValue`

Overviews (cards principais)

Relatório	Campos principais
Organization overview	`tripsScheduledToday`, `availableSeats`, `pendingReservations`, `ticketsSoldToday/Yesterday`, `revenueToday/Yesterday`
Platform overview	`transactedVolume`, `revenue`, `pendingTransfers`, `activeOrganizations`

Séries e rankings (gráficos)

Relatório	Descrição
Sales series	Vendas líquidas diárias (`date`, `total`).
Revenue & commission series	Volume transacionado e receita líquida da plataforma por dia.
Occupancy by route	Ocupação por rota (`seatsSold`, `capacity`, `occupancyRate`).
Top organizations	Organizações por receita (ranking).
Trip review trends	Série e rankings de avaliações (`summary`, `series`, `drivers`, `transportOperators`).

Escopo: ops vs bko

ops — relatórios da própria organização.
bko — relatórios da plataforma (todas as organizações).

Capacidades — ops

Autenticação ops, todos com escopo de organização.

Capacidade	Permissão	Descrição
Organization overview	`read:payment`	Visão operacional da organização.
Sales series	`read:payment`	Vendas líquidas diárias.
Occupancy by route	`read:trip`	Ocupação por rota.
Payment insights	`read:payment`	Insights de pagamentos.
Transfer insights	`read:transfer`	Insights de transferências.
Trip insights	`read:trip`	Insights de viagens.
Order insights	`read:order`	Insights de pedidos.
Trip review trends	`read:trip`	Tendências de avaliações por período, motorista e permissionário.

Trip review trends

Endpoint OPS:

GET /api/v1/ops/reports/trip-reviews

Filtros:

Query	Uso
`range`	Período de criação da avaliação.
`groupBy`	Agrupamento da série: `day`, `week` ou `month`.
`cooperativeId`	Filtra por cooperativa.
`transportOperatorId`	Filtra por permissionário avaliado.
`driverId`	Filtra por motorista avaliado.
`rating`	Filtra por intervalo de nota, por exemplo `<=2`.
`moderationStatus`	Filtra por `VISIBLE`, `FLAGGED` ou `HIDDEN`.
`limit`	Limite para rankings de motoristas e permissionários.

Resposta:

Campo	Uso
`summary`	Totais e médias do período.
`series`	Pontos temporais para gráfico.
`drivers`	Ranking de motoristas por média e volume.
`transportOperators`	Ranking de permissionários por média, volume e respostas.

Regras:

Tendências de avaliações usam TripReview.
moderationStatus permite incluir, separar ou excluir avaliações com comentários moderados.
Notas continuam disponíveis para análise interna mesmo quando comentários públicos estão HIDDEN.
respondedCount mede respostas oficiais da cooperativa na própria avaliação.
SupportCase não entra na média da avaliação; ele cobre apenas a tratativa privada.

Capacidades — bko

Autenticação bko, escopo da plataforma.

Capacidade	Permissão	Descrição
Platform overview	`read:payment`	Visão consolidada da plataforma.
Revenue series	`read:payment`	Série de receita e comissão.
Top organizations	`read:receivable`	Organizações por receita.
Payment insights	`read:payment`	Insights de pagamentos.
Transfer insights	`read:transfer`	Insights de transferências.
Order insights	`read:order`	Insights de pedidos.

Cada relatório é protegido pela permissão correspondente ao dado consultado (read:payment, read:transfer, read:order, read:trip, read:receivable).

Visão geral

Authorization

Benefits

Billing

Communication

Credit Grant

Export

Fleet

Identity

Observability

Operations

Platform

Sales

Support

Tenant

Tipos de relatório

Insights (cards de filtro)

Overviews (cards principais)

Séries e rankings (gráficos)

Escopo: ops vs bko

Capacidades — ops

Trip review trends

Capacidades — bko

​Tipos de relatório

​Insights (cards de filtro)

​Overviews (cards principais)

​Séries e rankings (gráficos)

​Escopo: ops vs bko

​Capacidades — ops

​Trip review trends

​Capacidades — bko

Tipos de relatório

Insights (cards de filtro)

Overviews (cards principais)

Séries e rankings (gráficos)

Escopo: ops vs bko

Capacidades — ops

Trip review trends

Capacidades — bko