Informações Gerais

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

Objetivo

 Esse requisito tem por objetivo o desenvolvimento de melhorias solicitadas por clientes que estão migrando do Logix para o Protheus.

Migrador - Importação Cadastro Plano de Saúde

Definição da Regra de Negócio

Em continuação ao projeto de migração de produto do RH Logix para o RH Protheus 11.80, será adicionada a opção Plano de Saúde no programa RHIMP01 - Importação Logix X Protheus a fim de importar os dados referentes aos cadastros de fornecedores de plano de saúde, configuração do plano e planos ativos dos funcionários e dependentes.

Este requisito trabalha em conjunto à implementação realizada no Logix, Export_Vale_Alimentacao_e_Refeicao_e_Plano_de_Saude, que trata o processo de exportação de dados do Logix gerando o arquivo plano_saude_logix.unl a ser utilizado na importação de dados no Protheus.

Atenção: necessário estar com as tabelas da rotina Manutenção de Tabelas criadas (entrar pelo menos uma vez na rotina para criá-las automaticamente – SIGAGPE / Atualizações / Definições de Cálculo / Manutenção de Tabelas).

Para os itens Fornecedores e Cadastro de Planos será realizada a gravação dos dados nas tabelas auxiliares presentes na rotina Manutenção de Tabelas (GPEA320) que são gravadas fisicamente na tabela RCC - Parâmetros.

A estrutura das tabelas auxiliares são definidas através da rotina Manutenção de Tabelas (GPEA310) que grava os dados fisicamente na tabela RCB - Configuração de Parâmetros.

Para realizar a gravação dos registros do arquivo, será necessário verificar a estrutura presente na tabela RCB antes de gravar os dados na RCC.

As informações apresentadas nesta especificação serão baseadas na configuração padrão das tabelas a fim de facilitar o entendimento do processo de gravação. Porém, no momento da gravação será necessário verificar a estrutura na RCB. Os campos presentes na RCB referem-se aos campos da tabela auxiliar e o conteúdo desses 'campos' deverão ser gravados todos no campo RCC_CONTEU, obedecendo o tamanho e ordem apresentada na RCB.

Tabelas utilizadas e suas estruturas:

O arquivo plano_saude_logix.unl possui uma estrutura dividida em três partes abrangendo os seguintes cadastros:

• Fornecedor de Plano de Saúde Médico e Odontológico

• Os registros do tipo '1' presentes no arquivo de importação plano_saude_logix.unl serão gravados na tabela RCC - Parâmetros referente à rotina Manutenção de Tabelas do SIGAPGE.
• Os dados de cada registro serão guardados em um array de arrays aFornec, sendo a primeira dimensão cada fornecedor e a segunda os dados de cada fornecedor. Para facilitar a gravação, os campos serão guardados no array já realizando os tratamentos de tamanho e valor necessários.
• A posição do array aFornec[x][1] guardará o código do Fornecedor. Como no Protheus o campo possui uma posição a mais, adicionar um 0 (zero) à esquerda do código enviado no arquivo: 0 + codigo.
• A posição do array aFornec[x][2] guardará o nome do Fornecedor. Guardar o nome do Fornecedor completando os 150 caracteres com espaços: PadR(nome + Space(150),150)
• A posição do array aFornec[x][3] guardará o código de cnpj do Fornecedor. 
• A posição do array aFornec[x][4] guardará o Registro da ANS do Fornecedor.
• A posição do array aFornec[x][5] guardará o código da tabela a qual pertence o Fornecedor. A princípio o campo ficará vazio e depois será preenchido durante a validação dos registros do tipo '2'.
  • No Protheus, utiliza-se duas tabelas auxiliares para gravar os dados de Fornecedores de Planos Assistenciais: 
    • S016 - Fornecedor de Plano Assistencial Médico
    • S017 - Fornecedor de Plano Assistencial Odontológico
    • Como no arquivo, os registros do tipo '1' não possuem a identificação de M ou O, será necessário realizar essa identificação no momento da leitura dos registros do tipo '2' presente no arquivo.
    • Definir o Tipo de Fornecedor através da posição 5 dos registros tipo '2' do arquivo a fim de definir a tabela auxiliar onde será gravado o registro:
      
      • Se M, gravar o campo RCC_CODIGO com conteúdo S016.
      • Se O, gravar o campo RCC_CODIGO com conteúdo S017. 
