get_returns_by_reason
Devoluções por motivo · domínio Vendas · escopo mcp:sales
O que faz
Devoluções de clientes agrupadas por motivo (pedido em desacordo, produto avariado, cliente sem dinheiro, etc.) — separa falha comercial (RCA-coachável) de falha logística de sinal de crédito. Use para 'por que estamos tendo devolução?' ou 'qual motivo mais pesa no mês'.
Exemplo de pergunta
“por que estamos tendo devolução?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Padrão | Significado |
|---|---|---|---|---|
from | data (YYYY-MM-DD) | sim | — | |
to | data (YYYY-MM-DD) | sim | — | |
top | number | não | — | Quantidade de motivos a retornar (padrão 20). |
O que você recebe
return_value— Devoluções (R$)return_qtyreturn_nfs
Cuidados ao ler o resultado
Leia antes de interpretar
- Sem meta — não existe alvo de devolução no Winthor (nunca fabricado).
- reverses_commission/blocks_customer (core.return_reason) não são projetados aqui — apenas o nome do motivo.
Por trás da ferramenta
Esta ferramenta consulta o endpoint /v1/agg/devolucao/by-motivo da API REST — as mesmas permissões e o mesmo recorte da sua credencial valem nos dois caminhos.
Esta página ajudou? Conte para a gente — lemos tudo.