CONTEÚDO

  1. Visão Geral
  2. Exemplo de utilização
  3. Tela PLSAGECOB
    1. Outras Ações / Ações relacionadas
  4. Tela PLSAGECOB
    1. Principais Campos e Parâmetros
  5. Tabelas utilizadas


01. VISÃO GERAL

Implementação da automatização para a geração do lote de cobrança, rotina responsável pela geração da receita das operadoras, que é executada mensalmente, no mesmo padrão de parametrização, mas que necessita a intervenção humana para executá-la.

Sabendo-se que os critérios de processamento são os mesmos, criamos um cadastro de parametrização, similar à capa do lote de cobrança, onde o usuário do sistema, geralmente do setor de faturamento, possa configurar um agendamento padrão.

A partir deste cadastro, criamos uma função que será executada pelo schedule Protheus, que fará a leitura deste cadastro e executará, via JOB, a geração do lote de cobrança.

O processo descrito acima atende somente o faturamento gerado de maneira contínua mensalmente.

02. EXEMPLO DE UTILIZAÇÃO

  1. Acesse Atualizações/Faturamento/ Agendamento de Cobranças.
  2. Será apresentada a tela com os opções Incluir, Alterar e Outras Ações.
  3. Na parte direita, é possível localizar os itens desejados por meio dos filtros de pesquisa. 
  4. Clique em Incluir.
  5. Preencha os campos conforme necessidade.
  6. Confira os dados e confirme.

Veja como funciona na prática:

Configuração do Schedule Protheus.

Para que rotina de agendamento seja executada de uma forma automática,  conforme o dia, mês e ano  que foi cadastrado no agendamento, precisamos configurar o schedule no módulo Configurador,  nesse contém a rotina que analisará  os agendamentos.

O schedule permite que rotinas do sistema sejam agendadas para que possam ser executadas posteriormente, em um período determinado pelo usuário. 

Esse mecanismo tem por objetivo encontrar agendamentos  que serão processados pela  rotina de Lote Cobrança (PLSA627).

Será permitido cadastrar mais de um agendamento para rodar simultaneamente, desde que os parâmetros sejam diferentes. 


Exemplo da rotina de Agendamento de Lote de Cobrança no schedule Protheus.

Mais informação sobre Schedule Protheus.

Schedule Protheus

Agendamento de Lote de Cobrança

O cadastro  de Agendamento de Lote de Cobrança (B6J), é a forma de agendarmos a geração do Lote de Cobrança em um determinado período, esse agendamento segue o mesmo parâmetros da capa do lote de cobrança (PLSA627).

Cód Agend: Código sequencial para controle interno.

Descrição: Nome dado ao agendamento. Ex.: Lote pessoa física.

Dia Execução: Dia do mês que esta parametrização será executada. Exemplo: se for indicado dia 27, todos os dias 27 dentro do período Inicial/Final esse agendamento será executado.

Fat. antecipado: Preencher com Sim ou Não. Este campo indica se o faturamento é antecipado. Quando este campo está parametrizado com Sim, o lote será gerado para o mês subsequente, se estiver Não, o lote é gerado para o mesmo mês. Exemplo:

Fat AntecipadoDia de ExecuçãoMês do Lote que será gerado
Sim23/03/2021Abril/2021
Não23/03/2021Março/2021


Intercâmbio:  Preencher com Sim ou Não. Indica se será realizada tratativa de intercâmbio.

Mês/Ano Inicial/Final : Indica o período que o agendamento estará ativo e será executado. Exemplo:


Mês/Ano Inicial01/2021
Mês/Ano Final12/2022
Dia Execução27
Fat. antecipadoNão
Dia ProcessamentoLote Gerado

27/01/2021 

Janeiro/2021
27/02/2021 Fevereiro/2021
27/03/2021 Março/2021
27/04/2021 Abril/2021
27/05/2021 Maio/2021
27/06/2021 Junho/2021
27/07/2021 Julho/2021
27/08/2021 Agosto/2021
27/09/2021 Setembro/2021
27/10/2021 Outubro/2021
27/11/2021 Novembro/2021
27/12/2021 Dezembro/2021


A partir de 2022, esta parametrização não estará mais ativa pois expirou o Mês/Ano Final.

Fis/Juridica: Indica o tipo de grupo de cobrança: Física ou Jurídica.

Grupo Cobran: Permite realizar um Filtro por Grupos de cobranças já cadastrados pelo cliente.

