rep_goal_attainment
Meta x realizado por vendedor (RCA) · domínio Metas · escopo mcp:goals
O que faz
Atingimento de meta de venda por vendedor (RCA) num mês: meta, realizado, % atingido e gap. Ordenado do mais ATRASADO para o mais adiantado. Informe o mês (YYYY-MM-01). Use para 'quais vendedores estão abaixo da meta?'.
Exemplo de pergunta
“quais vendedores estão abaixo da meta?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Padrão | Significado |
|---|---|---|---|---|
month | data (YYYY-MM-DD) | não | — | Mês da meta (primeiro dia, YYYY-MM-01) |
top | integer (1–500) | não | 50 |
O que você recebe
period— Períodogoal_level— Nível da metarep_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çãocustomers_realized— Positivação realizada
Cuidados ao ler o resultado
Leia antes de interpretar
- Nível por RCA (TIPOMETA='M') — nunca somar entre níveis (G12a).
- pct_attained usa o realizado BRUTO de devoluções (a convenção do Winthor 8055); pct_attained_net/realized_net_value abatem devoluções — diga qual base está usando.
- customers_target/customers_realized = meta e realizado de POSITIVAÇÃO (clientes distintos compradores no mês, grão movimento).
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.
Esta página ajudou? Conte para a gente — lemos tudo.