Histórico da Página

...

1. Visão Geral
2. Exemplo de utilização
   1. Premissas da rotina
   2. Utilização da rotina
3. Tela PLSA298
   1. Outras Ações / Ações relacionadas
      
   2. Tabela 1 - Mensagens de validações, problemas e soluções
   3. Uso do campo B19_VLRTNF
4. Tela PLSA298
   1. Parâmetros
      
5. Tabelas utilizadas
6. 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
7. 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

...

• Atraves 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.
• 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.
• 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.
• Mesmo após a geração do lote e houver alguns ajustes, poderemos reenviar as informações para a plataforma.
• A geração do Lote de Cobrança deverá respeita o periodo 

...

1. No momento da geração do Lote de cobrança em Atualizações / Faturamento / Lote de Cobrança (PLSA627).
2. Com os parâmetros da rotina prrenchidos como de costume, após a confirmação a rotina irá efetuar os cálculos e enviará as informaçãoes para a plataforma TOTVS Gestão de Receita Recorrente.
3. registros gravados e os botões para inclusão, edição, visualização e deleção de registros.
4. Mas a

...

1. Image Removed

...

implantacao

A implantação da integração do PLS com o GRR é feita nas seguintes etapas:

...

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:

• Expedição Contínua GRR Pilotos e SIGAGCT
• Pacotes de Atualização - Plano de Saúde - P12

...

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:

   
   

   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

   
   

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

   
   

5. 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
• BQC- Subcontrato
• BT5 - Grupo de Empresa Contrato
• BBT - Títulos Gerados
• BM1- Composição da Cobrança
• HRH - Assinatura GRR                  

#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

...

1. Se na parte superior foi informado dados corretos, o grid será automaticamente preenchido com o(s) item(ns) da NF, ou seja, o(s) registro(s) que constam na NF, de acordo com a tabela SD1. Logo, se constar um ou mais itens na NF, serão inseridos automaticamente no grid, para uso do usuário. 
2. Aqui, o usuário deve obrigatoriamente informar o número e sequência do evento da Guia (B19_GUIA), para associação entre o item e evento da guia.

...

1. Aqui, será aberta uma linha em branco, onde o usuário deverá informar obrigatoriamente o item da NF que deseja utilizar - através do campo ITEM (B19_ITEM) - ou seja, pode digitar a sequência do item que consta na NF ou então, usar o F3 do campo, que já filtra os itens apenas da NF que está sendo utilizada.
2. Após informar o item, basta informar a guia de atendimento que deseja associar - campo GUIA (B19_GUIA).

...

1. Se o parâmetro MV_PLAPCUS estiver com o valor "1":
   1. O cálculo do campo B19_VLRTNF será efetuado pelo custo do evento da NF (D1_CUSTO), dividido pela quantidade de itens que consta no evento da Guia (BD6_QTDPRO) -> (D1_CUSTO / BD6_QTDPRO).
   2. Por exemplo, na NF (tabela SD1) temos o item 0001 - ACETABULO CP3 28X52MM - QTD: 3, e o custo do item foi R$ 500,00 (D1_CUSTO). Na rotina, foi associado esse item da NF com o evento da Guia (tabela BD6) 000120221000000007 - QTD: 2.
   3. Logo, o valor que será exibido no campo B19_VLRTNF será: (500 [D1_CUSTO] / 2 [BD6_QTDPRO] ) = R$ 250,00.
2. Se o parâmetro MV_PLAPCUS estiver com o valor "0":
   1. O cálculo do campo B19_VLRTNF será efetuado pelo total do evento NF, sendo o cálculo pelo total do evento (D1_TOTAL) menos os descontos (caso existam - D1_VALDESC), dividido pela quantidade de itens da nota (D1_QUANT) e por fim, dividido pela quantidade de eventos na nota da guia (BD6_QTDPRO) -> ( ( (D1_TOTAL – D1_VALDESC) / D1_QUANT ) / BD6_QTDPRO).
   2. Por exemplo, na NF (tabela SD1) temos o item 0002 - CATETER DUPLO LUMEN - QTD: 2, e o total do item foi R$ 1750 (D1_TOTAL), com R$ 10,00 de desconto (D1_VALDESC). Na rotina, foi associado esse item da NF com o evento da Guia (tabela BD6) 000120221000000008 - QTD: 1.
   3. Logo, o valor que será exibido no campo B19_VLRTNF será: ( ( (1750 [D1_TOTAL] - 10 [D1_VALDESC]) / 2 [D1_QUANT] ) / 1 [BD6_QTDPRO] ) = R$ 870,00.
3. O campo B19_VLRTNF será usado nos seguintes momentos:
   1. Na rotina de monitoramento: campos B4N_VLTFOR e B4O_VLRPGF. Se se o campo B19_VLRTNF não existir, será usado o padrão de hoje, para gravar esses campos;
   2. Na rotina de mudança de fase: se deve cobrar do beneficiário o pagamento no ato e na rotina de cálculo de coparticipação.
   3. Para mais detalhes, consulte a observação no tópico 3 - Uso do campo B19_VLRTNF.

...

1. Image Removed

...

1. No browser da rotina, selecione em qual nota deseja adicionar vínculos com uma guia e após, clique no botão Alterar.
2. A parte superior da tela (cabeçalho), estará bloqueada para edição.
   1. Image Removed
3. No grid (parte inferior), realize a(s) associação(ões) do(s) item(ns) da NF com os eventos da guia, conforme explicado no item de Inclusão de Guia.
4. Após a edição, clique no botão Confirmar, para que os dados sejam salvos 
5. De acordo com as informações inseridas, o sistema pode apresentar várias mensagens de validação. Para consultar essas mensagens e seus significados - bem como a soluções - consulte a tabela 1.
6. Abaixo, um exemplo de alteração de NF, mostrando todas as etapas:
   1. Image Removed

...

1. No browser da rotina, selecione em qual nota deseja visualizar os vínculos com uma guia e após, clique no botão Visualizar.
2. A tela será aberta no modo de visualização, ou seja, apenas leitura dos dados, sem possibilidade de alteração.
   1. Image Removed
3. Abaixo, um exemplo de visualização de NF, mostrando as etapas:
   1. Image Removed

...

1. No browser da rotina, selecione qual nota deseja excluir - bem como as vinculações realizadas - e após, clique no botão Outras Ações / Excluir.
2. O sistema irá exibir a nota e todas as vinculações de guias realizadas. Para confirmar a exclusão, clique em Confirmar.
3. Abaixo, um exemplo de alteração de NF, mostrando todas as etapas:
   1. Image Removed

...

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.

...

Parâmetros envolvidos

...