Histórico da Página

Informações Gerais

Objetivo

O requisito tem como finalidade permitir que seja possível solicitar, via portal do beneficiário, inclusão de produto opcional para o grupo famíliar / grupo empresarial.

Além da possibilidade de solicitar a inclusão de opcionais, deverá existir uma tela para aprovação da solicitação, bem como incluir anexo e também opção de imprimir um formulário de inclusão ou exclusão do produto opcional.

Definição da Regra de Negócio

 A regra de negócio será dividida em duas partes: Portal e Remote

PORTAL 

1. No portal do beneficiário, deverá ser possível ao beneficiário / empresa solicitar produtos opcionais ao seu plano de saúde.
   1. Somente o beneficiário titular poderá solicitar produtos opcionais para ele e para sua família.
   2. A empresa poderá solicitar produtos opcionais para seus funcionários via portal empresa.
2. Os produtos do SIGAPLS são cadastrados na tabela BI3, em Atualizações->Produto Saúde->Produto Saúde (PLSA800).
   1. Nesse cadastro deverá ser criado um campo BI3_CLASSE, para vincular o produto saúde à uma classificação de produto.
      1. Não será necessário desenvolver esse cadastro de classificação de produto pois já existe um cadastro no SIGAPLS que se chama Classificação de Produtos, tabela (BY4), localizado em: 
         Atualizações->Produto Saúde->Classificação de Produto (PLSA251).
3. O portal deverá considerar como produto opcional somente os produtos saúde vinculados a um Grupo de produtos do tipo opcional.
   1. O vínculo entre Produto e Grupo de Produtos é feito pelo campo BI3_GRUPO.
   2. Por padrão, o grupo do tipo opcional cadastrado na rotina de Grupos de produto tem o código 002 mas podem existir outros grupos com o campo BE5_TIPO = 2 (Opcionais) que devem ser considerados.
   3. A rotina de Grupos de produtos utiliza a tabela BE5 e está localizada em Atualizações->Produto Saúde->Grupo de Produto (PLSA250).
4. O portal deverá considerar como produto opcional somente os produtos saúde vinculados a um Grupo de produtos do tipo opcional.
   1. O vínculo entre Produto e Grupo de Produtos é feito pelo campo BI3_GRUPO.
   2. Por padrão, o grupo do tipo opcional cadastrado na rotina de Grupos de produto tem o código 002 mas podem existir outros grupos com o campo BE5_TIPO = 2 (Opcionais) que devem ser considerados.
   3. A rotina de Grupos de produtos utiliza a tabela BE5 e está localizada em Atualizações->Produto Saúde->Grupo de Produto (PLSA250).
5. Como os produtos poderão ser classificados, para os produtos opcionais somente, deverá existir um menu para solicitação de opcional para cada classificação dos produtos.
   1. Deverá ser utilizada a mesma Web Function e o mesmo .APH para esses menus, a classificação será passada via parâmetro HttpGet na Url de chamada da página no portal.
      1. A Web Function terá o nome PPLSOLOP, se não for passada nenhuma classificação na Url, o portal deverá abrir uma página com todos os opcionais cadastrados, do contrário, deverá filtrar os opcionais pela classificação passada por parâmetro.
         1. Como chamar a Web Function sem parâmetro: W_PPLSOLOP.APW
         2. Como chamar a Web Function com parâmetro: W_PPLSOLOP.APW?cClass=01  supondo, logicamente que '01' represente uma classe de produto vinculada à um produto opcional.
            1. Para pegar o valor do parâmetro dentro da Web Function: HttpGet->cClass
         3. A
   Como os produtos poderão ser classificados, para os produtos opcionais somente, deverá existir um menu para solicitação de opcional para cada classificação dos produtos.
   1. Deverá ser utilizada a mesma Web Function e o mesmo .APH para esses menus, a classificação será passada via parâmetro HttpGet na Url de chamada da página no portal.
      1. A Web Function terá o nome PPLSOLOP, se não for passada nenhuma classificação na Url, o portal deverá abrir uma página com todos os opcionais cadastrados, do contrário, deverá filtrar os opcionais pela classificação passada por parâmetro.
         1. Como chamar a Web Function sem parâmetro: W_PPLSOLOP.APW
         2. Como chamar a Web Function com parâmetro: W_PPLSOLOP.APW?cClass=01  supondo, logicamente que '01' represente uma classe de produto vinculada à um produto opcional.
            1. Para pegar o valor do parâmetro dentro da Web Function: HttpGet->cClass
         3. A validação da solicitação de opcional, quando for específica de cada classe de produto será feita por pontos de entrada que não serão contemplados nessa Especificação.
      2. O título do formulário deverá também ser tratado dentro da Web Function de acordo com a classificação do produto. Por padrão será  “Solicitação de Opcional”.
         1. Exemplo: a classificação de produto tem a descrição "Opcional Odontológico", então o título do formulário será "Opcional Odontológico".
