Inclusão/Troca Módulo

Introdução
Essa rotina irá incluir ou trocar o módulo para um beneficiário, de acordo com os parâmetros informados. Caso o beneficiário possua uma programação de troca de módulo futura, o usuário tem a permissão de trocá-lo. Neste caso, o programa recupera o módulo definido para troca futura, insere a data de Fim de Vigência no mesmo e cadastra o novo módulo para o beneficiário.

Pré-requisito
O módulo a ser incluído / trocado deve estar cadastrado para o modelo de contrato ou para o contrato do beneficiário.
O Tipo de Contratação do módulo inserido/trocado deverá ser igual ao Tipo de Contratação do modelo de contrato.
Será verificado se o tempo minimo de permanência no módulo já foi atingido, essa parametrização é feita em Módulo Operadora.

O tempo mínimo de permanência é calculado da seguinte forma: o somatório da data de aquisição do módulo vigente para o beneficiário e os dias definidos nos campos Permanência Mínima Grau >= ou Permanência Mínima Grau <, deve ser menor ou igual a data do dia, se não for, a troca não pode ser executada.
Caso o módulo assistencial tenha algum módulo acessório vinculado ou uma negociação de módulo acessório, o módulo acessório também deve estar cadastrado para o modelo de contrato ou contrato do beneficiário e, se existir algum acessório que possua uma negociação de módulo acessório que não esteja vinculado a nenhum contrato, modelo ou módulo, este também deve ser cadastrado para o modelo de contrato/contrato do beneficiário.
Para os módulos acessórios vinculados ao módulo assistencial através de uma Negociação de Módulo Acessório estes serão incluídos automaticamente para o beneficiário. O usuário também tem a opção de incluir módulos acessórios opcionais para o beneficiário, neste caso, os módulos acessórios não precisam estar vinculados a uma negociação, basta que seja informado o produto convênio associado ao módulo acessório.
Na inclusão ou troca de módulo, a Data Inicio de Vigência do novo módulo deverá ser maior que a Data Aquisição parametrizada no módulo atual do beneficiário. Além disso, caso o beneficiário ou o contrato possua uma suspensão com vinculo rescindido na data de início vigência do módulo incluído, não será realizada a troca.
Quando o módulo assistencial possuir módulos acessórios vinculados, e caso estes não estejam vigentes na negociação de aquisição de módulo, ou possuam fim de vigência menor que a data de início de vigência do beneficiário, estes módulos não serão incluídos no cadastro do módulo beneficiário.
Quando o módulo assistencial possuir módulos acessórios vinculados, estes não serão incluídos automaticamente para os beneficiários dependentes, caso estes dependentes não atendam as restrições de aquisição destes módulos.
Não será permitida a inclusão ou troca de módulo para beneficiários dependentes, quando o campo igual família da negociação de aquisição de módulo estiver marcado.

Atualizações realizadas
Para a inclusão de um módulo, cria-se um novo módulo beneficiário, atribuindo o beneficiário, início de vigência, módulo e a data base de cobertura.
Para a troca, já existe o módulo beneficiário com o módulo do tipo 1 - Produlo Assistencial e com fim de vigência nulo. Esse módulo beneficiário será atualizado, atribuindo o valor para fim de vigência (será sempre um dia anterior a data de início de vigência informada no parâmetro Início Vigência) e cria-se um novo módulo beneficiário atribuindo o beneficiário, início de vigência, módulo e a data base de cobertura. Ou seja, na troca o módulo existente é fechado e é feita a inclusão de um novo módulo.
Quando o parâmetro Data Base Calc for informado, o mesmo será gravada no módulo do beneficiário e servirá como referência para utilizar a tabela de preços.

Parâmetros de entrada

Pasta

Campo

Descrição

Tipo/Grid

Obrigatório

[Restrições]
Código Cartão Beneficiário
Código do cartão do beneficiário para o qual será feita a inclusão / troca de módulo.

[Restrições]
Beneficiário
Código do beneficiário para o qual será feita a inclusão / troca de módulo.

Beneficiário

[Restrições]
Acomodação
Auto-preenchido de acordo com o beneficiário / contrato informado.

Acomodação

[Restrições]
Repasse
Auto-preenchido de acordo com o beneficiário / contrato informado.

Repasse do Beneficiário

[Restrições]
Módulo Origem Benef.

Módulo Operadora

[Restrições]
Módulo Destino Benef.
Define se será feita a inclusão ou a troca de um módulo.
Se o módulo informado for do tipo 1 - Produto Assistencial indica que se trata de uma troca de módulo.
Se o tipo do módulo for 9 - Acessório, indica que se trata de uma inclusão de módulo.

Módulo Operadora

