get_monthly_sales_trend
Tendência de faturamento por período · domínio Vendas · escopo mcp:sales
O que faz
Evolução do faturamento ao longo do tempo, em meses (padrão), semanas ou dias: valor, margem (R$ e %), NFs, clientes e ticket médio por período. Use para 'faturamento mês a mês', 'evolução das vendas' ou 'comparar este mês com o anterior'.
Exemplo de pergunta
“faturamento mês a mês” — 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) |
bucket | string (month · week · day) | não | month | Granularidade da série |
O que você recebe
period— Períodobilled_value— Faturado (R$, inclui bonificação)sale_value— Venda (R$, sem bonificação)margin_value— Margem (R$)margin_pct— Margem (%)nfs— Notas (qtde)customers— Clientesticket_medio— Ticket médio (R$)
Cuidados ao ler o resultado
Leia antes de interpretar
- O período corrente costuma estar parcial (o mês/semana ainda não fechou) — não compare um período incompleto com um fechado.
- Períodos sem venda não aparecem na série (não há linha com R$0).
Por trás da ferramenta
Esta ferramenta consulta o endpoint /v1/agg/sales/by-month 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.