Baixas Títulos (Retorno) - FINA710

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.

02. PRÉ-CONDIÇÃO

1) Necessita que seja configurado o Job FINA715 para alimentar os Logs das Baixas de 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.

      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):

03. EXEMPLO DE UTILIZAÇÃO

Na execução do Job FINA715 são gravadas tabelas F79 e F7A.

•      Banco do Brasil

     O Job irá requisitar ao banco boletos liquidados(realizado pagamento), baixados(não foi realizado pagamento e o banco deu baixa automaticamente) e protestados no período determinado do parâmetro MV_FNGDTBX até o dia atual, ou do dia anterior até o dia atual caso não informado o parâmetro.

- Caso o banco em questão possua webhook e o pagamento é feito com código de barras, o boleto ainda não pode ser considerado liquidado, é considerado como Baixa Operacional. (Em alguns casos pode ser cancelado ou estornado ao longo do dia pelo banco). 

          - Nesse caso é gravada tabela F79 no Protheus com os dados que o banco envia e retornado status ok para o banco.

          - Esse registro da tabela F79 que foi gravado pelo Webhook será processado pelo Job FINA715, que irá realizar a consulta desse boleto no banco para verificar se o boleto foi liquidado.

          - Caso o boleto ainda não tenha sido liquidado, o registro da F79 continua ativo para uma próxima execução do Job FINA715.

          - Caso o boleto tenha sido liquidado, o Protheus efetua a baixa do título.

Obs: Caso não exista nenhuma ocorrência de baixas/transferência/protesto no período requisitado ao banco, não será gravada F79 nem F7A, somente atualizado o parâmetro MV_FNGDTBX com a última execução do job que é mostrado em tela ao lado do título da rotina.

Nessa tela abaixo podemos acompanhar 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.

Na tela só é mostrado os processamentos com algum erro na requisição ao banco ou erro no processamento de baixa/transferência do título.

O cabeçalho do log (F79) será mostrado independente da filial em que o mesmo foi gerado. Haverá filtro de filial somente nos títulos exibidos no detalhe, respeitando as filiais que o usuário tem acesso e a seleção de filiais da rotina NGF. Neste caso, o sistema considera o campo F7A_FILTIT para realizar a verificação do acesso para exibição ou não do registro no monitor, ou seja, o campo F7A_FILIAL não será considerado neste cenário. Portanto em um caso onde o título não é localizado (exemplo de um título já excluído no Protheus), o sistema irá exibir esse registro para todos os usuários que possuam acesso a rotina, já que não foi possível identificar a filial de origem do título. 

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 possui 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.

08. PROCESSAR BAIXAS

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 irá 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. RELAÇÃO DE BAIXAS

10. TABELAS UTILIZADAS

• F79 - Log retorno boleto API Cabec.  
• F7A - Log retorno boleto API Itens