Sim

[Restrições]
Data Base Cobertura
Data e hora de início de vigência das coberturas. Regras: 1) A Data Base Cobertura deixou de ser obrigatória; 2) Se preenchida, o processo deverá assumí-la sem qualquer tipo de consistência nos Módulos gerados por Inclusão ou Troca; 3) Se não for preenchida, deverá levar em consideração o conteúdo de TipoHerCarTransferencia existente em NegociacaoAqModulo, em que se o TipoHerCarTransferencia for NULL, deverá assumir 2 - Herda de Todos os Módulos. Neste caso, o conteúdo da Data Base de Cobertura será gerado conforme as seguintes condições: a) Se Tipo = 3 (HERDA_APENAS_O_ÜLTIMO_MODULO), a Data Base de Cobertura do Módulo será igual à do Módulo mais recente; b) Se Tipo = 2 (HERDA_DE_TODOS_OS_MODULOS), a Data Base de Cobertura do Módulo é igual à do Módulo com Data Base mais antiga do Beneficiário; c) Se Tipo de Herança = 1 (NAO_HERDA) ou se NÃO houver Módulos anteriores do Beneficiário, a Data Base de Cobertura do Módulo será igual à Data de Início de Vigência do Módulo do Beneficiário.

[Restrições]
Início Vigência
Data e hora de inclusão / troca do módulo para o beneficiário.

Sim

[Restrições]
Data Base Calc.
É a Data base para cálculo dos valores de mensalidade/franquia/participação do beneficiário. Esta data serve de referência para indicar a tabela de preço a ser verificada nas negociações cadastradas.

[Restrições]
Motivo

Motivo de Suspensão de Vínculo

Sim

[Restrições]
Produto Convênio
Indica o produto convênio associado ao módulo acessório o qual será incluído opcionalmente para o beneficiário.

Módulo do Acessório

[Restrições]
Verifica Modulo Competência

[Restrições]
Analisa Contrato Anterior
Esta opção deverá ser utilizada juntamente com o Intervalo e/ou Lista de Contratos. Se marcado, a Inclusão/Troca ocorrerá para os Beneficiários dos Contratos informados e para os Beneficiários Aposentado/Demitido que possuírem o Contrato como anterior.

.. [Início de Vigência do Beneficiário]
Início de Vigência Inicial
Intervalo inicial de Início de Vigência dos Beneficiários para os quais será feita a inclusão/troca de módulo.

.. [Início de Vigência do Beneficiário]
Início de Vigência Final
Intervalo final de Início de Vigência dos Beneficiários para os quais será feita a inclusão/troca de módulo.

.. [Contratos]
Contrato Inicial
Intervalo inicial de Contrato para seleção dos Beneficiários para os quais será feita a inclusão/troca de módulo.

Contrato

.. [Contratos]
Contrato Final
Intervalo final de Contrato para seleção dos Beneficiários para os quais será feita a inclusão/troca de módulo.

Contrato

.. [Modelos]
Modelo Inicial
Intervalo inicial de Modelo de Contrato para seleção dos Beneficiários para os quais será feita a inclusão/troca de módulo.

Modelo de Contrato

.. [Modelos]
Modelo Final
Intervalo final de Modelo de Contrato para seleção dos Beneficiários para os quais será feita a inclusão/troca de módulo.

Modelo de Contrato

.. [Tipos de Contratação]
Exceto
Se marcado, indica que os valores informados no grid deverão ser desconsiderados da seleção.

.. [Tipos de Contratação]
Tipos de Contratação
Relação de tipos de contratação para seleção dos Beneficiários para os quais será feita a inclusão/troca de módulo.

Tipos de Contratação

.. [Contratos]
Exceto
Se marcado, indica que os valores informados no grid deverão ser desconsiderados da seleção.

.. [Contratos]
Contratos
Relação de contratos para seleção dos Beneficiários para os quais será feita a inclusão/troca de módulo.

Contratos

.. [Modelos]
Exceto
Se marcado, indica que os valores informados no grid deverão ser desconsiderados da seleção.

.. [Modelos]
Modelos
Relação de modelos de contrato para seleção dos Beneficiários para os quais será feita a inclusão/troca de módulo.

Modelos