• O campo RCC_SEQUEN será preenchido de forma sequencial no momento da gravação. Verificar a última sequencia presente na RCC, para a chave RCC_FILIAL + RCC_CODIGO
• O campo RCC_CONTEU receberá em forma de string todos os dados do registro gravado na seguinte ordem: aFornec[x][1]+aFornec[x][2]+aFornec[x][3]+aFornec[x][4]
• Os campo RCC_FILIAL, RCC_FIL e RCC_CHAVE ficarão em branco.
• Antes de realizar a gravação dos dados, verificar:
  • Se já existir o código de Fornecedor cadastrado: aFornec[x][1] == Substr(RCC_CODIGO,1,3) – não efetuar gravação, gerar log.

Exemplo do registro no arquivo:

1|99|XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX|99999999999999|99999999

• Faixas Plano de Saúde

Para facilitar o desenvolvimento e entendimento das regras, será separada a análise da Faixa de Plano de Saúde por Valor Fixo e a Faixa de Plano de Saúde por Idade.

• • Por Valor Fixo

• Os registros do tipo '2' presentes no arquivo de importação plano_saude_logix.unl serão gravados na tabela RCC - Parâmetros referente à rotina Manutenção de Tabelas do SIGAGPE.
• Os dados de cada registro serão guardados em um array de arrays aConfPlan1, sendo a primeira dimensão cada configuração e a segunda os dados de cada plano. Para facilitar a gravação, os campos serão guardados no array já realizando os tratamentos de tamanho e valor necessários.
• A posição do array aConfPlan1[x][1] guardará o código do Fornecedor. Como no Protheus o campo possui uma posição a mais, adicionar um 0 (zero) à esquerda do código enviado no arquivo: 0 + código.
• A posição do array aConfPlan1[x][2] guardará o código Plano a ser cadastrado.
  • Verificar o tamanho do campo (RCB_TAMAN onde RCB_CAMPOS = 'CODIGO' e RCB_CODIGO = 'S028'/'S030').
  • Caso o tamanho seja menor, emitir mensagem ao usuário perguntando se deseja prosseguir com o processo de nova numeração ou abortar a importação para ajustar a tabela.
    • Caso a resposta seja positiva, no momento da gravação utilizar um novo código, seguindo a sequencia presente na tabela.
    • Obs.: A pergunta pode ser feita antes do início do processamento, como forma de configuração, a fim de facilitar e agilizar o processo.
  • Será necessário possuir um De/Para interno para quando realizar a leitura dos registros do tipo '3' se identifique a qual plano o funcionário está atrelado.
• A posição do array aConfPlan1[x][3] guardará a descrição do Plano a ser cadastrado.
  • Verificar o tamanho do campo (RCB_TAMAN onde RCB_CAMPOS = 'DESCRICAO' e RCB_CODIGO='S028'/'S030').
  • Caso o tamanho seja menor, emitir mensagem ao usuário perguntando se deseja prosseguir com o processo, cortando os caracteres a mais ou abortar a importação para ajustar a tabela.
    • Obs.: A pergunta pode ser fieta antes do início do processamento, como forma de configuração, a fim de facilitar e agilizar o processo.
• A posição do array aConfPlan1[x][4] guardará o valor do Plano a ser cadastrado.
• A posição do array aConfPlan1[x][5] guardará a tabela onde o registro será gravado. 
  • No Protheus, utiliza-se diversas tabelas para gravar as faixas dos diversos tipos de Plano Assistencial, sempre diferindo o tipo médico do tipo odontológico. Para o tipo valor fixo, são utilizadas as tabelas:
    • S028 - Assistência Médica Valor Fixo
    • S030 - Assistência Odontológica Valor Fixo
    • Ao verificar o conteúdo a posição 5 do registro:
      • Se M, preencher o array aConfPlan1[x][5] com conteúdo S028.
      • Se O, preencher o array aConfPlan1[x][5] com conteúdo S030.
    • Sendo a posição aConfPlan1[x][1] == aFornec[x][1], então aFornec[x][5] := aConfPlan1[x][5]
  • O conteúdo da posição aConfPlan1[x][5] será gravado no campo RCC_CODIGO.

