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
Ter o serviço de agendamento Schedule configurado no servidor do Protheus. (Schedule - Como agendar a execução de rotinas)
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')
Importante!
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.
Importante
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')
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.
Informações
Para os casos em que o job aparentemente parece não estar sendo executado, é possível 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 Chaves para controle de logs