Histórico da Página

...

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

Algumas informações são trocadas Toda comunicação entre os sistemas acontece através das APIs REST do Protheus.

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

...

Informações

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

Toggle Cloak

id	userLGILGA

Como habilitar os campos USERLGI / USERLGA

Cloak

id	userLGILGA

Acesse SIGACFG / Base de Dados / Base de Dados / Dicionário de Dados

Encontre a tabela desejada:

Clique para editar a tabela e habilite os campos reservados: Log de Inclusão e Log de Alteração.

Agora salve para efetivar a alteração do dicionário(nesse passo será necessário acesso exclusivo ao sistema).

Detalhes mais técnicos sobre as APIs do Protheus podem ser consultados na documentação:

...

.

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

...

Deck of Cards

startHidden	false
history	false
id	ids

Card

default	true
id	id1
label	1. Parâmetro MV_RHNG
title	1. Parâmetro MV_RHNG

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

Informações
A partir desse momento, a cada inclusão ou alteração os dados serão gravados na tabela RJP .Esses dados serão integrados através de um JOB que será configurado no passo 4e podem ser visualizados no Monitor Integração NG(GPEM924).

Na primeira execução o processo pode ser um pouco demorado por isso será solicitada uma confirmação:

Image RemovedImage Removed

No final será possível visualizar o log dos registros gravados na tabela RJP:

Image Removed

Card

default	true
id	id2
label	2. Carga InicialMonitor Integração NG
title	2. Carga InicialMonitor 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.

Image Added

Informações

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

Toggle Cloak

id	mnVisReg

Visualizar um registro no detalhe:

Cloak

id	mnVisReg

Toggle Cloak

id	mnExcReg

Excluir da fila de integração:

Cloak

id	mnExcReg

Toggle Cloak

id	mnReevReg

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

Cloak

id	mnReevReg

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:

Image Removed

Toggle Cloak

id	paramEnt

Parâmetros de entrada:

Cloak

id	paramEnt

Parâmetro

Valor de Exemplo

Obrigatório

Tipo

Parâmetro

Valor Default

Descrição

Filial De:?

D MG 01

Não

String

query

Inicio da relação de filiais.

Filial Até:?

D MG 01

Não

String

query

Final da relação de filiais.

Cadastro de Funcionários

Check

Não

Opção

query

Informa que será enviado na carga inicial a relação de funcionários.

Cadastro de Dependentes

Check

Não

Opção

query

Informa que será enviado na carga inicial a relação de funcionários.

Matrícula De:?

Não

String

query

Início da relação de matrículas de funcionários ou dependentes.

Matrícula Até:?

999999

Não

String

query

Final da relação de matrículas de funcionários ou dependentes.

Cadastro de Pessoas

Check

Não

Opção

query

Informa que será enviado na carga inicial a relação de funcionários.

Participante De:?

000001

Não

String

query

Início da relação de códigos de participantes.

Participante Até:?

999999

Não

String

query

Final da relação de códigos de participantes.

Log de Processamento

Check

Não

Opção

query

Informa se deseja gerar um relatório com o LOG da carga de dados.

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

Informações

title	IMPORTANTE

Card

id	id3
label	3. Autenticação dos webservices NG
title	3. Autenticação dos webservices NG GPEM926

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.

Card

id	id4
label	4. Habilitar o Job de Integração
title	4. Habilitar o Job de Integração

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

Informações

title	Importante

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

Card

id	id5
label	5. Histórico de Envio
title	5. Histórico de Envio

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.

Image Added

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.

Card

id	id6
label	6. O que será integrado
title	56. O que será integrado

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

Tabela	Descrição	Path Quírons
SQGRD0	Cadastro de PessoasCandidatos	/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.

...

Preencher as perguntas e clicar em OK:

Image RemovedImage Added

Toggle Cloak

id	paramEntpergEnt

Parâmetros de entrada:

Cloak

id	paramEntpergEnt

Parâmetro	Valor de Exemplo	Obrigatório	Tipo	Parâmetro	Valor Default	Descrição
Filial De:?	D MG 01	Não	String	query		Inicio da relação de filiais.
Filial Até:?	D MG 01	Não	String	query		Final da relação de filiais.
Cadastro de Funcionários	Check	Não	Opção	query		Informa que será enviado na carga inicial a relação de funcionários.
Cadastro de Dependentes	Check	Não	Opção	query		Informa que será enviado na carga inicial a relação de funcionários.
Matrícula De:?	000001	Não	String	query		Início da relação de matrículas de funcionários ou dependentes.
Matrícula Até:?	999999	Não	String	query		Final da relação de matrículas de funcionários ou dependentes.
Cadastro de PessoasCandidatos	Check	Não	Opção	query		Informa que será enviado na carga inicial a relação de funcionárioscandidatos.
ParticipanteCandidato De:?	000001	Não	String	query		Início da relação de códigos de participantes.
ParticipanteCandidato Até:?	999999	Não	String	query		Final da relação de códigos de participantes.
Log de Processamento	Check	Não	Opção	query		Informa se deseja gerar um relatório com o LOG da carga de dados.

Toggle Cloak

id	detCargIni

Mais detalhes:

Cloak

id	detCargIni

Na

...

primeira

...

execução

...

o

...

processo

...

pode

...

ser

...

um

...

pouco

...

demorado

...

por

...

isso

...

será

...

solicitada

...

uma

...

confirmação:

...

No final será possível visualizar o log dos registros gravados na tabela RJP:

...

Image Removed

...

Informações

title	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 pessoas 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