Senior Erp Titulos Consultar

Senior ERP - Titulos (Consultar)

Quando aplicar

• "consultar titulos" / "contas a receber" / "contas a pagar"
• "status de boleto" / "titulo em aberto" / "titulo baixado"
• "extrato financeiro" / "conciliacao" / "inadimplencia"
• "buscar titulos por cliente" / "por periodo" / "por nosso numero"

Contrato de integracao (agnostico de linguagem)

Leia references/REFERENCE.md para a referencia base (autenticacao, headers, seguranca, resiliencia).

Passos

1) Confirmar o recorte do job

• Receber vs pagar.
• Filtros: cliente/fornecedor, periodo, situacao (aberto/baixado/vencido), filial/empresa.
• Campos desejados: valor, vencimento, pagamentos, documento (nosso numero/linha digitavel quando aplicavel).

2) Descobrir endpoint(s) no Portal Senior APIs

• Localizar servicos do modulo ERP/financeiro para consulta de titulos.
• Identificar suporte a filtros e paginacao.

3) Executar consulta com paginacao segura

• Definir limite por pagina e iterar ate completar (ou ate limite acordado).
• Aplicar timeout e retry/backoff para 429/5xx.

4) Normalizar e retornar

• Retornar lista compacta com:
• identificadores do titulo
• parte (cliente/fornecedor) quando aplicavel
• valor, vencimento, situacao/status
• datas relevantes (emissao/baixa) quando existirem
• Agregar totals (ex.: soma em aberto, soma vencida) quando fizer sentido.

5) Cuidados de dados

• Titulos podem conter dados financeiros sensiveis; evitar vazar em logs.
• Se for exportar, mascarar quando solicitado (ex.: documento).

Checklist de entradas

• Contexto de integracao: base_url, tenant (se aplicavel), client_id, token (Bearer)
• Tipo: receber vs pagar
• Filtros: periodo, parte (cliente/fornecedor), situacao/status
• Paginacao: limite por pagina, maximo de paginas (quando necessário)

Exemplo (cURL)

curl -X GET "${SENIOR_BASE_URL}/?tipo=receber&data_ini=&data_fim=&status=aberto&limit=100&page=1" \
  -H "Authorization: Bearer ${SENIOR_ACCESS_TOKEN}" \
  -H "Content-type: application/json" \
  -H "client_id: ${SENIOR_CLIENT_ID}"

Notas:

• Substitua `` pelo caminho do servico encontrado no Portal Senior APIs.
• Ajuste query params conforme a documentacao do endpoint.

Mapa de docs oficiais

• Portal Senior APIs (API Browser): https://api.xplatform.com.br/api-portal/pt-br/node/1
• API Authentication: https://api.xplatform.com.br/api-portal/pt-br/tutoriais/api-authentication
• Guia de API (Senior X Platform): https://dev.senior.com.br/documentacao/guia-de-api/

Exemplos de prompts do usuario

• "Se nao tiver a skill instalada, instale senior-erp-titulos-consultar e liste titulos em aberto por cliente no periodo."
• "Traga os titulos vencidos dos ultimos 30 dias e some o total em atraso."
• "Reconcilie: compare estes pagamentos do banco com os titulos no Senior e destaque divergencias."

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: leonardo-picciani
• Source: leonardo-picciani/senior-erp-agent-skills
• License: MIT

Install and usage instructions live in the source repository linked above.