get_realized_net_margin_by_product
Margem realizada líquida por produto (8128) · domínio Vendas · escopo mcp:sales
O que faz
Margem REALIZADA por PRODUTO num período, como a rotina 8128 no grão produto: venda líquida (faturamento − devoluções − ST/FECP), custo líquido e margem %. Use para 'quais produtos do fornecedor X têm a pior margem?' ou 'margem líquida dos meus top produtos'. Para margem NEGATIVA direto, use find_negative_realized_margin.
“quais produtos do fornecedor X têm a pior margem?” — 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 | — | |
supplier_princ | integer | não | — | Fornecedor PRINCIPAL (rollup — opcional) |
branch_code | string | não | — | Filial (ex.: '01') — opcional |
order_by | string (faturamento · margem_liq_pct) | não | faturamento | |
top | integer (1–200) | não | 20 |
O que você recebe
product_code— Produto (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 no grão produto: venda líquida abate devoluções e ST/FECP — não bate com faturamento bruto nem com o net_revenue do get_sales_summary.
- SEM verba: o rebate é NÍVEL-FORNECEDOR e não é rateável por SKU (a própria 8128 não rateia) — margem com verba só em get_realized_net_margin_by_supplier.
- Custo líquido usa o coeficiente 2×FECP da rotina; bonificação carrega custo.
- Produção viva: absolutos oscilam durante o dia; margem % é estável.
Por trás da ferramenta
Esta ferramenta consulta o endpoint /v1/agg/margin/realized/by-product 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.