Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Manual da Integração Quírons x DATASUL

Contexto de Negócio

A integração QuíronsRH 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:
    • NG Quírons: SST - Saúde e Segurança do Trabalho.

    • TOTVS RH - Linha DATASUL através dos seguintes módulos:
      • Folha de Pagamento: Módulo utilizado pelo cliente, sendo responsável pela manutenção dos cadastros: Funcionário, Dependente, Tipos de Estabilidade, Informações Adicionais, Histórico Funcional, Pessoa Física, Realização Treinamento, Abono, Afastamento, Centro de Custo, Tipos de Afastamentos, Turno de Trabalho, Tipos de Abonos, Estabilidade, Unidade de Lotação, Ocupação.
      • Administração de Treinamento: Módulo utilizado pelo cliente, sendo responsável pela manutenção dos cadastros: Treinamento, Necessidade de Treinamento.
      • Cargos e Salários: Cargo/Função, Cargo.

Pré-Requisito

  • Certificados do 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.


Parametrização DATASUL / Carga Inicial / Sincronizador

Deck of Cards
idConfiguração/Relação das APIs de integração e os objetos utilizados
Card
defaulttrue
idConfiguração DATASUL
labelConfiguração DATASUL

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.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
idCarga de Dados
labelCarga Inicial

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
idSincronizador
labelSincronizador

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


Relação APIs DATASUL 

Deck of Cards
idRelação APIs
Card
defaulttrue
idAPI Treinamentos
labelAPI 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
idAPI Tipos de Estabilidade
labelAPI 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
idAPI Informações Adicionais
labelAPI 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
idAPI Histórico Funcional
labelAPI 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
idAPI Funcionário
labelAPI 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
idAPI Dependentes
labelAPI 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
idIntegração NG - API Pessoa Física
labelIntegração NG - 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
idAPI Realização Treinamento
labelAPI 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
idAPI Abono
labelAPI 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
idAPI Afastamento
labelAPI 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
idAPI Centro Custo
labelAPI 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
idAPI Cargo/Função
labelAPI 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
idAPI Tipos de Afastamentos
labelAPI 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
idAPI Turno de Trabalho
labelAPI 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
idAPI Tipos de Abono 
labelAPI 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
idAPI Necessidade de Treinamento
labelAPI 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
idAPI Estabilidade
labelAPI 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
idAPI Unidade de Lotação
labelAPI 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
idAPI Cargo
labelAPI 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
idAPI – Ocupação
labelAPI – 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

   

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

...


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

...