Histórico da Página

CONTEÚDO

1. Visão Geral
2. Exemplo de utilização
   1. Implantação
      1. Premissas da Rotina
      2. Utilização da Rotina
      3. 1. Passo 1 - Dicionário de Dados
         2. Passo 2 - Patch
         3. Passo 3 - Ambiente
         4. Passo 4 - Wizard
         5. Passo 5 - Lançamento de Faturamento e Régua de Cobrança
         6. Passo 6 - Provedor e Métodos de Pagamento
         7. Passo 7 - Habilitar os Beneficiários para Integração
      4. Utilização da IntegraçãoRegua de Cobrança
   2. Tabelas utilizadas

   
   

   01. VISÃO GERAL

   Âncora
   visao_geral visao_geral

   Para tornar o fluxo de cobrança dos beneficiários dinâmico e rápido, o módulo de Plano de Saúde (PLS) disponibilizou a integração com a plataforma TOTVS Gestão de Receita Recorrente (GRR), com essa integração as operadoras que utilizarem o modelo de receita recorrente, poderão da melhor maneira reduzir inadimplência e aumentar a previsibilidade de recebimentos, uma solução para automatizar as cobranças recorrentes e melhorar ainda mais o seu desempenho financeiro.

   Nota
   Para mais informações sobre a plataforma TOTVS Gestão de Receita Recorrente. Clique aqui

   02. EXEMPLO DE UTILIZAÇÃO

   Âncora
   exemplo_utilizacao exemplo_utilizacao

   a. Implantação

   ...

   Âncora
   implantacao implantacao

   A implantação da integração do PLS com o GRR é feita nas seguintes etapas:

   ...

   Estado
   colour Yellow title Passo 1

   - Dicionário de Dados

   Âncora
   dicionario_dados dicionario_dados

   Atualizar o dicionário de dados através do pacote de expedição contínua do plano de saúde com data igual ou superior 0617/05/2024, ou para incluir manualmente pelo configurador, clique aqui para acessar a boletim técnico.

   • Os campos de integração GRR (XXX_INTGRR) no módulo Plano de Saúde (PLS) nos cadastros Grupo Familiar/Beneficiários (PLSA174), Contrato e Subcontrato do Grupo/Empresa (PLSA660), respeitando os níveis de cadastro que o sistema trabalha.
   • No cadastro de beneficiários (BA1), os campos de DDD (BA1_DDD), telefone (BA1_TELEFO) e e-mail (BA1_EMAIL) deverão estar preenchidos corretamente, pois a aplicação utiliza esses campos para transmissão de informação. 

   Realizar a implantação da plataforma TOTVS Gestão de Receita Recorrente (GRR) através do Guia de implantação GRR, algumas informações do módulo Plano de Saúde deverá estar na plataforma.

   Cadastrar o shedule INTEGPLSGRR responsável pela integração entre o módulo Plano de Saúde (PLS) e a plataforma TOTVS Gestão de Receita Recorrente (GRR), é essa aplicação que iremos cadastrar no configurador (SIGACFG) no item de schedule conforme explicações abaixo.

   ...

   Dica
   icon false
   Ao final do processo, o ambiente precisa ter os seguintes campos:  BA0_GRRREG BA0_DIAGRR BA3_INTGRR BBT_INTGRR BQC_INTGRR BT5_INTGRR Além do parâmetro: MV_PLUPBFQ

   
   

   ...

   Estado
   colour Yellow title Passo 2

   - Patch

   Âncora
   patch patch

   Aplicar os seguintes patchs no ambiente:

   • Expedição Contínua GRR Pilotos e SIGAGCT
   • Pacotes de Atualização - Plano de Saúde - P12

   Aviso
   icon false
   Dentro do arquivo de download da expedição contínua do GCT, tem um sdfbra que precisa ser aplicado através do UPDDISTR.

   
   

   ...

   Estado
   colour Yellow title Passo 3

   - Ambiente

   Âncora
   ambiente ambiente

   Configurar o ini do ambiente a ser implantado a integração:

   Bloco de código
   language text title appserver.ini
   [environment] fw-tf-registry-endpoint=https://endpoint-registry.totvs.app/api/v1/services

   
   

   ...

   Estado
   colour Yellow title Passo 4

   - Wizard

   Âncora
   wizard wizard

   Executar o wizard GRRWIZARD seguindo os passos definidos no Guia de implantação GRR.

   Dica
   Caso o processo seja finalizado com sucesso, será apresentada a imagem abaixo de ativação da integração Protheus x GRR:

   Image Added

   
   

   ...

   Estado
   colour Yellow title Passo 5

   - Lançamento de Faturamento e Régua de Cobrança

   Âncora
   lancamento_regua lancamento_regua

   Feito essas configurações, a próxima etapa é enviar os lançamentos de faturamento para o GRR, que são os itens na plataforma, para isso é necessário deixar o parâmetro MV_PLUPBFQ como .T.

   No cadastro da operadora de saúde, deverá ser informado a régua de cobrança que determina a quantidade de dias de antecipação que a plataforma (GRR) poderá enviar para os beneficiários as faturas, podemos determinar essa régua no campo Dias Antec. (BA0_DIAGRR)

   Nota
   title Importante
   Para o sistema enviar a régua de cobrança no processamento do schedule, depois que preencher a quantidade de dias, o campo Regua GRR (BA0_GRRREG) deverá ser alterado para Não, para o sistema entender que a régua está desatualizada no GRR e precisa ser enviada.

   Feito isso, deverá processar o seguinte schedule:

   Informações

   Dica
   Rotina: INTEGPLSGRR

   Image Removed

   note

   Rotina: INTEGPLSGRR

   Para mais informações de como configurar o schedule. Clique aqui

   b. Premissas da Rotina

   Configurar o item de planos na plataforma TOTVS Gestão de Receita Recorrente (GRR), para atender as datas de cobrança adeguada ao cenário da operadora. 

   Informações
   title Exemplo
   Estou gerando o Lote de cobrança (PLSA627), na data 01/09/2023, a plataforma TOTVS Gestão de Receita Recorrente (GRR), deverá estar configurada para que após a data de geração da cobrança a plataforma envia para os beneficiários, esse item é configurado em produtos na plataforma.

   Através dos cadastros, Grupo/Família no campo BA3_INTGRRC ou Subcontratos BQC_INTGRR ou Grupo/Empresa BT5_INTGRR, respeitando os níveis de cadastro que o sistema já trabalha, quando um estiver habilitados determinará que enviaremos informações de integração para a plataforma TOTVS Gestão de Receita Recorrente.

   Tanto para contratos de pessoas juridicas ou físicas poderão ser enviadas para a plataforma.

   Gerar o Lote de Cobrança (PLSA627) do mês ou período. 

   b. Utilização da Rotina

   Com a aplicação INTEGPLSGRR já cadastrada no schedule conforme acima, ela irá verificar se há movimentações a serem enviadas para a plataforma, lembrando que a quantidade de verificação diária vai depender do que foi estipulado no schedule . 

   Gerar Lote de cobrança do período desejado em Atualizações / Faturamento / Lote de Cobrança (PLSA627).

   Image Removed

   Após geração do lote de cobrança e o schedule configurado, a rotina verificará os movimentos de cobrança (BM1) gerado para enviar para a plataforma TOTVS Gestão de Receita Recorrente.

   c. Regua de Cobrança

   A regua de cobrança é um dispositivo da  plataforma TOTVS Gestão de Receita Recorrente (GRR) que determina a quantidade de dias de antecipação que a plataforma poderá enviar para os beneficiários as faturas, esse mecanismos chamamos de régua de cobrança, com a integração com o módulo Plano de Saúde (PLS) podemos determinar essa régua no cadastro de operadoras.

   03. TABELAS UTILIZADAS

   Nesse primeiro processamento, o schedule somente irá cadastrar os itens (Lançamento de faturamento - BFQ) e configurar a régua de cobrança.

   Dica
   Caso o processamento seja realizado com sucesso, os itens (Lançamentos de faturamento) serão cadastrados na plataforma GRR.

   Image Added

   Para enviar novamente os lançamentos, é necessário habilitar o parâmetro MV_PLUPBFQ antes do processamento do schedule.

   Para atualizar a régua é só alterar o campo régua GRR (BA0_GRRREG) para Não e preencher o valor do campo Dias Antec. (BA0_DIAGRR) antes do processamento do schedule.

   
   

   ...

   Estado
   colour Yellow title Passo 6

   - Provedor e Métodos de Pagamento

   Âncora
   provedor provedor

   Antes de cadastrar os beneficiários (subscrições), acesse a plataforma Gestão de Receita Recorrente para realizar o cadastro de provedores e métodos de pagamento das empresas e filiais, clique aqui para mais detalhes de como configurar.

   
   

   ...

   Estado
   colour Yellow title Passo 7

   - Habilitar os Beneficiários para Integração

   Âncora
   habilitar_beneficiarios habilitar_beneficiarios

   Para definir quais beneficiários serão enviados para o GRR, é necessário habilitar alguns campos nos cadastros conforme o nível escolhido: Famílias (BA3), Contratos (BT5) ou Subcontratos (BQC).

   1. Nível Família: Campo Integ. GRR (BA3_INTGRR) informado como:
      
      
      • Sim - Envia a família para o GRR.
      • Não - Não envia a família para o GRR.
      • Em branco - Olha o próximo nível, no caso o subcontrato.
        
        
   2. Nível Subcontrato: Campo Integ. GRR (BQC_INTGRR) informado como:
      
      
      • Sim - Envia todos os beneficiários do subcontrato para o GRR.
      • Não - Não envia os beneficiários do subcontrato para o GRR.

      • Em branco - Olha o próximo nível, no caso o contrato.

        Informações
        Para verificar esse nível, o campo da integração da família deverá estar em branco.

   3. Nível Contrato: Campo Integ. GRR (BT5_INTGRR) informado como:
      
      
      • Sim - Envia todos os beneficiários do contrato para o GRR.

      • Não - Não envia os beneficiários do contrato para o GRR.

        Informações
        Para verificar esse nível, os campos de integração da família e subcontrato deverão estar em branco.

   Dica
   title Implantação realizada com Sucesso!!!
   Todos os passos foram concluídos e o Plano de Saúde (PLS) está pronto para integrar com a plataforma TOTVS Gestão de Receita Recorrente (GRR).

   b. Utilização da Integração

   Âncora
   utilizacao_integracao utilizacao_integracao

   Na integração com o GRR, o Plano de Saúde (PLS) irá possuir 4 responsabilidades:

   1. Cadastrar os itens na plataforma, sendo os lançamentos de faturamento do módulo. (processo realizado no passo 5)
      
      
   2. Atualizar a régua de cobrança. (processo realizado no passo 5)
      
      

   3. Cadastrar as subscrições (beneficiários) na plataforma.
      
      Após geração do lote de cobrança, e necessário processar o schedule (INTEGPLSGRR), que irá verificar os títulos dos beneficiários que estão habilitados para integrar com o GRR (processo realizado no passo 7) para poder ser feito o cadastro:

      
      

      Informações
      icon false title Parâmetro MV_PGRRPAY
      Esse parâmetro define os métodos de pagamento do beneficiário na plataforma de Gestão de Receita Recorrente: 1 - boleto, 2 - cartão de crédito e 3 - pix. Exemplo: caso queria utilizar somente a forma de cartão de crédito, o parâmetro deverá está cadastrado com o valor: 2. Os valores deverão estar separados por |

      Dica
      Caso o processo de cadastramento do beneficiário seja realizado com sucesso, o beneficiário será cadastrada na subscrição do GRR

      
      

      Image Added

      
      

   4. Nota
      title Log
      Caso o processo não seja realizado com sucesso, através do log de críticas da integração será possível analisar o motivo: Diretório: protheus_data/logpls/{data}/pls_grr_critica.log Image Added

      
      

   5. No mesmo processamento do schedule que cadastra os beneficiários, será realizado também a medição das faturas do GRR que estão com o status "Aguardando Medição".
      
      Image Added
      

      Aviso
      icon false title Configuração do GRR
      Para que o processo funcione corretamente, o necessário que as configurações do GRR estejam realizadas corretamente, como: Ativação das organizações Configuração dos servições (JOB) para que as faturas sejam processadas (alteração do status criado para aguardando medição). Clique aqui para acessar a documentação.

      
      

      Dica
      Ao final do processamento de medição, a fatura será atualizada com os valores do título (SE1) do beneficiário naquele mês, além da composição da fatura (BM1).

   ...

   Por tanto, é necessário configurar o agendamento do schedule para realizar o cadastro dos beneficiários na GRR (será feito somente uma vez o cadastro de um beneficiário), e também a finalização das faturas que estão aguardando medição.

   Os demais passos o próprio GRR que irá realizar, como criação da fatura conforme o vencimento do beneficiário e cobrança via cartão de crédito, PIX ou boleto, o Plano de Saúde (PLS) nesse fluxo tem a responsabilidade de criar as subscrições (beneficiários) e realizar a medição da fatura, sendo o preenchimento do valor e da composição.

   Informações
   icon false title Baixa do Titulo no Financeiro
   Quando a fatura for pagar na plataforma do GRR (Gestão de receita recorrente), o job FwTotvsLinkJob deve ser configurado indicando a recorrência de sempre ativo para atender as solicitações, essa é a forma padrão de comunicação com o SmartLink, para mais informações consultar a Integração Descida de Dados Smart Link. Esse job, irá baixar os títulos do PLS no módulo Financeiro e gerar um novo título em nome do provedor (ex: REDE). Obs: É necessário cadastar o motivo de baixa: GRR

   03. TABELAS UTILIZADAS

   Âncora
   tabelas_utilizadas tabelas_utilizadas

   • BA1 - Beneficiários
   • BA3 - Famílias
   • BQC- Subcontrato
   • BT5 - Grupo de Empresa Contrato
   • BBT - Títulos Gerados
   • BM1- Composição da Cobrança
   • HRH - Assinatura GRR                  

   
   

   Nota
   icon false title Bônus!
   Para facilitar o processo de implantação, a rotina do schedule poderá ser executado no menu do protheus, através de uma user function, como no exemplo: Bloco de código language c# theme RDark linenumbers true collapse true #include "protheus.ch" /*/{Protheus.doc} PLGRRExec Executa a integração do PLS com o GRR através do schedule IntegPlsGrr @type function @version 12.1.2410 @author totvs @since 06/06/2024 /*/ user function PLGRRExec() local aCompany := {} as array if fwAlertNoYes("Confirma o processamento da integração?", "Integração PLS x GRR") aAdd(aCompany, cEmpAnt) aAdd(aCompany, cFilAnt) fwMsgRun(nil, {|| IntegPlsGrr(aCompany)}, "", "Processando Integração com o GRR...") fwAlertSuccess("Processamento executado com sucesso!", "") endif fwFreeArray(aCompany) return