Histórico da Página
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
01. VISÃO GERAL Âncora visao_geral visao_geral
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
exemplo_utilizacao | |
exemplo_utilizacao |
a. Implantação Âncora implantacao implantacao
implantacao | |
implantacao |
A implantação da integração do PLS com o GRR é feita nas seguintes etapas:
...
Estado | ||||||
---|---|---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
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 06, ou para incluir manualmente pelo configurador, clique aqui para acessar a boletim técnico.
Dica | ||
---|---|---|
| ||
Ao final do processo, o ambiente precisa ter os seguintes campos:
Além do parâmetro:
|
...
- Patch Estado colour Yellow title Passo 2 Âncora patch patch
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
- PACOTE DE CORRECAO FATURAMENTO - ROTINA LOTES DE COBRANCA12.
...
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 que é 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.
...
Aviso | ||
---|---|---|
| ||
Dentro do arquivo de download da expedição contínua do GCT, tem um sdfbra que precisa ser aplicado através do UPDDISTR. |
...
Estado | ||||||
---|---|---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Configurar o ini do ambiente a ser implantado a integração:
Bloco de código | ||||
---|---|---|---|---|
| ||||
[environment]
fw-tf-registry-endpoint=https://endpoint-registry.totvs.app/api/v1/services |
...
- Wizard Estado colour Yellow title Passo 4 Â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: |
...
Estado | ||||||
---|---|---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
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,
Nota | ||
---|---|---|
| ||
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 |
Dica |
---|
Rotina: INTEGPLSGRR |
Nota |
---|
Para mais informações de como configurar o schedule. Clique aqui |
Dica |
---|
No cadastro de Beneficiários (BA1), os campos BA1_DDD, BA1_TELEFO e BA1_EMAIL, deverá estar preenchidos corretamente, pois a aplicação utiliza esses campos para transmissão de informação. |
03. TABELAS UTILIZADAS
- BPW - CadBenef Online - Lote
- BPY - CadBenef Online - Beneficiário
- BA1 - Beneficiários
- BTS - Vidas
- BA3 - Famílias
- BA0 - Operadora de Saúde
- BG9 - Empresas
- BQC - Subcontratos
- BI3 - Produto Saúde
CONTEÚDO
- Visão Geral
- Momento da implantação
- Exemplo de utilização
- Parâmentros utilizadas
- Tabelas utilizadas
- Campos a serem criados
...
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.
Para mais informações sobre a plataforma TOTVS Gestão de Receita Recorrente. Clique aqui
...
Após a implantação da plataforma TOTVS Gestão de Receita Recorrente (GRR, vide Guia de implantação GRR), algumas informações do módulo Plano de Saúde deverá estar na plataforma.
Para tornar a implantação mais rápida e segura, disponibilizamos na aplicação PLSINTGRR, uma tratativa para que na primera vez que for ser executada, o módulo Plano de Sáude (PLS) irá enviar os dados para a plataforma TOTVS Gestão de Receita Recorrente (GRR).
A aplicação PLSINTGRR é a 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 no item de schedule conforme explicações abaixo.
- No Protheus módulo Configurador efetuaremos a configuração do Schedule, responsável por enviar os dados para a plataforma, tantos as subscrições quanto as medições geradas pelo lote de cobrança, lembrando que o cadastro do schedule deverá ser feito por um responsavel da área de TI da operadora.
- No cadastro de Usuários (BA1), os campos BA1_DDD,BA1_TELEFO,BA1_EMAIL, deverá estar preenchidos corretamente, pois a aplicação utiliza esses campos para transmissão de informação.
...
- 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.
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.
...
- Com a aplicação PLSINTGRR 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).
c. 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.
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
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. |
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
...
Estado | ||||||
---|---|---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
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 | ||||||
---|---|---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
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.
Aviso | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
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
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:Dica Caso o processo de cadastramento do beneficiário seja realizado com sucesso, o beneficiário será cadastrada na subscrição do GRR
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
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".
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
tabelas_utilizadas | |
tabelas_utilizadas |
- BA1 - Beneficiários
- BA3 - Famílias
...
- 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
- HRH - Assinatura GRR
Nota | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||
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:
|