Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Dica

Disponível a partir da release 12.1.2410 ou através de pacote de expedição contínua do plano de saúde com data igual ou superior

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.

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

...

Estado
colourYellow
titlePasso 2
- Patch
Âncora
patch
patch

Aplicar os seguintes patchs no ambiente:

...

Aviso
iconfalse

Dentro dos arquivos do arquivo de download GRR e da expedição contínua do GCT, tem um sdfbra que precisa ser aplicado através do UPDDISTR.

...

Estado
colourYellow
titlePasso 3
- Ambiente
Âncora
ambiente
ambiente

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

Bloco de código
languagetext
titleappserver.ini - PRODUÇÃO
[environment] 
fw-tf-registry-endpoint=https://endpoint-registry.totvs.app/api/v1/services

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

Bloco de código
languagetext
titleappserver.ini - STAGING
[environment]  
fw-tf-registry-endpoint=https://endpoint-registry.staging.totvs.app/api/v1/services


...

Estado
colourYellow
titlePasso 4
- Wizard
Âncora
wizard
wizard

EstadocolourYellowtitlePasso 4Executar 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 Removed

Image Added


...

Estado
colourYellow
titlePasso 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 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.

Dica

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

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.


...

Estado
colourYellow
titlePasso 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
colourYellow
titlePasso 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
  2. 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
    • o próximo nível, no caso o subcontrato
  3. )
    • .

  4. Nível Subcontrato: Campo Integ. GRR (BQC_INTGRR) informado como:
  5. Sim (Enviar


    • Sim - Envia todos os beneficiários do subcontrato para o GRR
  6. ),
    • .
    • Não
  7. (Não enviar
    • - Não envia os beneficiários do subcontrato para o GRR
  8. ),
    • .
    • Em branco

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

  10. )
    • .

      Informações

      Para verificar esse nível,

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

  12. deverão
    • deverá estar em branco.

  13. Nível
  14. Subcontrato
  15. Contrato: Campo Integ. GRR (BT5_INTGRR) informado como:
  16. Sim (Enviar


    • Sim - Envia todos os beneficiários do contrato para o GRR
  17. ),
    • .
    • Não

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

  19. )
    • .

      Informações

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

Aviso
titleImportante

No cadastro

...

dos beneficiários (BA1), os campos de DDD (BA1_DDD), telefone (BA1_TELEFO), e-mail (BA1_EMAIL) e os dados de

...

endereço deverão estar preenchidos

...

, pois

...

é esses dados são obrigatórios no GRR para transmissão de

...

informações.

...



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)

...

Informações
titleExemplo

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.

...

  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.

.

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:

    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

    Nota
    titleLog

    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


  4. 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
    iconfalse
    titleConfiguraçã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

Dica

Rotina: INTEGPLSGRR

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

  • 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
iconfalse
titleBô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
languagec#
themeRDark
linenumberstrue
collapsetrue
#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