Integração | Protheus SIGAGPE x Quírons |

CONTEÚDO

01. VISÃO GERAL

O objetivo deste documento é explicar a integração do Protheus com o software Quírons através da troca de mensagens no formato JSON utilizando o padrão de APIs REST.

02. O QUE É O QUÍRONS ?

O Quírons é uma solução SaaS voltada para SST (Saúde e Segurança do Trabalho) desenvolvida pela NG Informática, para maiores informações consulte a documentação no link https://quirons.com.br/.

03. COMUNICAÇÃO DO QUÍRONS COM AS APIS DO PROTHEUS

Toda comunicação entre os sistemas acontece através das APIs REST.

Para que o Quírons se comunique com as APIs do Protheus primeiro realize a configuração prévia do Quírons.

Feita essa configuração, habilite o REST do Protheus e já será possível carregar algumas informações como o cadastro de Funções, Turnos de trabalho, Centro de Custo e etc.

Importante

Os campos _USERLGI e _USERLGA são utilizados para controlar quando um registro foi incluído ou alterado.

Caso se depare com uma mensagem informando que o campo USERLGI ou USERLGA não foi encontrado, será necessário habilitá-los no módulo configurador.

Como habilitar os campos USERLGI / USERLGA

04. COMUNICAÇÃO DO PROTHEUS COM AS APIS DO QUÍRONS

O Protheus também se comunica utilizando as APIs do Quírons.

A cada alteração de Funcionários, Dependentes, Cargos, por exemplo, será gravado um registro na tabela RJP que indicará que aquele cadastro deve ser enviado.

Para que as alterações feitas no Protheus sejam refletidas no Quírons, o cliente deve fazer as seguintes as seguintes configurações:

Acessar o módulo configurador e preencher o PARÂMETRO MV_RHNG com .T.

A partir desse momento, a cada inclusão ou alteração os dados serão gravados na tabela RJP e podem ser visualizados no Monitor Integração NG(GPEM924).

Acesse o Monitor Integração NG (GPEM924) para visualizar os histórico de registros que já foram integrados ou estão pendentes de integração.

ATENÇÃO

Modernizamos a tela de Monitor Integração NG e incluímos algumas melhorias, veja mais detalhes em Monitor de Processamento Quírons (Novo).

Opções disponíveis:

Visualizar um registro no detalhe:

Excluir da fila de integração:

Forçar o reenvio de um registro já integrado:

Parâmetros NG (GPEM926).

Utilize essa rotina para configurar a autenticação com as APIs do Quírons.

Primeiro informe a URL base das APIs do Quírons e em seguida informe o usuário e senha do usuário do Quírons que será utilizado nas integrações.

* Importante se certificar que o servidor onde o Protheus está instalado possui acesso à URI cadastrada aqui.

Em ambientes cloud, por uma questão de segurança, endereços externos costumam ser bloqueados por padrão.

** Caso tenha dúvidas sobre ou onde obter as informações acima, entre em contato com o suporte da NG.

JOB de Integração (GPEM923).

Essa rotina que deve ser cadastrada no SCHEDULE será responsável por verificar as alterações pendentes na tabela RJP e fazer o envio para o Quírons.

Importante

O programa GPEM923 funciona apenas como JOB e não possui interface visual, por esse motivo não é necessário incluí-lo no menu.

Histórico de Envio

Para habilitar a gravação do Histórico do que é enviado para o Quírons será necessário configurar o parâmetro MV_HISTQUI com 1 ou 2.

Onde:

0	Nunca grava histórico.
1	Grava histórico de erros apenas.
2	Sempre grava o histórico

Desse momento em diante o histórico ficará gravado na tabela RU7 e poderá ser consultado em:

Monitor Integração NG (GPEM924) / Outras Ações / Histórico Envio.

Caso tenha o interesse de apagar todo o Histórico ou apenas o histórico de determinado intervalo é possível fazê-lo através da opção:

Monitor Integração NG (GPEM924) / Outras Ações / Limpar Histórico.

Apenas a nível de informação, finalizada a configuração o Protheus estará apto a enviar:

Tabela	Descrição	Path Quírons
SQG	Cadastro de Candidatos	/ttalk/person
SRA	Funcionários	/ttalk/employee
SR7	Histórico Funcional - Alterações Salariais	/ttalk/functionalHistory
SRB	Dependentes	/ttalk/dependant
SRE	Histórico Funcional - Transferências	/ttalk/functionalHistory
RA4	Treinamentos	/ttalk/trainingHistory
SQB	Departamentos	/ttalk/department
SQ3	Cargos	/ttalk/position

05. CARGA INICIAL

A Carga Inicial deve ser utilizada para enviar, para a tabela RJP, informações criadas antes da ativação do parâmetro MV_RHNG.

Acessar a rotina disponível em: SIGAGPE / Atualizações / Integrações / Integração Ng / Carga Inicial (GPEM925)

Preencher as perguntas e clicar em OK:

Parâmetros de entrada:

Mais detalhes:

IMPORTANTE

Para uma melhor experiência, sugerimos que o usuário esteja logado na mesma filial em que ele deseja realizar a operação nos cadastros cujo conteúdo será integrado com o Quírons e que a Carga Inicial seja realizada por Filial.

Caso as tabelas de funcionários, dependentes e candidatos tiverem compartilhamentos diferentes, será necessário realizar a carga de cada uma de forma separada.

06. DEMAIS INFORMAÇÕES

APIs dessa Integração disponíveis por padrão no REST Protheus:

Descrição	Path	Tabela	Métodos	Objetivo
Tipos de Abono	/allowanceTypes	SP6	GET	Somente consulta
Centro de Custo	/payrollCostCenter	CTT	GET	Somente consulta
Turnos de Trabalho	/workingShift	SR6	GET	Somente consulta
Cadastro de Funções	/positions	SRJ	GET	Somente consulta
Tipos de Afastamento/Ausência	/leaveOfAbsenceType	RCM	GET	Somente consulta
Tipos de Estabilidade	/stabilityType	RCC	GET	Somente consulta
Tipos de Treinamento	/classes	RA2	GET	Somente consulta
Adicionais de Periculosidade e Insalubridade	/additional	SRA	PUT	Alteração
Estabilidade Funcional	/stabilitycontrol	RFX	POST, PUT, DELETE	Inclusão, Alteração, Exclusão
Marcações de Ponto	/allowanceControl	RF0	POST, PUT, DELETE	Inclusão, Alteração, Exclusão
Necessidade de Treinamento	/trainingNecessity	RA2/RA3	POST, PUT, DELETE	Inclusão, Alteração, Exclusão
Afastamentos / Ausências	/leaveOfAbsenceControl	SR8	POST, PUT, DELETE	Inclusão, Alteração, Exclusão

Outros detalhes técnicos podem ser consultados na documentação:

DI Protheus X NG - Integração de Movimentos - Medicina e Segurança - RH.

07. ASSUNTOS RELACIONADOS

Configuração Integração Quírons e Totvs

Exemplo de configuração do REST#872616691