🌐 Endpoints do Policy Radar Executivo
Endpoints via Gateway (Recomendado)
Base URL: https://csuite.internut.com.br/api/executive/radar
1. KPIs Consolidados
GET /api/executive/radar/kpis?org_id=0&target_month=2025-12-01
Resposta:
{
"org_id": 0,
"target_month": "2025-12-01",
"penetration_empresa_mes": 144,
"penetration_meta_mes": 300,
"sales_value": 29686182.0,
"machines_sold": 9468,
"low_turn_units": 0,
"payout_amount": 23577.84,
"sellers_with_bonus": 12,
"radar_critical_items": 0,
"inbox_rows_today": 908,
"inbox_revendas_today": 435,
"inbox_fit_total": 16362
}
2. Vendedores (Heatmap)
GET /api/executive/radar/sellers?org_id=0&target_month=2025-12-01
Resposta:
{
"items": [
{
"org_id": 0,
"target_month": "2025-12-01",
"vendedor_id": "131",
"target_penetration": 60,
"actual_penetration": 42,
"penetration_pct": 70.0,
"sales_value": 392963.0,
"machines_sold": 123,
"low_turn_units": 0,
"payout_amount": 1964.82
}
]
}
3. Ruptura Top 20
GET /api/executive/radar/rupture?org_id=0
Resposta:
{
"items": [
{
"org_id": 0,
"Produto_ID": 1980324,
"Produto_Modelo": "ZT-781K",
"Estoque_Atual": 0,
"Vendidas_12m": 4,
"Media_Mensal_12m": 0.33,
"Cobertura_Meses": 0.0,
"signal_code": "RUPTURA",
"severity": 5
}
]
}
4. Low-turn Top 20
GET /api/executive/radar/lowturn?org_id=0
Resposta:
{
"items": [
{
"org_id": 0,
"Produto_ID": 35226,
"Produto_Modelo": "YL4834",
"Estoque_Atual": 10,
"Vendidas_12m": 0,
"ultima_entrada_estoque": "2009-05-28",
"Dias_Em_Estoque": 6061,
"severity": 5
}
]
}
5. Inbox do Dia
GET /api/executive/radar/inbox?org_id=0&vendedor_id=131
Resposta:
{
"items": [
{
"org_id": 0,
"vendedor_id": 131,
"campaign_code": "CAMP_LOW_TURN_BUNDLES",
"bundle_title": "Bundle: ZJ-802 + A7100-I (ativar giro)",
"revenda_id": 705016,
"fit_score": 228,
"tier_alvo": "A",
"priority": 10
}
]
}
6. Status de Metas ⭐ NOVO
GET /api/executive/radar/targets-status?org_id=0&target_month=2025-12-01
Resposta:
{
"items": [
{
"org_id": 0,
"target_month": "2025-12-01",
"seller_entity_ref": "107",
"seller_name": "Vendedor 107",
"kpi_code": "PENETRACAO_REVENDAS",
"target_value": 50,
"min_value": 40,
"stretch_value": 60,
"actual_value": 24,
"gap_value": 26,
"pct_atingido": 48.0
}
]
}
7. Evolução da Penetração ⭐ NOVO
GET /api/executive/radar/penetracao-evolucao?org_id=0&months=12
Resposta:
{
"items": [
{
"org_id": 0,
"target_month": "2025-12-01",
"revendas_ativas_mes": 144,
"machines_sold_mes": 802,
"sales_value_mes": 2515953.9
},
{
"org_id": 0,
"target_month": "2025-11-01",
"revendas_ativas_mes": 323,
"machines_sold_mes": 1947,
"sales_value_mes": 6038886.7
}
]
}
8. Radar de Estoque ⭐ NOVO
GET /api/executive/radar/estoque-radar?org_id=0&limit=50&severity_min=4
Resposta:
{
"items": [
{
"org_id": 0,
"Produto_ID": 1979573,
"Produto_Modelo": "B9500-17-ED2",
"Estoque_Atual": 5,
"Vendidas_12m": 0,
"Cobertura_Meses": null,
"ultima_entrada_estoque": "2023-02-22",
"Dias_Em_Estoque": 1043,
"signal_code": "SEM_GIRO",
"severity": 5,
"Acao_Recomendada": "QUEIMAR/REPOSICIONAR"
}
]
}
9. Foco Diário ⭐ NOVO
GET /api/executive/radar/daily-focus?org_id=0&target_month=2025-12-01
Resposta:
{
"items": [
{
"org_id": 0,
"target_month": "2025-12-01",
"seller_entity_ref": "32",
"seller_name": "Vendedor 32",
"target_value": 50,
"actual_value": 12,
"gap_value": 38,
"pct_atingido": 24.0,
"foco_recomendado": "FOCO TOTAL: aumentar penetração (reativar + novos pedidos)",
"revendas_por_dia_necessarias": 38
}
]
}
10. Metas Dinâmicas
GET /api/executive/radar/targets?org_id=0&target_month=2025-12-01
Resposta:
{
"items": [
{
"org_id": 0,
"target_month": "2025-12-01",
"vendedor_id": 131,
"target_penetration": 60,
"revendas_12m": 203,
"revendas_a": 41,
"revendas_b": 61,
"revendas_c": 101,
"weighted_base": 315.5,
"actual_penetration": 42,
"attainment_pen_pct": 70.0
}
]
}
Endpoints Diretos (csuite-context)
Base URL: https://csuite.internut.com.br/context/api/executive/dashboard
Todos os endpoints acima também estão disponíveis diretamente via:
- /context/api/executive/dashboard/kpis
- /context/api/executive/dashboard/sellers
- /context/api/executive/dashboard/rupture
- /context/api/executive/dashboard/lowturn
- /context/api/executive/dashboard/inbox
- /context/api/executive/dashboard/targets-status
- /context/api/executive/dashboard/penetracao-evolucao
- /context/api/executive/dashboard/estoque-radar
- /context/api/executive/dashboard/daily-focus
- /context/api/executive/dashboard/targets
Parâmetros Comuns
org_id(obrigatório): ID da organização (use0para dados padrão)target_month(opcional): Mês alvo no formatoYYYY-MM-01(ex:2025-12-01)vendedor_id/seller(opcional): Filtrar por vendedor específicomonths(opcional): Número de meses para histórico (padrão: 12)limit(opcional): Limite de registros (padrão: 50)severity_min(opcional): Severidade mínima (1-5)
Status Atual
✅ Todos os 9 endpoints estão funcionando e retornando dados reais.
🚀 Upgrade Estratégico - Novos Endpoints (31/12/2025)
Policy Effectiveness (Fechamento de Loop)
GET /api/executive/radar/policy-effectiveness?org_id=0&policy_code=INV_LOW_TURN
Retorna efetividade de políticas baseado em outcomes observados.
Attention Budget (Governança Cognitiva)
GET /api/executive/radar/attention-budget?org_id=0&budget_type=BUNDLE_PER_SELLER_DAY
Status do Attention Budget para evitar overload humano.
Policy Versions (Versionamento)
GET /api/executive/radar/policy-versions?org_id=0&policy_code=INV_LOW_TURN
GET /api/executive/radar/policy-version-comparison?org_id=0&policy_code=INV_LOW_TURN
Histórico e comparação de versões de políticas.
Seller Context (Contexto de Carteira)
GET /api/executive/radar/seller-context?org_id=0&seller_id=131
Contexto completo da carteira do vendedor para metas dinâmicas.
Brand Radar (KPIs por Marca)
GET /api/executive/radar/brand-radar?org_id=0
KPIs consolidados por marca para decisões executivas.
What-if Engine (Simulação)
GET /api/executive/radar/whatif/low-turn-bundle?org_id=0
GET /api/executive/radar/whatif/ruptura-reduction?org_id=0
POST /api/executive/radar/whatif/run-scenario?scenario_id=1&org_id=0
Simulação de cenários futuros.
📄 Documentação completa: docs/ENDPOINTS_UPGRADE_ESTRATEGICO.md
Última atualização: 2025-12-31