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:

Realizar o acesso ao programa FP1440 Manutenção Pessoa Física e realizar o cadastro de uma nova pessoa:

Integrações > DI Quírons x RH DATASUL > image2022-9-23_11-10-53.png

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):

Integrações > DI Quírons x RH DATASUL > image2022-9-23_11-32-19.png

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':

Integrações > DI Quírons x RH DATASUL > image2022-9-23_11-40-38.png

Verificamos que o funcionário somente estará sendo exibido para o estabelecimento selecionado no do programa FP1500

Realizar o acesso ao programa RS0027 Candidato Externo e realizar o cadastro de um novo registro de Candidato:

Integrações > DI Quírons x RH DATASUL > image2022-9-23_11-56-18.png

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:

Integrações > DI Quírons x RH DATASUL > image2022-9-23_12-7-28.png

Realizar acesso ao programa FP1760 Manutenção Dependentes e realizar a inclusão de um registro de dependente:

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:

Integrações > DI Quírons x RH DATASUL > image2022-9-23_14-44-9.png

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':

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:

Integrações > DI Quírons x RH DATASUL > image2022-9-29_16-15-52.png

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:

Integrações > DI Quírons x RH DATASUL > image2022-9-29_16-21-30.png

Realizado acesso ao programa AT0031 Manutenção Funcionário para realizar a inclusão de um treinamento para o Funcionário:

Integrações > DI Quírons x RH DATASUL > image2022-9-23_17-14-51.png

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:

Integrações > DI Quírons x RH DATASUL > image2022-9-23_17-24-13.png

Realizar o acesso ao programa FP0780 Manutenção Unidade Lotação e cadastrar uma unidade de lotação:

Integrações > DI Quírons x RH DATASUL > image2022-9-23_17-49-58.png

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:

Integrações > DI Quírons x RH DATASUL > image2022-9-23_17-53-29.png

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:

Integrações > DI Quírons x RH DATASUL > image2022-9-29_11-56-2.png

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:

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 :

Integrações > DI Quírons x RH DATASUL > image2022-9-29_17-36-20.png

Integrações > DI Quírons x RH DATASUL > image2022-9-29_17-46-28.png

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:

Integrações > DI Quírons x RH DATASUL > image2022-9-29_17-49-15.png

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:

Integrações > DI Quírons x RH DATASUL > image2022-9-29_17-52-26.png

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.

Integrações > DI Quírons x RH DATASUL > image2022-9-29_17-55-29.png

Ao confirmar a inclusão do Atestado acima, podemos verificar este Afastamento do Datasul via programa FP1600 Manutenção Histórico de Situações:

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:

Integrações > DI Quírons x RH DATASUL > image2022-9-29_21-21-59.png

Integrações > DI Quírons x RH DATASUL > image2022-9-29_21-24-40.png

No Datasul, podemos verificar o cadastro da Condição Diferenciadas de Trabalho no programa FP1500 Funcionários:

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:

Integrações > DI Quírons x RH DATASUL > image2022-9-29_17-52-26.png

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

Integrações > DI Quírons x RH DATASUL > image2022-9-29_19-52-55.png

Ao confirmar a inclusão do Atestado acima, podemos verificar este Abono do Datasul via programa FP1600 Manutenção Histórico de Situações:

Integrações > DI Quírons x RH DATASUL > image2022-9-29_20-2-46.png

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:

Integrações > DI Quírons x RH DATASUL > image2022-9-29_20-5-54.png

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:

Integrações > DI Quírons x RH DATASUL > image2022-9-29_20-13-25.png

Parametrização DATASUL / Carga Inicial / Sincronizador

Geração de token de acesso:

Para geração do token de acesso é necessário criar o diretório “cfghur” dentro da pasta hcm.

O programa "prghur/spp/gera_ativacao_integr_ng.p" deve ser executado pelo editor da base.

Integrações > DI Quírons x RH DATASUL > 001.png

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.