• O campo RCC_SEQUEN será preenchido de forma sequencial no momento da gravação. Verificar a última sequencia presente na RCC, para a chave RCC_FILIAL + RCC_CODIGO.
• O campo RCC_CONTEU receberá em forma de string todos os dados do registro gravado na seguinte ordem: aConfPlan1[x][2]+aConfPlan1[x][3]+aConfPlan1[x][4]+aConfPlan1[x][4]+aConfPlan1[x][4]+Space(08)+0.00+Space(08)+0.00+Space(08)+0.00+aConfPlan1[x][1]
• Os campo RCC_FILIAL, RCC_FIL e RCC_CHAVE ficarão em branco.
• Verificações necessárias para gravação:
  • Assim como nas rotinas de migração dos outros itens, indicar mensagem sobre a divergência no tamanho dos campos e se o usuário confirmar, realizar o corte da informação para gravação dos dados. (Lembrando de realizar a verificação antes de carregar a informação no array)
  • Realizar gravação dos Planos apenas se houver Fornecedor cadastrado nas tabelas S016 (quando plano médico) ou S017 (quando plano odontológico).

Exemplo do registro no arquivo:

2|99|99|XXXXXXXXXXXXXXXXXXXX|X|9999.99|V||||||||

2|99|99|XXXXXXXXXXXXXXXXXXXX|X|9999.99|V||

• • Por Idade

• Os registro do tipo '2' presentes no arquivo de importação plano_saude_logix.unl  serão gravados na tabela RCC - Parâmetros referente à rotina Manutenção de Tabelas do SIGAGPE.
• Os dados de cada registro serão guardados em um array de arrays aConfPlan2, sendo a primeira dimensão cada configuração e a segunda os dados de cada plano. Para facilitar a gravação, os campos serão guardados no array já realizando os tratamentos de tamanho e valor necessários.
• Os registro do tipo '2' presentes no arquivo de importação plano_saude_logix.unl  serão gravados na tabela RCC - Parâmetros referente à rotina Manutenção de Tabelas do SIGAGPE.
• Os dados de cada registro serão guardados em um array de arrays aConfPlan2, sendo a primeira dimensão cada configuração e a segunda os dados de cada plano. Para facilitar a gravação, os campos serão guardados no array já realizando os tratamentos de tamanho e valor necessários.
• A posição do array aConfPlan2[x][1] guardará o código do Fonecedor. Como no Protheus o campo possui uma posição a mais, adicionar um 0 (zero) à esquerda do código enviado no arquivo: 0 + código.
• A posição do array aConfPlan2[x][2] guardará o código do Plano a ser cadastrado.
  
• Verificar o tamanho do campo (RCB_TAMAN onde RCB_CAMPOS = 'CODIGO' e RCB_CODIGO = 'S009'/'S014').
• Caso o tamanho seja menor, emitir mensagem ao usuário perguntando se deseja prosseguir com o processo de nova numeração ou abortar a importação para ajustar a tabela.
  • Caso a resposta seja positiva, no momento da gravação utilizar um novo código, seguindo a sequencia presente na tabela.
  • Obs.: A pergunta pode ser feita antes do início do processamento, como forma de configuração, a fim de facilitar e agilizar o processo.
