openthorDocumentação

get_positivacao_by_rep

Positivação por vendedor (RCA) · domínio Clientes · escopo mcp:customers

O que faz

Positivação por RCA: clientes positivados no mês corrente sobre a base ativa (12m), com a taxa (%). Use para 'qual a positivação dos vendedores este mês?'.

Exemplo de pergunta

qual a positivação dos vendedores este mês?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.

Parâmetros

ParâmetroTipoObrigatórioPadrãoSignificado
topinteger (1–200)não50
order_bystring (taxa_pct · active_base · positivados)nãotaxa_pct
include_pseudo_repsbooleannãofalse

O que você recebe

  • active_base — Base ativa (12m)
  • positivados — Positivados no mês
  • taxa_pct — Positivação (%)

Cuidados ao ler o resultado

Leia antes de interpretar
  • Base ativa = clientes que compraram nos últimos 12 meses (de PCMOV, não do cadastro CODUSUR1).
  • Positivados = compraram no mês corrente. RCAs pseudo 73/2 excluídos por padrão.

Por trás da ferramenta

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