`find_trade_white_space`

Lacunas de trade (batalha naval produto×cliente) · domínio Trade · escopo mcp:trade

O que faz

Onde estão as oportunidades: para um fornecedor, cruza seus produtos mais vendidos com seus melhores clientes e devolve as LACUNAS — um cliente forte que ainda NÃO compra um produto forte. Ordenado pelo valor do cliente (prioridade). Use para 'onde posso vender mais do fornecedor X?' ou 'que produtos faltam na carteira dos meus melhores clientes?'.

Exemplo de pergunta

“onde posso vender mais 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
`supplier_code`	integer	sim	—	Fornecedor (indústria) a analisar — obrigatório
`days`	integer (1–180)	não	90	Janela de venda (dias)
`n_products`	integer (1–15)	não	10	Top N produtos do fornecedor
`n_customers`	integer (1–15)	não	10	Top N clientes

O que você recebe

customer_code — Cliente (cód.)
fantasia — Nome fantasia
rep_code — Vendedor (RCA)
product_code — Produto (cód.)
description — Descrição
customer_value — Valor do cliente (R$)
status — Status

Cuidados ao ler o resultado

Leia antes de interpretar

Cada linha é uma oportunidade (um produto forte que um cliente forte ainda não compra), priorizada pelo valor do cliente.
O top-N é calculado DENTRO da sua carteira e da janela — um RCA vê as lacunas dos próprios clientes.
SKUs gêmeos são deduplicados (CODPRODPRINC). Limites: janela ≤180 dias, N ≤15 produtos/clientes.

Por trás da ferramenta

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