openthorDocumentação
Abrir o painel

supervisor_goal_attainment

Meta x realizado por supervisor · domínio Metas · escopo mcp:goals

O que faz

Atingimento de meta por SUPERVISOR num mês (nível SV): meta, realizado (bruto e líquido de devoluções), % atingido e meta/realizado de positivação da equipe. Use para 'quais supervisores estão abaixo da meta?'.

Exemplo de pergunta

“quais supervisores estão abaixo da meta?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.

Parâmetros

ParâmetroTipoObrigatórioPadrãoSignificado
monthdata (YYYY-MM-DD)não—Mês da meta (YYYY-MM-01); opcional
topinteger (1–200)não50

O que você recebe

  • period — Período
  • goal_level — Nível da meta
  • rep_code — Vendedor (RCA)
  • target_value — Meta (R$)
  • realized_value — Realizado bruto (R$)
  • pct_attained — % atingido (bruto)
  • gap_value — Falta para a meta (R$)
  • realized_net_value — Realizado líquido (R$)
  • pct_attained_net — % atingido (líquido)
  • customers_target — Meta de positivação
  • customers_realized — Positivação realizada

Cuidados ao ler o resultado

Leia antes de interpretar
  • Nível supervisor (TIPOMETA='SV'; o código do supervisor vem em owner_code). Nunca somar entre níveis (G12a).
  • pct_attained usa o realizado BRUTO (convenção 8055/CLI-17); pct_attained_net abate devoluções — declare a base.
  • Realizado da equipe = atribuição pelo ROSTER ATUAL (ADR-0023); NULL = roster ainda não sincronizado (estado honesto, não é zero).
  • A lista inclui BUCKETS DE CANAL (ex. CANAL ESPECIAL) — unidades organizacionais, não pessoas.

Por trás da ferramenta

Esta ferramenta consulta o endpoint /v1/goals da API REST — as mesmas permissões e o mesmo recorte da sua credencial valem nos dois caminhos.