6. A tela de solicitação de opcionais deverá será composta por:ser criada usando a classe WCHTML e deverá ser composta por:
   1.  uma consulta F3 "Matrícula" de beneficiário se o usuário logado for uma empresa, pois geralmente há um grande número de beneficiários vinculados a uma empresa, essa consulta deverá retornar Matrícula e Nome do beneficiário em um campo "Nome" texto normal não editável.
      1. Lembrando que não é uma consulta padrão SXB, é uma consulta de portal, feita em javascript.
      2. EXPLICAR COMO FAZER UMA F3 NO PORTAL
   2. um combobox "Beneficiário" de beneficiários em que o "value" da option seja a matrícula do beneficiário e o texto da option seja o nome, esse combo será apenas se o usuário logado for um beneficiário, assim sendo, os outros beneficiários a ele vinculados serão apenas seus familiares, portanto um número pequeno de beneficiários.
   3. um campo data "Data adesão" que será carregado com a data do sistema e não deverá ser editável.
   4. um campo data "Data Limite" que será obrigatório e corresponde a data em o opcional será bloqueado. (usar o datepicker do Jquery)
      1. EXPLICAR COMO USAR O DATEPICKER
   5. um grid de opcionais com a primeira coluna sendo checkboxes para ser possível selecionar o opcional.
      1. deverá ser possível selecionar mais de um opcional para cada beneficiário selecionado e então clicar no botão inserir.
      2. EXPLICAR O RDBRW PARA CARREGAR OS OPCIONAIS       
   6. um grid de beneficiários que será populado cada vez que o usuário do portal clicar em "Inserir".
      1. Se for selecionado n opcionais, deverão ser adicionadas n linhas.
      2. EXPLICAR COMO ADICIONAR LINHAS NA GRID.
7. Quando o usuário clicar em confirmar a solicitação, se houver algum ponto de entrada para validação de regras específicas de classificação de produto, eles deverão ser executados, caso todas validações retornem .T. , deverá ser gravada uma solicitação de adição de opcionais e também deverá ser gerado um protocolo para acompanhamento da solicitação ao beneficiário.
8. Se houver documentos necessários vinculados à adição do Opcional, deverá ter um botão na grid de beneficiários que abrirá uma modal do Bootstrap com uma grid de todos os documentos que devem ser vinculados, o usuário não será obrigado a anexar os documentos, mas a solicitação será gravada com status "Pendente de documentação".
   
   1. Será uma solicitação para cada Beneficiário x Opcional.
   2. VERIFICAR O CADASTRO DE DOCUMENTOS PARA OPCIONAIS
9. Se não houver documento vinculado a adição do opcional, gravar a solicitação com status "Em análise".
10. A solicitação deverá ser gravada na tabela B7L e a análise da solicitação será feita de maneira semelhante a análise de solicitação de alteração de dados cadastrais da Rede de Atendimento, rotina PLSA814.
    
    1. VERIFICAR COM O OSCAR QUAIS SÃO AS TABELAS E CAMPOS QUE PRECISO GRAVAR PARA FAZER UMA SOLICITAÇÃO E EXPLICAR AQUI.
    2. Se a solicitação de cada opcional for aprovada, os dados do beneficiário e do opcional devem ser gravados na tabela BF4 - Opcionais dos usuários e deve mudar o status para Deferido.
    3. Se a solicitação não for aprovada, deverá apenas mudar o status da solicitação para Indeferido.
11. O usuário poderá consultar o status de cada solicitação feita para cada beneficiário e opcional via protocolo recebido quando a solicitação foi confirmada no portal.
    1. Nessa tela o usuário poderá anexar os possíveis documentos faltantes.
