Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.

Informações Gerais

Especificação
Produto	Microsiga Protheus ®	Módulo	SIGAGPE
Segmento Executor	Serviços
Projeto¹	M_SER_RH003	IRM¹	PCREQ-9087
Requisito¹		Subtarefa¹
Chamado²
País	( X ) Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia ( ) Outro _____________.
Outros	<Caso necessário informe outras referências que sejam pertinentes a esta especificação. Exemplo: links de outros documentos ou subtarefas relacionadas>.

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

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

LOGIX		PROTHEUS
Cadastro De Entidades de Saúde (RHU0080)		Fornecedor Plano de Assistência Médica/Odontológica (GPEA320 - Tabelas S016 e S017)
Atributo	Tipo	Atributo	Tipo
Fixo 1 Identificador do Identifica o registro de Informações de Fornecedores	char (01)
cod_entid_saude Código da Entidade de Saúde (Fornecedor do Plano)	number (02)	codigo Código identificador do Fornecedor	char (03) picture: 999
den_entid_saude Descrição da Entidade Será enviado sem máscaras	char (30)	nome Nome do Fornecedor	char (150) picture: @!
cnpj Número do CNPJ Será enviado sem máscaras	char (14)	cnpj CNPJ do Fornecedor	char (14) picture: @R 99.999.999/9999-99
num_registro_ans Número do Registro da ANS	char (20)	regans Número do Registro da ANS	char (09) picture: 999999999
		*Todos os registros são de preenchimento obrigatório e deverão estar presentes no arquivo de importação.

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_FILIAL será preenchido no momento da gravação com a filial presente O campo RCC_SEQUEN será preenchido de forma sequencial no momento da gravação. Verificar a última sequencia presente na RCC, para a chava 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.??valida cnpj?

Exemplo do registro no arquivo:

1|99|XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX|99999999999999|99999999

Faixas Plano de Saúde
- Por Valor Fixo
- Por Idade

LOGIX		PROTHEUS
Cadastro De Planos de Saúde (RHU0090)		Faixas Plano de Assistência Médica/Odontológica (GPEA320 - Tabelas ??verificar??)
Atributo	Tipo	Atributo	Tipo
Fixo 2 Identifica o Registro de Informações de Plano de Saúde	char (01)
plano_saude.cod_entid_saude Código da Entidade de Saúde (Fornecedor do Plano)	number (02)
plano_saude.cod_plano_saude Código do Plano de Saúde	number (04)

Planos Ativos
- Funcionários
- Dependentes
- Agregados

plano_saude.des_plano_saude Descrição do Plano de Saúde	char (30)
Tipo de Plano Indica se o Plano de Saúde será O - Odontológico ou M - Médico Será necessário prever DE/PARA de códigos através do programa VDP10141 de acordo com os códigos de Entidade de Saúde e Plano de Saúde, cadastrados no RHU0090 - Plano de Saúde da seguinte forma: Tabela: PLANO_SAUDE Sistema Integração: Protheus De Campo: cod_plano_saude De Valor: Código do Plano de Saúde informado no RHU0090 De Campo:cod_entid_saude De Valor: Código da Entidade de Saúde informado no RHU0090 Para Valor: Deve ser informado os seguintes Valores O - Odontológico ou M - Médico Se não for cadastrado o DE/PARA das informações contidas no RHU0090 ou houver o cadastramento incorreto do valor no DE/PARA, será emitida mensagem de Alerta e será atribuído nos registros exportados o valor M - Médico	char (01)
plano_saude.val_plano Valor do Plano de Saúde Esta coluna será preenchida somente quando as opções Base_Calculo e Val_pl_idade do programa RHU0090 não tiverem valores preenchidos	number (11,2)
Forma de Cálculo Forma de Cálculo do Plano As opções que serão preenchidas serão: V - Valor : Quando não houver parametrização na opção Val_pl_idade do programa RHU0090 I - Idade : Quando houver houver parametrização na opção Val_pl_idade do programa RHU0090 B - Base de Cálculo: Quando houver parametrização na opção Base_cálculo do programa RHU0090 Se o plano de saúde for por Base de Cálculo será enviado somente as informações de códigos do plano e entidade, devido as regras e forma de parametrização de base de cálculo entre o Logix e Protheus serem totalmente divergentes. Será mostrado no relatório de erros no Logix para o usuário parametrizar no Protheus a base de cálculo do respectivo plano.	char (01)
Tipo de Beneficiário do Plano Para a Forma de Cálculo dos planos de saúde por idade, será atribuído os seguintes valores nesta coluna: T - Titular - Irá englobar a opção T - Titular, definido para o Tipo de Beneficiário do Plano D - Dependente : Irá englobar as opções D - Dependente Observação: No Protheus, não existe o conceito da opção DT - Dependente Titular Desta forma, os Tipos de Beneficiários que tiverem esta opção (DT) não serão exportados para o arquivo, sendo informada inconsistência no relatórios de erros. A - Agregado : Irá englobar as opções A - Agregado Observação: No Protheus, não existe o conceito da opção AT - Agregado Titular Desta forma, os Tipos de Beneficiários que tiverem esta opção (AT) não serão exportados para o arquivo, sendo informada inconsistência no relatórios de erros.	char (01)
rhu_pl_saude_idade.idade_faixa Para a Forma de Cálculo dos planos de saúde por idade, será atribuída nesta coluna o limite da faixa de idade Esta informação irá se repetir de acordo com a quantidade de faixas definidas	number (03)
rhu_pl_saude_idade.val_plano_saude Para a Forma de Cálculo dos planos de saúde por idade, será atribuída nesta coluna o valor do plano de saúde, conforme a faixa de idade Esta informação irá se repetir de acordo com a quantidade de faixas definidas	number (17,2)

