Histórico da Página

CONTEÚDO

1. Visão Geral
2. Exemplo de utilização
   1. Implantação
      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
   2. Utilização da IntegraçãoUtilização da Rotina
3. 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.

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:

...

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 17/05/2024, ou para incluir manualmente pelo configurador, clique aqui para acessar a boletim técnico.

...

Aplicar os seguintes patchs no ambiente:

Release 12.1.2210:

ATUALIZACAO DE ARQUIVOS FONTES V12.1.2210 EXP GRR PILOTOS EXPEDICAO CONTINUA

ATUALIZACAO DE ARQUIVOS FONTES V12.1.2210 SIGAGCT EXPEDICAO CONTINUA

PACOTE DE CORRECAO FATURAMENTO - ROTINA LOTES DE COBRANCA12.1.2210

Release 12.1.2310

ATUALIZACAO DE ARQUIVOS FONTES V12.1.2310 EXP GRR PILOTOS EXPEDICAO CONTINUA

ATUALIZACAO DE ARQUIVOS FONTES V12.1.2310 SIGAGCT EXPEDICAO CONTINUA

...

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

...

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

[environment] 
fw-tf-registry-endpoint=https://endpoint-registry.totvs.app/api/v1/services

ou para ambientes internos da TOTVS, será utilizado o staging:

[environment]  
fw-tf-registry-endpoint=https://endpoint-registry.staging.totvs.app/api/v1/services

...

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

Image Added

...

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 e no cadastro da operadora de saúde, deverá ser informado a régua de cobrança para a plataforma TOTVS Gestão de Receita Recorrente (GRR) 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)

...

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

Image Added

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

Para e para atualizar a régua é só alterar o campo régua GRR (BA0_GRRREG) para Não que o sistema irá enviar Não e preencher o valor do campo Dias Antec. (BA0_DIAGRR) para o GRR.

1. Cadastros necessários:

) antes do processamento do schedule.

...

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.

...

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
Preencher os campos de integração GRR (BQC_INTGRR, BT5_INTGRR E BA3_INTGRR) para indicar quais famílias (BA3), contratos (BT5) ou subcontratos (BQC) deverão ser enviados para o GRR. O sistema irá verificar quem vai enviar conforme o nível:
Nível Família: Campo informado como: Sim (Enviar para o GRR), Não (Não enviar para o GRR), Em branco (Olhar
2. • o próximo nível, no caso o subcontrato
)
3. • .
     
     
4. Nível Subcontrato: Campo Integ. GRR (BQC_INTGRR) informado como:
Sim (Enviar
5. 
   
   
   • Sim - Envia todos os beneficiários do subcontrato para o GRR
),
6. • .
   • Não
(Não enviar
7. • - Não envia os beneficiários do subcontrato para o GRR
),
8. • .

   • Em branco

(Olhar

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

)

10. • .

      Informações
      Para verificar esse nível,

os campos

11. • o campo da integração da família

deverão

12. • deverá estar em branco.

13. Nível
Subcontrato
14. Contrato: Campo Integ. GRR (BT5_INTGRR) informado como:
Sim (Enviar
15. 
    
    
    • Sim - Envia todos os beneficiários do contrato para o GRR
),
16. • .

    • Não

(Não enviar

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

)

18. • .

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


No cadastro de beneficiários (BA1), os campos de DDD (BA1_DDD), telefone (BA1_TELEFO), e-mail (BA1_EMAIL) e de endereços deverão estar preenchidos corretamente, pois a aplicação (GRR) utiliza esses campos para transmissão de informação.
Nota

title	Importante

19. Configurar o item de planos na plataforma TOTVS Gestão de Receita Recorrente (GRR), para atender as datas de cobranças adequadas 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 envie para os beneficiários. Esse item é configurado em produtos na plataforma.

No primeiro processamento do schedule, o parâmetro MV_PLUPBFQ deverá estar preenchido como .T. para que o sistema envie os itens (Lançamentos de faturamento - BFQ) e as subscrições (Famílias) gerados no último ano. Após isso, o sistema irá alterar o parâmetro para .F. para que no segundo processamento não envie novamente essa carga inicial.

20. 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.
    1. No Protheus módulo Configurador efetuaremos a configuração do Schedule, responsável por enviar os dados para a plataforma TOTVS Gestão de Receita Recorrente (GRR), tanto a subscrições quanto as medições geradas pelo lote de cobrança, lembrando que o cadastro do schedule deverá ser feito por um responsável da área de TI da operadora.

Image Removed

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) dentro daquele mês em que o schedule está sendo processado, de todas as famílias que estão configuradas para enviar para a plataforma TOTVS Gestão de Receita Recorrente.

03. TABELAS UTILIZADAS

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.

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                  

#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