Árvore de páginas

Versões comparadas

Chave

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

...

Informações
titleAtenção para os Retorno Bancários
  • Baixas de 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.

Image Removed

  • Webhook para o Banco do Brasil disponível a partir da versão 12.1.2310 do Protheus ou Appserver igual ou superior a 20.3.1.4.
  • Baixas de Títulos (Retorno Bancário) por API via job FINA715 eWebhook para o Itaú estão em fase de piloto, ainda não estão disponíveis.

01. VISÃO GERAL

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

...

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

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


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

...

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.

Image RemovedImage Added

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

      Configurar conforme desejado:.

Image Removed

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

Image RemovedImage Added


      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 Modified


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.

...

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


Os demais códigos disponibilizados pelo Banco do Brasil atualmente não são consultados, portanto, não são tratados pelo Protheus. A saber:

01 - NORMAL

02 - MOVIMENTO CARTORIO

03 - EM CARTORIO

04 - TITULO COM OCORRENCIA DE CARTORIO

08 - TITULO COM PENDENCIA DE CARTORIO

10 - TITULO BAIXADO/PAGO EM CARTORIO

11 - TITULO LIQUIDADO/PROTESTADO

12 - TITULO LIQUID/PGCRTO

13 - TITULO PROTESTADO AGUARDANDO BAIXA

14 - TITULO EM LIQUIDACAO

15 - TITULO AGENDADO

16 - TITULO CREDITADO

17 - PAGO EM CHEQUE - AGUARD.LIQUIDACAO

18 - PAGO PARCIALMENTE CREDITADO

80 - EM PROCESSAMENTO (ESTADO TRANSITÓRIO)


Informações
titleOutros valores recebidos

 Caso a API retorne valores na tag "valorOutroRecebido" o mesmo será somado aos juros do título no movimento de baixa. 

Totvs custom tabs box items
defaultno
referenciaItau
Aviso
titleFluxo em processo de pilotos
  • O fluxo de retorno para o processamento das baixas com o banco Itaú está em processo de piloto, sendo assim, ainda NÃO está liberado para uso!

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.


Atenção→ A API do Banco Itaú não possui informacão de data de crédito. A data de crédito para retorno será considerada a data do pagamento + A6_RETENCA, sempre levando em consideração datas válidas. É possível manipular a data de crédito pelo Ponto de Entrada NGFDTDIS.


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

Obs: 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, somente haverá . Haverá filtro de filial somente nos títulos exibidos no detalhe, respeitando as filiais que o usuário tem acesso no títulos que serão listados.

...

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. 

Image Added


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.

...

Encontre qualquer registro dos logs utilizando o campo Pesquisar.

Image RemovedImage Added

05. BUSCA AVANÇADA

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

Image RemovedImage RemovedImage Added

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.

Image Removed

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
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 RemovedImage Added

Card
idpasso2
labelMarcar como Resolvido

Marca o registro do como resolvido e altera o status.

Image RemovedImage RemovedImage Added


08. PROCESSAR BAIXAS

Image Removed

Informações
Aviso
titleImportante

Esta funcionalidade foi liberada está disponível em pacotes acumulados de expedição contínua com data igual ou superior a 14/04/2023.

Image Added

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
effectDuration2
historyfalse
idbaixas
effectTypeslide
Card
id033
labelRelease 12.1.033 e anteriores

Através do relatório de

...

Relação de baixas

...

(FINR190

...

) é possível listar todas as baixas realizadas pelo job (FINA715).

O histórico padrão gravado nos movimentos de baixa é "Baixa por processo automático (API)" e a origem do movimento FINA715 (E5_ORIGEM), sendo possível criar layout personalizado com o filtro de origem para exibição das baixas via APIs.

Card
defaulttrue
id2310
labelRelease 12.1.2310 e posteriores

Através dos recursos disponíveis no smart view Relação de baixas (FINSV010) é possível listar todas as baixas realizadas pelo job (FINA715).

O histórico padrão gravado nos movimentos de baixa é "Baixa por processo automático (API)" e a origem do movimento FINA715 (E5_ORIGEM).

Mais informações: Smart View - Relação de Baixas

10. TABELAS UTILIZADAS

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

...