Planos Ativos
- Funcionários
- Dependentes
- Agregados

LOGIX		PROTHEUS
Planos de Saúde (RHU3470)		Planos de Saúde Ativos (GPEA001)
Atributo	Tipo	Atributo	Tipo
Fixo 3 Identifica o Registro de Informações de Funcionários	char (01)
Empresa Protheus Enviar o código da Empresa Protheus, de acordo com a Empresa Logix Vinculada a Empresa Protheus no LOG00083 - Cadastro de Empresas	char (02)
Filial Protheus Enviar o código da Filial Protheus, de acordo com a Empresa Logix Vinculada a Empresa/Filial Protheus no LOG00083 - Cadastro de Empresas	char (08)
fun_plano_saude.num_matricula Número da Matrícula do Funcionário Será previso o DE/PARA de matrículas para o Protheus, se na exportação de funcionários houve esta necessidade	number (06)
Tipo de Plano Indica se o Plano de Saúde será O - Odontológico ou M - Médico Será necessário prever DE/PARA de códigos através do programa VDP10141 de acordo com os códigos de Entidade de Saúde e Plano de Saúde, cadastrados no RHU0090 - Plano de Saúde da seguinte forma: Tabela: PLANO_SAUDE Sistema Integração: Protheus De Campo: cod_plano_saude De Valor: Código do Plano de Saúde informado no RHU0090 De Campo:cod_entid_saude De Valor: Código da Entidade de Saúde informado no RHU0090 Para Valor: Deve ser informado os seguintes Valores O - Odontológico ou M - Médico Se não for cadastrado o DE/PARA das informações contidas no RHU0090 ou houver o cadastramento incorreto do valor no DE/PARA, será emitida mensagem de Alerta e será atribuído nos registros exportados o valor M - Médico	char (01)
fun_plano_saude.cod_entid_saude Código da Entidade de Saúde (Fornecedor do Plano)	number (02)
fun_plano_saude.cod_plano_saude Código do Plano de Saúde	number (04)
entid_saude_evento.cod_evento_desc Código do Evento, verba Protheus, que será realizado o desconto do funcionário A informação será considerada do programa RHU0080 - Entidades de Saúde, campo Evento Desconto Será utilizado DE/PARA de códigos de Eventos, definidos no Logix.	number (04)
fun_plano_saude.num_depend Código do Dependente, caso o plano de saúde se refira a dependente Se o Tipo de Beneficiário for para Agregado, esta informação não será preenchida	number (02)
dependente.nom_depend Nome do Dependente Esta informação será preenchida somente se o Tipo de Beneficiário do Plano for A - Agregado	char (70)
dependente.dat_nasc Data de Nascimento do Dependente Esta informação será preenchida somente se o Tipo de Beneficiário do Plano for A - Agregado	date
rhu_depend_docum.cpf Número do CPF do Dependente Esta informação será preenchida somente se o Tipo de Beneficiário do Plano for A - Agregado Esta informação não será obrigatória e caso tenha, será enviado sem máscaras.	char (14)
LOGIX		PROTHEUS
Planos de Saúde (RHU3470)		Planos de Saúde Ativos (GPEA001)
Atributo	Tipo	Atributo	Tipo