Dia Vencto: Dia do mês que será atribuído ao vencimento do título. Exemplo: se for indicado dia 27, o vencimento de todos os títulos será o dia 27 do mês que está sendo processado.

Modal Cobr.: Permite informar e filtrar baseado na modalidade de cobrança.

Filtro Fam: Permite indicar um filtro especifico para a rotina com instruções ADVPL.

Vencto. Ini e Vencto. Final: Permite realizar um filtro baseado no dias de vencimento cadastrados na parametrização do nível de cobrança encontrado pelo sistema (utiliza a mesma ideia do filtro do Lotes de Cobrança (PLSA627).

B6J - Cabeçalho de agendamento de lote de cobrança em Schedule


Essa rotina também contempla um agendamento mais específico para uma ou mais empresas conforme o range selecionado.

Para os casos de pessoa jurídica, podemos selecionar por contrato e até subcontrato.

Para os casos de pessoa física, podemos utilizar o botão filtro que tem a mesma funcionalidade da rotina  Lote de Cobrança.

Consulta de Log de execução

O Cadastro de Agendamento contempla o item de consulta de log de execução. é nele que analisaremos se o Lote de Cobrança foi executado corretamente.

Exemplo abaixo vemos que a rotina executou corretamente.


Exemplo abaixo vemos que a rotina não executou corretamente, temos que analisar os motivos.

Alguns motivos que não gera o Lote de cobrança.



Caso a opção item gerado estiver preenchido como "Não" o administrador do sistema deverá analisar o console log do Appserver e o log job_Schepls627.log que é gerado na pasta LOGPLS.

Configurações de Menu

No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013).

Menu

Atualizações

Submenu

Faturamento 

Nome da Rotina

Agendamento de Cobrança

Programa

PLSAGECOB

Módulo

Plano de Saúde

Campos

B6K - Parametrização do Lote de Cobrança em Schedule


SX2 - Informações da Tabela 
Campo Descrição
X2_CHAVEB6K
X2_NOME

Parametrização do Lote de Cobrança em Schedule

X2_UNICOB6K_FILIAL+B6K_NUMSEC
SIX - Índice 
OrdemChave
1B6K_FILIAL+B6K_NUMSEC


CampoDescrição
CampoB6K_FILIAL
TipoCaractere
Tamanho8
Decimal0
TítuloFilial
DescriçãoFilial
UsadoSim
ObrigatórioNão
BrowseSim
Ordem1


CampoDescrição
CampoB6K_NUMSEC
TipoCaractere
Tamanho6
Decimal0
TítuloNum. Sec.
DescriçãoNumero Sequencial
UsadoSim
ObrigatórioNão
BrowseSim
Ordem2


CampoDescrição
CampoB6K_CODOPE
TipoCaractere
Tamanho4
Decimal0
TítuloOperadora:
DescriçãoCódigo da Operadora
UsadoSim
ObrigatórioNão
BrowseSim
Ordem3


CampoDescrição
CampoB6K_CODEMP
TipoCaractere
Tamanho4
Decimal0
TítuloEmpresa
DescriçãoEmpresa
UsadoSim
ObrigatórioNão
BrowseSim
Ordem4


CampoDescrição
CampoB6K_DESEMP
TipoCaractere
Tamanho249
Decimal0
TítuloGrp/Empresa
DescriçãoGrp/Empresa
UsadoSim
ObrigatórioNão
BrowseSim
Ordem5


CampoDescrição
CampoB6K_NUMCON
TipoCaractere
Tamanho12
Decimal0
TítuloContrato
DescriçãoContrato
UsadoSim
ObrigatórioNão
BrowseSim
Ordem6


CampoDescrição
CampoB6K_VERSAO
TipoCaractere
Tamanho3
Decimal0
TítuloVersão
DescriçãoVersão
UsadoSim
ObrigatórioNão
BrowseSim
Ordem7


CampoDescrição
CampoB6K_SUBCON
TipoCaractere
Tamanho9
Decimal0
TítuloSubcontrato
DescriçãoSubcontrato
UsadoSim
ObrigatórioNão
BrowseSim
Ordem8


CampoDescrição
CampoB6K_VERSUB
TipoCaractere
Tamanho3
Decimal0
TítuloVersão Subco
DescriçãoVersão do Subcontrato
UsadoSim
ObrigatórioNão
BrowseSim
Ordem9


