...

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

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

...

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

...

3. Estrutura da Interface

> Parte Superior: Dados do Beneficiário

...

• 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

...

4. Passo a Passo das Funcionalidades

Opção de Menu Novo Filtro

...

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

...

...

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

...

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

...

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

...

7. Ponto de Entrada do Status de Contato

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

...

...

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

...

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

...

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

...

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

...

10. Consulta a 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).

...

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

...

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

...