01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Desenvolver uma rotina que permita aos usuários visualizar os beneficiários inadimplentes, juntamente com os respectivos títulos em aberto. A rotina também deverá identificar os beneficiários que atendem aos critérios estabelecidos pela Resolução Normativa nº 593, possibilitando sua categorização conforme diferentes status.

03. SOLUÇÃO

...

>> Índice <<

Índice
maxLevel 2 minLevel 2

>> O que é o Monitor de Inadimplência? <<

O Monitor de Inadimplência é uma ferramenta desenvolvida para permitir que usuários visualizem, acompanhem e registrem informações sobre beneficiários de planos de saúde que possuem faturas vencidas. O sistema também identifica aqueles que se enquadram na RN nº 593 da ANS, norma que regulamenta o cancelamento de contratos por inadimplência.

...

> Funcionalidades do Sistema

• Consulta de beneficiários inadimplentes.

• Visualização de títulos em aberto.

• Registro de interações realizadas com os beneficiários.

• Envio de e-mail de notificação de inadimplência.

• Filtros específicos da RN 593.

...

>> Parâmetros (SX6) <<

A rotina leva em consideração dois parâmetros para retornar os títulos:

• MV_PLSTIT - Tipo do título (campo E1_TIPO)

• MV_PLPFE11 - Prefixo do título (campo E1_PREFIXO)

4. Estrutura da Interface

Image Removed

> Parte Superior: Dados do Beneficiário

• Matrícula

• Nome do Beneficiário

• Código do Cliente (SA1)

• Código da Loja Relacionado ao Cliente (SA1)

• Nome do Cliente (SA1)

• Nome Social

• Data de Internação

• Matrícula Antiga

• Operadora

• Empresa

• Contrato

• Subcontrato

> Parte Inferior Esquerda: Títulos em Atraso

>> Como Acessar a Rotina <<

1. Para acessar o monitor de inadimplência, digite no campo que está na parte superior do lado esquerdo a seguinte informação: PLMONINAD.
2. Voce também pode acessar a rotina navegando pelo menu: Atualizações > Faturamento > Monitor de Inadimplência.

Image Added

       2. Uma tela exibindo os parâmetros iniciais será mostrada.

Image Added

       3. Preencha os campos e clique em OK.

>> Estrutura da Interface <<

Image Added

> Parte Superior: Dados do Beneficiário

• Matrícula

• Nome do Beneficiário

• Código do Cliente (SA1)

• Código da Loja Relacionado ao Cliente (SA1)

• Nome do Cliente (SA1)

• Nome Social

• Data de Internação

• Matrícula Antiga

• Operadora

• Empresa

• Contrato

• Subcontrato

> Parte Inferior Esquerda: Títulos em Atraso

• Prefixo

• Número do Título

• Vencimento

• Dias em Atraso

• Valor

• Prefixo

• Número do Título

• Vencimento

• Dias em Atraso

• Valor

• Vencimento Real

• Emissão

• Mês Base

• Ano Base

• Parcela

• Tipo

• Número do Lote de Cobrança

• Contrato

• Subcontrato

• Código do Cliente

• Loja do Cliente

> Parte Inferior Direita: Contatos Realizados

• Confirmação de recebimento do contato

• Data do contato

• Hora do contato

• Origem do contato

• Matrícula do beneficiário posicionado

• Motivo do contato

• Data da criação do registro no sistema

• Hora da criação do registro no sistema

...

>> Passo a Passo das Funcionalidades <<

> Opção de Menu Novo Filtro

1. Clique no botão Novo Filtro.

2. Uma janela com um formulário será exibida.

3. Preencha os dados conforme a necessidade.

4. Clique em OK.

> Opção de Menu Atualizar Dados

1. Clique no botão Atualizar Dados.

2. O sistema irá recarregar os dados com base nos parâmetros preenchidos anteriormente.

> Opção de Menu Enviar Notificação de Inadimplência

1. Selecione uma ou mais linhas na tabela da esquerda.

2. Clique no botão Enviar Notificação de Inadimplência.

