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:
    • 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
      titleFuncioná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
      titleCandidato

      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
      titleDependente

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

    • Expandir
      titleCargo

      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
      titleHistó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
      titleHistó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
      titleDepartamento

      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
      titleNecessidade 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
      titleAfastamentos

      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
      titleCondiçõ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
      titleAbonos

      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
      titleEstabilidade

      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
idConfiguração
Card
defaulttrue
idConfiguraçãoDTS
labelConfiguraçã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 Parâmetros Medicina/Segurança, a aba “Integrações“ ficará visível:

Card
idCarga de Dados
labelCarga 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:

  1. Primeiro Envio:
    • Unidade de Lotação
    • Cargos
  2. 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
idSincronizador
labelSincronizador

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

Card
idInformações
labelInformaçõ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

Card
idCheck List de Implantação
labelCheck List de Implantação

Check List de Implantação - DATASUL x Quirons


Informações Técnicas:

Expandir
titleClique aqui para expandir

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
idAPI Pessoa Física
labelAPI 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