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:

    • 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

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

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

      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:


      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: 

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

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

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

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

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

    • 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

    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:

    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

    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:

    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