Histórico da Página

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	Datasul	Módulo	Portal HCM
Segmento Executor	Manufatura
Projeto	D_MAN_HCM002	IRM	PCREQ-540
Requisito	PCREQ-6092	Subtarefa	PDRMAN-4425
Release de Entrega Planejada	12.1.9
País	( X ) Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia ( ) Outro _____________.

Objetivo

Possibilitar a consultar e alteração pelo funcionário de seus dados cadastrais relacionados ao eSocial.

Definição da Regra de Negócio

Ao entrar no Portal HCM no portlet Meus Dados existirá uma aba chamada "eSocial". Nesta aba o funcionário terá duas opções:

Download: Exportar uma planilha excel contendo todos os dados cadastrais do eSocial relativos ao funcionário, como: dados pessoais, endereço, identificação funcional e documentos (ver tabela de localização dos campos eSocial logo abaixo).
Upload: Importar a planilha excel exportada acima. Os dados alterados serão gravados no HCM.

Abaixo segue o fluxo completo deste processo:

Nota

title	FLUIG

As apis do processo 3 devem ser construidas para que sejam reaproveitadas no Fluig.

Rotina	Tipo de Operação
FP0170 - Manuteção Grupo de Informações	Alteração
Portlet Meus Dados - EmployeeDataView	Alteração
varinc/varXXXXX.i	Novo
object/sopy/brw/b02py262.w	Alteração
FPAPI054.p	Alteração
FPAPIXXX	Novo

Tabelas de localização dos campos eSocial

Relação dos campos eSocial do funcionário que serão incluídos na planilha excel e o tipo possível de permissão no mesmo (consulta ou alteração).

Legenda
Campo HCM	Nome do campo na tela do HCM
Campo eSocial	Nome do campo no layout do eSocial
Campo Flex	Nome do campo equivalente que será usado na planilha
Campo Novo	Indica se esse campo não existe nas demais telas flex do Portal HCM
Programa	Código da tela do HCM que contem o campo
Tabela	Tabela no banco do HCM onde o valor do campo é armazenado
Tipo Permissão	Indica se o funcionário poderá alterar o valor do campo na planilha
Zoom	Indica se o campo é do tipo combobox

ID	Campo HCM	Campo eSocial	Campo Flex	Campo Novo?	Programa	Tabela	Tipo Permissão	Zoom?
Pessoal
1	Nome eSocial	nmTrab	Nome eSocial	Sim	FP1440A	compl_pessoa_fisic.nom_pessoa_fisic_sped	alterar	Não
2	Sexo	sexo	Sexo	Não	FP1440	rh_pessoa_fisic.idi_sexo	consultar	Sim
3	Cútis	racaCor	Cútis	Sim	FP1440	rh_pessoa_fisic.idi_cor_cutis	consultar	Sim
4	Estado Civil	estCiv	Estado Civil	Não	FP1440	rh_pessoa_fisic.idi_estado_civil	alterar	Sim
5	Grau Instrução	grauInstr	Grau de Instrução	Não	FP1440	rh_pessoa_fisic.cdn_grau_instruc	alterar	Sim
6	Data Nascimento	dtNascto	Data Nascimento	Não	FP1440	rh_pessoa_fisic.dat_nascimento	consultar	Não
7	Município	codMunic	Município Nascimento	Sim	FP1440A	compl_pessoa_fisic.cod_livre_1,2,7	alterar	Sim
8	UF Nascimento	uf	UF Nascimento	Não	FP1440	rh_pessoa_fisic.cod_unid_federac_nasc	alterar	Sim
9	País Nascimento	paisNascto	País Nascimento	Não	FP1440	rh_pessoa_fisic.cod_pais_nasc	alterar	Sim
10	País Nacionalidade	paisNac	País Nacionalidade	Sim	FP1440A	compl_pessoa_fisic.cod_livre_1,9,3	alterar	Sim
11	Nome Mãe	nmMae	Nome da Mãe	Não	FP1440	rh_pessoa_fisic.nom_mae_pessoa_fisic	alterar	Não
12	Nome Pai	nmPai	Nome do Pai	Não	FP1440	rh_pessoa_fisic.nom_pai_pessoa_fisic	alterar	Não

