`GET /v1/agg/trade/white-space`

Lacunas produto × cliente de um fornecedor (white space) — quem ainda não compra o quê. · domínio Trade

Exemplo

cURL

curl -H "Authorization: Bearer ot_live_SEU_TOKEN_AQUI" \
  "https://api.openthor.dev/v1/agg/trade/white-space?supplier_code=123&limit=5"

A autenticação e o formato do envelope { data, meta } são comuns a todos os endpoints — veja Autenticação e Resposta e metadados.

Parâmetros

Este endpoint é uma função: aceita somente os parâmetros abaixo (a sintaxe genérica de filtros não se aplica).

Parâmetro	Tipo	Obrigatório	Padrão	Máximo
`supplier_code` — supplier	int	sim	—	—
`days` — days	int	não	90	180
`n_products` — n_products	int	não	10	15
`n_customers` — n_customers	int	não	10	15

Colunas retornadas

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

Ordenação e paginação

Ordene com sort=coluna (crescente) ou sort=-coluna (decrescente). Colunas ordenáveis: customer_value. Limite padrão 225, máximo 225 linhas por chamada; pagine com offset enquanto meta.has_more for true.

O que sua chave enxerga

O recorte da credencial (filial, vendedor, cliente, fornecedor, janela de datas) é aplicado no servidor e não pode ser ampliado por filtros — dois usuários podem ver totais diferentes no mesmo endpoint, por desenho.

Ferramentas MCP sobre este endpoint

find_trade_white_space — Lacunas de trade (batalha naval produto×cliente)

Esta página ajudou? Conte para a gente — lemos tudo.