Integração NG - RH - RM

Neste artigo será descrito o passo a passo para a parametrização da integração Quírons(NG) com o Módulo de RH.

Introdução

Cada vez mais o mercado exige que as operações complexas e manipulação de dados sejam ainda mais ágeis e com custos reduzidos. Com o RH não é diferente, os processos cada vez mais complexos e com muitas variáveis a serem analisadas no que tange a segurança e medicina do trabalho, os profissionais de saúde precisam de agilidade na hora de controlar processos funcionais da empresa.

Com essa necessidade e a importância desta área dentro da empresa, softwares especialistas em medicina e segurança do trabalho estão cada vez mais presentes no mercado e foi neste contexto que surgiu a necessidade da criação de um produto que possibilite automatizar cadastros e rotinas de funcionais dentro do ERP através de uma interface de integração.

QUÍRONS

Software desenvolvido pela NG, empresa com ampla experiência em gestão de medicina e segurança do trabalho, sendo pioneira na administração de processos funcionais e com atuação no mercado a mais de trinta anos tendo vários cases de sucesso.(Dados extraídos do site do próprio parceiro, mais informações).

Requisitos:

Versão: 12.1.29
Possuir acesso à Internet.
Estrutura de rede estável, para que haja trafego de dados sem interrupção.
RM devidamente configurado e serviço Rest habilitado em seu host. Exemplo da configuração, clique aqui.
TI do cliente deve liberar para acesso externo o IP e Porta.

Entidades da Integração:

Enviados Para o sistema Quírons:
- Funcionário
- Pessoa
- Dependente
- Histórico funcional
- Histórico de Treinamento
- Departamento
- Cargo
Buscados pelo o sistema Quírons:
- Tipos de Afastamento
- Centro de custo
- Turnos de Trabalho
- Tipos de Estabilidade
- Cursos
- Funções
- Histórico de Atestados

Dados enviados para o RM pelo o sistema Quírons:
- Necessidade de Treinamento
- Afastamentos
  - Quando é gerado um afastamento a situação do funcionário é alterada seguindo as regras do Novo Atestado.
- Condições diferenciadas de trabalho
- Abonos
- Estabilidade

Configurações inicias TOTVS Gestão de Pessoas (RM)

Para habilitar a integração no TOTVS Gestão de Pessoas (RM) é necessário configurar o sistema.

TOTVS Gestão de Pessoas (RM)

Primeiro é necessário ir no menu Cadastro de Integrações - RH e fazer a criação de uma nova integração para a NG.

Na inclusão escolha o Código do Parceiro da NG (0) e insira a Url base das chamadas as APIs dela. Por exemplo: https://app.quirons.com/ttalk/ URL de produção; https://hml.quirons.com/ttalk/ URL de homologação.

Atenção: Não marque a opção Utiliza para todas as Coligadas, pois o sistema da NG terá um usuário para cada uma delas, a não ser que o mesmo usuário seja cadastrado em todas. Desmarque o campo Ativo, para marca-lo ao final da parametrização. Insira o usuário e a senha do usuário do Quírons que será utilizado para a integração. Após isso salvar.

Acesse o anexo nesta mesma tela e clique em Entidades Integração.

Neste anexo será preenchido o restante da Url para cada uma das entidades de integração. No total são 5 entidades na integração sendo elas e seus respectivos complementos da Url:

Pessoa: person?branchId=X
Funcionário: employee?branchId=X
Histórico Funcional: functionalhistory?branchId=X
Dependente: dependant?branchId=X
Histórico de Treinamento: traininghistory?branchId=X
Cargo: position?branchId=X
Departamento: department?branchId=X

Observação: Substitua o X por um código de filial da coligada para validar a conexão. Esta alteração é necessária somente para o teste de conexão após o teste basta voltar para o X, não é necessário criar um registro para cada filial.

Após o preenchimento do Complemento da Url utilize o botão Testar Conexão para validar se esta sendo possível encontrar a API destino caso contrário uma mensagem de erro irá aparecer. Se todas as entidades forem testadas com sucesso podem prosseguir.

Parametrizador

Entrar em Configurações | Parametrizador.

07.00.15 – Integração com Terceiros e APIs.

07.00.15.01 – APIs.

Nesta etapa do parametrizador API Tipo Afastamento deverão ser informados/vinculados os Tipos de Afastamentos e Motivos de Afastamentos que serão utilizados no Quírons.

Essa associação é premissa para integrar corretamente os afastamentos provenientes dos Quirons. Disponível a partir da 12.1.34

Foi incluído um novo parâmetro para a inclusão de um tipo de RNT para ser utilizado quando a NG enviar as informações de Necessidade de Treinamento. É necessário o preenchimento deste para que a integração funcione corretamente, para este item.

Cursos

Para que a integração da Necessidade de Treinamento funcione corretamente é necessário que os cursos que serão utilizados na integração possuam Características Pessoais especificas para cada um deles.

Além disso, as características pessoais devem ter somente 3 níveis que representam:

1-Indispensável
2-Desejado
3-Recomendado

Após essas parametrizações a integração já pode ser Ativada.

Carga Inicial

É possível gerar as mensagens para todas as entidades da integração, basta executar o processo de Carga Inicial.

Observação: Para enviar os dados dependentes de funcionário (Hist. Funcional, Treinamento e Dependente) é aconselhado enviar o funcionário antes.

Mensagens criadas:

Após a Ativação os cadastros ao fazer edições nos cadastros de funcionário, de pessoa e de dependentes e também ao finalizar uma turma mensagens serão geradas para serem enviadas ao sistema da NG. Essas mensagens ficam presentes no menu Fila de Mensagens - RH .

Após entrar neste menu selecione as mensagens que deseja enviar e vá em Processos e selecione Enviar Mensagens. Este processo irá enviar as mensagens e as respostas de cada uma delas serão salvas dentro do registro respectivo. Caso o sistema tenha recebido uma resposta de sucesso o retorno é colocado no campo Retorno, caso contrario irá para o campo Erro. No campo erro será possível ver qual o erro que a mensagem teve para ser tratado pelo usuário. Todas as mensagens com o status de erro são passiveis de serem enviadas novamente caso necessário.

Atalhos

Páginas filhas