12. Deverá ser criado um parâmetro MV_MOTOPC que deverá gravar o código de motivo de bloqueio de opcional padrão para quando a atingir a data limite do opcional, ser gravado este código na tabela BF4 (Opcionais de usuários).

 

 

<Na tabela abaixo informe quais são as rotinas envolvidas, o tipo de operação, a opção de menu e se necessário uma breve descrição das regras de negócio relacionadas a rotina>.

 

Rotina	Tipo de Operação	Opção de Menu	Regras de Negócio
[ACAA040 – Parâmetros]	[Alteração]	[Atualizações -> Acadêmico-> Tesouraria]	-
[ACAA050 – Negociação Financeira]	[Envolvida]	[Atualizações -> Acadêmico-> Tesouraria]	-
[ACAA060 – Cadastro de Pedidos]	[Criação]	[Atualizações -> Acadêmico-> Cadastros]	-

 

Exemplo de Aplicação:

• Criar o campo “% Mínimo Espécie” (AAA_PERESP) onde o usuário informará o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação.
• Criar o campo “Referência Mínima para Cálculo” (AAA_REFCAL) onde o usuário informará um dos 4 valores disponíveis para pagamento das mensalidades  como a referência mínima para calcular o débito total do aluno.
• Criar o parâmetro MV_ACPARNE que definirá se as informações de “% Mínimo Espécie” e “Referência Mínima para Cálculo” serão obrigatórias.
• O parâmetro MV_ACPARNE deve ter as seguintes opções: 1=Obrigatório e 2=Opcional. Deve ser inicializado como opcional>.

 

Tabelas Utilizadas

• SE2 – Cadastro de Contas a Pagar
• FI9 – Controle de Emissão de DARF>.

Opcional

Protótipo de Tela

<Caso necessário inclua protótipos de telas com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software>.

Protótipo 01

 Image Removed

Opcional

Fluxo do Processo

<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>. 

Opcional

Dicionário de Dados

Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/

(Opcional)

Grupo de Perguntas

<Informações utilizadas na linha Protheus>.

Nome: FINSRF2

(Opcional)

Consulta Padrão

<Informações utilizadas na linha Protheus>

Consulta: AMB

1. 1. 1. No .APH PPLCHACPR tem uma F3 de beneficiários, basta seguir o mesmo exemplo.

         oMatUsu:=WCComponent():New("F","Field_MATUSU","Matricula", "26","21")
oMatUsu:setJSKeyPre("return TxtBoxFormat(this, event,'9999.9999.999999.99-9');")
oMatUsu:setJsFF3("return ChamaPoP('W_PPLSXF3.APW?cFunName=PLSF3BA1&F3Nome=Field_MATUSU&F3CmpDes=Field_MATUSU,Field_NOMUSR','jF3','yes');")
oMatUsu:setJSBlur("fCheckMat(this);")
oMatUsu:setObrigat(.T.) 

   2. um combobox "Beneficiário" de beneficiários em que o "value" da option seja a matrícula do beneficiário e o texto da option seja o nome, esse combo será apenas se o usuário logado for um beneficiário, assim sendo, os outros beneficiários a ele vinculados serão apenas seus familiares, portanto um número pequeno de beneficiários.
   3. um campo data "Data adesão" que será carregado com a data do sistema e não deverá ser editável.
   4. um campo data "Data Limite" que será obrigatório e corresponde a data em o opcional será bloqueado. (usar o datepicker do Jquery)
      1. Criar o componente como foi criado no exemplo acima, mas olhar as propriedades existentes no WCComponent para usar somente o necessário.
         Para usar o datepicker basta setar a propriedade 'data' do componente utilizando:
                oDataLim:setData(.T.) 
   5. um grid de opcionais com a primeira coluna sendo checkboxes para ser possível selecionar o opcional.
      1. deverá ser possível selecionar mais de um opcional para cada beneficiário selecionado e então clicar no botão inserir.
      2. Para criar uma grid, utilize o .APH PPLCHABOL como exemplo. Ele usar uma Web Function chamada PPLGETDGRI que chama o método Web Service getDadGrid que executa uma User Funcion passada por HttpGet para a Web Function, essa User Function deverá ficar localizada no fonte PPLSRDBRW e deverá fazer um Select na tabela BI3, filtrando os produtos vinculados a grupos de produto do tipo Opcional e se houver classificação de produto vinculada, deverá acrescentar como filtro também.    
   6. um grid de beneficiários que será populado cada vez que o usuário do portal clicar em "Inserir".
      1. Se for selecionado n opcionais, deverão ser adicionadas n linhas.
      2. Para adicionar 1 ou N linhas de uma vez na grid, vai ser necessário criar uma nova função, que fique genérica de preferência, mas pode-se utilizar como base a função JavaScript fMntIteGen que fica no arquivo jspls.js.
