Webservice V2
Dashboard

Dashboard

A API expõe os indicadores do painel da sua agência para você montar relatórios próprios. Na V2, o período vai por query params (month, year); sem eles, usa o mês corrente.

Período por query
Informe ?month=05&year=2026. O month vai de 1 a 12 e o year com 4 dígitos.

Resumo do mês

GET /dealer/summary retorna o saldo atual e o total ativado no período.

bash
curl --request GET \
  --url 'https://portal.woo-fi.com/api/webservice/v2/dealer/summary?month=05&year=2026' \
  --header 'Authorization: Bearer {seu-token}'
json
{ "current_balance": 8661.15, "total_activations": 696.12 }

Ativações por status

GET /dealer/activations-by-status agrupa as ativações do período por status, com cor, total e participação:

json
[
  { "status": "Aberto", "color": "#F87315", "total": 3, "percentage": 75 },
  { "status": "Concluído", "color": "#069668", "total": 1, "percentage": 25 }
]

Ranking de vendedores

GET /dealer/top-sellers — os vendedores que mais faturaram:

json
[ { "name": "Seller 1", "total_amount": 380.64 } ]

GET /dealer/top-activations — as maiores ativações, com vendedor e agência:

json
[ { "seller_name": "Seller 1", "dealer_name": "Dealer 1", "total_amount": 356.64 } ]

Vendedores da agência

GET /dealer/sellers lista cada vendedor com vendas e comissão, e a contagem de ativos em meta:

json
{
  "data": [ { "name": "Seller 1", "email": "seller1@email.com", "total_sales_amount": 421.64, "estimated_commission": 42.16 } ],
  "meta": { "total_active_sellers": 2 }
}

Próximos passos