get_realized_net_margin_by_supplier
Margem realizada líquida por fornecedor (8128) · domínio Vendas · escopo mcp:sales
O que faz
Margem REALIZADA por fornecedor principal num período, como a rotina 8128 do Winthor: venda líquida (faturamento − devoluções − ST/FECP), custo líquido e margem % SEM e COM verba (rebate do fornecedor). Use para 'qual a margem real do fornecedor X em junho?' ou 'ranking de margem líquida por fornecedor'.
“qual a margem real do fornecedor X em junho?” — 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 |
supervisor_code | integer | não | — | Supervisor (atribuição da TRANSAÇÃO — opcional) |
top | integer (1–200) | não | 50 |
O que você recebe
supplier_princ— Fornecedor principal (cód.)fornecedor— Fornecedorfaturamento— Faturamento (R$)venda_liq— Venda líquida (R$)custo_liq— Custo líquido (R$)verba— Verba (R$)margem_sv_pct— Margem sem verba (%)margem_cv_pct— Margem com verba (%)
Cuidados ao ler o resultado
- Base 8128: venda líquida = faturamento − devoluções − ST/FECP — NÃO bate com o net_revenue/faturamento líquido do get_sales_summary (que não abate impostos) nem com margem bruta.
- Custo líquido = ΣVLCUSTOFINB − ΣICMSRETIDO − ΣCMVdevol − 2×ΣVLFECP − ΣFECPdevol (fórmula da rotina; bonificação carrega custo).
- verba/margem_cv_pct = rebate NÍVEL-FORNECEDOR: vêm NULOS (omissão explícita) sob chave com row_scope de vendedor/cliente ou com filtro de supervisor — a verba não acompanha esses cortes.
- supervisor_code = atribuição no MOMENTO da transação (CODSUPERVMOV) — difere do roster atual usado em get_sales_by_supervisor.
- Produção viva: absolutos oscilam durante o dia; margem % é estável. Devolução avulsa cancelada após a ingestão pode deixar resíduo (declarado).
Por trás da ferramenta
Esta ferramenta consulta o endpoint /v1/agg/margin/realized/by-supplier 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.