find_negative_realized_margin
Produtos com margem realizada NEGATIVA (caça-prejuízo 8128) · domínio Vendas · escopo mcp:sales
O que faz
Produtos cuja margem líquida REALIZADA (rotina 8128) ficou ABAIXO de um limiar no período — por padrão, abaixo de 0% (prejuízo real: vendeu, devolveu ou custou mais do que a venda líquida). Ordenado da pior margem para a menos ruim. Use para 'onde estou perdendo dinheiro?' ou 'produtos no vermelho em junho'.
“onde estou perdendo dinheiro?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.
A margem realizada (rotina 8128) depende de objetos específicos do seu Winthor — disponível conforme a configuração do seu ambiente.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Padrão | Significado |
|---|---|---|---|---|
from | data (YYYY-MM-DD) | sim | — | |
to | data (YYYY-MM-DD) | sim | — | |
threshold | integer (…–100) | não | 0 | Limiar de margem % (padrão 0 = só negativas) |
supplier_princ | integer | não | — | Fornecedor PRINCIPAL (opcional) |
branch_code | string | não | — | Filial (opcional) |
top | integer (1–200) | não | 20 |
O que você recebe
product_code— Produto (cód.)descricao— Descriçãosupplier_princ— Fornecedor principal (cód.)faturamento— Faturamento (R$)venda_liq— Venda líquida (R$)custo_liq— Custo líquido (R$)margem_liq_pct— Margem líquida (%)
Cuidados ao ler o resultado
- Base 8128 (venda líquida s/ ST-FECP; custo com 2×FECP e bonificação) — a margem oficial, não a bruta.
- SEM verba (nível-fornecedor): um produto negativo pode ser compensado pela verba do fornecedor — confira em get_realized_net_margin_by_supplier.
- Margem negativa persistente = preço/custo/devolução para investigar; cruzando com a margem de CADASTRO (get_catalog_margin_quality) dá o diagnóstico completo.
Por trás da ferramenta
Esta ferramenta consulta o endpoint /v1/margin/realized/below-threshold 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.