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

...

Configurar o plano 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 desses 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 enviar para a plataforma.
Gerar o Lote de Cobrança (PLSA627) do mês ou período.
A aplicação será executada em forma de schedule e 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.

...

Outras Ações / Ações relacionadas

...

Foi informado uma série de documento fiscal que não existe na tabela SF1 - Cabeçalho da Nota

...

Se a sequência de Fornecedor / Loja / Número e Série de Documento Fiscal já está cadastrada e necessita cadastrar um vínculo de guia com algum item dessa NF, basta localizar essa Nota no browser inicial da rotina e clicar em Alterar, para incluir esse novo vínculo.

O sistema não permite que a mesma nota seja lançada diversas vezes, ou seja, uma vez cadastrada, basta localizá-la e editar, inserindo as guias que deseja.

...

Ao inserir um número de Guia, foi colocado um evento que já consta em outra NF cadastrada. Logo, não é possível que um mesmo evento da guia esteja ligado a mais de uma NF.

...

Guia/Evento já informada para outro item da Nota Fiscal.

Não é possível relacionar um evento de guia para mais de um item de NF.

...

Verifique a informação digitada, pois um evento de guia só pode estar relacionado à apenas um item de NF.

Não é possível que um mesmo evento da guia esteja ligado a mais de uma NF.

...

Guia já informada para o mesmo item dessa NF.

Item: / Documento: / Linha:

...

Foi inserido um novo registro no grid, onde foi imputado mesmo item/produto para uma guia que já está cadastrada para o mesmo item/produto da Nota.

Note que o sistema informa o código do item, número do documento e o número da linha no grid, onde o registro já existe.

...

Verifique a informação digitada, pois não é possível incluir um mesmo item/produto para uma mesma guia.

Não é possível que um mesmo evento da guia esteja ligado a mais de uma NF.

...

Essa mensagem é exibida quando associamos um item da NF com uma guia, mas o saldo do item na NF é menor que o total da guia(s) informada(s), onde o processo é interrompido.

Por exemplo, temos o item na NF (DS1): (A) 0001 - DIU - Qtd: 1.
Vamos associar a guia: (B) 000120001001 - QTD: 2
Ao realizar a associação entre o item da NF com a guia, esse alerta será exibido, pois a quantidade do item na NF é 1 (A), mas na guia está sendo usado a quantidade 2 (B), logo, a quantidade da nota é menor e não é possível realizar a associação.

...

Verifique a informação digitada, sendo necessário revisar a ligação entre eventos Guia x item da NF, pois a quantidade do item na NF é menor que o total utilizado pelas guias.
Veja se os lançamentos existentes estão corretos e se a guia informada é a correta também.

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

...

O campo B19_VLRTNF será usado no Monitoramento, para gravação dos campos B4N_VLTFOR e B4O_VLRPGF:
1. O valor do campo B4N_VLTFOR é usado na tag <valorPagoFornecedores>;
2. O valor do campo B4O_VLRPGF é usado na somatória da tag <valorPagoFornecedor>;
3. Se o campo B19_VLRTNF não existir na base ou constar zerado, será utilizado o valor do item, direto da Nota Fiscal - campo D1_TOTAL.
O campo B19_VLRTNF será usado na Mudança de Fase e cálculo da coparticipação, nos seguintes cenários:
1. Se estiver configurado no sistema a cobrança no ato da execução do evento pelo beneficiário, o sistema irá utilizar o campo B19_VLRTNF para o cálculo, que será gravado no campo BD6_VLRACB.
  1. Se o campo não existir ou estiver vazio, o campo BD6_VLRACB será gravado com o valor do item - obtido direto da tabela SD1 - conforme valor do parâmetro MV_PLAPCUS: Se o parâmetro estiver com o valor "0", será gravado o valor do campo D1_TOTAL, se não, D1_CUSTO.
2. Será usado na rotina de cálculo de coparticipação do beneficiário:
  1. Se existir o campo, será usado o valor obtido do campo B19_VLRTNF. Caso não exista ou esteja vazio, será usada a somatória dos valores obtidos pelo processamento da BD7 do evento, pelo campo BD7_VLRBPR.

...

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

...

title	Tabela B19 - Nota Fiscal Guias Internação

...

title	Consultas Padrões - FOR / B1VPLS / B19SD1 / B1XPLS

...

Consulta Padrão FOR

...

Consulta SXB

...

D1_FILIAL == xFilial("SD1") .and. D1_DOC == FwFldGet("B19_DOC") .and. D1_SERIE == FwFldGet("B19_SERIE") .and. D1_FORNECE == FwFldGet("B19_FORNEC") .and. D1_LOJA == FwFldGet("B19_LOJA")

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

Contêm

01#A020SXB()#A020Visual('SA2')

Alias

FOR

Tipo

4 - Colunas

Sequência

01

Coluna

