openthorDocumentação

list_orders

Pedidos (lista) · domínio Pedidos · escopo mcp:orders

O que faz

Lista de pedidos com filtros: período, status (status_code: 1=faturado, 2=bloqueado, 3=pendente, 4=cancelado), RCA, cliente, supervisor. Use para 'mostre os pedidos pendentes do vendedor X'.

Exemplo de pergunta

mostre os pedidos pendentes do vendedor X” — 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
status_codeintegernão1=faturado, 2=bloqueado, 3=pendente, 4=cancelado
rep_codeintegernão
customer_codeintegernão
supervisor_codeintegernão
topinteger (1–1000)não100

O que você recebe

  • order_id — Nº do pedido
  • ordered_at — Data do pedido
  • customer_code — Cliente (cód.)
  • rep_code — Vendedor (RCA)
  • status — Status
  • status_reason — Motivo do status
  • age_days — Idade (dias)

Cuidados ao ler o resultado

Leia antes de interpretar
  • PCPEDC é entrada de pedido (inclui bonificação) — difere de get_top_sales_reps (venda faturada).

Por trás da ferramenta

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