...

...

...

1. Selecione uma ou mais linhas na tabela da esquerda.

2. Clique no botão Enviar Notificação de Inadimplência.

• Antes de enviar o e-mail, o sistema verifica se o campo de e-mail do beneficiário selecionado (BA1_EMAIL) está preenchido e válido. Além disso, caso o cliente vinculado ao beneficiário também deva receber o e-mail, o sistema verifica se o e-mail do cliente (A1_EMAIL) está disponível e em conformidade com o padrão esperado.
• Se um ou mais endereços de e-mail estiverem ausentes ou inválidos, uma janela de aviso será exibida informando o problema.

Image Added

     3. Clicando em Não! O sistema exibirá uma lista contendo os beneficiários e os clientes que estão com alguma não conformidade no e-mail. No caso abaixo, o e-mail não foi configurado.

Image Added 

      4. Ao confirmar a ação clicando em 'Sim', o sistema exibirá uma janela solicitando que o usuário escolha se o envio dos e-mails deve ser feito apenas para o titular ou para o titular e o cliente.

Image Added

      5. Clicando em uma das opções, o sistema iniciará o processo de envio dos e-mails. 

Image Added

• Caso ocorram falhas em um ou mais envios, será exibida uma lista contendo apenas os detalhes do erro e os dados dos respectivos beneficiários que não receberam o e-mail, os que não estiverem na lista foram enviados com sucesso. 

Image Added

• Se ao final do processo de envio dos e-mails, não ocorrer nenhum erro, o sistema irá apresentar apenas a mensagem confirmando o envio.

Image Added

>

Image Removed

     3. Clicando em Não! O sistema exibirá uma lista contendo os beneficiários e os clientes que estão com alguma não conformidade no e-mail. No caso abaixo, o e-mail não foi configurado.

Image Removed 

      4. Ao confirmar a ação clicando em 'Sim', o sistema exibirá uma janela solicitando que o usuário escolha se o envio dos e-mails deve ser feito apenas para o titular ou para o titular e o cliente.

Image Removed

      5. Clicando em uma das opções, o sistema iniciará o processo de envio dos e-mails. 

Image Removed

• Caso ocorram falhas em um ou mais envios, será exibida uma lista contendo apenas os detalhes do erro e os dados dos respectivos beneficiários que não receberam o e-mail, os que não estiverem na lista foram enviados com sucesso. 

Image Removed

• Se ao final do processo de envio dos e-mails, não ocorrer nenhum erro, o sistema irá apresentar apenas a mensagem confirmando o envio.

Image Removed

Opção de Menu Documentação

• Exibe a documentação do monitor de inadimplência.

> Opção de Menu Filtros RN 593

📝 Como funciona?

• Ao abrir o Monitor, todos os beneficiários inadimplentes são exibidos, independentemente da RN 593.

• Os filtros RN 593 refinam os dados carregados, mantendo apenas os que atendem à norma.

✅ Premissas para atender a RN 593:

1. Cobrança no nível da família (BA3_COBNIV == '1)

2. Data-base do contrato >= 01/12/2024 (BA3_DATBAS)

3. Dois ou mais títulos em atraso, sendo um com 50 dias ou mais

🔽 Filtros Disponíveis

• Mais de 50 Dias de Atraso Sem Envio de Notificação

  • Deve atender todas as premissas

  • Não possuir interações registradas

  • ❌ Não estar internado (BE4_DTDIGI)

...

...

>> Seção Contatos Realizados <<

A seção de Contatos Realizados é onde ficam registradas todas as interações com o cliente, seja quando a empresa entra em contato com o beneficiário ou quando o beneficiário entra em contato com a empresa.

...

1. Para incluir um registro, clique no botão incluir e insira os dados referentes ao contato realizado.

Campos disponíveis:

📩 Cont. Conf ? (BRZ_CNFCON)

• Indica se o recebimento do contato foi confirmado, conforme o meio de comunicação utilizado.
  Valores possíveis:

...

      > 1 – Recebimento confirmado

📅 Data do Contato (BRZ_DATCON)

• Data em que o contato com o beneficiário foi realizado.

⏰ Hora do Contato (BRZ_HORCON)

• Horário em que o contato foi efetuado.

🗓️ Data de Criação (BRZ_DATCRI)

• Data em que o registro foi criado na tabela.

🕒 Hora de Criação (BRZ_HORCRI)

• Horário em que o registro foi inserido na tabela.

...

>> Criação de Botões Customizados <<

Através do Ponto de entrada PLMON001, é possível criar botões na rotina, permitindo a criação de quantos botões forem necessários com as funcionalidades desejadas.

...

function PLMON001()
     LOCAL aMenu := {}
     AADD(aMenu, {"Teste Botão 1", {||U_botao1()}})
     AADD(aMenu, {"Teste Botão 2", {||U_botao2()}})
return aMenu

Image Modified

...

>> Ponto de Entrada do Status de Contato <<

Através do Ponto de entrada PLMON002, é possível criar status relacionados à tabela de contatos realizados (BRZ).

...

...

>> Recuperar Seleção de Beneficiários <<

• Os beneficiários selecionados no mark browse não podem ser passados diretamente como parâmetro para botões customizados ou em customizações relacionadas aos contatos realizados. Para contornar essa limitação, foi disponibilizado um método estático que retorna um objeto JSON contendo a lista dos beneficiários selecionados.
• Com a utilização desse método, a lista dos beneficiários selecionados na tela estará disponível em qualquer fonte, função ou método customizado enquanto o monitor de inadimplência estiver aberto.

Sintaxe

Retorno

...

oJSelecBeneficiaries := delinquency.monitor.DelinquencyInterface():getSelecBeneficiaries()

//O objeto retorna os seguintes atributos

//dados do beneficiário
//oJSelecBeneficiaries[nPosicao]["beneficiarie"]["register"] - Matrícula completa do beneficiário
//oJSelecBeneficiaries[nPosicao]["beneficiarie"]["name"    ] - Nome do beneficiário
//oJSelecBeneficiaries[nPosicao]["beneficiarie"]["email"]    - E-mail do beneficiário

//dados do cliente
//oJSelecBeneficiaries[nPosicao]["client"]["code" ] - Código do cliente e loja
//oJSelecBeneficiaries[nPosicao]["client"]["name" ] - Nome do cliente
//oJSelecBeneficiaries[nPosicao]["client"]["email"] - e-mail do cliente

...

>> Inserção de Dados na Tabela de Contatos Realizados (BRZ) <<

Dependendo da quantidade de contatos que precisam ser registrados — como no caso do envio de e-mails em massa para diversos beneficiários, onde é necessário gerar um registro de contato para cada envio —, é comum que customizações precisem lidar com essa geração em larga escala.

...

//Instancia a classe de serviços
oMonitorService := totvs.protheus.health.delinquency.monitor.DelinquencyService():New()

// Cria o objeto bulk
oMonitorService:createBulkContact()

For nSendMail := 1 To 100

	//Nesse momento os dados são gravados em um objeto mas serão efetivamente gravados na tabela quando somar 1000 registros inseridos no objeto
	//ou a cada execução do método flushBulkContact
   self:oMonitorService:insertDataBulkContact("00010001123456011", "01", "E-mail enviado para o beneficiário")
Next

//efetua a gravação dos dados contidos no objeto na tabela BRZ
oMonitorService:flushBulkContact()

Sintaxe

Parâmetros

Retorno

...

Hora Criação (BRZ_HORCRI) -  Irá gravar a hora em que o registro foi gerado. 

...

>> Consultar Tabelas Temporárias <<

Os dois grids (beneficiários e títulos) utilizam tabelas temporárias. Para ter acesso utilizando a sintaxe ADVPL, use o alias BENEINAD (beneficiários) e BENEFINA (títulos).

...

Em casos em que os dados das tabelas temporárias precisem ser utilizadas diretamente em uma query, em um join com outra tabela do sistema por exemplo, se faz necessário informar o nome real da tabela no banco de dados, pois o alias não funciona para tabelas temporárias. Dessa forma, disponibilizamos dois métodos que basicamente retornam o nome real das tabelas temporárias de beneficiário e do financeiro naquele momento (o nome muda dinamicamente a cada execução da rotina ou atualização da tela).

Sintaxe (tabela beneficiários BENEINAD)

Retorno

cRealTable := totvs.protheus.health.delinquency.monitor.DelinquencyService():realNameBeneficiaries()
oExecQuery := FWExecStatement():New()

//não é necessário utilizar o campo D_E_L_E_T_ pois a temporária possui apenas registros ativos
cSQL := " SELECT *"
cSQL += " FROM " + cRealTable

oExecQuery:SetQuery( cSQL )

cAliasTemp := oExecQuery:OpenAlias()

Sintaxe (tabela de Titulos BENEFINA)

Retorno

cRealTable := totvs.protheus.health.delinquency.monitor.DelinquencyService():realNameInvoices()
oExecQuery := FWExecStatement():New()

//não é necessário utilizar o campo D_E_L_E_T_ pois a temporária possui apenas registros ativos
cSQL := " SELECT *"
cSQL += " FROM " + cRealTable

oExecQuery:SetQuery( cSQL )

cAliasTemp := oExecQuery:OpenAlias()

cTitulo := (cAliasTemp)->E1_NUM

...

>> Ambiente Com Banco de Dados Oracle <<

O monitor de inadimplência utiliza tabelas temporárias para armazenar tanto os dados dos beneficiários quanto os títulos em aberto. No entanto, o banco de dados Oracle possui uma particularidade: os dados inseridos em uma tabela temporária durante uma seção não ficam visíveis em outras sessões.

...

04. DEMAIS INFORMAÇÕES

Atualização do Dicionário de Dados

inclusão de itens da tabela BRZ no Arquivo SX3:

...

Campo

...

Tipo

...

Tamanho

...

Decimal

...

Titulo

...

Descrição

...

Picture

...

Validação

...

Relação

...

F3

...

Trigger

...

Usado

...

Obrigatório

...

Exibe Browser

...

Visual

...

Contexto

...

CBox

...

Inicializa Browse (INIBRW)

...

Help

...

Filial    

...

Filial do Sistema  

...

Cont. Conf ?  

...

Indica se o recebimento do contato foi confirmado, conforme o meio de comunicação utilizado.

...

Data Contato

...

Data em que o contato com o beneficiário foi realizado.

...

Hora Contato

...

Hora em que o contato foi realizado.

...

Origem cont.

...

Origem do contato.

...

Desc. Origem

...

Descrição da origem.

04. DEMAIS INFORMAÇÕES

Atualização do Dicionário de Dados

Inclusões na tabela SX2 (Tabela):

Inclusão no Arquivo SIX (índices):

Inclusão de itens no Arquivo SX3 (campos da tabela):

Inclusão no arquivo SX1 (Pergunte):

Inclusão no arquivo SX6 (Parâmetros do Sistema):

Inclusão no Arquivo SX7 (gatilhos):

Inclusão no arquivo SX9 (Relacionamento):

Inclusão no arquivo SXB (Consulta Padrão):

> Consulta padrão EMPIND:

> Consulta padrão CONIND:

> Consulta padrão SUBIND:

>> Importante

Card documentos
Informacao As alterações de dicionário referente a essa implementação estarão disponíveis através de pacote de expedição contínua do plano de saúde com data igual ou superior 16/06/2025. Titulo °

05. ASSUNTOS RELACIONADOS

• DT Gerenciador de Contas de E-mail
• Resolução Normativa 593 - ANS
• AdvPl Utilizando MVC

...

Matrícula

...

Matrícula completa do beneficiário.

...

Beneficiário

...

Nome do beneficiário.

...

Mot. Contato

...

Motivo do contato.

...

Data Criação

...

Data de criação do registro.

...

Hora Criação

...