Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


Índice

...

titleAtenção para os Retorno Bancários

...

01

...

Image Removed

...

.

...

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 BrasilWebhook -  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
titleImportante
  • As tabelas F79 e F7A devem possuir o mesmo compartilhamento, caso contrario não será possível executar o JOB - FINA715FINA718.
  • 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

...

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

Image Removed

...

  1. Em Configurações de contas (Configuração de Contas (Pagar e Receber) - FINA710), editar a conta desejada e configurar

...

Image Removed

      Configurar conforme desejado:

Image Removed

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

      Preencher para utilização do Webhook.

      Salvar Alterações:

Image Removed

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

Image Removed

Aviso
titleImportante
  • 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

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
tabsBanco do Brasil, Itaú
idsBB,Itau
Totvs custom tabs box items
defaultyes
referenciaBB

Para o Banco do Brasil são requisitados pelos códigos de estado de cobrança definidos pelo BB:

06 - LIQUIDADO Pagamento realizado → Job realizará a baixa no Protheus via execauto do FINA070.

07 - BAIXADO → (Cancelado), por exemplo: não foi pago até a data limite máxima de recebimento e o banco deu baixa no boleto → Job realizará a transferência desse título no Protheus para a situação de cobrança 0 -> Carteira removendo do borderô via execauto do FINA060.

05 e 09 - PROTESTADO ELETRONICO e TITULO PROTESTADO MANUAL → banco colocou em protesto → Job realizará a transferência desse título no Protheus para a situação definida na Configuração de Contas deste banco, tendo como padrão transferir para a carteira F → CARTEIRA PROTESTO via execauto do FINA060.

Totvs custom tabs box items
defaultno
referenciaItau

Para o Itaú são requisitados por API as situações:

LIQUIDADO Pagamento realizado → Job realizará a baixa no Protheus via execauto do FINA070.

BAIXADO → (Cancelado), será realizada a transferência desse título no Protheus para a situação de cobrança 0 -> Carteira removendo do borderô via execauto do FINA060.

PROTESTADO → banco colocou em protesto → Job realizará a transferência desse título no Protheus para a situação definida na Configuração de Contas deste banco, tendo como padrão transferir para a carteira F → CARTEIRA PROTESTO via execauto do FINA060.

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.

...

  1. /habilitar o retorno automático.

03. EXEMPLO DE UTILIZAÇÃO

  1. Ao realizar o acesso ao Protheus, utilizando o modulo Financeiro, deverá ser acessado o menu Atualizações → Gestão Financeira → Novo Gestor Financeiro
  2. 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):
  3. 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
titleImportante

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.


Image Removed

Informações
titleJOB FINA715

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

Image Removed

04. PESQUISAR

Encontre qualquer registro dos logs utilizando o campo Pesquisar.

Image Removed

05. BUSCA AVANÇADA

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

Image RemovedImage Removed

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.

Image Removed

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 -

RESOLVIDO

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

Image Removed

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
startHiddenfalse
idAções
Card
idpasso1
labelDetalhes do erro

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

Image Removed

(F7A_ERREXE)

Aviso
titleImportante
Esta funcionalidade foi liberada em pacotes acumulados com data igual ou superior a 14/04/2023
Card
idpasso2
labelMarcar como Resolvido

Marca o registro do como resolvido e altera o status.

Image RemovedImage Removed

08. PROCESSAR BAIXAS

Image Removed

.

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.

(F7A_STATUS)


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  

...