Retorno dos Boletos via API/WS

🧩 Objetivo

A aba Retornos API tem como função facilitar a identificação e liquidação de boletos bancários que foram pagos no período selecionado, permitindo ao usuário integrar essas informações com as faturas em aberto no sistema. A tela se encontra no Menu Banco -> Retorno de Boletos.

⚙️ Funcionamento

1. Seleção da Conta Bancária

• Campo para selecionar uma conta bancária previamente configurada no sistema.

• Este filtro determina a origem dos dados de liquidação dos boletos consultados.

2. Definição do Período

• O usuário escolhe o intervalo de datas para consulta (ex.: Hoje, Últimos 7 dias, Data personalizada).

• Base temporal usada para buscar os boletos liquidados na API bancária.

3. Consulta de Boletos

• Ao clicar no botão Consultar Boletos, o sistema realiza uma integração com a API do banco vinculado à conta selecionada.

• São retornados e listados na grade os títulos que foram liquidados dentro do período especificado.

4. Listagem dos Títulos

A grade exibe os seguintes dados por boleto liquidado:

• Parceiro

• Nome (no arquivo)

• ID do Boleto

• Nº Documento

• Valor do Título

• Vencimento

• Mora, Multa e Acréscimos

• Valor Pago

• Datas de Ocorrência e Crédito

• Nosso Número, Agência e Conta

• Motivos de ocorrência, tarifas, abatimento, desconto e despesas

Além disso:

• A primeira coluna da grid possui checkboxes, permitindo selecionar múltiplos boletos que permitirá o sistema realizar a liquidação dos titulos localizados.

5. Liquidação das Parcelas

• Após selecionar os boletos desejados, o usuário deve clicar no botão Liquidar Parcelas (F5).

• O sistema irá:

  • Identificar faturas em aberto vinculadas aos boletos selecionados.

  • Atualizar o status de cada parcela, registrando os pagamentos conforme os dados retornados.

  • Gerar movimentações financeiras conforme as regras do sistema.

📌 Observações Técnicas

• Caso possui valores relacionados a tarifas do boleto cobrada pelo banco, será registrar uma despesa no sistema referente as mesmas.

• Os valores recebidos são desmembrados para compor os campos de multa, mora, juros, tarifas, etc.