Histórico da Página

CONTEÚDO

1. Visão Geral
2. Exemplo de utilização

1. Premissas da rotina
2. Utilização da rotina

...

1. Outras Ações / Ações relacionadas
   
2. Tabela 1 - Mensagens de validações, problemas e soluções
3. Uso do campo B19_VLRTNF

1. 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ção

...

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

...

...

• 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  

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
• PACOTE DE CORRECAO FATURAMENTO - ROTINA LOTES DE COBRANCA12.1.231
  

...

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

[environment] 
fw-tf-registry-endpoint=https://endpoint-registry.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 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)

Feito isso, deverá processar o seguinte schedule:

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

...

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 o próximo nível, no caso o subcontrato.
     
     
2. 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.

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

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

   
   

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

...

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

...

1. 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.
2.  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         

...

...

...

Consulta Padrão FOR   

...

Consulta SXB

...

...

#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