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):
Entidades da Integração
- 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:
- Necessidade de Treinamento
- Afastamentos
- Condições diferenciadas de trabalho
- Abonos
- Estabilidade
Parametrização DATASUL / Carga Inicial / Sincronizador
Deck of Cards |
---|
|
Card |
---|
default | true |
---|
id | ConfiguraçãoDTS |
---|
label | Configuração |
---|
| 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.
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
|
Card |
---|
id | Carga de Dados |
---|
label | Carga Inicial |
---|
| 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:
- 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 |
Card |
---|
id | Sincronizador |
---|
label | Sincronizador |
---|
| 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 |
Card |
---|
id | Informações |
---|
label | Informações |
---|
| 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 |
|
Informações Técnicas:
Expandir |
---|
title | Clique aqui para expandir |
---|
|
Relação APIs DATASUL Deck of Cards |
---|
| Card |
---|
default | true |
---|
id | API Treinamentos |
---|
label | API Treinamentos |
---|
| 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 |
Card |
---|
id | API Tipos de Estabilidade |
---|
label | API Tipos de Estabilidade |
---|
| 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 |
Card |
---|
id | API Informações Adicionais |
---|
label | API Informações Adicionais |
---|
| 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 |
Card |
---|
id | API Histórico Funcional |
---|
label | API Histórico Funcional |
---|
| 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 |
Card |
---|
id | API Funcionário |
---|
label | API Funcionário |
---|
| 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 |
Card |
---|
id | API Dependentes |
---|
label | API Dependentes |
---|
| 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 |
Card |
---|
id | API Pessoa Física |
---|
label | API Pessoa Física |
---|
| 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 |
Card |
---|
id | API Realização Treinamento |
---|
label | API Realização Treinamento |
---|
| 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 |
Card |
---|
id | API Abono |
---|
label | API Abono |
---|
| 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 |
Card |
---|
id | API Afastamento |
---|
label | API Afastamento |
---|
| 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 |
Card |
---|
id | API Centro Custo |
---|
label | API Centro Custo |
---|
| 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 |
Card |
---|
id | API Cargo/Função |
---|
label | API Cargo/Função |
---|
| 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 |
Card |
---|
id | API Tipos de Afastamentos |
---|
label | API Tipos de Afastamentos |
---|
| 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 |
Card |
---|
id | API Turno de Trabalho |
---|
label | API Turno de Trabalho |
---|
| 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 |
Card |
---|
id | API Tipos de Abono |
---|
label | API Tipos de Abono |
---|
| 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 |
Card |
---|
id | API Necessidade de Treinamento |
---|
label | API Necessidade de Treinamento |
---|
| 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 |
Card |
---|
id | API Estabilidade |
---|
label | API Estabilidade |
---|
| 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 |
Card |
---|
id | API Unidade de Lotação |
---|
label | API Unidade de Lotação |
---|
| 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 |
Card |
---|
id | API Cargo |
---|
label | API Cargo |
---|
| 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 |
Card |
---|
id | API – Ocupação |
---|
label | API – Ocupação |
---|
| 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 |
|
|