Endereço
ID	Campo HCM	Campo eSocial	Campo Flex	Campo Novo?	Programa	Tabela	Tipo Permissão	Zoom?
13	Tipo Logradouro	tpLograd	Tipo	Sim	FP1440A	compl_pessoa_fisic.cod_tip_lograd	alterar	Sim
14	Endereço	dscLograd	Endereço	Não	FP1440	rh_pessoa_fisic.nom_ender_rh	alterar	Não
15	No. Res.	nrLograd	Número	Não	FP1440	rh_pessoa_fisic.cod_livre_1,066,008	alterar	Não
16	Ponto Referência	complemento	Ponto Referência	Não	FP1440	rh_pessoa_fisic.nom_pto_refer	alterar	Não
17	Bairro	bairro	Bairro	Não	FP1440	rh_pessoa_fisic.nom_bairro_rh	alterar	Não
18	CEP	cep	CEP	Não	FP1440	rh_pessoa_fisic.cod_cep_rh	alterar	Não
19	Município	codMunic	Muncípio	Sim	FP1440A	compl_pessoa_fisic.cod_livre_1,085,007	alterar	Sim
20	UF	uf	UF	Não	FP1440	rh_pessoa_fisic.cod_unid_federac_rh	alterar	Sim
21	País Endereço	paisResid	País Endereço	Não	FP1440	rh_pessoa_fisic.cod_pais_ender	alterar	Sim
22	Telefone	fonePrinc	Telefone	Não	FP1440	rh_pessoa_fisic.num_ddd + rh_pessoa_fisic.num_telefone	alterar	Não
23	Telefone Contato	FoneAlternat	Telefone Contato	Não	FP1440	rh_pessoa_fisic.num_ddd_contat + rh_pessoa_fisic.num_telef_contat	alterar	Não
24	E-mail	emailPrinc	E-mail	Não	FP1440	rh_pessoa_fisic.nom_e_mail	alterar	Não
25	E-mail Contato	emailAlternat	E-mail Contato	Sim	FP1440	rh_pessoa_fisic.cod_livre_1,26,40	alterar	Não

ID	Campo HCM	Campo eSocial	Campo Flex	Campo Novo?	Programa	Tabela	Tipo Permissão	Zoom?
Endereço / Endereço Exterior
26	Cidade Exterior	nmCid	Cidade Exterior	Sim	FP1440A	compl_pessoa_fisic.nom_cidad_exterior	alterar	Não
27	Código Endereçamento Postal	codPostal	Código Endereçamento Postal	Sim	FP1440A	ompl_pessoa_fisic.cod_livre_1,072,010	alterar	Não

ID	Agrupador Flex	Campo HCM	Campo eSocial	Campo Flex	Campo Novo?	Programa	Tabela	Tipo Permissão	Zoom?
Identificação Funcional / Trabalhador Estrangeiro
28	Identificação Funcional / Trabalhador Estrangeiro	Chegada	dtChegada	Data Chegada	Sim	FP1440A	compl_pessoa_fisic.cod_livre_1,92,8	alterar	Não
29	Identificação Funcional / Trabalhador Estrangeiro	Condição	classTrabEstrang	Condição	Sim	FP1440A	compl_pessoa_fisic.idi_cond_trabdor_estrang	alterar	Sim
30	Identificação Funcional / Trabalhador Estrangeiro	Casado com brasileiro	casadoBr	Casado com brasileiro	Sim	FP1440A	compl_pessoa_fisic.cod_livre_1,100,1	alterar	Não
31	Identificação Funcional / Trabalhador Estrangeiro	Filhos brasileiros	filhosBr	Filhos brasileiros	Sim	FP1440A	compl_pessoa_fisic.cod_livre_2,1,1	alterar	Não

Documentos / Identificação
ID	Campo HCM	Campo eSocial	Campo Flex	Campo Novo?	Programa	Tabela	Tipo Permissão	Zoom?
32	CPF	cpfTrab	CPF	Não	FP1440, FP1500	funcionario.cod_id_feder	consultar	Não
33	Carteira Identidade	nrRg	Carteira Identidade	Não	FP1440	rh_pessoa_fisic.cod_id_estad_fisic	alterar	Não
34	Orgão Emissor	orgaoEmissor	Órgão Emissor	Não	FP1440	campo compl_pessoa_fisic.num_livre_1 + rh_pessoa_fisic.cod_orgao_emis_id_estad	alterar	Sim
35	Emissão Identidade	dtExped	Emissão Identidade	Não	FP1440	rh_pessoa_fisic.dat_emis_id_estad_fisic	alterar	Não

