• Baixas Títulos (Retorno Bancário) por API via job FINA715 para o Banco do Brasil foi disponibilizado no pacote de expedição contínua com data igual ou superior a 23/01/2023 para as releases 12.1.33 e posteriores.

  • Webhook para o Banco do Brasil disponível a partir da versão 12.1.2310 do Protheus. 


01. VISÃO GERAL

         Rotina para visualização dos logs das baixas de títulos por API, gerados via job FINA715 ou via Webhook.


         FINA715 x Webhook

         - Ao executar o Job FINA715, o Protheus inicia a comunicação com o banco solicitando informações de eventos de baixa de boletos.

         - Ao configurar o Webhook é o banco que inicia a comunicação com o Protheus, enviando informações de eventos de baixa de boletos.

            Para o Protheus receber as informações enviadas pelo banco via Webhook é necessário um serviço REST habilitado no Protheus e disponibilizado para o banco.

                  → Banco do Brasil → Webhook -  Para mais detalhes sobre a configuração do Webhook do Banco do Brasil Clique aqui.


  • As tabelas F79 e F7A devem possuir o mesmo compartilhamento, caso contrario não será possível executar o JOB - FINA715.
  • Para que seja acessível essa nova opção no novo gestor financeiro se faz necessário a existência do campo F79_ESTCOB

02. PRÉ-CONDIÇÃO

1) Necessita que seja configurado o Job FINA715 para alimentar os Logs das Baixas Títulos, caso não configurado será exibida um mensagem de alerta encaminhando o usuário para Configuração dos Jobs de boletos.

      2) Em Configurações de contas, editar a conta desejada e configurar o Baixa de Títulos (Retorno):

      Configurar conforme desejado:


      Endereço (URL) de call-back do webhook

      Preencher para utilização do Webhook.

      Ao informar este campo o job FINA715 não será executado para esta conta.


      Salvar Alterações:

      3) Na rotina Parâmetro de Banco (FINA130), preencher com a opção 4=Recebimento on-line no campo Ret. Automat. (EE_RETAUT) para indicar a subconta a ser utilizada para Baixa de Títulos (Retorno):

  • Opção 4=Recebimento on-line para o campo EE_RETAUT disponível a partir da primeira expedição contínua de janeiro de 2023.


03. EXEMPLO DE UTILIZAÇÃO

Nessa tela podemos acompanhar todos os processamentos de retorno bancário realizados por API, onde é possível visualizar quantidade de títulos baixados e não baixados e o por qual motivo não ocorreu a baixa.

Para cada execução com sucesso do Job FINA715 será atualizado o título da tela com data e hora da execução.


04. PESQUISAR

Encontre qualquer registro dos logs utilizando o campo Pesquisar.

05. BUSCA AVANÇADA

Para encontrar dados mais específicos, utilize a opção de busca avançada.

06. DETALHES

Para cada log na grid, é possível expandir os detalhes (Títulos) que o compõe. Clique na seta localizada no inicio da linha do log que deseja expandir e serão exibidos os dados referentes a esse log.

STATUS

O Status determina a situação do detalhe do Log (Título), onde podemos possuir dois valores:

RESOLVIDO

Este status determina que o detalhe do log (Título) foi corrigido. Para esse status as ações ficam desabilitadas.

PENDENTE

Este status determina que o detalhe do log (Título) ainda possuí erros. Para esse status as ações ficam habilitadas. 

07. AÇÕES DOS DETALHES

Para cada detalhe na grid, é possível saber mais informações sobre Detalhes do Erro ou também Marcar como resolvido.

Exibe os detalhes erros de um detalhe do Log (Título) que não foi baixado por algum motivo.

Marca o registro do como resolvido e altera o status.


08. PROCESSAR BAIXAS

Esta funcionalidade foi liberada em pacotes acumulados com data igual ou superior a 14/04/2023.

Através dessa funcionalidade é possível realizar a comunicação online com o banco, e baixar os títulos a receber no ERP sem a necessidade do job (FINA715).

Todo o processamento ira ocorrer de forma assíncrona, ou seja, o ERP não irá aguardar a finalização, permitindo a navegação livre do usuário.




09. TABELAS UTILIZADAS