get_top_sales_reps
Top vendedores (RCAs) por período · domínio Vendas · escopo mcp:sales
O que faz
Ranking de vendedores por valor de venda em um período — inclui faturamento líquido de devoluções (net_revenue) e devoluções (return_value) por RCA; valores em R$. Use para 'quem são meus melhores vendedores em maio?' ou 'líquido por vendedor'.
Exemplo de pergunta
“quem são meus melhores vendedores em maio?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Padrão | Significado |
|---|---|---|---|---|
from | data (YYYY-MM-DD) | sim | — | Início do período (YYYY-MM-DD) |
to | data (YYYY-MM-DD) | sim | — | Fim do período (inclusivo) |
top | integer (1–200) | não | 10 | |
order_by | string (sale_value · billed_value · margin_value · net_revenue) | não | sale_value |
O que você recebe
rep_code— Vendedor (RCA)sale_value— Venda (R$, sem bonificação)billed_value— Faturado (R$, inclui bonificação)margin_value— Margem (R$)net_revenue— Faturamento líquido (R$)return_value— Devoluções (R$)
Cuidados ao ler o resultado
Leia antes de interpretar
- billed_value inclui bonificação a preço de tabela; sale_value exclui bonificação.
- net_revenue = vendas − devoluções do RCA (datadas pela devolução), SEM abater impostos.
- Apenas filial ativa.
Por trás da ferramenta
Esta ferramenta consulta o endpoint /v1/agg/sales/by-rep 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.