Documentos / Identificação / Registro de Identidade Civil
ID	Campo HCM	Campo eSocial	Campo Flex	Campo Novo?	Programa	Tabela	Tipo Permissão	Zoom?
36	RIC	nrRic	Número	Sim	FP1440	compl_pessoa_fisic.cod_ric	alterar	Não
37	Órgão Emissor RIC	orgaoEmissor	Órgão Emissor	Sim	FP1440	compl_pessoa_fisic.cod_orgao_emis_ric	alterar	Não
38	Exped RIC	dtExped	Data Emissão	Sim	FP1440	compl_pessoa_fisic.dat_expedic_ric	alterar	Não

ID	Campo HCM	Campo eSocial	Campo Flex	Campo Novo?	Programa	Tabela	Tipo Permissão	Zoom?
Documentos / Carteira de trabalho
39	Número CTPS	nrCtps	CTPS	Não	FP1500	funcionario.cod_cart_trab	alterar	Não
40	Série	serieCtps	Série	Não	FP1500	funcionario.cod_ser_cart_trab,4,5	alterar	Não
41	UF	ufCtps	UF	Não	FP1500	funcionario.cod_unid_federac_cart_trab	alterar	Sim

Documentos / Outros
ID	Campo HCM	Campo eSocial	Campo Flex	Campo Novo?	Programa	Tabela	Tipo Permissão	Zoom?
42	PIS	nisTrab	PIS	Não	FP1500	funcionario.cod_pis	consultar	Não
43	Matrícula INSS	nisTrab	Matrícula INSS	Não	Fp1500	funcionario.cod_func_inss	consultar	Não
44	NIS	nisTrab	NIS	Sim	FP1440A	compl_pessoa_fisic.cod_nume_ident_social	consultar	Não

Documentos / Outros / Estrangeiro
ID	Campo HCM	Campo eSocial	Campo Flex	Campo Novo?	Programa	Tabela	Tipo Permissão	Zoom?
45	Ident Estrang	nrRne	Numero da Identidade	Sim	FP1440	rh_pessoa_fisic.cod_identde_estrang	alterar	Não
46	Emissor RNE	orgaoEmissor	Órgão Emissor RNE	Sim	FP1440A	compl_pessoa_fisic.cod_livre_1,036,020	alterar	Não
47	Emissão RNE	dtExped	Data Emissão RNE	Sim	FP1440A	compl_pessoa_fisic.cod_livre_1,028,008	alterar	Não

Documentos / Outros / Órgão de Classe
ID	Campo HCM	Campo eSocial	Campo Flex	Campo Novo?	Programa	Tabela	Tipo Permissão	Zoom?
48	Registro Profissional	nrOc	Número do Registro	Sim	FP3800	habilid_profis_func.cod_reg_profis_func	alterar	Não
49	Ent Classe + UF	orgaoEmissor	Órgão Emissor	Sim	FP1040, FP3800	habilid_profis.cod_entid_clas_profis + ' ' + string(habilid_profis_func.cod_unid_federac_rh)	alterar	Sim
50	Expedição	dtExped	Data Emissão	Sim	FP3800F	habilid_profis_func.dat_livre_1	alterar	Não
51	Validade	dtValid	Data Validade	Sim	FP3800F	habilid_profis_func.dat_livre_2	alterar	Não

ID	Campo HCM	Campo eSocial	Campo Flex	Campo Novo?	Programa	Tabela	Tipo Permissão	Zoom?
Documentos / Outros / CNH
52	Cart Habilitação	nrCnh	Registro CNH	Sim	FP1500	funcionario.num_cart_habilit	alterar	Não
53	Expedição	dtExped	Data Emissão CNH	Sim	FP1500F	funcionario.cod_livre_4,115,008	alterar	Não
54	UF	ufCnh	UF CNH	Sim	FP1500	funcionario.cod_livre_1,10,4	alterar	Sim
55	Vencimento Habilitação	dtValidade	Data Validade CNH	Sim	FP1500	funcionario.dat_vencto_habilit	alterar	Não
56	Data Primeira CNH	dtPriHab	Data Primeira CNH	Sim	FP1500F	sped_participan.dat_primei_cnh	alterar	Não
57	Categoria Habilitação	categoriaHab	Categoria CNH	Sim	FP1500	funcionário.cod_categ_habilit	alterar	Não

FP0170 - Manutenção Grupo de Informações

Criar um novo grupo de informações chamado: "P01 - Portal Meus Dados". (segur_grp_atrib_dados, grp_atrib_dados).
- Esse grupo terá lógica semelhante ao do grupo FIS.
  - Criar três tipos de permissões para a pasta: sem permissão, consultar e alterar.
  - Criar arquivo .d de inicialização da tabela segur_grp_atrib_dado, onde terá dois grupos default: QSQ e COO. Esses grupos terão o tipo permissão default CONSULTAR.
- Criar a include (varinc/varXXXXX.i) para conter a pasta com o nome eSocial.
  - Essa include será semelhante a var10108.i.
- Alterar oprograma object/sopy/brw/b02py262.w para tratar o novo grupo P01.

Protótipo Grupo de Informações - P01 Portal Meus Dados

Meus Dados - Api Progress

Programa	Dependência	Procedure	Tipo	Objetivo	Parâmetros	Regra	Retorno
FPAPIXXX	FPAPI054/pi_seguranca	pi_habilita_eSocial	Novo	Retornar se a aba eSocial será mostrada para o funcionário.	empresa estabelecimento funcionário	verificar se o eSocial não está habilitado para aquele empregador (estabelecimento), então, caso verdadeiro, cria tt-erro com a mensagem 2 (Importante: Para fazer essa verificação a api deverá chamar o FPEFD502, e, caso retorne 1, significa que o eSocial não está habilitado). Se estiver habilitado para o eSocial, então, chama a pi_segurança, para verificar se o funcionário tem acesso ao eSocial. Caso verdadeiro, cria a tt-erro com a mensagem 3.	tt-erro
FPAPI054		pi_seguranca	Alteração	Alterar a api para retornar a segurança do grupo de informações P01		Na pi-seguranca quando p_tipo_usuario = 1 adicionar condição para o grupo P01 e alimentar a tt_segur_grp_atrib_dado. Lógica idêntica a do grupo FIS. Na pi-seguranca quando p_tipo_usuario = 2 adicionar condição para o grupo P01 e alimentar a tt_segur_grp_atrib_dado. Lógica idêntica a do grupo FIS. Importante: Caso um funcionário esteja em dois ou mais grupos de segurança, deve-se considerar a permissão do grupo menos restritivo. Exemplo: Funcionário Pedro possui os grupos QSQ e FUN. O grupo QSQ tem permissão para consultar. Já o grupo FUN tem permissão para alterar. Neste caso a permissão que vale é a de alterar. A sequência de restrição é: Sem permissão -> Consultar -> Alterar.	tt-erro tt_segur_grp_atrib_dado
FPAPIXXX		pi_retorna_zoom_xxxxx	Novo	Criar varias procedures que retornem o valor dos zoom dos campos		Criar uma procedure para cada campo que na tabela de localiza dos campos eSocial a coluna Zoom for "sim". A procedure deverá retornar uma temp-table com essa lista de valores possíveis para o campo. Se ao consultar a lista ela estiver vazia, criar a tt-erro com a mensagem 1.	tt-xxxx tt-erro
FPAPIXXX		pi_salva_campos_eSocial	Novo	Possibilitar alteração de todos os campos eSocial	empresa estabelecimento funcionário todos os campos listados na tabela de localização do eSocial	A procedure irá verificar quais campos recebidos como parâmetro não estão em branco, então, deve atualiza-los no HCM. Verificar a lógica de atualização nas telas progress, para garantir a integridade dos dados. Ver FP6650rp e FP6600 (fazer um ctrl+c ctrl+v retirando os campos que não estão na tabela de localização). Fazer uma analise no especifico drg0003, avaliando o que pode ser aproveitado. Caso seja encontrado alguma inconsistência nos dados, cria-se tt-erro com a mensagem 4.	tt-erro
FPAPIXXX	FPAPIXXX/pi_retorna_zoom_xxxxx FPAPIXXX/pi_retorna_campos_eSocial	pi_gera_planilha_excel_eSocial	Novo	Fazer a criação de uma planilha excel contendo todos os campos do eSocial presentes na tabela de localização, então, salvar a planilha em um diretório recebido como parâmetro	diretório de rede compartilhado empresa estabelecimento funcionário	Criar uma planilha excel contendo todos os campos eSocial da tabela de localização. (Ver modelo em FP7060) salvar a planilha no diretório recebido como parâmetro. O nome da planilha deve usar o seguinte formato: <emp_estab_mat_dataatual-horaatual-minuto-segundo>, exemplo: 1_10_34-20102015-1700-54170054.xls Preencher todos os campos da planilha conforme valores atuais (pi_retorna_campos_eSocial) Campos onde na tabela de localização estão marcados como zoom, devem vir selecionados no registro atual do funcionário ou vazio. Estes campos na planilha devem ser do tipo combobox (pi_retorna_zoom_xxxxx) Retorna Retornar o nome da planilha salva, exemplo: 1_10_34-20102015-1700-54170054.xls	tt-erro v-file-name
FPAPIXXX		pi_retorna_campos_eSocial	Novo	Retornar todos os valores atuais de todos os campos do eSocial presentes na tabela de localização	empresa estabelecimento funcionário	Alimentar a tt-fields-eSocial com seu respectivo valor. Ver tabela de localização para encontrar as tabelas correspondente de cada campo.	tt-fields-eSocial ->.field-name ->.field-value
FPAPIXXX	FPAPIXXX/pi_salva_campos_eSocial	pi_le_planilha_excel_eSocial	Novo	Retornar todos os valores atuais de todos os campos do eSocial presentes na planilha enviada pelo funcionário através do upload	diretório de rede compartilhado nome da planilha	Lê a planilha recebida como parâmetro, então alimenta a tabela tt-fields-eSocial. Caso encontre alguma inconsistência nos dados lidos cria tt-erro com a mensagem 4. Chama a pi_salva_campos_eSocial passando a tabela tt-fields-eSocial.	tt-erro