CampoDescrição
CampoB6K_EMPFIN
TipoCaractere
Tamanho4
Decimal0
TítuloEmp Final
DescriçãoEmpresa Final
UsadoSim
ObrigatórioNão
BrowseSim
Ordem10


CampoDescrição
CampoB6K_DESFIN
TipoCaractere
Tamanho249
Decimal0
TítuloGrp/Empresa
DescriçãoGrp/Empresa
UsadoSim
ObrigatórioNão
BrowseSim
Ordem11


CampoDescrição
CampoB6K_CONFIN
TipoCaractere
Tamanho12
Decimal0
TítuloCont. Final
DescriçãoContrato Final
UsadoSim
ObrigatórioNão
BrowseSim
Ordem12


CampoDescrição
CampoB6K_VERFIN
TipoCaractere
Tamanho3
Decimal0
TítuloVersão Final
DescriçãoVersao Contrato Final
UsadoSim
ObrigatórioNão
BrowseSim
Ordem13


CampoDescrição
CampoB6K_SUBFIN
TipoCaractere
Tamanho9
Decimal0
TítuloSub. Final
DescriçãoNº Subcontrato Final
UsadoSim
ObrigatórioNão
BrowseSim
Ordem14


CampoDescrição
CampoB6K_VESUFI
TipoCaractere
Tamanho3
Decimal0
TítuloVersão Final
DescriçãoVersão Subcontrato Final
UsadoSim
ObrigatórioNão
BrowseSim
Ordem15

B6Q - Param. Lote de Cobrança em Schedule


SX2 - Informações da Tabela 
Campo Descrição
X2_CHAVEB6Q
X2_NOME

Param. Lote de Cobrança em Schedule

X2_UNICOB6Q_FILIAL+B6Q_CODAGE
SIX - Índice 
OrdemChave
1B6Q_FILIAL+B6Q_CODAGE


CampoDescrição
CampoB6Q_FILIAL
TipoCaractere
Tamanho8
Decimal0
TítuloFilial
DescriçãoFilial
UsadoSim
ObrigatórioNão
BrowseSim
Ordem1


CampoDescrição
CampoB6Q_CODAGE
TipoCaractere
Tamanho6
Decimal0
TítuloCod. Agend.
DescriçãoCod. Agend.
UsadoSim
ObrigatórioNão
BrowseSim
Ordem2


CampoDescrição
CampoB6Q_DTEXEC
TipoData
Tamanho8
Decimal0
TítuloData Execuc.
DescriçãoData Execuc.
UsadoSim
ObrigatórioNão
BrowseSim
Ordem3


CampoDescrição
CampoB6Q_HORA
TipoCaractere
Tamanho8
Decimal0
TítuloHr. Fim Exec
DescriçãoHorario Final de execução
UsadoSim
ObrigatórioNão
BrowseSim
Ordem4


CampoDescrição
CampoB6Q_GERADO
TipoCaractere
Tamanho1
Decimal0
TítuloItem Gerado
DescriçãoItem Gerado
UsadoSim
ObrigatórioNão
BrowseSim
Ordem5


CampoDescrição
CampoB6Q_DESCRI
TipoCaractere
Tamanho60
Decimal0
TítuloDesc.Geracao
DescriçãoDesc.Geracao
UsadoSim
ObrigatórioNão
BrowseSim
Ordem6


CampoDescrição
CampoB6Q_NUMERO
TipoCaractere
Tamanho8
Decimal0
TítuloNumero Lote
DescriçãoNumero Lote
UsadoSim
ObrigatórioNão
BrowseSim
Ordem7


CampoDescrição
CampoB6Q_MESREF
TipoCaractere
Tamanho2
Decimal0
TítuloMes Referen.
DescriçãoMes Referen.
UsadoSim
ObrigatórioNão
BrowseSim
Ordem8

03. TELA PLSAGECOB

Outras Ações / Ações relacionadas

AçãoDescrição
VisualizarIndica a visualização do registro.
ExcluirExclusão do registro.
Imprimir BrowseImpressão da listagem do Browse.

04. TELA PLSAGECOB

Principais Campos e Parâmetros

CampoDescrição
OperadoraIndica o  código da Operadora
DescriçãoIndica o  nome do Agendamento.
Dia ExecuçãoIndica o dia da execução.
Ano Inicial

Indica o ano inicial do agendamento.

Mês InicialIndica o mês inicial do agendamento.



05. TABELAS UTILIZADAS