Histórico da Página
...
Informações | ||
---|---|---|
| ||
|
01. VISÃO GERAL
Tela 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.
→ Itaú → Webhook - Para mais detalhes sobre a configuração do Webhook do Itaú Clique aqui.
→ Santander → Webhook - Para mais detalhes sobre a configuração do Webhook do Santander Clique aqui.
Aviso | ||
---|---|---|
| ||
|
...
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):
Aviso | ||
---|---|---|
| ||
|
03. EXEMPLO DE UTILIZAÇÃO
Na execução do Job FINA715 são gravadas tabelas F79 e F7A.
- Para os bancos que possuem API de listagem → API onde é possível consultar eventos de liquidação/baixa de boletos por período:
Banco do Brasil e Itaú.
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.
Totvs custom tabs box | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
|
- Para bancos que não possuem API de listagem:
Banco Santander
Quando o banco não possui API de listagem para consultar baixas de boletos de um período determinado o job FINA715 realizará a consulta de todos os boletos em aberto na base de dados.
É realizada uma query no banco de dados para selecionar todos os boletos em aberto baseados nas tabelas SEA e SE1 e registro a registro é consultada API de consulta de boletos no banco em questão para saber se o boleto foi liquidado. Caso tenha sido liquidado o Protheus efetua a baixa do título.
Utilizando o Ponto de Entrada NGFQRRET é possível restringir a query de consulta para determinar os registros que serão processados e consultados via API, otimizando a quantidade de registros a serem processados.
Se o banco possui Webhook, como o banco Santander:
- 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.
...
Informações | ||
---|---|---|
| ||
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:
...
Este status determina que o detalhe do log (Título) ainda possuí possui erros. Para esse status as ações ficam habilitadas.
...
Deck of Cards | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
|
08. PROCESSAR BAIXAS
Avisoinfo | ||
---|---|---|
| ||
Esta funcionalidade foi liberada está disponível em pacotes acumulados de expedição contínua 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 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
Deck of Cards | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
10. TABELAS UTILIZADAS
- F79 - Log retorno boleto API Cabec.
- F7A - Log retorno boleto API Itens
...