openthorDocumentação

get_orders_by_rep

Pedidos por vendedor (RCA) · domínio Pedidos · escopo mcp:orders

O que faz

Pedidos por RCA em um período: quantidade, valor total, clientes distintos e pedidos de bonificação. Use para 'quantos pedidos cada vendedor lançou?'.

Exemplo de pergunta

quantos pedidos cada vendedor lançou?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.

Parâmetros

ParâmetroTipoObrigatórioPadrãoSignificado
fromdata (YYYY-MM-DD)não
todata (YYYY-MM-DD)não
supervisor_codeintegernão
topinteger (1–200)não50

O que você recebe

  • rep_code — Vendedor (RCA)
  • orders — Pedidos (qtde)
  • customers — Clientes
  • bonus_orders — Pedidos de bonificação

Cuidados ao ler o resultado

Leia antes de interpretar
  • Entrada de pedido (inclui bonificação), não venda faturada. Quantidades; valor em R$ virá com os itens (fase posterior).

Por trás da ferramenta

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