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:
- 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:
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.
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 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:
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
Informações Técnicas: