~~ODT~~ echo "
"; echo "Última atualização: "; ver('', false); echo "
"; ====== Cadastrar Dependente ====== O cadastro de dependentes permite que o servidor registre no sistema pessoas que dependem dele economicamente, como filhos e esposa, por exemplo. Com este cadastro, ambos tem benefícios como, no caso do servidor, desconto no imposto de renda retido na fonte. Enquanto que o dependente terá benefícios como plano de saúde e, em caso de morte do servidor, pensão. Os responsáveis por essa funcionalidade são os atendentes do Departamento de Administração de pessoal. ===== Descrição do Caso de Uso ===== Este caso de uso se inicia em// SIGRH -> Administração de Pessoal -> Cadastros -> Dependentes -> Cadastrar//. Para realizar o cadastro de um dependente é necessário informar os seguintes dados: * **Servidor Responsável***: Formato - NOME DO SERVIDOR (9999999), Tipo - AUTOCOMPLETE, Entrada de dados: Matrícula SIAPE, NOME DO SERVIDOR, CPF ou Nome de Identificação. ([[#principais_regras_de_negócio|RN02, RN03 e RN04]]) * **Código SIAPE**: Tipo - NUMÉRICO. ([[#Principais_regras_de_negocio|RN05]]) * **__Nome Completo__**: Tipo - TEXTO. * **__Matrícula SIAPE__**: Tipo - NUMÉRICO. * **__Cargo:__** Tipo - TEXTO. * **__Unidade de Lotação__**: Tipo - TEXTO. * **__Unidade de Exercício__**: Tipo - TEXTO. * **Grau de Parentesco do dependente***: Tipo - TEXTO, São apresentadas opções: ''Avós, Companheiro(a), Conjugue, Enteado(a), Ex-Esposo(a), Irmão(a), Filho(a), Pais e Qualquer outra relação''. O tipo de relação existente entre servidor e dependente; ([[#principais_regras_de_negócio|RN06, RN07, RN08 e RN09]] * **Documento Judicial**: Tipo TEXTO. ([[#principais_regras_de_negócio|RN10]]) * **Condição de Dependência***: Tipo - TEXTO. Relação de dependência para com o servidor. * **Nome do Dependente***: Tipo - TEXTO. ([[#principais_regras_de_negócio|RN11 e RN12]]) * **__Matrícula Siape do Dependente__**: Tipo - NUMÉRICO. ([[#principais_regras_de_negócio|RN13]]) * **Data de Nascimento***: Formato - DD/MM/AAAA, Tipo - DATA. Nascimento do dependente. * **Sexo***: Tipo - TEXTO, São apresentadas opções: ''Feminino'' ou ''Masculino''. * **Filiação do Dependente***: Tipo - TEXTO. * **Nacionalidade do Dependente***: Tipo - TEXTO, São apresentadas as opções: ''Brasileiro Nato, Brasileiro Naturalizado, Equiparado e Brasileiro, Estrangeiro'' e ''Nenhuma''. * **Observações**: Tipo - TEXTO. * Documento Obrigatório de Identificação do Dependente * **__Tipo de Documento__**: Tipo TEXTO, O CPF é considerado como documento obrigatório. ([[#Principais_regras_de_negocio|RN14]]) * **Número***: Tipo - NUMÉRICO. ([[#principais_regras_de_negócio|RN16, RN17, RN18 e RN19]]) * **Arquivo do Documento***: Tipo - TEXTO. ([[#Principais_regras_de_negocio|RN20]]) * Demais Documentos do Dependente ([[#principais_regras_de_negócio|RN21]]) * **Tipo de Documento***: Tipo - TEXTO, São apresentadas 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'' e ''RG''. ([[#principais_regras_de_negócio|RN05]]) * Para //Certidão de Casamento, Certidão de Casamento com Matrícula, Certidão de Nascimento// ou //Certidão de Nascimento com Matrícula//: * **Matrícula***: Tipo - NUMÉRICO. ([[#principais_regras_de_negócio|RN22]]) * **Declaração de Nascido Vivo***: Tipo - TEXTO. ([[#principais_regras_de_negócio|RN23]]) * **Número***: Tipo - NUMÉRICO. * **Documento de Estrangeiro**: Tipo - LÓGICO. ([[#principais_regras_de_negócio|RN24]]) * **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. * Para //RG//: * **Número***: 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. * Para //Comprovante de Matrícula//: * **Instituição***: Tipo - TEXTO. * **Data de Emissão***: Tipo - DATA. * **Ano**: Tipo - NUMÉRICO. * Para //Passaporte// ou //Outros//: * **Número***: Tipo - NUMÉRICO. * **Arquivo do Documento***: Tipo - TEXTO, Campo exibido para qualquer tipo de documento a ser cadastrado. * Documentos Cadastrados para o Dependente * **__Tipo de Documento__**: Tipo - TEXTO. ([[#Principais_regras_de_negocio|RN26]]) * **__Número do Documento__**: Tipo - NUMÉRICO. * **__Anexos do Documentos__**: Tipo - TEXTO. ([[#Principais_regras_de_negocio|RN25 e RN33]]) Para cada documento listado, são exibidos os nomes dos arquivos anexados que permitem o acesso ao arquivo anexo, e também existe a opção de //Remover// o documento, porém a opção de remoção não aparece quando o documento for um CPF devido à sua obrigatoriedade incondicional. * Benefícios * **Tipo de Benefício**: Tipo - TEXTO. ([[#Principais_regras_de_negocio|RN27 e RN28]]) * **Descrição do Benefício**: Tipo - TEXTO. * Anexos do Benefício ([[#Principais_regras_de_negocio|RN29, RN30 e RN31]]) * **Tipo de Documento***: Tipo - TEXTO. * **Arquivo***: Tipo - TEXTO. * Listagem de Benefícios * **__Tipo de Benefício__**: Tipo - TEXTO. * **__Data de Início__**: Tipo - DATA. * **__Data de Término__**: Tipo - DATA. ([[#Principais_regras_de_negocio|RN32]]) * **__Observação do Benefício__**: Tipo - TEXTO. * **__Documentos Anexados__**: Tipo - TEXTO. ([[#Principais_regras_de_negocio|RN33]]) Para cada benefício listado, tem-se a opção de remoção do benefício. ([[#principais_regras_de_negócio|RN34 e RN35]]) 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** - Só serão listados no autocomplete, servidores que tenham um destes tipos ativos: APOSENTADO, CEDIDO, EXTERNO, PGTO_SUSPENSO, SERVIDOR_ATIVO. (Tarefa 74346, v4.2.0) * **RN03** - Os campos //Nome Completo, Matrícula SIAPE, Cargo, Unidade de Lotação// e //Unidade de Exercício// serão exibidos quando o campo //Servidor Responsável// for preenchido. No cadastro de dependentes pelo Portal do Servidor, tais campos não são exibidos. * **RN04** - No cadastro de dependentes pelo Portal do Servidor, o servidor responsável é o usuário que está logado no sistema. Dessa forma, este campo está disponível apenas para leitura. * **RN05** - No cadastro de dependentes pelo Portal do Servidor, o campo //Código SIAPE// não é apresentado. (#[[http://www.iproject.ufrn.br/iproject/public/VerTarefa?num=94229|94229]], v4.5.2) * **RN06** - Ao selecionar o grau de parentesco, a condição de dependência será preenchida apenas com as condições relacionadas ao grau de parentesco selecionado. * **RN07** - No cadastro de dependentes no Portal do Servidor, os servidores só poderão cadastrar os dependentes cujo //Grau de Parentesco do dependente// seja ''Cônjuge'' ou ''Filho(a)'' ou os que foram definidos no parâmetro ''PARENTESCOS_CADASTRAR_VIA_PROCESSO''. Esse parâmetro indica quais os graus de parentesco são cadastrados apenas pelo RH. ([[http://www.iproject.ufrn.br/iproject/public/VerTarefa?num=68592|68592]] , v3.12.3) * **RN08** - Para dependente com grau de parentesco classificado como cônjuge, é necessário que o mesmo tenha cadastrado uma certidão de casamento ou RG. * **RN09** - Para dependente com grau de parentesco classificado como filho para um responsável, é necessário que o dependente tenha cadastrado uma certidão de nascimento ou RG. (Tarefa 68269, v3.12.5) * **RN10** - O campo //Documento Judicial// será disponível apenas quando o grau de parentesco for "Qualquer outra relação". * **RN11** - Caso o dependente tenha a condição de dependência de ''ESTUDANTE'' ou ''ESTUDANTE UNIVERSITÁRIO S/ REMUNERAÇÃO'' deverá ser exigido o cadastro de um comprovante de matrícula nos documentos do dependente. * **RN12** - Não é possível cadastrar um mesmo dependente para dois servidores, para isto foi criado o caso de uso [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:consultas_relatorios:funcionais:consultas_gerais:cadastrar_novo_responsavel|Cadastrar Novo Responsável]]. O sistema vai emitir mensagem informando que o dependente já está cadastrado para outro servidor, e que para efetivar o cadastro deverá ser procurado o setor de Administração de Pessoal. Os critérios para validar se o dependente já existe são: //Nome, Data de Nascimento// e //Tipo/Número de documento//. * **RN13** - No caso de dependentes homônimos, que não do mesmo servidor, é possível ter certidões com mesmo número, porém tendo outras informações diferentes, exemplo: ser de cartórios diferentes, registradas em livros/folhas diferentes, etc. (Tarefa 59855, v3.11.0) * **RN14** - O campo //Matrícula SIAPE do dependente// só estará disponível quando o dependente é um servidor da instituição. * **RN15** - É obrigatório cadastrar um CPF para qualquer grau de parentesco e qualquer condição de dependência. * **RN16** - Ao cadastrar o dependente, será realizada uma validação se o CPF informado está cadastrado no sistema, ou para outro servidor ou para outro dependente. Caso o CPF esteja cadastrado, será disparada uma mensagem: "O número de CPF Informado já está cadastrado no sistema para algum Servidor ou Dependente.". A **RN19** define uma exceção à essa regra. * **RN17** - Caso o CPF informado pertença à um servidor, os dados: //Nome do Dependente, Data de Nascimento, Filiação do Dependente, Sexo// e //Nacionalidade// serão preenchidos automaticamente, sem opção de alteração. Se o cadastro do dependente seguir a **RN19**, o dependente não será considerado servidor e os campos não serão preenchidos automaticamente. * **RN18** - Caso um dependente com CPF de servidor tenha seu número de CPF alterado, os campos bloqueados pela **RN17** serão liberados para edição. * **RN19** - Pode haver concomitância de CPF caso o dependente seja do tipo ''Filho'' e não possua CPF. Nesse caso o cadastro é feito utilizando o CPF da mãe. Essa validação é feita da seguinte forma: Se o servidor responsável for do sexo feminino, o sistema permite que o CPF do dependente seja igual ao do responsável. Se o servidor responsável for do sexo masculino, o sistema permite cadastrar o CPF igual ao de outro dependente do sexo feminino. (#[[http://www.iproject.ufrn.br/iproject/public/VerTarefa?num=121995|121995]], v4.9.35). Para os casos em que não há pais do sexo feminino, cadastrar o CPF de quem está cadastrado no SIAPE em Nome da Mãe. (#[[http://www.iproject.ufrn.br/iproject/public/VerTarefa?num=166313|166313]]) * **RN20** - Neste ponto existe uma opção para anexar o arquivo ao CPF, onde é possível vincular mais de um anexo para o documento. A obrigatoriedade deste campo é definida através de um parâmetro do sistema (''DOCUMENTOS_DEPENDENTES_SEM_ANEXO''). * **RN21** - É possível cadastrar/anexar mais de um documento para um mesmo dependente, porém só é possível cadastrar um documento por tipo de documento. Quando adicionado um documento, o tipo adicionado é removido da listagem de tipos para cadastrar um novo documento. * **RN22** - 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''. Enquanto que os campos //Livro, Folha// e //Número do Documento// ficam em modo somente leitura, e são preenchidos ao digitar uma matrícula completa, constituída de 32 caracteres. Através desta informação, 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°. * **RN23** - 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''. * **RN24** - No caso da inserção de documentação comprobatória de certidão de casamento/nascimento ter sido emitida fora do país, ou seja 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 devido a inexistência de tais informações na documentação original. * **RN25** - Foi criado um parâmetro para definir quais tipos de documentos não irão exigir cadastro de anexos. (ParametrosGerais.DOCUMENTOS_DEPENDENTES_SEM_ANEXO) * **RN26** - Os tipos de documentos possuem um novo campo denominado idade_exigencia (este campo é acessível somente via banco de dados, ver SQL nos dados para testes) onde é determinada uma idade em que este tipo de documento torna-se obrigatório. Para a UFRN, apenas o RG é obrigatório para qualquer dependente acima de 18 anos. * **RN27** - Ao inserir um tipo de benefício, o mesmo não será disponibilizado ao inserir novamente um tipo de benefício. Além de só serem exibidos os benefícios de acordo com relacionamento existente entre Grau de Parentesco x Condição de dependência x Tipos de Benefícios. * **RN28** - Independente do relacionamento existente entre Grau de Parentesco x Condição de dependência x Tipos de Benefícios, entre as opções disponíveis para o tipo do benefício, não deve ser exibida a opção ''ASSIST A SAÚDE SUPLEMENTAR'', que se refere ao benefício de plano de saúde. * **RN29** - É possível anexar vários documentos para um mesmo benefício. * **RN30** - Dependendo do tipo de benefício escolhido, alguns tipos de documentos deverão ser anexados obrigatoriamente em “Anexos do Benefício”. * **RN31** - Para os benefícios, foi definido um campo na tabela que indica se será obrigatório anexar um arquivo. Além disso alguns tipos de benefícios não podem ser cadastrados, como por exemplo ''ASSIST A SAÚDE SUPLEMENTAR'', pois este só poderá ser cadastrado via solicitação ao RH. * O benefício ''ASSIST A SAÚDE SUPLEMENTAR'' só será cadastrado para um dependente quando um plano de saúde for autorizado pelo RH. * **RN32** - Para cada benefício adicionado, caso haja uma limitação de idade máxima, será adicionado e exibida mensagem com os seguintes dados: * ''Caro servidor: [A condição de dependência FILHO(A) | O benefício SEM EXIGÊNCIA DE CONDIÇÃO ] só é válido(a) até a idade máxima de [6] anos. Após completar a idade máxima, o dependente se tornará inválido no sistema. Caso ainda se encaixe em alguma condição de dependência (ex: filho estudante que passar a ser filho estudante universitário) ou benefício o dependente deverá ser recadastrado.'' * **RN33** - Cada nome de arquivo exibido em "Listagem de Benefícios" e em "Documentos Cadastrados para o Dependente", é uma forma de acesso de baixar o arquivo. * **RN34** - A opção para remover o benefício não será exibida para o benefício ''ASSIST A SAÚDE SUPLEMENTAR'', que se refere ao benefício de plano de saúde. * **RN35** - Apenas os benefícios ainda não cadastrados no SIAPE poderão ser removidos da base de dados. * **RN36** - No caso dos dependentes servidores, a validação dos benefícios e documentos será diferenciada. Foram criados campos lógicos na entidade TipoDocumentoDependente, que indica se este tipo de documento pode estar associado à outro dependente quando há relação mútua de dependência, assim como os tipos de benefícios também. * **RN37** - Quando houverem [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:administracao:cadastros:dependentes:arquivos_de_dependentes:consultar_arquivos_gerados|Arquivos de Dependentes]] aguardando processamento do SIAPE, não será possível realizar cadastro ou alteração nos dados dos dependentes. * **RN38** - Quando um dependente é cadastrado pelo Departamento de Administração de Pessoal, seu status já fica como ''Autorizado''. * **RN39** - Ao cadastrar o dependente será criado uma entrada no histórico deste, indicando quando e quem realizou a operação. ==== Resoluções/Legislações Associadas ==== {{:desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:cadastros:dependentes:portaria_normativa_3_-_2012_1_.pdf|Portaria Normativa nº 3, de 27 de Abril de 2012}} * Para uma boa compreensão em relação ao relacionamento entre grau de parentesco, condição de dependência e benefícios, analise o seguinte documento: {{:desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:cadastros:dependetes:tabela_dependente_-_parentesco_condicao_beneficio.pdf|}} ===== Classes Persistentes e Tabelas Envolvidas ===== ^ Classe ^ Tabela | | br.ufrn.sigrh.dominio.TipoGrauParentesco| administrativo.rh_tipos.tipo_grau_parentesco | | br.ufrn.sigrh.dominio.TipoCondicaoDependente| administrativo.rh_tipos.tipo_condicao_dependente | | br.ufrn.sigrh.dominio.RelacaoParentescoCondicaoBeneficio| administrativo.rh_tipos.relacao_parent_cond_benef| | br.ufrn.sigrh.dominio.pessoal.dominio.Dependente| administrativo.pessoal.dependente | | br.ufrn.sigrh.dominio.pessoal.dominio.ResponsavelDependente| administrativo.pessoal.responsavel_dependente | | br.ufrn.sigrh.dominio.pessoal.dominio.Documento_Dependente| administrativo.pessoal.documento_dependente | | br.ufrn.sigrh.dominio.TipoDocumentoDependente| administrativo.rh_tipos.tipo_documento_dependente | | br.ufrn.sigrh.dominio.AnexoDocumentoDependente| administrativo.pessoal.anexo_documento_dep | | br.ufrn.sigrh.dominio.HistoricoDependente| administrativo.pessoal.historico_dependente | | br.ufrn.sigrh.dominio.HistoricoResponsavelDependente| administrativo.pessoal.historico_responsavel | | br.ufrn.sigrh.dominio.TipoBeneficioDependente| administrativo.pessoal.tipo_beneficio_dependente | | br.ufrn.sigrh.dominio.BeneficioResponsavel| administrativo.pessoal.beneficio_responsavel | | br.ufrn.sigrh.dominio.DocumentoBeneficioDependente| administrativo.pessoal.documento_beneficio_dep| ====== Plano de Testes ====== Sistema: SIGRH Módulo: Administração de Pessoal Link(s): Cadastros -> Dependentes -> Cadastrar Login(s): mirian(ADMINISTRADOR_DAP), elizabete(GESTOR_DAP), gerlane(USUARIO_AUTO_ATENDIMENTO) Papel que usuário deve ter: SigrhPapeis.ADMINISTRADOR_DAP, SigrhPapeis.GESTOR_DAP, SigrhPapeis.USUARIO_AUTO_ATENDIMENTO ===== Cenários de Teste ===== Cadastrar dependentes para Servidores com diferentes graus de parentesco e condições de dependência e verificar se o cadastro é realizado corretamente com a exigência dos documentos anexados. Montar cadastro de dependentes servidores da instituição preenchendo o campo de cpf com cpf's de servidores. Montar cadastro de relações mútuas de dependentes onde um dependente seja dependente do outro: Ex: Cadastrar Mirian como dependente de Zoroastro, e Zoroastro como dependente de Mirian. ===== Dados para o Teste ===== * Para verificar os tipos de documentos obrigatórios para um determinado tipo de benefício, acesse a operação [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:administracao:cadastros:tipos_de_beneficio:listar_alterar|Listar/Alterar Tipos de Benefícios]]. Para validar a RN26 utilize a consulta select * from rh.servidor where id_ativo in (2, 7, 8, 5, 1) limit 10 (nessa consulta esta mostrando os servidores que podem ser mostrados no autocomplete) select * from rh.servidor where id_ativo not in (2, 7, 8, 5, 1) limit 10 (nessa consulta esta mostrando os servidores que NÃO podem ser mostrados no autocomplete) Para validar a [[#Principais_regras_de_negocio|RN03]] e [[#Principais_regras_de_negocio|RN06]] acesse o UC de [[desenvolvimento:especificacoes:sigrh:administracao_de_pessoal:casos_de_uso:consultas_relatorios:funcionais:consultas_gerais:dependentes|consulta de dependentes]] A [[#Principais_regras_de_negocio|RN06]] será validada acessando a opção "VISUALIZAR DETALHES" Para validar a [[#Principais_regras_de_negocio|RN10]] é necessário acessar o sigadmin, e alterar o papel GESTOR_DAP e GESTOR_CADASTRO para ter exigência de unidade em SigAdmin -> Config. do Sistema -> Permissões -> Gerenciamento de Papéis localize os papéis desejados e marque a opção de exigência de unidade. Depois acesso SigAdmin -> Config. do Sistema -> Permissões -> Implantar Permissões. Localize o usuário desejado, remova o papel GESTOR_DAP e GESTOR_CADASTRO e adicione novamente informando a unidade a qual o papel está associado. Obs.: Não é padrão para a UFRN o vínculo de papel com unidade, portanto após validar a [[#Principais_regras_de_negocio|RN10]] deverão ser desfeitas as alterações. Comando sql com alguns CPFs para testes: select cpf_cnpj from comum.pessoa p join rh.servidor s using (id_pessoa) where s.id_ativo = 1 and cast(p.cpf_cnpj as varchar) not in(select numero_documento from pessoal.documento_dependente where id_tipo_documento_dependente = 3 ) Obs.: para os cpf's listados de pessoas, completar com zeros à esquerda quando não tiver 11 dígitos. Para saber os documentos que terão uma validação especial de acordo com [[#Principais_regras_de_negocio|RN22]] use o seguinte select: select * from rh_tipos.tipo_documento_dependente where unicidade_dep_servidor = true Para Validar a [[#Principais_regras_de_negocio|RN22]] e saber quais os benefícios **NÃO** deverão apresentar para BENEFICIÁRIOS SERVIDORES segue select: select * from pessoal.tipo_beneficio_dependente where permite_relacao_mutua = false Para Validar a [[#Principais_regras_de_negocio|RN31]] usar o seguinte select: select * from rh_tipos.tipo_documento_dependente where idade_exigencia is not null;