Meus Dados - EmployeeDataView - Flex

Criar mais uma aba na tela flex Meus Dados chamada "eSocial".
- Chamar a pi_habilita_eSocial, então, se tt-erro tiver dados, a aba não deve aparecer para o funcionário. No log do jboss deve ser impresso um warning com o conteúdo da tt-erro.
- Dentro da aba eSocial criar dois botões: "download" e "Upload". Esses botões deverão ter uma descrição detalhada referente a seu funcionamento. Sugestão: colocar os botões centralizados na pagina e em cima a descrição.

Meus Dados - EmployeeDataView - Java/Flex - Botão Download

Implementar no hcm.properties uma propriedade para que seja informado um diretório UNC compartilhado com jboss e appserver.
Chamar api pi_gera_planilha_excel_eSocial passando como parametro o diretório compartilhado onde a planilha deve ser salva.
- Abrir planilha no brownser do usuário ou como download no navegador. (Ver exemplos em $/HCM/Fontes_Doc/Customizacao/Crefisa/v000/Java-Flex/Fontes/hcm-payroll-crefisa-epc/modules/justificationmonitorview-upc/src/main/flex/com/datasul/hcm/payroll/timelabor/timeattendance/justification/justificationmonitorview / $/HCM/Fontes_Doc/Customizacao/Crefisa/v000/Java-Flex/Fontes/hcm-payroll-crefisa-epc/modules/justificationmonitorview-upc/src/main/flex/com/datasul/hcm/payroll/timelabor/timeattendance/justification/justificationmonitorview /$/HCM/Fontes_Doc/Customizacao/Reutilizaveis/v2.12/MDW/JavaFlex/Fontes/mdw-301/src/main/resources).

Meus Dados - EmployeeDataView - Java/Flex - Botão Upload

Verificar se o funcionário logado possui permissão (FP0170, grupo P01, pasta eSocial) de alteração.
- Se não, gera a mensagem 7.
- Se sim, salva
Salvar
- planilha enviada na pasta compartilhada. Antes de salvar alterar o nome da planilha para o padrão <emp_estab_mat_dataatual-horaatual-
minuto-segundo
- minutosegundo_M>, exemplo: 1_10_34-20102015-1700-54_M.xls.
  - Chamar a api pi_le_planilha_excel_eSocial.
    - Caso retorne registros na tt-erro, deve-se exibir o erro 5 concatenado com o erro retornado na tt-erro.
    - Se a tt-erro estiver vazia, mostrar a mensagem 6.

Mensagem

Código	mensagem
1	"A tabela de <nome_tabela> está vazia. Efetue o cadastro no <código do programa>".
2	"<Func: matricula-estabelecimento-empresa> Empregador com eSocial não habilitado.
3	"<Func: matricula-estabelecimento-empresa> Funcionário sem permissão no FP0170 (grupo informação P01), para consultar eSocial.
4	"<Func: matricula-estabelecimento-empresa> O campo <nome_do_campo> com valor <valor_campo> é inválido.
5	Ocorreu um erro ao salvar os dados da planilha <diretório+nome.xls>: <tt-erro>
6	Dados eSocial atualizados com sucesso!
7	Ocorreu um erro ao salvar os dados da planilha: Funcionário sem permissão para atualizar o eSocial.

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 116

Nova versão 117

Chave

Informações Gerais

Objetivo

Definição da Regra de Negócio

Mensagem