01. VISÃO GERAL

Configurações necessárias para habilitar os jobs de transmissão e retorno de títulos por API.

02. PRÉ-CONDIÇÕES

03. JOBS 

A configuração dos jobs deve ser única por Grupo de Empresas. sendo necessário cadastrar apenas um agendamento para uma filial.

Exemplo:

Empresa T1

Filiais: D MG 01 , D MG 02 , D RJ 01 , D RJ 02 , D SP 01 , D SP 02

Apenas 1 cadastro de agendamento no schedule para 1 Empresa/Filial para que o schedule execute apenas 1 chamada e fique a cargo do job executar para o grupo de empresas todo.

Empresa/Filial = T1/D MG 01 ;    → Correto

Empresa/Filial = T1/D MG 01 ;T1/D MG 02 ;T1/D RJ 01 ;    → Incorreto

Empresa/Filial = T1;    → Incorreto  → schedule executa chamada para todas as filiais.


O Job FINA713 é responsável pela transmissão do títulos e envio de boletos por e-mail.

O Job deve ser configurado com o código do "Grupo de Empresa" passando por parâmetro. Exemplo:  Grupo de empresas com o código = 01 FINA713('01')

O Retorno Bancário do Contas a Receber por API está liberado somente para o Banco do Brasil (001).


O Job FINA715 é responsável pela retorno de títulos e realizar as baixas no sistema.

O Job deve ser configurado com o código do "Grupo de Empresa" passando por parâmetro. Exemplo:  Grupo de empresas com o código = 01 FINA715('01')


Obs.: O JOB de baixas de títulos (FINA715) será executado considerando a data inicial a data do parâmetro MV_FNGDTBX (caso vazio considera a data corrente) e a data fim será sempre a data corrente.

Para execução do JOB com a data inicial anterior à data corrente é necessário a criação/alteração do parâmetro MV_FNGDTBX e informar qual a data deseja a execução, exemplo:

Data corrente – 20/07/2022 12:00:00

Data anterior – 01/01/2022 00:00:00

O JOB será executado considerando o período com início em 01/01/2022 e finalizando em 20/07/2022 (Os horários não influenciam na execução do JOB).

O parâmetro deverá ser preenchido com a data no formato (“2022-01-01 00:00:00”).

Após a execução do JOB com o parâmetro informado com a data anterior a data corrente, o sistema irá atualizar o parâmetro com a data da execução (data corrente “2022-07-20 12:00:00”) 

Sempre que houver necessidade de processamento do JOB com data inicial diferente da corrente altere o parâmetro com a data desejada.





A comunicação bancaria online do contas a pagar foi liberada em pacotes acumulados com data igual ou superior a , somente para o Banco do Brasil (001).

O Job FINA717 é responsável pela transmissão e liberação dos títulos a pagar. Para entender o funcionamento de forma detalhada acesse a documentação Job de transmissão dos pagamentos - FINA717

O Job deve ser configurado com o código do "Grupo de Empresa" passando por parâmetro. Exemplo:  Grupo de empresas com o código = 01 FINA717('01')

O Job FINA718 é responsável pela baixa dos títulos a pagar. Para entender o funcionamento de forma detalhada acesse a documentação Job de retorno dos pagamentos - FINA718

O Job deve ser configurado com o código do "Grupo de Empresa" passando por parâmetro. Exemplo:  Grupo de empresas com o código = 01 FINA718('01')



Para os casos em que o job aparentemente parece não estar sendo executado, é possivel acompanhar os processos pelo console.log do appserver, para isso, configure as chaves na seção do ambiente:

  • FWTRACELOG
  • FWLOGMSG_DEBUG

Para mais informações acesse a documentação https://tdn.totvs.com/display/public/framework/Chaves+para+controle+de+logs


04. CONFIGURAÇÃO

No módulo configurado SIGACFG acesse o menu Schedule >Schedule.

Em agendamentos selecione  aopção cadastro e adicione o agendamento do job.

No exemplo do Grupo de empresa 01, configure a rotina como FINA713('01') para transmissão ou FINA715('01') para o retorno.

Configure o módulo como Financeiro 06 e configure o ambiente e recorrência conforme a necessidade.