openthorDocumentação

get_receivables_by_rep

Contas a receber por vendedor (RCA) · domínio Financeiro · escopo mcp:financial

O que faz

Exposição de contas a receber (em aberto, vencido, inadimplente) por vendedor (RCA), com Média Atraso e % de títulos inadimplentes. Use para 'quais dos meus vendedores carregam a carteira vencida?'.

Exemplo de pergunta

quais dos meus vendedores carregam a carteira vencida?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.

Parâmetros

ParâmetroTipoObrigatórioPadrãoSignificado
order_bystring (overdue_amount · delinquent_amount · open_amount · avg_days_overdue)nãooverdue_amount
topinteger (1–200)não50

O que você recebe

  • rep_code — Vendedor (RCA)
  • open_amount — Em aberto (R$)
  • overdue_amount — Vencido (R$)
  • delinquent_amount — Inadimplente (R$)
  • title_count — Títulos (qtde)
  • avg_days_overdue
  • delinquent_share

Cuidados ao ler o resultado

Leia antes de interpretar
  • Inadimplência exclui PIX/cartão (atraso de liquidação, não calote — G10).
  • Nome do vendedor resolvido do cadastro de RCAs, não vem do view de recebíveis.

Por trás da ferramenta

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