Será necessário possuir um De/Para interno para quando realizar a leitura dos registros do tipo '3' se identifique a qual plano o funcionário está atrelado
• A posição do array aConfPlan2[x][31] guardará o código do Fonecedor. Como no Protheus o campo possui uma posição a mais, adicionar um 0 (zero) à esquerda do código enviado no arquivo: 0 + código.
• A posição do array aConfPlan2[x][2] guardará o código do Plano a ser cadastrado.
  a descrição do Plano a ser cadastrado.
  
  • Verificar o tamanho do campo (RCB_TAMAN onde RCB_CAMPOS = 'DESCRICAOCODIGO' e RCB_CODIGO = 'S028S009'/'S030S014').
  • Caso o tamanho seja menor, emitir mensagem ao usuário perguntando se deseja prosseguir com o processo , cortando os caracteres a mais de nova numeração ou abortar a importação para ajustar a tabela.
    • Caso a resposta seja positiva, no momento da gravação utilizar um novo código, seguindo a sequencia presente na tabela.
    • Obs.: A pergunta pode ser fieta feita antes do início do processamento, como forma de configuração, a fim de facilitar e agilizar o processo.
  • Será necessário possuir um De/Para interno para quando realizar a leitura dos registros do tipo '3' se identifique a qual plano o funcionário está atrelado
• A A posição do array aConfPlan2[x][43] guardará a descrição do Plano a ser cadastrado.
  
  • Verificar o tamanho do campo (RCB_TAMAN onde RCB_CAMPOS = 'DESCRICAO' e RCB_CODIGO='S028'/'S030').
  • Caso o tamanho seja menor, emitir mensagem ao usuário perguntando se deseja prosseguir com o processo, cortando os caracteres a mais ou abortar a importação para ajustar a tabela.
    • Obs.: A pergunta pode ser fieta antes do início do processamento, como forma de configuração, a fim de facilitar e agilizar o processo.
• A fim de facilitar a gravação dos dados, a posição no array aConfPlan2 para cada tipo de beneficiário será fixa.
  • Possíveis tipos de beneficiários: T, D, A.
  • Os valores DT e AT não serão tratados no Protheus. Se houver algum registro com este conteúdo, emitir inconsistência no relatório de erros.
  • Se 'T', o valor da faixa será gravado na posição aConfPlan2[x][5]
  • Se 'D', o valor da faixa será gravado na posição aConfPlan2[x][6]
  • Se 'A', o valor da faixa será gravado na posição aConfPlan2[x][7]
  • Caso não haja valor para algum(ns) dos tipos, manter a posição com conteúdo em branco.
• A posição do array aConfPlan2[x][4] guardará a idade limite da faixa etária do plano.
  
  • Atenção!!
    
    • No arquivo, o registro com a configuração de plano por faixa etária pode vir com várias faixas na mesma linha, indicando os valores para um mesmo tipo de beneficiário de acordo com a faixa.
    • No Protheus, as configurações de faixa etária são feitas por faixa, indicando os valores de cada tipo (titular, beneficiário, agregado).
    • Nesses casos, será necessário incluir diferentes linhas do array aConfPlan2, uma linha para cada faixa. E, quando a faixa dos outros tipos for igual a uma já existente, adicionar o valor à linha já adicionada. Seguir o exemplo:
      • 2|99|9999|XXXXXXXXXXXXXXX|M||I|D|007|100.00|D|018|120.00|D|024|160.00|D|040|180.00|D|999|250.00|T|018|120.00|T|050|250.00|T|999|300.00|  
      • aConfPlan2[1][4] := '007'
        • Como tipo 'D', então aConfPlan2[1][6] := 100.00
      • aConfPlan2[2][4] := '018'
        • Como tipo 'D', então aConfPlan2[2][6] := 120.00
        • Como tipo 'T', então aConfPlan2[2][5] := 120.00
      • aConfPlan2[3][4]
  idade limite da faixa etária do plano.
  
  • Atenção!!
    
    • No arquivo, o registro com a configuração de plano por faixa etária pode vir com várias faixas na mesma linha, indicando os valores para um mesmo tipo de beneficiário de acordo com a faixa.
    • No Protheus, as configurações de faixa etária são feitas por faixa, indicando os valores de cada tipo (titular, beneficiário, agregado).
    • Nesses casos, será necessário incluir diferentes linhas do array aConfPlan2, uma linha para cada faixa. E, quando a faixa dos outros tipos for igual a uma já existente, adicionar o valor à linha já adicionada. Seguir o exemplo:
      • 2|99|9999|XXXXXXXXXXXXXXX|M||I|D|007|100.00|D|018|120.00|D|024|160.00|D|040|180.00|D|999|250.00|T|018|120.00|T|050|250.00|T|999|300.00|  
      • aConfPlan2[1][4] := '007'
        • Como tipo 'D', então aConfPlan2[1][6] := 100.00
      • aConfPlan2[2][4] := '018'
        • Como tipo 'D', então aConfPlan2[2][6] := 120.00
        • Como tipo 'T', então aConfPlan2[2][5] := 120.00
      • aConfPlan2[3][4] := '024'
        • Como tipo 'D', então aConfPlan2[3][6] := 160.00
      • aConfPlan2[4][4] := '040'
        • Como tipo 'D', então aConfPlan2[4][6] := 180.00
      • aConfPlan2[5][4] := '999'
        • Como tipo 'D', então aConfPlan2[5][6] := 250.00
        • Como tipo 'T', então aConfPlan2[5][5] := 300.00
      • aConfPlan2[6][4] := '050'
        • Como tipo 'T', então aConfPlan2[6][5] := 250.00