Pasta	Campo	Descrição	Tipo/Grid	Obrigatório
[Restrições]	Código Cartão Beneficiário	Código do cartão do beneficiário para o qual será feita a inclusão / troca de módulo.
[Restrições]	Beneficiário	Código do beneficiário para o qual será feita a inclusão / troca de módulo.	Beneficiário
[Restrições]	Acomodação	Auto-preenchido de acordo com o beneficiário / contrato informado.	Acomodação
[Restrições]	Repasse	Auto-preenchido de acordo com o beneficiário / contrato informado.	Repasse do Beneficiário
[Restrições]	Módulo Origem Benef.		Módulo Operadora
[Restrições]	Módulo Destino Benef.	Define se será feita a inclusão ou a troca de um módulo. Se o módulo informado for do tipo 1 - Produto Assistencial indica que se trata de uma troca de módulo. Se o tipo do módulo for 9 - Acessório, indica que se trata de uma inclusão de módulo.	Módulo Operadora	Sim
[Restrições]	Data Base Cobertura	Data e hora de início de vigência das coberturas. Regras: 1) A Data Base Cobertura deixou de ser obrigatória; 2) Se preenchida, o processo deverá assumí-la sem qualquer tipo de consistência nos Módulos gerados por Inclusão ou Troca; 3) Se não for preenchida, deverá levar em consideração o conteúdo de TipoHerCarTransferencia existente em NegociacaoAqModulo, em que se o TipoHerCarTransferencia for NULL, deverá assumir 2 - Herda de Todos os Módulos. Neste caso, o conteúdo da Data Base de Cobertura será gerado conforme as seguintes condições: a) Se Tipo = 3 (HERDA_APENAS_O_ÜLTIMO_MODULO), a Data Base de Cobertura do Módulo será igual à do Módulo mais recente; b) Se Tipo = 2 (HERDA_DE_TODOS_OS_MODULOS), a Data Base de Cobertura do Módulo é igual à do Módulo com Data Base mais antiga do Beneficiário; c) Se Tipo de Herança = 1 (NAO_HERDA) ou se NÃO houver Módulos anteriores do Beneficiário, a Data Base de Cobertura do Módulo será igual à Data de Início de Vigência do Módulo do Beneficiário.
[Restrições]	Início Vigência	Data e hora de inclusão / troca do módulo para o beneficiário.		Sim
[Restrições]	Data Base Calc.	É a Data base para cálculo dos valores de mensalidade/franquia/participação do beneficiário. Esta data serve de referência para indicar a tabela de preço a ser verificada nas negociações cadastradas.
[Restrições]	Motivo		Motivo de Suspensão de Vínculo	Sim
[Restrições]	Produto Convênio	Indica o produto convênio associado ao módulo acessório o qual será incluído opcionalmente para o beneficiário.	Módulo do Acessório
[Restrições]	Verifica Modulo Competência
[Restrições]	Analisa Contrato Anterior	Esta opção deverá ser utilizada juntamente com o Intervalo e/ou Lista de Contratos. Se marcado, a Inclusão/Troca ocorrerá para os Beneficiários dos Contratos informados e para os Beneficiários Aposentado/Demitido que possuírem o Contrato como anterior.
.. [Início de Vigência do Beneficiário]	Início de Vigência Inicial	Intervalo inicial de Início de Vigência dos Beneficiários para os quais será feita a inclusão/troca de módulo.
.. [Início de Vigência do Beneficiário]	Início de Vigência Final	Intervalo final de Início de Vigência dos Beneficiários para os quais será feita a inclusão/troca de módulo.
.. [Contratos]	Contrato Inicial	Intervalo inicial de Contrato para seleção dos Beneficiários para os quais será feita a inclusão/troca de módulo.	Contrato
.. [Contratos]	Contrato Final	Intervalo final de Contrato para seleção dos Beneficiários para os quais será feita a inclusão/troca de módulo.	Contrato
.. [Modelos]	Modelo Inicial	Intervalo inicial de Modelo de Contrato para seleção dos Beneficiários para os quais será feita a inclusão/troca de módulo.	Modelo de Contrato
.. [Modelos]	Modelo Final	Intervalo final de Modelo de Contrato para seleção dos Beneficiários para os quais será feita a inclusão/troca de módulo.	Modelo de Contrato
.. [Tipos de Contratação]	Exceto	Se marcado, indica que os valores informados no grid deverão ser desconsiderados da seleção.
.. [Tipos de Contratação]	Tipos de Contratação	Relação de tipos de contratação para seleção dos Beneficiários para os quais será feita a inclusão/troca de módulo.	Tipos de Contratação
.. [Contratos]	Exceto	Se marcado, indica que os valores informados no grid deverão ser desconsiderados da seleção.
.. [Contratos]	Contratos	Relação de contratos para seleção dos Beneficiários para os quais será feita a inclusão/troca de módulo.	Contratos
.. [Modelos]	Exceto	Se marcado, indica que os valores informados no grid deverão ser desconsiderados da seleção.
.. [Modelos]	Modelos	Relação de modelos de contrato para seleção dos Beneficiários para os quais será feita a inclusão/troca de módulo.	Modelos