get_gross_margin_by_branch
Margem bruta por filial · domínio Vendas · escopo mcp:sales
O que faz
Faturamento e margem bruta por filial em um período: valor, margem (R$ e %), NFs e clientes. Use para 'margem por filial' ou 'qual loja teve melhor margem?'.
Exemplo de pergunta
“margem por filial” — 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 | — | |
order_by | string (margin_value · billed_value · margin_pct) | não | margin_value | |
top | integer (1–200) | não | 50 |
O que você recebe
branch_code— Filialbilled_value— Faturado (R$, inclui bonificação)margin_value— Margem (R$)margin_pct— Margem (%)nfs— Notas (qtde)customers— Clientes
Cuidados ao ler o resultado
Leia antes de interpretar
- Margem bruta = receita − custo (CUSTOREAL); margem 'realizada' (8128) é outro produto.
Por trás da ferramenta
Esta ferramenta consulta o endpoint /v1/agg/sales/by-branch 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.