find_below_cost_sales
Vendas abaixo do custo (margem negativa) · domínio Vendas · escopo mcp:sales
O que faz
Notas fiscais com margem NEGATIVA em um período (receita < custo). Ordenadas da mais negativa para a menos. Use para 'vendi algo no prejuízo?' ou 'NFs abaixo do custo'.
Exemplo de pergunta
“vendi algo no prejuízo?” — 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–1000) | não | 50 |
O que você recebe
invoice_id— Nº interno da NFbilled_at— Emitida emcustomer_code— Cliente (cód.)rep_code— Vendedor (RCA)revenue_amount— Faturamento (R$)cost_amount— Custo (R$)margin_amount— Margem (R$)
Cuidados ao ler o resultado
Leia antes de interpretar
- Inclui bonificações (is_bonus=true), que são intencionalmente abaixo do custo — confira a coluna is_bonus.
- Margem = receita − custo (CUSTOREAL). Considera a data de faturamento.
Por trás da ferramenta
Esta ferramenta consulta o endpoint /v1/invoices 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.