Liberação: 21/08/2026
#Financeiro

Objetivo da mudança:

O objetivo desta alteração é disponibilizar a liquidação automática de boletos bancários do Banco Santander via “Webhook”, proporcionando maior agilidade e dinamismo ao processo. Com essa implementação, o sistema passa a receber notificações do banco em tempo real assim que os boletos de cobrança são pagos, executando a baixa automática da respectiva duplicata no Contas a Receber, além de realizar a movimentação bancária e os demais lançamentos com base nas regras da baixa de boleto bancário manual. Caso ocorram inconsistências, como valores divergentes ou duplicatas não localizadas, a baixa automática não é efetuada, e as informações são enviadas para uma tela de acompanhamento para tomada de decisão do operador.

Rotinas / Telas:

• Útil > Configuração do Sistema , tela : Configurações do Sistema (frmCfgSistema)
• Principal > Financeiro > Contas a Receber > Relação de Boletos Liquidados – Webhook , tela : Relação de Boletos Liquidados – Webhook (frmRelacaoBoletosLiquidados)
• Principal > Financeiro > Contas a Receber > Manutenção de Contas a Receber , tela : Manutenção Coletiva do Contas a Receber (frmManutColetivaCtaReceber)

Instruções sobre o que configurar:

1. Acessar a tela Configurações do Sistema (frmCfgSistema) em Útil > Configuração do Sistema e definir a CFG_BAIWBK – “UTILIZAR BAIXA AUTOMÁTICA DE BOLETOS BANCÁRIOS – WEBHOOK?” com a opção “Sim” ou “Não”; por padrão, ela é enviada como “Não”;

2. Informar as credenciais de acesso da API na mesma tela de configurações, preenchendo os parâmetros CFG_LOGFNA – “FINANCEIRO SERVICES API – LOGIN”, CFG_SENFNA – “FINANCEIRO SERVICES API – SENHA” e CFG_PORFNA – “FINANCEIRO SERVICES API – PORTA”;

3. Realizar a criação das tabelas “RETBCO_WEBHOOK” e “FNATSK” no banco de dados através dos scripts disponibilizados;

4. Garantir a instalação e execução do serviço “Financeiro Services API”;

5. Certificar-se de que a carteira do cliente esteja cadastrada no formato “CONFIG–“ e o banco de envio esteja preenchido na duplicata;

6. Cadastrar o operador automático configurado em CFG_OPEAUT – “OPERADOR AUTOMATICO” na tela de cadastro de operadores e preencher a empresa autorizada para baixa.

Instruções sobre como utilizar:

1. Após a liquidação do boleto pelo cliente, o Banco Santander envia uma notificação em tempo real para o sistema;

2. O sistema consulta a duplicata através do “Nosso Número” e valida os valores e a data de vencimento;

3. Se a duplicata for localizada e os valores estiverem corretos, a baixa é realizada automaticamente e a mensagem padrão do sistema é enviada ao operador informando a liberação para faturamento;

4. Caso a duplicata não seja localizada ou apresente divergência no valor pago, a baixa não é realizada, e o registro fica disponível na tela “Relação de Boletos Liquidados – Webhook”;

5. Na tela “Relação de Boletos Liquidados – Webhook”, utilizar os filtros de “Status”, “Empresa”, “Cliente”, “Portador” e “Data do Recebimento” para consultar os registros;

6. A tela exibe as colunas “DUPLICATA”, “PARCELA”, “CLIENTE”, “VALOR ORIGINAL”, “VALOR PAGO”, “DTA VEN”, “DTA RECEBIMENTO” e “DIFERENÇA”;

7. Utilizar o botão [F1] para acessar a tela de baixa de contas a receber e efetuar a baixa manual quando necessário;

8. Utilizar o botão [F2] para consultar o histórico da duplicata selecionada.