Histórico da Página

CONTEÚDO

Visão Geral

Exemplo de utilização

...

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

...

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.
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.
O momento de trocas de informação se dará no momento da execução do schedule, que trabalhará de forma diária enviando os dados para a plataforma. Para mais informações sobre schedule. Clique aqui

...

1. Configuração da plataforma TOTVS Gestão de Receita Recorrente onde será do número do clientId e clientSecret gerado pela equipe de implantação.
2. No Protheus módulo Configurador efetuar configuração do Schedule para efetuar.Image Removed
3. Gerar Lote de cobrança do período desejado em Atualizações / Faturamento / Lote de Cobrança (PLSA627).Image Removed
4. 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.

...

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

...

Dicionário de dados - SX3

...

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

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:

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
Rotina: INTEGPLSGRR Para mais informações de como configurar o schedule. Clique aqui

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

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

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

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

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

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

Árvore de páginas

Versões comparadas

Versão antiga 36

Nova versão Atual

Chave

CONTEÚDO

01. VISÃO GERAL
Âncora

visao_geral
visao_geral

02. EXEMPLO DE UTILIZAÇÃO
Âncora
exemplo_utilizacao
exemplo_utilizacao

a. Implantação
Âncora

implantacao

implantacao

Dicionário de dados - SX3

b. Utilização da Integração
Âncora
utilizacao_integracao
utilizacao_integracao

03. TABELAS UTILIZADAS
Âncora
tabelas_utilizadas
tabelas_utilizadas

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 36

Nova versão Atual

Chave

CONTEÚDO

01. VISÃO GERAL Âncora

visao_geralvisao_geral

02. EXEMPLO DE UTILIZAÇÃO Âncoraexemplo_utilizacaoexemplo_utilizacao

a. Implantação Âncora

implantacao

implantacao

Dicionário de dados - SX3

b. Utilização da Integração Âncorautilizacao_integracaoutilizacao_integracao

03. TABELAS UTILIZADAS Âncoratabelas_utilizadastabelas_utilizadas

01. VISÃO GERAL
Âncora

visao_geral
visao_geral

02. EXEMPLO DE UTILIZAÇÃO
Âncora
exemplo_utilizacao
exemplo_utilizacao

a. Implantação
Âncora

b. Utilização da Integração
Âncora
utilizacao_integracao
utilizacao_integracao

03. TABELAS UTILIZADAS
Âncora
tabelas_utilizadas
tabelas_utilizadas