`supplier_goal_attainment`

Meta x realizado por fornecedor · domínio Metas · escopo mcp:goals

O que faz

Atingimento de meta por FORNECEDOR num mês: meta (Σ das metas RCA×fornecedor, nível F), realizado (bruto e líquido), % atingido e nº de RCAs com meta. Use para 'estamos batendo a meta do fornecedor X?'.

Exemplo de pergunta

“estamos batendo a meta do fornecedor X?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.

Parâmetros

Parâmetro	Tipo	Obrigatório	Padrão	Significado
`month`	data (YYYY-MM-DD)	não	—	Mês da meta (YYYY-MM-01); opcional
`top`	integer (1–200)	não	20
`order_by`	string (pct_attained · target_value · realized_value · realized_net_value)	não	pct_attained

O que você recebe

supplier_code — Fornecedor (cód.)
target_value — Meta (R$)
realized_value — Realizado bruto (R$)
realized_net_value — Realizado líquido (R$)
pct_attained — % atingido (bruto)
pct_attained_net — % atingido (líquido)
customers_target — Meta de positivação
reps — Vendedores (qtde)

Cuidados ao ler o resultado

Leia antes de interpretar

Meta do fornecedor = Σ das metas RCA×fornecedor (TIPOMETA='F' — a hierarquia da 8055 reconcilia: Σ F = empresa). O nível é pinado no servidor.
pct_attained usa o realizado BRUTO (convenção 8055); pct_attained_net abate devoluções (atribuídas pela indústria do produto).
Positivação REALIZADA não é somada aqui (clientes compartilhados entre RCAs contariam 2×) — para o realizado de positivação, use o drill por RCA (/v1/goals nível F).

Por trás da ferramenta

Esta ferramenta consulta o endpoint /v1/agg/goals/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.