2. Cada vez que o usuário clicar em Inserir, para incluir o beneficiário e seus opcionais na grid de beneficiários, o sistema deverá validar:
   
   1. Se já existe o produto opcional inserido para o beneficiário na grid. Se já existir, não deve adicionar novamente e notificar o usuário com uma mensagem.
   2. Se já existir o produto opcional cadastrado e em vigência para o beneficiário. Se já existir, não deve adicionar e deve aparecer uma mensagem.
3. Quando o usuário clicar em confirmar a solicitação, se houver algum ponto de entrada para validação de regras específicas de classificação de produto, eles deverão ser executados, caso todas validações retornem .T. , deverá ser gravada uma solicitação de adição de opcionais ( que será criada no Protheus ) e também deverá ser gerado um protocolo para acompanhamento da solicitação ao beneficiário.
4. Se houver documentos necessários vinculados à adição do Opcional, ao confirmar a solicitação, o usuário será redirecionado para uma tela de anexo de documentos, o usuário não será obrigado a anexar os documentos, mas a solicitação será gravada com status "Pendente de documentação".
   1. O usuário poderá anexar um arquivo compactado com todos os documentos ou anexar vários documentos.
   2. Será apenas uma solicitação gerada para todos os beneficiários e seus opcionais.
5. Se não houver documento vinculado a adição do opcional ou o usuário adicionar pelo menos um documento, gravar a solicitação com status "Em análise".
6. O usuário poderá consultar o status da solicitação feita com o protocolo recebido quando a solicitação foi confirmada no portal.
   1. Nessa tela o usuário poderá anexar os possíveis documentos faltantes.
   2. Somente deverá ser possível anexar documentos nas solicitações com status "Pendente de documentação".
   3. Após o usuário anexar os documentos, o status geral da solicitação deverá ser alterado novamente para "Em análise"
   4. O status deverá ser também por Opcional, pois a aprovação na tela de análise de solicitação de adição de opcionais ( que será criada no Protheus ) será por item.
7. Todas as telas que utilizam seleção de beneficiários com consulta F3 devem ser alteradas para combobox quando for portal do beneficiário, se for portal empresa, permanecem as consultas F3.

Remote

1. Os produtos do SIGAPLS são cadastrados na tabela BI3, em Atualizações->Produto Saúde->Produto Saúde (PLSA800).
   1. Nesse cadastro deverá ser criado um campo BI3_CLASSE, para vincular o produto saúde à uma classificação de produto.
      1. Não será necessário desenvolver esse cadastro de classificação de produto pois já existe um cadastro no SIGAPLS que se chama Classificação de Produtos, tabela (BY4), localizado em: 
         Atualizações->Produto Saúde->Classificação de Produto (PLSA251).
