get_supplier_penetration_scorecard
Scorecard de penetração por fornecedor · domínio Trade · escopo mcp:trade
O que faz
Por fornecedor: SKUs cadastrados (portfólio vendável) vs vendidos, a penetração (%), nº de clientes e valor (180 dias). Use para 'qual fornecedor tem mais portfólio sem girar?'.
Exemplo de pergunta
“qual fornecedor tem mais portfólio sem girar?” — 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 | não | — | Filtra um fornecedor (opcional) |
top | integer (1–500) | não | 50 | |
order_by | string (penetration_pct · sold_skus · value · customers) | não | value |
O que você recebe
supplier_code— Fornecedor (cód.)registered_skus— SKUs cadastradossold_skus— SKUs vendidospenetration_pct— Penetração (%)customers— Clientesvalue— Faturamento (R$)
Cuidados ao ler o resultado
Leia antes de interpretar
- Cadastrados = PCPRODFILIAL vendáveis (238), não OBS2='FL'. Janela de venda 180 dias. Gêmeos deduplicados.
Por trás da ferramenta
Esta ferramenta consulta o endpoint /v1/agg/trade/penetration-scorecard 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.