get_sales_by_supervisor
Vendas por supervisor (equipe) · domínio Vendas · escopo mcp:sales
O que faz
Faturamento por SUPERVISOR em um período — inclui faturamento líquido de devoluções (net_revenue), devoluções, margem, NFs e clientes da equipe. Aceita filtro de fornecedor (fornecedor × supervisor). Use para 'como está a equipe do supervisor X?' ou 'líquido por supervisor'.
Exemplo de pergunta
“como está a equipe do supervisor X?” — 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 | — | |
to | data (YYYY-MM-DD) | sim | — | |
top | integer (1–200) | não | 20 | |
order_by | string (net_revenue · sale_value · billed_value · margin_value · return_value) | não | net_revenue | |
supplier_code | integer | não | — | Opcional: restringe ao fornecedor (indústria) |
O que você recebe
supervisor_code— Supervisorbilled_value— Faturado (R$, inclui bonificação)sale_value— Venda (R$, sem bonificação)net_revenue— Faturamento líquido (R$)return_value— Devoluções (R$)margin_value— Margem (R$)nfs— Notas (qtde)customers— Clientes
Cuidados ao ler o resultado
Leia antes de interpretar
- Atribuição pelo ROSTER ATUAL (PCUSUARI): se um RCA trocou de equipe, o histórico dele conta para o supervisor atual.
- supervisor_code NULO = vendas de RCAs sem supervisor no roster (bucket 'sem supervisor' — honesto, não some).
- A lista de supervisores inclui BUCKETS DE CANAL (ex. CANAL ESPECIAL) — unidades organizacionais, não pessoas.
- net_revenue = vendas − devoluções (sem abater impostos).
Por trás da ferramenta
Esta ferramenta consulta o endpoint /v1/agg/sales/by-supervisor 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.