top_debtors
Maiores devedores (inadimplência por cliente) · domínio Financeiro · escopo mcp:financial
O que faz
Clientes com mais valor a receber, vencido e inadimplente (R$). Inadimplência exclui PIX/cartão (atraso de liquidação, não calote — G10). Ordene por overdue_amount ou delinquent_amount. Use para 'quem me deve mais?' ou 'meus maiores inadimplentes'.
Exemplo de pergunta
“quem me deve mais?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Padrão | Significado |
|---|---|---|---|---|
order_by | string (overdue_amount · delinquent_amount · open_amount) | não | overdue_amount | |
top | integer (1–200) | não | 15 |
O que você recebe
customer_code— Cliente (cód.)open_amount— Em aberto (R$)overdue_amount— Vencido (R$)delinquent_amount— Inadimplente (R$)title_count— Títulos (qtde)
Cuidados ao ler o resultado
Leia antes de interpretar
- delinquent_amount exclui PIX/cartão (G10).
- Considera apenas títulos abertos (G11).
Por trás da ferramenta
Esta ferramenta consulta o endpoint /v1/agg/receivables/by-customer 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.