openthorDocumentação

get_mix_penetration

Penetração de mix por cliente (fornecedor) · domínio Trade · escopo mcp:trade

O que faz

Para um fornecedor, quantos SKUs do portfólio cada cliente compra (penetração % e segmento MONO/PARCIAL/ALTO/COMPLETO). Informe supplier_code. Use para 'quais clientes compram pouco do mix do fornecedor X?'.

Exemplo de pergunta

quais clientes compram pouco do mix do fornecedor X?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.

Parâmetros

ParâmetroTipoObrigatórioPadrãoSignificado
supplier_codeintegersim
topinteger (1–1000)não50
order_bystring (penetration_pct · skus_bought · value)nãopenetration_pct

O que você recebe

  • customer_code — Cliente (cód.)
  • supplier_code — Fornecedor (cód.)
  • skus_bought — SKUs comprados
  • registered_skus — SKUs cadastrados
  • penetration_pct — Penetração (%)
  • mix_segment — Segmento de mix
  • value — Faturamento (R$)

Cuidados ao ler o resultado

Leia antes de interpretar
  • Janela de 180 dias. SKUs gêmeos (variantes) deduplicados por produto-pai.
  • Penetração = SKUs comprados ÷ SKUs vendáveis do fornecedor.

Por trás da ferramenta

Esta ferramenta consulta o endpoint /v1/agg/trade/mix-penetration da API REST — as mesmas permissões e o mesmo recorte da sua credencial valem nos dois caminhos.