Histórico da Página
Manual da Integração Quírons x DATASUL
Contexto de Negócio
A
...
integração Quírons x RH DATASUL entrega aos clientes uma experiência diferenciada nos processos através da comunicação nativa dos sistemas, que enviam e recebem as informações.
Sistemas Envolvidos
Descrição dos sistemas envolvidos no contexto de negócio (e que serão envolvidos na integração).
- NG Quírons - Software de gestão de medicina e segurança do trabalho:
- Folha de Pagamento: Módulo utilizado pelo cliente, sendo responsável pela manutenção dos cadastros: Funcionário, Dependentes, Pessoas Físicas, Históricos Funcionais, Informações Adicionais, Tipos de Estabilidade, Turnos de Trabalho, Abonos, Tipos de Abonos, Afastamentos, Tipos de Afastamentos, Centros de Custo, Unidades de Lotação e Cargos.
- Administração de Treinamento: Módulo utilizado pelo cliente, sendo responsável pela manutenção dos cadastros: Treinamentos, Necessidades de Treinamento e Treinamentos Realizados.
- NG Quírons: SST - Saúde e Segurança do Trabalho.
- TOTVS RH - Linha DATASUL através dos seguintes módulos:
Pré-Requisito
- Certificados do Servidor Quírons atualizado no client (requisições HTTPS).
- O servidor DATASUL possuir IP Externo liberado, para realizar a comunicação entre os produtos.
- Informar os parâmetros de conexão do Quírons no Datasul:
- URL, usuário, senha e tipo de ambiente (Homolog. / Produção).
- Fornecer ao Quírons os parâmetros de conexão do Datasul (REST):
- URL, usuário e senha.
Entidades da Integração
Enviados para o sistema Quírons:
Expandir title Funcionário Realizar o acesso ao programa FP1440 Manutenção Pessoa Física e realizar o cadastro de uma nova pessoa:
Após cadastrar a Pessoal Física, realizar o acesso ao programa FP1500 Funcionários e realizar o cadastro de um novo registro de funcionário vinculando a pessoa física cadastrada anteriormente (Verifique que além de selecionarmos a pessoa física para este funcionário, também definimos para qual o estabelecimento se trata o cadastro):
Após realizar o cadastro de Pessoa Física e do Funcionário, o cadastro do Funcionário estará disponível para ser enviado para o Quírons podendo ser sincronizado via programa MT1100. No Quírons, o funcionário será disponibilizado no caminho 'Inicio > Outros > Pessoas':
Verificamos que o funcionário somente estará sendo exibido para o estabelecimento selecionado no do programa FP1500
Expandir title Candidato Realizar o acesso ao programa RS0027 Candidato Externo e realizar o cadastro de um novo registro de Candidato:
Após cadastrar o candidato Externo, realizado o acesso ao programa RS0788 Manter Agenda Requisição e incluir na agenda o Candidato Externo cadastrado anteriormente:
Expandir title Dependente Realizar acesso ao programa FP1760 Manutenção Dependentes e realizar a inclusão de um registro de dependente:
Expandir title Cargo Realizar acesso ao programa FP0770 Manutenção Cargo Básico e inserido um novo registro, este registro deve ser utilizado na formulação do Cargo posteriormente:
Após ter inserido o Cargo Básico, realizado acesso ao programa FP0720 Manutenção Cargo e inserido um registro de Cargo selecionando o Cargo Básico inserido anteriormente:
Ao realizar o cadastro do Cargo e Cargo Básico, após a sincronização dos dados para o Quírons, o Cargo estará disponibilizado no menu 'Inicio > Outros > Ocupação':
Expandir title Histórico funcional Realizar o acesso ao programa FP1620 Manutenção Salários e realizar o cadastro de um novo cargo para o Funcionário em questão:
Após haver um registro de Cargo para o Funcionário, seja pelo próprio cadastro do Funcionário no programa FP1500 Funcionários ou o cargo inserido no programa FP1620 Manutenção Salários, ao realizar a sincronização no programa MT1100, a listagem do cargo do Funcionário poderá ser verificado no no caminho 'Inicio > Outros > Pessoas' na aba Histórico Funcional:
Expandir title Histórico de Treinamento Realizado acesso ao programa AT0031 Manutenção Funcionário para realizar a inclusão de um treinamento para o Funcionário:
Após realizar a sincronização de envio de dados, podemos verificar no Quírons o envio realizado do Histórico de Treinamento no menu 'Inicio > Outros > Pessoas' para o funcionário que foi realizado o registro de treinamento anteriormente:
Expandir title Departamento Realizar o acesso ao programa FP0780 Manutenção Unidade Lotação e cadastrar uma unidade de lotação:
Após realizar o cadastro da Unidade de Lotação, acessado o programa FP0800 Manutenção Plano Lotação e vinculado a Unidade cadastrada anteriormente para um plano de lotação na aba Unidade conforme exemplo abaixo:
Após cadastrar a Unidade e realizar o vinculo em um Plano de Lotação, feito o acesso ao programa FP0570 Manutenção Complemento Estabelecimento e vinculado o Plano de Lotação em um estabelecimento, verifique que a Unidade Lotação só será exibida no Quírons para o estabelecimento utilizado nesse cadastro:
Somente após realizar o cadastro e os vínculos exibidos anteriormente, que o registro de Unidade Lotação (Departamento no Quírons) estará disponível para o envio via sincronização. Após a Sincronização realizada, a Unidade Lotação será disponibilizada no Quírons no menu 'Inicio > Outros > Departamento':
- Buscados pelo o sistema Quírons:
Para poder realizar a busca de dados pelo Quírons, devemos realizar acesso ao menu da conta, disponível no canto superior direito e na aba Organização selecionar a opção de Integração no estabelecimento que está selecionado, na pop up de Integrações, selecione a opção Sincronizar para o cadastro desejado:
Os dados disponíveis para a busca pelo Quírons são os listados abaixo.
- Tipos de Afastamento
- Centro de Custo
- Turnos de Trabalho
- Tipos de Estabilidade
- Treinamentos
- Funções
- Tipos de abono
- Dados enviados para o DATASUL pelo o sistema Quírons:
Expandir title Necessidade de Treinamento O cadastro de Necessidade de Treinamento pode ser feito acessando o programa no menu 'Inicio > Risco > Detalhes (Treinamento)' onde e um cadastro selecionamos o Funcionário em questão na seção de Caracterização do Risco e mais abaixo na seção Treinamentos podemos selecionar a Necessidade de treinamento para o funcionário selecionado :
Ao realizar o cadastro acima exibido, podemos verificar o cadastro da Necessidade de Treinamento no Datasul pelo Programa DS0081 Manutenção Necessidade Treinamento selecionando o funcionário selecionado no cadastro do Risco anteriormente:
Expandir title Afastamentos O cadastro de Afastamentos no Quírons deve ser realizado no menu "Inicio > Prontuários Médicos" e selecionar o Funcionário desejado. Na tela de alteração do prontuário deste Funcionário, na seção Atestado Médico, selecionar a opção Novo Atestado Médico:
Na tela de inclusão do Atestado Médico do Funcionário, além das informações de Data de inicio e fim do atestado e informações médicas, devemos selecionar na opção Tipo o valor Atestado, desta forma será habilitada a seleção do Tipo de Ausência.
Ao confirmar a inclusão do Atestado acima, podemos verificar este Afastamento do Datasul via programa FP1600 Manutenção Histórico de Situações:
Expandir title Condições Diferenciadas de Trabalho Para o cadastro de Condições Diferenciadas de Trabalho, no Quírons vamos acessar o menu 'Inicio > Riscos' e em um cadastro de Risco, inserido as informações de cadastro como Agente, Fonte Geradora, etc.. E também inserido a Intensidade deste risco cadastrado. Logo mais abaixo do cadastro dos detalhes do Risco, selecionado na opção Pessoas o Funcionário cujo o cadastro será referenciado:
No Datasul, podemos verificar o cadastro da Condição Diferenciadas de Trabalho no programa FP1500 Funcionários:
Expandir title Abonos O cadastro de Afastamentos no Quírons deve ser realizado no menu "Inicio > Prontuários Médicos" e selecionar o Funcionário desejado. Na tela de alteração do prontuário deste Funcionário, na seção Atestado Médico, selecionar a opção Novo Atestado Médico:
Na tela de inclusão do Atestado Médico do Funcionário, além das informações de Data de inicio e fim do atestado e informações médicas, devemos selecionar na opção Tipo o valor Declaração, desta forma será habilitada a seleção do Tipo de Abono
Ao confirmar a inclusão do Atestado acima, podemos verificar este Abono do Datasul via programa FP1600 Manutenção Histórico de Situações:
Expandir title Estabilidade O cadastro de Estabilidade no Quírons deve ser realizado via o menu 'Início > Mandatos' onde será necessário acessar o Detalhes de um mandato em vigência e na seção Componente inserir um novo registro para o Funcionário desejado:
Após cadastrar o componente do mandato anterior, podemos verificar a Estabilidade no Datasul via Programa FP3821 Listagem Estabilidade do Funcionário via execução do relatório conforme imagem abaixo:
Parametrização DATASUL / Carga Inicial / Sincronizador
Deck of Cards | |||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||
|
Informações Técnicas:
Expandir | ||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||
Relação APIs DATASUL
|
...
|
...
Integração NG - API Funcionário – Complemento
Objetivo: Integração do funcionário deve contemplar as informações de Cargo, Estado Civil, Grau de Instrução, CTPS, Nome da Mãe, Estado do endereço, Código da RAIS e Categoria eSocial afim de atender exigência de relatório legais no parceiro NG.
src/prghur/fpp/employee.p
Processos de Carga de dados:
Carga NG (Homologação x Produção)
object/sopm/vwr/v09pm338.w
Carga NG (Pessoa, Funcionários e Dependentes)
Objetivo: Efetuar o processo de carga das pessoas, funcionários e dependentes para integração da NG.
prghur/fpp/employeeDependentsLog.p
prghur/fpp/employeeLog.p
prghur/fpp/personLog.p
prghur/mtp/mt1000.w
prghur/mtp/mt1000rp.p
prghur/mtp/mt1000tt.i
Carga NG – (Lotação e Cargo)
Objetivo: Permitir que o Datasul realize o processo de carga das unidades de lotação e cargo para a NG.
prghur/mtp/mt1000.w
prghur/mtp/mt1000rp.p
prghur/mtp/mt1000tt.i
Sincronizador NG
Objetivo Permitir que as mensagens, Pendentes de envio ou com erro, relacionadas a Pessoas, Funcionários, Dependentes, Histórico Funcional e Realização de Treinamentos originadas a partir da Carga e/ou gatilho possam ser enviadas ao sistema da NG.
prghur/fpp/employee.p
prghur/fpp/employeeHistoryPosition.p
prghur/mtp/mt1100.w
prghur/mtp/mt1100rp.p
prghur/mtp/mt1100tt.i
src/prghur/mtp/mt1000rp.p
univdata/men_mmt.d
Alteração de informações com mensagem Pendente
Objetivo: Automatizar os cancelamentos das mensagens Pendentes/Erro caso o registro que originou a mensagem seja alterado.
rh/api/v1/generics/rh-integ.i
Chave identificadora | Ajuste dos status | Ajuste dos Gatilhos
database/tgpm/twp/twpm064.p
database/tgpm/twp/twpm200.p
database/tgpy/twp/twpy047.p
database/tgpy/twp/twpy085.p
database/tgpy/twp/twpy257.p
prghur/fpp/apiAllowanceTypes.p
database/inpy/i01py00840.i
prghur/fpp/apiPayRollCostCenter.p
prghur/fpp/apiLeaveOfAbsenceType.p
prghur/fpp/apiWorkingShift.p
prghur/fpp/apiPositions.p
prghur/fpp/apiClasses.p
prghur/fpp/apiStabilityType.p
prghur/fpp/employee.p
prghur/fpp/employeeDependents.p
prghur/fpp/trainingHistory.p
prghur/fpp/person.p
prghur/fpp/employeeHistoryPosition.p
Senha de validação - Integração NG
Objetivo: Criar validação por arquivo com chave de acesso para tela de ativação e programa de geração da carga de integração NG.
prghur/fpp/fpefd564.p
prghur/mtp/mt0004.w
gera-ativacao-integr-ng.p
...
|
...
Expandir | ||||
---|---|---|---|---|
| ||||
Geração de token de acesso Para geração do token de acesso é necessário criar o diretório “CFGHUR”. O programa "gera_ativacao_integr_ng.
Deverá ser informado no campo BASE CNPJ/CPF os primeiros 8 dígitos do CNPJ de cada empresa que participará do processo de integração. Caso tenha dúvidas de onde localizar a informação, basta acessar o programa FP0500 – Parâmetros Empresa RH Após informar a base do CGC o programa gerará um novo arquivo contendo o token de acesso. O arquivo terá o nome "config_integr_ng.xml", e estará localizado na pasta C:\temp. Atenção: O arquivo config_integr_ng.xml deverá ser copiado para a pasta "cfghur" e este diretório deverá ser informado no propath da base do cliente. Seguindo os procedimentos descritos acima, ao acessar o programa MT0004 Manutenção Paramentros Medicina/Segurança, a pasta “Integrações“ ficará visível. Parametrização de credenciais de acesso MT0004 |