CONTEÚDO
- Visão Geral
- Exemplo de utilização
- Tela PLSAGECOB
- Outras Ações / Ações relacionadas
- Outras Ações / Ações relacionadas
- Tela PLSAGECOB
- Principais Campos e Parâmetros
- Principais Campos e Parâmetros
- 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
- Acesse Atualizações/Faturamento/ Agendamento de Cobranças.
- Será apresentada a tela com os opções Incluir, Alterar e Outras Ações.
- Na parte direita, é possível localizar os itens desejados por meio dos filtros de pesquisa.
- Clique em Incluir.
- Preencha os campos conforme necessidade.
- 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.
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 Antecipado | Dia de Execução | Mês do Lote que será gerado |
---|---|---|
Sim | 23/03/2021 | Abril/2021 |
Não | 23/03/2021 | Març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 Inicial | 01/2021 |
---|---|
Mês/Ano Final | 12/2022 |
Dia Execução | 27 |
Fat. antecipado | Não |
Dia Processamento | Lote 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_CHAVE | B6J |
X2_NOME | Agendamento de Lote de Cobrança em Schedule |
X2_UNICO | B6J_FILIAL+B6J_CODAGE |
SIX - Índice | |
Ordem | Chave |
1 | BCJ_FILIAL+BCJ_CODOPE+BCJ_TIPSER |
Campo | Descrição |
Campo | B6J_FILIAL |
Tipo | Caractere |
Tamanho | 8 |
Decimal | 0 |
Título | Filial |
Descrição | Filial |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Ordem | 1 |
Campo | Descrição |
Campo | B6J_CODAGE |
Tipo | Caractere |
Tamanho | 6 |
Decimal | 0 |
Título | Cód. Agend. |
Descrição | Código de Agendamento |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Ordem | 2 |
Ordem | 2 |
Campo | Descrição |
Campo | B6J_CODOPE |
Tipo | Caractere |
Tamanho | 4 |
Decimal | 0 |
Título | Operadora: |
Descrição | Codigo da Operadora |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Ordem | 3 |
Campo | Descrição |
Campo | B6J_DESCRI |
Tipo | Caractere |
Tamanho | 50 |
Decimal | 0 |
Título | Descrição |
Descrição | Descrição |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Ordem | 4 |
Campo | Descrição |
Campo | B6J_DIAEXE |
Tipo | Numérico |
Tamanho | 2 |
Decimal | 0 |
Título | Dia Execução |
Descrição | Dia Execução |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Ordem | 5 |
Campo | Descrição |
Campo | B6J_MESFRE |
Tipo | Caractere |
Tamanho | 1 |
Decimal | 0 |
Título | Fat.Antecip. |
Descrição | Faturamento Antecipado |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 6 |
Campo | Descrição |
Campo | B6J_INTERC |
Tipo | Caractere |
Tamanho | 1 |
Decimal | 0 |
Título | Intercambio |
Descrição | Intercambio |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 7 |
Campo | Descrição |
Campo | B6J_ANOINI |
Tipo | Caractere |
Tamanho | 4 |
Decimal | 0 |
Título | Ano Inicial |
Descrição | Ano Inicial |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Ordem | 8 |
Campo | Descrição |
Campo | B6J_MESINI |
Tipo | Caractere |
Tamanho | 2 |
Decimal | 0 |
Título | Mês Inicial |
Descrição | Mês Inicial |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Ordem | 9 |
Campo | Descrição |
Campo | B6J_ANOFIM |
Tipo | Caractere |
Tamanho | 4 |
Decimal | 0 |
Título | Ano Final |
Descrição | Ano Final |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Ordem | 10 |
Campo | Descrição |
Campo | B6J_MESFIM |
Tipo | Caractere |
Tamanho | 2 |
Decimal | 0 |
Título | Mês Final |
Descrição | Mês Final |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Ordem | 11 |
Campo | Descrição |
Campo | B6J_FISJUR |
Tipo | Caractere |
Tamanho | 1 |
Decimal | 0 |
Título | Fis/Juridico |
Descrição | Fis/Juridico |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Ordem | 12 |
Campo | Descrição |
Campo | B6J_GRUCOB |
Tipo | Caractere |
Tamanho | 4 |
Decimal | 0 |
Título | Grupo Cobran |
Descrição | Grupo Cobran |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 13 |
Campo | Descrição |
Campo | B6J_DESGRU |
Tipo | Caractere |
Tamanho | 50 |
Decimal | 0 |
Título | Descri Grupo |
Descrição | Descrição do Grupo |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 14 |
Campo | Descrição |
Campo | B6J_DIAVEN |
Tipo | Numérico |
Tamanho | 2 |
Decimal | 0 |
Título | Dia Vencto |
Descrição | Dia de Vencimento |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 15 |
Campo | Descrição |
Campo | B6J_MODCOB |
Tipo | Caractere |
Tamanho | 1 |
Decimal | 0 |
Título | Modal Cobr. |
Descrição | Modalidade de Cobrança |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 16 |
Campo | Descrição |
Campo | B6J_FILTRO |
Tipo | Caractere |
Tamanho | 249 |
Decimal | 0 |
Título | Filtro Fam. |
Descrição | Filtro Arquivo Família |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 17 |
Campo | Descrição |
Campo | B6J_LOTREN |
Tipo | Caractere |
Tamanho | 12 |
Decimal | 0 |
Título | Lote Renovac |
Descrição | Lote de renovação de cont |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 18 |
Campo | Descrição |
Campo | B6J_VCTINI |
Tipo | Numérico |
Tamanho | 2 |
Decimal | 0 |
Título | Vencto Ini. |
Descrição | Vencimento Inicial |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 19 |
Campo | Descrição |
Campo | B6J_DTEMIS |
Tipo | Data |
Tamanho | 8 |
Decimal | 0 |
Título | Dt Emissão |
Descrição | Data de emissão do tit |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 20 |
Campo | Descrição |
Campo | B6J_VCTFIN |
Tipo | Numérico |
Tamanho | 2 |
Decimal | 0 |
Título | Vencto Final |
Descrição | Vencimento Final |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 21 |
Campo | Descrição |
Campo | B6J_AGLUTI |
Tipo | Caractere |
Tamanho | 1 |
Decimal | 0 |
Título | Aglut. Lanc. |
Descrição | Vencimento Final |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 22 |
Campo | Descrição |
Campo | B6J_CARIMP |
Tipo | Caractere |
Tamanho | 1 |
Decimal | 0 |
Título | Carnê ? |
Descrição | Carnê ? |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 23 |
Campo | Descrição |
Campo | B6J_GRCOBV |
Tipo | Caractere |
Tamanho | 249 |
Decimal | 0 |
Título | Var. Grp Co |
Descrição | Varios Grp de cobrança |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 24 |
Campo | Descrição |
Campo | B6J_REEMB |
Tipo | Caractere |
Tamanho | 1 |
Decimal | 0 |
Título | Som. Reemb? |
Descrição | Somente Reembolso |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 25 |
B6K - Parametrização do Lote de Cobrança em Schedule | |
SX2 - Informações da Tabela | |
---|---|
Campo | Descrição |
X2_CHAVE | B6K |
X2_NOME | Parametrização do Lote de Cobrança em Schedule |
X2_UNICO | B6K_FILIAL+B6K_NUMSEC |
SIX - Índice | |
Ordem | Chave |
1 | B6K_FILIAL+B6K_NUMSEC |
Campo | Descrição |
Campo | B6K_FILIAL |
Tipo | Caractere |
Tamanho | 8 |
Decimal | 0 |
Título | Filial |
Descrição | Filial |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 1 |
Campo | Descrição |
Campo | B6K_NUMSEC |
Tipo | Caractere |
Tamanho | 6 |
Decimal | 0 |
Título | Num. Sec. |
Descrição | Numero Sequencial |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 2 |
Campo | Descrição |
Campo | B6K_CODOPE |
Tipo | Caractere |
Tamanho | 4 |
Decimal | 0 |
Título | Operadora: |
Descrição | Código da Operadora |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 3 |
Campo | Descrição |
Campo | B6K_CODEMP |
Tipo | Caractere |
Tamanho | 4 |
Decimal | 0 |
Título | Empresa |
Descrição | Empresa |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 4 |
Campo | Descrição |
Campo | B6K_DESEMP |
Tipo | Caractere |
Tamanho | 249 |
Decimal | 0 |
Título | Grp/Empresa |
Descrição | Grp/Empresa |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 5 |
Campo | Descrição |
Campo | B6K_NUMCON |
Tipo | Caractere |
Tamanho | 12 |
Decimal | 0 |
Título | Contrato |
Descrição | Contrato |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 6 |
Campo | Descrição |
Campo | B6K_VERSAO |
Tipo | Caractere |
Tamanho | 3 |
Decimal | 0 |
Título | Versão |
Descrição | Versão |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 7 |
Campo | Descrição |
Campo | B6K_SUBCON |
Tipo | Caractere |
Tamanho | 9 |
Decimal | 0 |
Título | Subcontrato |
Descrição | Subcontrato |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 8 |
Campo | Descrição |
Campo | B6K_VERSUB |
Tipo | Caractere |
Tamanho | 3 |
Decimal | 0 |
Título | Versão Subco |
Descrição | Versão do Subcontrato |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 9 |
Campo | Descrição |
Campo | B6K_EMPFIN |
Tipo | Caractere |
Tamanho | 4 |
Decimal | 0 |
Título | Emp Final |
Descrição | Empresa Final |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 10 |
Campo | Descrição |
Campo | B6K_DESFIN |
Tipo | Caractere |
Tamanho | 249 |
Decimal | 0 |
Título | Grp/Empresa |
Descrição | Grp/Empresa |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 11 |
Campo | Descrição |
Campo | B6K_CONFIN |
Tipo | Caractere |
Tamanho | 12 |
Decimal | 0 |
Título | Cont. Final |
Descrição | Contrato Final |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 12 |
Campo | Descrição |
Campo | B6K_VERFIN |
Tipo | Caractere |
Tamanho | 3 |
Decimal | 0 |
Título | Versão Final |
Descrição | Versao Contrato Final |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 13 |
Campo | Descrição |
Campo | B6K_SUBFIN |
Tipo | Caractere |
Tamanho | 9 |
Decimal | 0 |
Título | Sub. Final |
Descrição | Nº Subcontrato Final |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 14 |
Campo | Descrição |
Campo | B6K_VESUFI |
Tipo | Caractere |
Tamanho | 3 |
Decimal | 0 |
Título | Versão Final |
Descrição | Versão Subcontrato Final |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 15 |
B6Q - Param. Lote de Cobrança em Schedule | |
SX2 - Informações da Tabela | |
---|---|
Campo | Descrição |
X2_CHAVE | B6Q |
X2_NOME | Param. Lote de Cobrança em Schedule |
X2_UNICO | B6Q_FILIAL+B6Q_CODAGE |
SIX - Índice | |
Ordem | Chave |
1 | B6Q_FILIAL+B6Q_CODAGE |
Campo | Descrição |
Campo | B6Q_FILIAL |
Tipo | Caractere |
Tamanho | 8 |
Decimal | 0 |
Título | Filial |
Descrição | Filial |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 1 |
Campo | Descrição |
Campo | B6Q_CODAGE |
Tipo | Caractere |
Tamanho | 6 |
Decimal | 0 |
Título | Cod. Agend. |
Descrição | Cod. Agend. |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 2 |
Campo | Descrição |
Campo | B6Q_DTEXEC |
Tipo | Data |
Tamanho | 8 |
Decimal | 0 |
Título | Data Execuc. |
Descrição | Data Execuc. |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 3 |
Campo | Descrição |
Campo | B6Q_HORA |
Tipo | Caractere |
Tamanho | 8 |
Decimal | 0 |
Título | Hr. Fim Exec |
Descrição | Horario Final de execução |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 4 |
Campo | Descrição |
Campo | B6Q_GERADO |
Tipo | Caractere |
Tamanho | 1 |
Decimal | 0 |
Título | Item Gerado |
Descrição | Item Gerado |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 5 |
Campo | Descrição |
Campo | B6Q_DESCRI |
Tipo | Caractere |
Tamanho | 60 |
Decimal | 0 |
Título | Desc.Geracao |
Descrição | Desc.Geracao |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 6 |
Campo | Descrição |
Campo | B6Q_NUMERO |
Tipo | Caractere |
Tamanho | 8 |
Decimal | 0 |
Título | Numero Lote |
Descrição | Numero Lote |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 7 |
Campo | Descrição |
Campo | B6Q_MESREF |
Tipo | Caractere |
Tamanho | 2 |
Decimal | 0 |
Título | Mes Referen. |
Descrição | Mes Referen. |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Ordem | 8 |
03. TELA PLSAGECOB
Outras Ações / Ações relacionadas
Ação | Descrição |
---|---|
Visualizar | Indica a visualização do registro. |
Excluir | Exclusão do registro. |
Imprimir Browse | Impressão da listagem do Browse. |
04. TELA PLSAGECOB
Principais Campos e Parâmetros
Campo | Descrição |
---|---|
Operadora | Indica o código da Operadora |
Descrição | Indica o nome do Agendamento. |
Dia Execução | Indica o dia da execução. |
Ano Inicial | Indica o ano inicial do agendamento. |
Mês Inicial | Indica 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.