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
   3. Inclusão de Guia x Nota Fiscal
   4. Edição de Guia x Nota Fiscal
   5. Visualização de Guia x Nota Fiscal
   6. Exclusão de Guia x Nota Fiscal
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. 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
   Tela PLSA298
   1. Parâmetros
5. 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

...

• Uma Nota Fiscal pode ser atrelada a vários eventos de guias diversas;
• Não será possível utilizar duas notas diferentes para vincular um mesmo evento na Guia:
  1. Ou seja, não será possível para o evento A da guia 000085, ter duas NF atreladas, apenas uma Nota.
• Ao associar o evento da Guia com a Nota Fiscal, será verificado se essa guia já está associada em outra Nota. Se sim, o lançamento será bloqueado, pois não podemos ter um evento de guia associado a mais de uma nota; 
• O sistema controla o "saldo" da Nota com a guia lançada, ou seja:
  1. Se na Nota Fiscal temos a quantidade 5 para o item, e a quantidade usada na guia for 3, e não existir lançamento anterior para a mesma Nota, a inclusão é possível;
  2. No cenário acima, se já existir lançamento anterior com a mesma NF e quantidade usada no evento foi 3, o sistema irá emitir um alerta, pois ultrapassou a quantidade da Nota (existe guia associada a Nota, com evento que usa quantidade 3 e estamos lançando outra guia que também usa quantidade 3 no evento, portanto, a quantidade utilizada foi 6, maior que a quantidade 5 que existe na Nota Fiscal), onde a inclusão não será possível;

...

1. Todas a notas fiscais que forem lançadas no sistema - no módulo de Compras - pela rotina de Documento de Entrada, poderão ser utilizadas para realizar o vínculo entre um evento de guia com o item da Notas Fiscal.
2. Para incluir essa associação entre um evento de Guia (tabela BD6) e uma Nota (tabela SD1), no remote, acesse: Atualizações / Proc. Contas / Nota Fiscal de Entrada x Guias (PLSA298).
3. A rotina irá abrir e exibir o browser inicial, exibindo os 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:

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

...