Árvore de páginas


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.

Atenção

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.

Rotina: SCHEPLS627

O Novo Schedule está disponível a partir da lib 20231009 e configuração da Porta Multiprotocolo e Interface Protheus com PO UI (vide Nova interface do Protheus com PO UI).

Mais informação sobre Schedule Protheus.

Schedule Protheus

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


  • Não há movimentação.
  • Parâmetros incorretos.


Atenção

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

B6J - Agendamento de Lote de Cobrança em Schedule


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

Agendamento de Lote de Cobrança em Schedule

X2_UNICOB6J_FILIAL+B6J_CODAGE
SIX - Índice 
OrdemChave
1BCJ_FILIAL+BCJ_CODOPE+BCJ_TIPSER


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


CampoDescrição
CampoB6J_CODAGE
TipoCaractere
Tamanho6
Decimal0
TítuloCód. Agend.
DescriçãoCódigo de Agendamento
UsadoSim
ObrigatórioSim
BrowseSim
Ordem2
Ordem2


CampoDescrição
CampoB6J_CODOPE
TipoCaractere
Tamanho4
Decimal0
TítuloOperadora:
DescriçãoCodigo da Operadora
UsadoSim
ObrigatórioSim
BrowseSim
Ordem3


CampoDescrição
CampoB6J_DESCRI
TipoCaractere
Tamanho50
Decimal0
TítuloDescrição
DescriçãoDescrição
UsadoSim
ObrigatórioSim
BrowseSim
Ordem4


CampoDescrição
CampoB6J_DIAEXE
TipoNumérico
Tamanho2
Decimal0
TítuloDia Execução
DescriçãoDia Execução
UsadoSim
ObrigatórioSim
BrowseSim
Ordem5


CampoDescrição
CampoB6J_MESFRE
TipoCaractere
Tamanho1
Decimal0
TítuloFat.Antecip.
DescriçãoFaturamento Antecipado
UsadoSim
ObrigatórioNão
BrowseSim
Ordem6


CampoDescrição
CampoB6J_INTERC
TipoCaractere
Tamanho1
Decimal0
TítuloIntercambio
DescriçãoIntercambio
UsadoSim
ObrigatórioNão
BrowseSim
Ordem7


CampoDescrição
CampoB6J_ANOINI
TipoCaractere
Tamanho4
Decimal0
TítuloAno Inicial
DescriçãoAno Inicial
UsadoSim
ObrigatórioSim
BrowseSim
Ordem8


CampoDescrição
CampoB6J_MESINI
TipoCaractere
Tamanho2
Decimal0
TítuloMês Inicial
DescriçãoMês Inicial
UsadoSim
ObrigatórioSim
BrowseSim
Ordem9


CampoDescrição
CampoB6J_ANOFIM
TipoCaractere
Tamanho4
Decimal0
TítuloAno Final
DescriçãoAno Final
UsadoSim
ObrigatórioSim
BrowseSim
Ordem10


CampoDescrição
CampoB6J_MESFIM
TipoCaractere
Tamanho2
Decimal0
TítuloMês Final
DescriçãoMês Final
UsadoSim
ObrigatórioSim
BrowseSim
Ordem11


CampoDescrição
CampoB6J_FISJUR
TipoCaractere
Tamanho1
Decimal0
TítuloFis/Juridico
DescriçãoFis/Juridico
UsadoSim
ObrigatórioSim
BrowseSim
Ordem12


CampoDescrição
CampoB6J_GRUCOB
TipoCaractere
Tamanho4
Decimal0
TítuloGrupo Cobran
DescriçãoGrupo Cobran
UsadoSim
ObrigatórioNão
BrowseSim
Ordem13


CampoDescrição
CampoB6J_DESGRU
TipoCaractere
Tamanho50
Decimal0
TítuloDescri Grupo
DescriçãoDescrição do Grupo
UsadoSim
ObrigatórioNão
BrowseSim
Ordem14


CampoDescrição
CampoB6J_DIAVEN
TipoNumérico
Tamanho2
Decimal0
TítuloDia Vencto
DescriçãoDia de Vencimento
UsadoSim
ObrigatórioNão
BrowseSim
Ordem15


CampoDescrição
CampoB6J_MODCOB
TipoCaractere
Tamanho1
Decimal0
TítuloModal Cobr.
DescriçãoModalidade de Cobrança
UsadoSim
ObrigatórioNão
BrowseSim
Ordem16


CampoDescrição
CampoB6J_FILTRO
TipoCaractere
Tamanho249
Decimal0
TítuloFiltro Fam.
DescriçãoFiltro Arquivo Família
UsadoSim
ObrigatórioNão
BrowseSim
Ordem17


CampoDescrição
CampoB6J_LOTREN
TipoCaractere
Tamanho12
Decimal0
TítuloLote Renovac
DescriçãoLote de renovação de cont
UsadoSim
ObrigatórioNão
BrowseSim
Ordem18


CampoDescrição
CampoB6J_VCTINI
TipoNumérico
Tamanho2
Decimal0
TítuloVencto Ini.
DescriçãoVencimento Inicial
UsadoSim
ObrigatórioNão
BrowseSim
Ordem19


CampoDescrição
CampoB6J_DTEMIS
TipoData
Tamanho8
Decimal0
TítuloDt Emissão
DescriçãoData de emissão do tit
UsadoSim
ObrigatórioNão
BrowseSim
Ordem20


CampoDescrição
CampoB6J_VCTFIN
TipoNumérico
Tamanho2
Decimal0
TítuloVencto Final
DescriçãoVencimento Final
UsadoSim
ObrigatórioNão
BrowseSim
Ordem21


CampoDescrição
CampoB6J_AGLUTI
TipoCaractere
Tamanho1
Decimal0
TítuloAglut. Lanc.
DescriçãoVencimento Final
UsadoSim
ObrigatórioNão
BrowseSim
Ordem22


CampoDescrição
CampoB6J_CARIMP
TipoCaractere
Tamanho1
Decimal0
TítuloCarnê ?
DescriçãoCarnê ?
UsadoSim
ObrigatórioNão
BrowseSim
Ordem23


CampoDescrição
CampoB6J_GRCOBV
TipoCaractere
Tamanho249
Decimal0
TítuloVar. Grp Co
DescriçãoVarios Grp de cobrança
UsadoSim
ObrigatórioNão
BrowseSim
Ordem24


CampoDescrição
CampoB6J_REEMB
TipoCaractere
Tamanho1
Decimal0
TítuloSom. Reemb?
DescriçãoSomente Reembolso
UsadoSim
ObrigatórioNão
BrowseSim
Ordem25


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

  • B6J - Schedule de Cobrança          
  • B6K - Compl. Jurídico        
  • B6Q - Param. Lote de Cobrança em Schedule.