• A fim de facilitar a gravação dos dados, a posição no array aConfPlan2 para cada tipo de beneficiário será fixa.
  • Possíveis tipos de beneficiários: T, D, A.
  • Os valores DT e AT não serão tratados no Protheus. Se houver algum registro com este conteúdo, emitir inconsistência no relatório de erros.
  • Se 'T', o valor da faixa será gravado na posição aConfPlan2[x][5]
  • Se 'D', o valor da faixa será gravado na posição aConfPlan2[x][6]
  • Se 'A', o valor da faixa será gravado na posição aConfPlan2[x][7]
  • Caso não haja valor para algum(ns) dos tipos, manter a posição com conteúdo em branco.

• • • • •  então aConfPlan2[6][5] := 250.00
• O campo RCC_SEQUEN será preenchido de forma sequencial no momento da gravação. Verificar a última presente na RCC, para a chave RCC_FILIAL + RCC_CODIGO.
• O campo RCC_CONTEU receberá em forma de string todos os dados do registro gravado na seguinte ordem: aConfPlan2[x][2]+aConfPlan2[x][3]+aConfPlan2[x][4]+aConfPlan2[x][5]+aConfPlan2[6]+aConfPlan2[x][7]+Space(02)+'0.000'+Space(02)+'0.000'+Space(02)+'0.000'+aConfPlan2[x][1]
• Os campos RCC_FILIAL, RCC_FIL e RCC_CHAVE ficarão em branco.
• Verificações necessárias antes da gravação:
  • Assim como nas rotinas de migração dos outros itens, indicar mensagem sobre a divergência no tamanho dos campos e se o usuário confirmar, realizar o corte da informação para gravação dos dados. (Lembrando de realizar a verificação antes de carregar a informação no array)
  • Realizar gravação dos Planos apenas se houver Fornecedor cadastrado nas tabelas S016 (quando plano médico) ou S017 (quando plano odontológico).

Exemplo do registro no arquivo:

2|99|9999|XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX|X||X|X|999|99999999999999.99|

2|99|9999|XXXXXXXXXXXXXX|M||I|A|020|300.00|A|999|900.00|D|018|180.00|D|999|250.00|T|050|200.00|T|999|300.00|

2|99|9999|XXXXXXXXXXXXXXX|M||I|D|007|100.00|D|018|120.00|D|024|160.00|D|040|180.00|D|999|250.00|T|018|120.00|T|050|250.00|T|999|300.00|

• Planos Ativos 

• • Funcionários
  • Dependentes
  • Agregados

RASCUNHO - RETIRAR DEPOIS

Definição da Regra de Negócio

<Regra de negócio é o que define a forma de fazer o negócio, o processo definido e/ou as regras que devem ser contempladas. Devem ser descritas restrições, validações, condições e exceções do processo. Caso necessário, incluir neste capítulo também regras de integridade que devem ser observadas no momento do desenvolvimento>.

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

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

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