`GET /v1/agg/margin/realized/by-supplier`

Margem realizada líquida (rotina 8128) por fornecedor, com e sem verba. · domínio Vendas

Exemplo

cURL

curl -H "Authorization: Bearer ot_live_SEU_TOKEN_AQUI" \
  "https://api.openthor.dev/v1/agg/margin/realized/by-supplier?limit=5"

A autenticação e o formato do envelope { data, meta } são comuns a todos os endpoints — veja Autenticação e Resposta e metadados.

Parâmetros

Este endpoint é uma função: aceita somente os parâmetros abaixo (a sintaxe genérica de filtros não se aplica).

Parâmetro	Tipo	Obrigatório	Padrão	Máximo
`branch_code` — branch	text	não	—	—
`supervisor_code` — supervisor	int	não	—	—
`supplier_princ` — supplier	int	não	—	—

Colunas retornadas

supplier_princ — Fornecedor principal (cód.)
fornecedor — Fornecedor
faturamento — 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 (%)

Ordenação e paginação

Ordene com sort=coluna (crescente) ou sort=-coluna (decrescente). Colunas ordenáveis: faturamento · venda_liq · custo_liq · margem_sv_pct · margem_cv_pct · verba · supplier_princ. Limite padrão 50, máximo 200 linhas por chamada; pagine com offset enquanto meta.has_more for true.

O que sua chave enxerga

O recorte da credencial (filial, vendedor, cliente, fornecedor, janela de datas) é aplicado no servidor e não pode ser ampliado por filtros — dois usuários podem ver totais diferentes no mesmo endpoint, por desenho.

Ferramentas MCP sobre este endpoint

get_realized_net_margin_by_supplier — Margem realizada líquida por fornecedor (8128)

Esta página ajudou? Conte para a gente — lemos tudo.