Integrações > DI Quírons x RH DATASUL > 002.png

Seguindo os procedimentos descritos acima, ao acessar o programa MT0004-Manutenção Parâmetros Medicina/Segurança, a aba “Integrações“ ficará visível:

Atenção: O usuário deve ser o e-mail do usuário cadastrado no Quírons e a senha deve ser a mesma utilizada no Quírons.

Este usuário deve ter acesso a todos os Estabelecimentos e Filiais que serão enviados ao Quírons, esta parametrização é realizada no Quírons.

A carga inicial pode ser realizada via programa MT1000 selecionando na seção de Tipo de Processamento a opção Carga Inicial:

Para a carga inicial deve ser obedecido uma ordem no envio, ou seja, as mensagens de Funcionário, Dependente, Histórico Funcional, Histórico de Treinamento, Unidade de Lotação e Cargos não podem ser enviadas na mesma execução. Este envio deve ser obedecida na seguinte ordem:

Primeiro Envio:
- Unidade de Lotação
- Cargos
Segundo Envio:
- Funcionário
- Depedente
- Histórico Funcional
- Histórico de Treinamento

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
O programa MT1100 Sincronizador tem como 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:

Integrações > DI Quírons x RH DATASUL > image2022-9-30_11-16-36.png

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

Tela de Parâmetros
Objetivo: Disponibilizar ao usuário uma tela de configuração para integração com a NG que permite a configuração em base de Produção ou Ambiente de Homologação.
object/sopm/vwr/v09pm338.w
prghur/mtp/mt0004.w

Check List de Implantação - DATASUL x Quirons

Informações Técnicas:

Relação APIs DATASUL

Integração NG - API Treinamentos
Objetivo: integrar informações da tabela de treinamento do HCM com o sistema NG
prghur/fpp/apiClasses.p
prghur/fpp/apiClassesV1.i
prghur/fpp/fpefd561.p
rh/api/v1/Classes.p

Integração NG - API Tipos de Estabilidade
Objetivo: integrar informações da tabela de Tipos de Estabilidade do HCM com o sistema NG
prghur/fpp/apiStabilityType.p
prghur/fpp/apiStabilityTypeV1.i
prghur/fpp/fpefd561.p
rh/api/v1/StabilityType.p

Integração NG - API Informações Adicionais
Objetivo: integrar informações de Adicional da NG para integrar com as informações de funcionário para o sistema do HCM
prghur/fpp/apiAdditional.p
prghur/fpp/fpefd563b.p
rh/api/v1/Additional.p

Integração NG - API Histórico Funcional (Local de Trabalho, Função, Depto, Seção)
Objetivo: integrar informações da tabela de Histórico Funcional do HCM com o sistema NG
prghur/fpp/employeeHistoryPosition.p
database/tgpy/twp/twpy085.p

Integração NG - API Funcionário
Objetivo: integrar informações da tabela de Funcionário do HCM com o sistema NG
prghur/fpp/employee.p
database/tgpy/twp/twpy085.p

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

Integração NG - API Dependentes
Objetivo: integrar informações da tabela de Dependentes do HCM com o sistema NG
database/inpy/i01py00838.i
database/inpy/i01py00840.i
database/inpy/i02py00838.i
database/inpy/i02py00840.i
database/tgpy/tcp/tcpy00838.p
database/tgpy/tcp/tcpy00840.p
database/tgpy/tdp/tdpy00838.p
database/tgpy/tdp/tdpy00840.p
database/tgpy/twp/twpy00838.p
database/tgpy/twp/twpy00840.p
prghur/fpp/employeeDependents.p
rh/api/v1/generics/rh-integ.i
database/tgpy/twp/twpy047.p

Integração NG - API Pessoa Física
Objetivo: integrar informações da tabela de Pessoa Física do HCM com o sistema NG
database/tgpm/twp/twpm200.p
database/tgpy/twp/twpy085.p
database/tgpy/twp/twpy257.p
prghur/fpp/person.p

