get_worst_margin_customers
Clientes de pior margem · domínio Vendas · escopo mcp:sales
O que faz
Clientes com a MENOR margem percentual em um período — onde a rentabilidade aperta. Ordenado da pior margem para a melhor. Use para 'onde estou perdendo margem?' ou 'clientes menos rentáveis'.
Exemplo de pergunta
“onde estou perdendo margem?” — 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 |
O que você recebe
customer_code— Cliente (cód.)margin_pct— Margem (%)margin_value— Margem (R$)billed_value— Faturado (R$, inclui bonificação)nfs— Notas (qtde)
Cuidados ao ler o resultado
Leia antes de interpretar
- margin_pct é fração (0–1). Considera apenas clientes com venda no período.
Por trás da ferramenta
Esta ferramenta consulta o endpoint /v1/agg/sales/by-customer 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.