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írons 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:
  • 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, Dependentes, Dependente, Tipos de EstabilidadePessoas Físicas, Históricos Funcionais, Informações Adicionais, Histórico Funcional, Pessoa Física, Realização Treinamento, Abono, Afastamento, Centro de CustoTipos de Estabilidade, Turnos de Trabalho, Abonos, Tipos de Abonos, Afastamentos, Tipos de Afastamentos, Turno Centros de TrabalhoCusto, Tipos de Abonos, Estabilidade, Unidade de Lotação, OcupaçãoUnidades de Lotação e Cargos.
    • Administração de Treinamento: Módulo utilizado pelo cliente, sendo responsável pela manutenção dos cadastros: TreinamentoTreinamentos, Necessidade Necessidades de Treinamento e Treinamentos Realizados.Cargos e Salários: Cargo/Função, Cargo.
    • 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.

Parametrização DATASUL / Carga Inicial / Sincronizador


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:

      Image Added


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

      Image Added


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

      Image Added

      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:

      Image Added


      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:

      Image Added

    • Expandir
      titleDependente

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

      Image Added

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

      Image Added


      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: 

      Image Added

      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:

      Image Added


      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: 

      Image Added

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

      Image Added


      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: 

      Image Added

    • Expandir
      titleDepartamento

      Realizar o acesso ao programa FP0780 Manutenção Unidade Lotação e cadastrar uma unidade de lotação:

      Image Added


      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:

      Image Added


      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:

      Image Added


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

      Image Added



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

Image AddedImage Added

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  :

      Image Added

      Image Added


      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:

      Image Added

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

      Image Added


      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.

      Image Added


      Ao confirmar a inclusão do Atestado acima, podemos verificar este Afastamento do Datasul via programa FP1600 Manutenção Histórico de Situações:

      Image Added

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

      Image Added

      Image Added


      No Datasul, podemos verificar o cadastro da Condição Diferenciadas de Trabalho no programa FP1500 Funcionários:

      Image Added

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

      Image Added


      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

      Image Added


      Ao confirmar a inclusão do Atestado acima, podemos verificar este Abono do Datasul via programa FP1600 Manutenção Histórico de Situações:

      Image Added

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

      Image Added


      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:

      Image Added


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. 

Image Added


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.

Image Added


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.

Image Added

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:

Image Added

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
Deck of Cards
idConfiguração

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. 

Image Removed

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.

Image Removed

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

Image Removed

Carga Inicial
Card
defaulttrue
idConfiguração DATASUL
labelConfiguração DATASUL
Card
idCarga de Dados
label


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

Image Added


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 

Integração NG - Integração NG -
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
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
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