Integração NG - API Realização Treinamento
Objetivo: integrar informações da tabela de Realização Treinamento do HCM com o sistema NG
prghur/fpp/trainingHistory.p
database/tgpm/twp/twpm064.p

Integração NG - API Abono
Objetivo: integrar informações de Abono do sistema NG com a tabela de abono do HCM.
prghur/fpp/apiAllowanceControl.p
prghur/fpp/fpefd563a.p
rh/api/v1/AllowanceControl.p

Integração NG - API Afastamento
Objetivo: integrar informações de Afastamento do sistema NG com informações do Afastamento do HCM
prghur/fpp/apiLeaveOfAbsenceControl.p
rh/api/v1/LeaveOfAbsenceControl.p

Integração NG - API Centro Custo
Objetivo: Integrar informações da tabela de centro de custos do HCM com o sistema NG.
prghur/fpp/apiPayRollCostCenter.p
prghur/fpp/apiPayRollCostCenterV1.i
prghur/fpp/fpefd561.i
prghur/fpp/fpefd561.p
rh/api/v1/PayRollCostCenter.p

Integração NG - API Cargo/Função
Objetivo: Integrar informações da tabela de cargo do HCM com o sistema NG.
prghur/fpp/apiPositions.p
prghur/fpp/apiPositionsV1.i
rh/api/v1/Positions.p
prghur/fpp/fpefd561.p

Integração NG - API Tipos de Afastamentos
Objetivo: Integrar informações da tabela de tipos de afastamentos do HCM com o sistema NG.
prghur/fpp/apiLeaveOfAbsenceType.p
prghur/fpp/apiLeaveOfAbsenceTypeV1.i
rh/api/v1/LeaveOfAbsenceType.p

Integração NG - API Turno de Trabalho
Objetivo: Integrar informações da tabela de turnos de trabalhos do HCM com o sistema NG.
prghur/fpp/apiWorkingShift.p
prghur/fpp/apiWorkingShiftV1.i
rh/api/v1/WorkingShift.p

Integração NG - API Tipos de Abono
Objetivo: Integrar informações da tabela de tipos de abonos do HCM com o sistema NG.
prghur/fpp/apiWorkingShift.p
prghur/fpp/apiWorkingShiftV1.i
rh/api/v1/WorkingShift.p

Integração NG - API Necessidade de Treinamento
Objetivo: Integrar informações de Necessidade de Treinamento do sistema NG com o sistema HCM.
prghur/fpp/apiTrainingNecessity.p
prghur/fpp/fpefd563d.p
rh/api/v1/TrainingNecessity.p

Integração NG - API Estabilidade
Objetivo: Integrar informações do sistema NG com as informações de "Estabilidade" do sistema HCM
prghur/fpp/apiStabilityControl.p
prghur/fpp/fpefd563c.p
rh/api/v1/StabilityControl.p

Integração NG - API Unidade de Lotação
Objetivo: Permitir que o Datasul envie informações de unidades de lotação (departamento) para o sistema da NG.
prghur/fpp/department.p
database/inpy/i02py00840.i
database/tgpy/tdp/tdpy286.p
database/tgpy/twp/twpy286.p

Integração NG - API Cargo
Objetivo: Permitir que o Datasul envie informações de Cargo para o sistema da NG.
prghur/fpp/position.p
database/tgpy/tdp/tdpy026.p
database/tgpy/twp/twpy026.p
prghur/mtp/mt1100rp.p

Integração NG - API – Ocupação
Objetivo: Alterar a API Positions para considerar somente a informação do Cargo. A positions deve ser inativa e deve ser substituída por occupation
prghur/fpp/apiOccupation.p
prghur/fpp/apiOccupationV1.i
rh/api/v1/Occupation.p
prghur/fpp/fpefd561.p