Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Revertida da versão 44

...

Informações
titleAtenção para os Retorno Bancários
  • Baixas 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.
  • 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 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.Baixas Títulos (Retorno Bancário) por API via job FINA715 eWebhook para o Santander 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.

         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.

                  → Santander → Webhook e Job FINA715-  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

02. PRÉ-CONDIÇÃO

1) Necessita que seja configurado o Job FINA715 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

      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.

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.

...

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.

Índice

...

titleAtenção para os Retorno Bancários

...

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

02. PRÉ-CONDIÇÃO

1) Necessita que seja configurado o Job FINA715 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 Modified

      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.

Image Modified


      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.


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.

, Santander,Santander
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.

...