2. A solicitação gerada no portal deverá ser gravada na tabela BBA (Cabeçalho da solicitação) e BBW (Opcionais da solicitação).
   1. Deverá ser criada a rotina de análise da solicitação de opcionais.
      1. Deverá ser criada em MVC.
      2. Utilize a rotina PLSA814 como base para a criação desta nova.
      3. A tabela BBA será o cabeçalho da solicitação.
      4. A tabela BBW gravará os opcionais solicitados.
      5. Veja os campos necessários em cada tabela na parte de Dicionário de dados desta especificação.
         1. A tabela BBA deverá ter um campo de Observação para o analista da solicitação preencher e, quando o beneficiário consultar a solicitação, se este campo estiver preenchido ele poderá visualizar no portal.
            1. O ícone para visualizar a Observação deve aparecer se, e somente se o campo de Observação estiver preenchido.
            2. Se o usuário entrar na tela de análise e não modificar o valor do campo da observação, o sistema deverá exibir uma mensagem do tipo Sim/Não para notificá-lo de que o campo não foi alterado.  
         2. A tabela BBW irá gravar o código do opcional, a matrícula do beneficiário, data de adesão e data limite, deverá possuir um campo para incluir uma observação sobre o item e também um campo de status do item para ser visualizado no portal.
            1. Os status do item serão: Aprovado, Rejeitado e Pendente de documentação.
   2. Se a solicitação de cada opcional for aprovada, os dados do beneficiário e do opcional devem ser gravados na tabela BF4 - Opcionais dos usuários e deve mudar o status dos aprovados para Aprovado.
   3. Se a solicitação de cada opcional for rejeitada, deverá apenas mudar o status dos opcionais rejeitados solicitação para Rejeitado.
   4. Quando o analista da solicitação confirmar a tela, o status da solicitação deve ficar Processado se não houver nenhum item com Pendencia de documentação, e ainda deve ser exibida uma mensagem do tipo Sim/Não para verificar se o usuário deseja mesmo finalizar a solicitação, se for clicado em "Sim", mudar o status geral da solicitação para Processado, se for clicado em "Não" mudar o status geral da solicitação para Em Análise. 
      1. Se houver itens com Status "Pendente de documentação" e o usuário confirmar a solicitação o sistema deverá exibir um alerta ao usuário avisando que a solicitação ainda está em aberto pois há itens com falta de documentação.
   5. Quando a solicitação for finalizada, deverá ser gravada com Status Processado.
      1. Uma solicitação só pode ser alterada para Processado somente quando não houver nenhum item com Status Pendente de documentação.
      2. Não será possível alterar uma solicitação processada.
      3. Quando uma solicitação for finalizada, os opcionais aprovados devem ser replicados para a tabela BF4.
      4. Os status gerais da solicitação são: Em análise, Pendente de documentação (quando houver itens pendentes de documentação) e Processado (finalizada)
3. Deverá ser criado um campo na tabela BF4 chamado BF4_DATSOL que vai gravar a data em que foi solicitado o opcional, mas só será gravado se a análise da solicitação for aprovada.
4. No campo já existente BF4_DATBAS deverá ser gravada a data em que a solicitação foi aprovada.
5. No campo já existente BF4_DATBLO deverá ser gravada a data em que o opcional será bloqueado, esta data poderá ser alterada na análise da solicitação.
   
6. Deverá ser criado um parâmetro MV_MOTOPC que deverá gravar o código de motivo de bloqueio de opcional padrão para quando a atingir a data limite do opcional, ser gravado este código na tabela BF4 (Opcionais de usuários).
7. A rotina de perfil de acesso (PLSA008) deverá ser readaptada para atender o portal empresa.

Tabelas Utilizadas

• BE5 – Grupos de produto
• BY4 – Classificações de produto
• BI3 –   Produto Saúde
• BF4 – Opcionais dos usuários
• BBA – Cabeçalho Solicitações Beneficiários
  
• BBW – Opcionais da Solicitação

Protótipo de Tela

Protótipo 01 - Tela de Solicitação de Opcional - Portal Empresa

Image Added

Protótipo 02 - Tela de Solicitação de Opcional - Portal Beneficiário

Image Added

Protótipo 03 - Anexo de Documentos

Image Added

Protótipo 04 - Consulta de solicitações 

Image Added

Protótipo 05 - Interação de solicitações

Image Added

Protótipo 06 - Anexo de documentos na consulta de protocolo 

Image Added

Protótipo 07 - Tela da Análise de solicitação

Image Added

Fluxo do Processo

 Fluxo 01 - Solicitar o opcional no portal

Image Added

Fluxo 02 - Consultar a solicitação do opcional no portal

Image Added

Fluxo 03 - Análise da Solicitação no remote

Image Added

Caso de Uso

Image Added

Opcional

Dicionário de Dados

Parâmetro - MV_MOTOPC

Arquivo ou Código do Script: BI3 – Produto Saúde

Arquivo ou Código do Script: BF4 – Opcionais dos usuários

Arquivo ou Código do Script: BBA – Cabeçalho Solicitações Beneficiários

Arquivo ou Código do Script: BBW – Opcionais da Solicitação

Consulta Padrão

Consulta: BY4BI3

(Opcional)

Estrutura de Menu

<Informações utilizadas na linha Datasul>.

Procedimentos

Programas

Cadastro de Papéis

<O cadastro de papéis é obrigatório para os projetos de desenvolvimento FLEX a partir do Datasul 10>.

<Lembrete: o nome dos papeis em inglês descrito neste ponto do documento, devem ser homologados pela equipe de tradução>.