Histórico da Página
Índice |
---|
...
title | Atenção para os Retorno Bancários |
---|
...
01
...
...
.
...
VISÃO GERAL
...
Rotina para visualização
...
das falhas ao baixar um titulo a pagar que teve seu pagamento transmitido por API, todas as informações serão geradas através do job FINA718 (Job de retorno dos pagamentos - FINA718)
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.
Aviso | ||
---|---|---|
| ||
|
02. PRÉ-CONDIÇÃO
...
- Necessita que seja configurado o Job
...
- FINA718 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.
...
- Em Configurações de contas (Configuração de Contas (Pagar e Receber) - FINA710), editar a conta desejada e configurar
...
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.
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 | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
|
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.
...
- /habilitar o retorno automático.
03. EXEMPLO DE UTILIZAÇÃO
- Ao realizar o acesso ao Protheus, utilizando o modulo Financeiro, deverá ser acessado o menu Atualizações → Gestão Financeira → Novo Gestor Financeiro
- Assim que acessado o sub menu Novo Gestor Financeiro, será necessário clicar no menu Comunicação bancaria (online) → Contas a pagar → Log Retorno (Baixas):
- Será mostrado uma browse contendo as baixas que não deram certo no ERP.
Descrição das colunas:
- Banco - Banco oficial previamente configurado no cadastro de bancos (A6_BCOOFI)
- Agência - Agencia do banco (A6_AGENCIA)
- Nro Conta - Numero da conta do banco (A6_NUMCON)
- Dt. Proces - Data do processamento (F79_DTPROC)
- Hr. Proces - Hora do processamento (F79_HRPROC)
- Qtde. Títulos - Quantidade de títulos que fazem parte do processo (F79_QTDTIT)
- Qtde. Process - Quantidade de títulos que foram processados (F79_QTPROC)
- Qtde. Process - Quantidade de títulos que tiveram algum tipo de falha durante o processamento (F79_NBAIXA)
- Processo - Sempre terá o conteúdo igual a BAIXA.
Aviso | ||
---|---|---|
| ||
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 |
...
Novo Gestor Financeiro. |
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, processamento é 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
...
títulos que tiveram algum tipo de falha durante o processamento.
Descrição das colunas:
- Status - Determina a situação do detalhe do Log (Título), onde podemos possuir dois valores:
...
- (F7A_STATUS)
- Resolvido -
- (F7A_STATUS)
RESOLVIDO
- Este status determina que o detalhe do log (Título) foi corrigido. Para esse status as ações ficam desabilitadas.
PENDENTE
- Pendente - Este status determina que o detalhe do log (Título) ainda possuí erros. Para esse status as ações ficam habilitadas.
- Filial - Filial de origem do titulo (F7A_FILORI)
- Prefixo - Prefixo do titulo (F7A_PREFIX)
- Nro. Titulo
...
- - Numero do titulo (F7A_NUMERO)
- Parcela - Parcela do titulo (F7A_PARCEL)
- Tipo - Tipo do titulo (F7A_TIPO)
- Fornecedor - Fornecedor informado no titulo (F7A_FORNEC)
- Loja - Loja do fornecedor (F7A_LOJA)
- Dt Emiss - Data de emissão do titulo (F7A_EMISSA)
- Vlr. Titulo - Valor do titulo que foi enviado ao banco (F7A_VALOR)
- Vlr. Multa - Valor da multa que foi enviado ao banco (F7A_MULTA)
- Vlr. Juros - Valor do juros que foi enviado ao banco (F7A_JUROS)
- Vlr. Desconto - Valor do desconto que foi enviado ao banco (F7A_DESCON)
...
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.
Deck of Cards | |||||||
---|---|---|---|---|---|---|---|
| |||||||
| |||||||
Aviso | |||||||
| |||||||
Esta funcionalidade foi liberada em pacotes acumulados com data igual ou superior a 14/04/2023
|
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 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. RELAÇÃO DE BAIXA
Através do relatório de "Relação de baixas - FINR190" é possível listar todas as baixas realizadas pelo job (FINA715FINA718).
O histórico padrão gravado nos movimentos de baixa é "Baixa por processo automático(API)" e a origem do movimento FINA715 FINA718 (E5_ORIGEM), sendo possível criar layout personalizado com o filtro de origem para exibição das baixas via APIs API's.
10. TABELAS UTILIZADAS
- F79 - Log retorno boleto API Cabec.
- F7A - Log retorno boleto API Itens
...