Configuração de Faixas do Plano
Logix		Protheus
Atributo	Tipo	Atributo	Tipo
Identificador Conteúdo fixo 2 a fim de identificar a informação a ser importada. Quando conteúdo 2 = Faixa Plano
Código do Fornecedor (RHU0080) Código de identificação do fornecedor.	char(02) \|99\|
Código do Plano Código de identificação do Plano	char(02) \|99\|
Descrição Descrição do Plano	char(20) \|XXXXXXXXXXXXXXXXXXXX\|
Tipo do Plano Código de identificação do Plano Fazer De/Para no VDP10141 do RHU0090 a fim de identificar se é: O - Odontológico M - Médico	Char(01) \|X\|
Valor Fixo Valor fixo do plano Utilizado em situações em que não haja definição de Base de Cálculo ou Faixa Etária	\|9999.99\|
Forma de Cálculo V - Valor Fixo I - Idade	\|V\| - \|I\|
Associado facultativo T - Titular D - Dependente DT - Dependente A - Agregado AT - Agregado	\|T\| - \|D\| - \|DT\| - \|A\| - \|AT\|
Idade facultativo Faixa 1 Montar a faixa no registro.	number(02) \|99\|
Valor facultativo Valor Faixa 1 Montar a faixa no registro.	number(07) \|999999.99\|
Idade facultativo Faixa 2	number(02) \|99\|
Valor facultativo Valor Faixa 2	number(07) \|999999.99\|
Idade facultativo Faixa 3	number(02) \|99\|
Valor facultativo Valor Faixa 3	number(07) \|999999.99\|
Idade facultativo Faixa 4	number(02) \|99\|
Valor facultativo Valor Faixa 4	number(07) \|999999.99\|
Observação: Se o plano de saúde for por Base de Cálculo não será enviado. Será mostrado relatório de erro no Logix para o usuário parametrizar no Protheus

Plano Ativos Funcionário
Logix		Protheus
Atributo	Tipo	Atributo	Tipo
Identificador Conteúdo fixo 3 a fim de identificar a informação a ser importada. Quando conteúdo 3 = Planos Ativos Funcionário
Empresa (RHU3470)	\|99\|
Filial (RHU3470)	\|99\|
Matricula (RHU3470)	\|999999\|
Tipo do Plano Código de identificação do Plano Fazer De/Para no VDP10141 do RHU0090 a fim de identificar se é: O - Odontológico M - Médico	\|X\|
Entidade Cadastrar DE/PARA no VDP10141, da tabela PLANO_SAUDE O usuário fará o cadastro das regras no Protheus	\|99\|
Plano Cadastrar DE/PARA no VDP10141, da tabela PLANO_SAUDE O usuário fará o cadastro das regras no Protheus	\|99\|
Verba Buscar a verba de desconto do RHU0080	\|999\|
Dependente facultativo Verificar se há dependentes/agregados e buscar informações do Plano no RHU0020 Se não tiver, deixar em branco. Se for agregado, não precisa levar o código do dependente	\|99\|
Nome facultativo Nome do Agregado	\|XXXXXXXXXXXXXXX\|
Data de Nascimento facultativo Data de Nascimento do Agregado	\|99/99/9999\|
CPF facultativo CPF do Agregado	\|99999999999\|
Observação O período será colocado como sendo o MV_FOLMES do Protheus

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

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

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*/

Índice	Chave
01	<FI9_FILIAL+FI9_IDDARF+FI9_STATUS>
02	<FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_EMISS+FI9_IDDARF>
03	<FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_PREFIX+FI9_NUM+FI9_PARCEL+FI9_TIPO>

Campo	<AAA_PERESP>
Tipo	<N>
Tamanho	<6>
Valor Inicial	<Varia de acordo com o tipo informado. Por exemplo, quando o campo “tipo” for date, neste campo pode ser informado uma data>.
Mandatório	Sim ( ) Não ( )
Descrição	<Referência Mínima para Cálculo>
Título	<Ref.Calc.>
Picture	<@E999.99>
Help de Campo	<Informar o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação>

(Opcional)

Grupo de Perguntas

<Informações utilizadas na linha Protheus>.

Nome: FINSRF2

X1_ORDEM	01
X1_PERGUNT	Emissão De
X1_TIPO	D
X1_TAMANHO	8
X1_GSC	G
X1_VAR01	MV_PAR01
X1_DEF01	Comum
X1_CNT01	'01/01/08'
X1_HELP	Data inicial do intervalo de emissões das guias de DARF a serem consideradas na seleção dos dados para o relatório

(Opcional)

Consulta Padrão

<Informações utilizadas na linha Protheus>

Consulta: AMB

Descrição	Configurações de Planejamento
Tipo	Consulta Padrão
Tabela	“AMB”
Índice	“Código”
Campo	“Código”; ”Descrição”
Retorno	AMB->AMB_CODIGO

Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.

Árvore de páginas

Versões comparadas

Versão antiga 10

Nova versão 11

Chave

Informações Gerais

Objetivo

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

Definição da Regra de Negócio

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

Faixas Plano de Saúde

Planos Ativos

Planos Ativos

Definição da Regra de Negócio

Opcional

Protótipo de Tela

Opcional

Fluxo do Processo

Opcional

Dicionário de Dados

(Opcional)

Grupo de Perguntas

(Opcional)

Consulta Padrão

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 10

Nova versão 11

Chave

Informações Gerais

Objetivo

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

Definição da Regra de Negócio

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

Faixas Plano de Saúde

Planos Ativos

Planos Ativos

Definição da Regra de Negócio

Opcional

Protótipo de Tela

Opcional

Fluxo do Processo

Opcional

Dicionário de Dados

(Opcional)

Grupo de Perguntas

(Opcional)

Consulta Padrão