`get_supervisor_supplier_trend`

Histórico mensal de atingimento por supervisor × fornecedor · domínio Metas · escopo mcp:goals

O que faz

Atingimento de meta por supervisor × fornecedor, mês a mês — para achar quedas de desempenho por equipe. Use para 'como a equipe do supervisor X está performando com o fornecedor Y ao longo dos meses?'.

Exemplo de pergunta

“como a equipe do supervisor X está performando com o fornecedor Y ao longo dos meses?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.

Parâmetros

Parâmetro	Tipo	Obrigatório	Padrão	Significado
`supplier_code`	integer	sim	—	Fornecedor (obrigatório)
`supervisor_code`	integer	não	—	Filtra um supervisor (opcional)
`top`	integer (1–500)	não	100

O que você recebe

supervisor_code — Supervisor
supervisor_name — Nome do supervisor
supplier_code — Fornecedor (cód.)
supplier_name — Fornecedor
period — Período
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
customers_realized — Positivação realizada

Cuidados ao ler o resultado

Leia antes de interpretar

SEM histórico retroativo: o mês mais antigo disponível é o primeiro que fechou depois deste recurso entrar no ar — nunca reconstruído de meses anteriores (o roster atual não reflete quem reportava a quem no passado).
Um mês só aparece depois de fechado por completo (janela de 2 meses de core.goal) — o mês em andamento nunca é mostrado.
pct_attained usa o realizado BRUTO (convenção 8055); pct_attained_net abate devoluções.

Por trás da ferramenta

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