01

Descrição

Código

Contêm

A2_COD

Alias

FOR

Tipo

4 - Colunas

Sequência

01

Coluna

02

Descrição

Loja

Contêm

A2_LOJA

Alias

FOR

Tipo

4 - Colunas

Sequência

01

Coluna

03

Descrição

Nome

Contêm

SUBSTR(A2_NOME,1,30)

Alias

FOR

Tipo

5 - Retorno

Sequência

01

Coluna

Descrição

Contêm

SA2->A2_COD

Alias

FOR

Tipo

5 - Retorno

Sequência

02

Contêm

SA2->A2_LOJA

Consulta Padrão B1XPLS

Consulta SXB

Alias

B1XPLS

Tipo

1 - Consulta

Sequência

01

Coluna

RE

Descrição

Guias de Internação

Contêm

BD6

Alias

B1XPLS

Tipo

2 - Ordens

Sequência

01

Coluna

01

Contêm

PLPESQGUIA()

Alias

B1XPLS

Tipo

5 - Retorno

Sequência

01

Contêm

BD6->(BD6_CODOPE+BD6_CODLDP+BD6_CODPEG+BD6_NUMERO+BD6_ORIMOV+BD6_SEQUEN)

Consulta Padrão B1VPLS

Consulta SXB

Alias

B1VPLS

Tipo

1 - Consulta

Sequência

01

Coluna

DB

Descrição

NF's Entrada

Contêm

SF1

Alias

B1VPLS

Tipo

2 - Ordens

Sequência

01

Coluna

01

Descrição

Doc+Série

Alias

B1VPLS

Tipo

2 - Ordens

Sequência

02

Coluna

02

Descrição

Fornecedor+Loja

Alias

B1VPLS

Tipo

4 - Colunas

Sequência

01

Coluna

01

Descrição

Cod

Contêm

F1_DOC

Alias

B1VPLS

Tipo

4 - Colunas

Sequência

01

Coluna

02

Descrição

Série

Contêm

F1_SERIE

Alias

B1VPLS

Tipo

4 - Colunas

Sequência

01

Coluna

03

Descrição

Fornecedor

Contêm

F1_FORNECE

Alias

B1VPLS

Tipo

4 - Colunas

Sequência

01

Coluna

04

Descrição

Loja

Contêm

F1_LOJA

Alias

B1VPLS

Tipo

5 - Retorno

Sequência

01

Contêm

SF1->F1_DOC

Alias

B1VPLS

Tipo

5 - Retorno

Sequência

02

Contêm

SF1->F1_SERIE

Alias

B1VPLS

Tipo

6 - Filtros

Sequência

01

Contêm

F1_FORNECE == M->B19_FORNEC .And. F1_LOJA == M->B19_LOJA

Consulta Padrão B19SD1

Consulta SXB

Alias

B19SD1

Tipo

1 - Consulta

Sequência

01

Coluna

DB

Descrição

Produtos

Contêm

SD1

Alias

B19SD1

Tipo

2 - Ordens

Sequência

01

Coluna

01

Descrição

Documento + Serie

Alias

B19SD1

Tipo

4 - Colunas

Sequência

01

Coluna

01

Descrição

Item NF

Contêm

D1_ITEM

Alias

B19SD1

Tipo

4 - Colunas

Sequência

01

Coluna

02

Descrição

Produto

Contêm

D1_COD

Alias

B19SD1

Tipo

5 - Retorno

Sequência

01

Contêm

SD1->D1_ITEM

Alias

B19SD1

Tipo

5 - Retorno

Sequência

02

Contêm

SD1->D1_COD

Alias

B19SD1

Tipo

6 - Filtros

Sequência

01

Contêm

Árvore de páginas

Versões comparadas

Versão antiga 28

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

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

03. TABELAS UTILIZADAS
Âncora
tabelas_utilizadas
tabelas_utilizadas

Consulta Padrão FOR

Consulta SXB

Consulta Padrão B1XPLS

Consulta SXB

Consulta Padrão B1VPLS

Consulta SXB

Consulta Padrão B19SD1

Consulta SXB

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 28

Nova versão Atual

Chave

CONTEÚDO

01. VISÃO GERAL Âncora

visao_geralvisao_geral

02. EXEMPLO DE UTILIZAÇÃO Âncora

exemplo_utilizacaoexemplo_utilizacao

a. Implantação Âncoraimplantacaoimplantacao

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

03. TABELAS UTILIZADAS Âncoratabelas_utilizadastabelas_utilizadas

Consulta Padrão FOR

Consulta SXB

Consulta Padrão B1XPLS

Consulta SXB

Consulta Padrão B1VPLS

Consulta SXB

Consulta Padrão B19SD1

Consulta SXB

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

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

03. TABELAS UTILIZADAS
Âncora
tabelas_utilizadas
tabelas_utilizadas