✎ desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:cadastros:dependentes:autorizacoes:autorizar_novos_cadastros_de_dependentes [WIKI

Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.
~~ODT~~
<PHP>
echo "<div style='display:block;float:right;'>";
echo "Última atualização: ";
ver('', false);
echo "</div>";
</PHP>

====== Autorizar Novos Cadastros de Dependentes  ======

Os servidores poderão [[desenvolvimento:especificacoes:sigrh:portal_do_servidor:casos_de_uso:servicos:dependentes:cadastrar_consultar|cadastrar dependentes]], que estarão sob responsabilidade do servidor da instituição. O próprio servidor poderá realizar o cadastro, que ficará pendente de autorização pelo DAP. Com este cadastro, ambos têm benefícios como, no caso do servidor, desconto no imposto de renda retido na fonte. O dependente terá benefícios como plano de saúde e, em caso de morte do servidor, pensão. Após este cadastro, o servidor poderá solicitar autorização para realizar novo cadastro de dependentes.

Precondição: É necessário que se tenha feito [[desenvolvimento:especificacoes:sigrh:portal_do_servidor:casos_de_uso:servicos:dependentes:cadastrar_consultar|cadastro de dependentes]].

O Gestor de Pessoal é o responsável por realizar a autorização ou não dos cadastros de dependentes pendentes de autorização. ([[#principais_regras_de_negócio|RN01]])

===== Descrição do Caso de Uso =====

O caso de uso se inicia quando o usuário acessa a opção SIGRH ->  Administração de Pessoal -> Cadastros -> Dependentes -> Autorizações -> Autorizar Novos Cadastros de Dependentes

Antes da listagem dos dependentes a serem autorizados, será exibido os seguintes filtros:

  * **Servidor Responsável**: Formato - NOME DO SERVIDOR (9999999). Tipo - AUTOCOMPLETE. Entrada de dados: Matrícula SIAPE, NOME DO SERVIDOR ou CPF.
  * **Unidade de Exercício**: Formato - NOME DA UNIDADE (99.99.99), Tipo - AUTOCOMPLETE. Entrada de dados: NOME DA UNIDADE ou CÓDIGO DA UNIDADE.
  * **Considerar Unidades Vinculadas à Unidade de Exercício**: TIPO - LÓGICO. Caso a Unidade de Exercício seja selecionada, opção de busca por unidades vinculadas é habilitada.
  * **Unidade de Lotação**: Formato - NOME DA UNIDADE(99.99.99), Tipo - AUTOCOMPLETE. Entrada de dados: NOME DA UNIDADE ou CÓDIGO DA UNIDADE.
  * **Considerar Unidades Vinculadas à Unidade de Lotação**: TIPO LÓGICO. Caso a Unidade de Lotação seja selecionada, será habilitada esta opção de busca por unidades vinculadas.
  * **Nome do Dependente**: Tipo - TEXTO.
  * **Filiação do Dependente**: Tipo - TEXTO.
  * **Data de Nascimento**: Formato - DD/MM/AAAA. Tipo - DATA.
  * **Grau de Parentesco**: Tipo - TEXTO. São apresentadas as opções: ''COMPANHEIRO(A, CÔNJUGE, EX - ESPOSA, PAIS, QUALQUER OUTRA RELAÇÃO, ENTEADO(A), FILHO(A), IRMÃO, AVÓS''.
  * **Condição de Dependência**: Tipo - TEXTO, Exemplos de opções disponíveis: ''Sem exigência de condição, estudante, inválido...''.
  * **Tipo de Documento**: Tipo - TEXTO, São apresentadas as opções: ''CERTIDÃO DE NASCIMENTO, CERTIDÃO DE NASCIMENTO COM MATRÍCULA, CERTIDÃO DE CASAMENTO, CPF, RG, PASSAPORTE, COMPROVANTE DE MATRÍCULA''.
  * **Número do Documento**: Tipo - TEXTO.
  * **Tipo de Benefício**: Tipo - TEXTO. São apresentadas as opções: ''AUXILIO PRE-ESCOLAR INDIRETA, AUXILIO PRE-ESCOLAR DIRETA, DEDUCAO DO IMPOSTO DE RENDA, SALARIO FAMILIA, ASSISTENCIA MEDICO-HOSPITALAR PMDF, AUXILIO FAMILIAR, AJUDA DE CUSTO, AUXILIO NATALIDADE, AUXILIO MORADIA, PLANO DE SAUDE''.

É exibida uma listagem de cadastros de dependentes a serem autorizados, contendo os seguintes dados:

  * **__Dependente__**: Formato - Nome do dependente do servidor. Tipo - Texto.
  * **__Responsável (CPF)__**: Formato - Nome do servidor (CPF). Tipo - Texto.  
  * **__Parentesco__**: Tipo - Texto.
  * **__Nascimento__**: Formato - DD/MM/AAAA. Tipo - Data.
  * **__Status__**: Tipo - Texto.
  * **__Data de Cadastro__**: Formato - DD/MM/AAAA. Tipo - Data.

Na listagem dos registros, são disponibilizadas as opções //Visualizar Dependentes//, //Autorizar dependente// e //Negar autorização do dependente//. ([[#Principais Regras de Negócio|RN03 e RN04]]).
    
**Visualizar Dependentes**

Esta funcionalidade é descrita dentro da especificação de [[desenvolvimento:especificacoes:sigrh:portal_do_servidor:casos_de_uso:consultas:dependentes|Consultar Dependentes]] do módulo Portal do Servidor, em Visualizar Detalhes.
 
**Autorizar Dependente** e **Negar Autorização de Dependente**

Caso seja selecionada ou a opção de autorizar ou a opção de negar, o sistema exibe os seguintes dados do dependente:

  * **__Nome do Dependente__**: Tipo - TEXTO.
  * **__Grau de Parentesco com o Servidor__**: Tipo - TEXTO.
  * **__Condição de Dependência__**: Tipo - TEXTO.
  * **__Data de Nascimento__**: Tipo - DATA.
  * **__Sexo__**: Tipo - TEXTO.
  * **__Responsável (Servidor)__**: Formato - NOME DO SERVIDOR (999999). Tipo - TEXTO. 
  * **__Filiação__**: Tipo - TEXTO.
  * **__Status do Cadastro__**: Tipo - TEXTO.
  * **__Observações sobre a autorização__**: Tipo - TEXTO.
  * **__Ativo__**: Tipo - LÓGICO. Formato - SIM/NÃO.
  * **__Observações__**: Tipo - TEXTO.

  * Documentos do Dependente
    * **__Tipo de Documento__**: Tipo - TEXTO. Sendo possíveis as opções ''CERTIDÃO DE CASAMENTO, CERTIDÃO DE CASAMENTO COM MATRÍCULA, CERTIDÃO DE NASCIMENTO, CERTIDÃO DE NASCIMENTO COM MATRÍCULA, PASSAPORTE, CPF'' e ''RG''. 
       * //Certidão de Casamento, Certidão de Casamento com Matrícula, Certidão de Nascimento e Certidão de Nascimento com Matrícula//
         * **__Matrícula__**: Tipo - NUMÉRICO. ([[#principais_regras_de_negócio|RN03, RN04 e RN05]])
         * **__Declaração de Nascido Vivo__**: Tipo - TEXTO.([[#principais_regras_de_negócio|RN06]])
         * **__Número do Documento__**: Tipo - NUMÉRICO.  
         * **__Documento de Estrangeiro__**: Tipo - LÓGICO. ([[#principais_regras_de_negócio|RN07]])
         * **__Nome do Cartório__**: Tipo - TEXTO. 
         * **__Local do Cartório__**: Tipo - TEXTO. 
         * **__Estado__**: Tipo - TEXTO. É considerado somente a sigla do estado. 
         * **__Data de Emissão do Documento__**: Formato - DD/MM/AAAA. Tipo - DATA. 
         * **__Livro__**: Tipo - TEXTO. 
         * **__Folha__**: Tipo - NUMÉRICO. 
         * **__Anexos__**: Tipo - TEXTO. 
       * //RG//
         * **__Número do Documento__**: Tipo - NUMÉRICO.
         * **__Órgão Expedidor__**:  Tipo - TEXTO. É considerado somente a sigla do órgão expedidor. 
         * **__Estado__**: Tipo - TEXTO. É considerado somente a sigla do estado. 
         * **__Data de Expedição__**: Formato - DD/MM/AAAA. Tipo - DATA.
         * **__Anexos__**: Tipo - TEXTO.
       * //Passaporte, CPF e outros//
         * **__Número do Documento__**: Tipo - NUMÉRICO.
         * **__Anexos__**: Tipo - TEXTO. 

  * Benefícios/Observações
    * **__Tipo de Benefício__**: Tipo - TEXTO.
    * **__Data de Início__**: Formato - DD/MM/AAAA. Tipo - DATA.
    * **__Data de Término__**: Formato - DD/MM/AAAA. Tipo - DATA.
    * **__Observação do Benefício__**: Tipo - TEXTO.
    * **__Documentos Anexados__**: Tipo - TEXTO. 

  * **Observações de Autorização**: Tipo TEXTO

Por fim, pode-se optar pela autorização ou negação do cadastro, dependendo de qual opção foi escolhida anteriormente.([[#principais_regras_de_negócio|RN08 e RN09]])


Modelo de email de Autorização/Negação:([[#Principais Regras de Negócio|RN10]])

<code>
Assunto do Email: Autorização de Dependente - MENSAGEM AUTOMÁTICA
  
Conteúdo: 
  Caro(a) <NOME DO SERVIDOR>, Foi realizada a seguinte operação: <DESCRIÇÃO DA OPERAÇÂO (AUTORIZAÇÃO/NEGAÇÃO)>
  para o seu dependente <NOME DO DEPENDENTE>, pelo   Departamento de Administração Pessoal(DAP). 
  Observação: <TEXTO DA OBSERVAÇÃO>.
  Esta mensagem foi gerada automaticamente pelo sistema e não deve ser respondida.

</code>

Após o envio do email, o caso de uso é finalizado.

===== Principais Regras de Negócio =====

  * **RN01** - Quando o usuário logado possuir papel com exigência de vinculação a uma unidade, todas as operações somente podem ser realizadas para servidores lotados na unidade que foi vinculada ao papel. Caso contrário, as operações podem ser realizadas para servidores lotados em qualquer unidade.
  * **RN02** - Por padrão, serão retornados todos os registros no acesso inicial ao caso de uso.
  * **RN03**: O campo //Matrícula// é exibido quando //Tipo de Documento// escolhido for ''CERTIDÃO DE CASAMENTO COM MATRÍCULA'' ou ''CERTIDÃO DE NASCIMENTO COM MATRÍCULA''.
  * **RN04**: O campo //Matrícula// deve ser constituído de 32 caracteres.
  * **RN05**: Através do valor dado em //Matrícula//, o campo //Número// é preenchido automaticamente com os números compreendidos entre 24° ao 30° caractere. Enquanto, //Livro// é compreendido entre 16° ao 20° e //Folha// pelos números compreendidos entre 21° ao 23°. 
  * **RN06**: O campo //Declaração de Nascido Vivo// é exibido quando //Tipo de Documento// escolhido for ''CERTIDÃO DE NASCIMENTO'' ou ''CERTIDÃO DE NASCIMENTO COM MATRÍCULA''.
  * **RN07**: Quando //Documento de Estrangeiro// for selecionado, os campos //Nome do Cartório, Local do Cartório, Estado, Data de Emissão, Livro// e //Folha// deixam de ser obrigatórios.
  * **RN08** - Na realização da autorização do cadastro do dependente, ao optar pela autorização do cadastro, seu status é atualizado para ''Cadastro autorizado'';
  * **RN09** - Na realização da autorização do cadastro do dependente, ao optar pela negação da autorização do cadastro, seu status é atualizado para ''Cadastro Negado'';
  * **RN10** - Ao autorizar ou negar um cadastro de dependente, deve ser enviado para o servidor um e-mail informando que o cadastro do dependente foi autorizado/negado e o motivo (o motivo que é informado nas observações);
  * **RN11** - Será gerada uma entrada no histórico do dependente quando qualquer operação for realizada.


==== Resoluções/Legislações Associadas  ====

Não se Aplica

<ifauth @admin>

===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe ^ Tabela |
| br.ufrn.sigrh.pessoal.dominio.Dependente | administrativo.pessoal.dependente |
| br.ufrn.sigrh.dominio.HistoricoDependente| administrativo.pessoal.historico_dependente |
| br.ufrn.sigrh.dominio.HistoricoResponsavelDependente| administrativo.pessoal.historico_responsavel |

====== Plano de Teste ======

Sistema: SIGRH

Módulo: Administração de Pessoal

Link(s): Cadastros -> Dependentes -> Autorizações -> Autorizar Novos Cadastros de Dependentes 

Papel que usuário deve ter:  SigrhPapeis.ADMINISTRADOR_DAP, SigrhPapeis.GESTOR_DAP

Usuário : mirian

===== Cenários de Teste ===== 

Realizar a operação descrita nos dados para o teste e acessar o caso de uso de [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:consultas_relatorios:funcionais:consultas_gerais:visualizar_detalhes|Visualizar dados atuais]] para validar a RN04.

===== Dados para o Teste ===== 

É possível que seja [[desenvolvimento:especificacoes:sigrh:portal_do_servidor:casos_de_uso:servicos:dependentes:cadastrar_consultar|cadastrado um novo dependente]] através do menu do Servidor, pois dependentes cadastrados pelo Menu DAP já ficam como autorizados.

Para validar a RN04 acessar o link [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:consultas_relatorios:funcionais:consultas_gerais:visualizar_detalhes| Visualizar Detalhes]]

</ifauth>