Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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
titleImportante

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
iduserLGILGA
Como habilitar os campos USERLGI / USERLGA

Cloak
iduserLGILGA

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
startHiddenfalse
historyfalse
idids
Card
defaulttrue
idid1
label1. Parâmetro MV_RHNG
title1. 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 e podem ser visualizados no Monitor Integração NG(GPEM924).

Card
defaulttrue
idid2
label2. Monitor Integração NG
title2. 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. 

Image Added


Informações
titleATENÇÃ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
idmnVisReg
Visualizar um registro no detalhe:

Cloak
idmnVisReg

Toggle Cloak
idmnExcReg
Excluir da fila de integração:

Cloak
idmnExcReg

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

Cloak
idmnReevReg

Card
idid3
label3. Autenticação dos webservices NG
title3. 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.

Image Added

* 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
idid4
label4. Habilitar o Job de Integração
title4. Habilitar o Job de Integração

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.

Image Added

Informações
titleImportante

O programa GPEM923 funciona apenas como JOB e não possui interface visual, por esse motivo não é necessário incluí-lo no menuEsses dados serão integrados através de um JOB que será configurado no passo 4.

. Carga Inicial2. Carga Inicial
Card
idid2id5
label5. Histórico de Envio
title5. 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:

0Nunca grava histórico.
1Grava histórico de erros apenas.
2
title
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
idid6
label6. O que será integrado
title6. O que será integrado

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

TabelaDescriçãoPath Quírons
SQGCadastro de Candidatos/ttalk/person
SRAFuncionários/ttalk/employee
SR7Histórico Funcional - Alterações Salariais/ttalk/functionalHistory
SRBDependentes/ttalk/dependant
SREHistórico Funcional - Transferências/ttalk/functionalHistory
RA4Treinamentos/ttalk/trainingHistory
SQBDepartamentos/ttalk/department
SQ3Cargos/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:

...

Image Added

Toggle Cloak
id

...

pergEnt
Parâmetros de entrada:

paramEnt
Cloak
id
pergEnt
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é:?
999999NãoStringquery
Final da relação de matrículas de funcionários ou dependentes.
Cadastro de 
Pessoas
Candidatos
CheckNãoOpçãoquery
Informa que será enviado na carga inicial a relação de 
funcionários
candidatos.
Participante
Candidato De:?
000001NãoStringquery
Início da relação de códigos de participantes.
Participante
Candidato Até:?
999999NãoStringquery
Final da relação de códigos de participantes.
Log de Processamento
CheckNãoOpçãoquery
Informa se deseja gerar um relatório com o LOG da carga de dados.

Toggle Cloak
iddetCargIni
Mais detalhes:

Cloak
iddetCargIni

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:


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

Image Removed

Image Removed

Informações
titleIMPORTANTE

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çãoPathTabelaMétodosObjetivo
Tipos de Abono/allowanceTypesSP6GETSomente consulta
Centro de Custo/payrollCostCenterCTTGETSomente consulta
Turnos de Trabalho/workingShift SR6GETSomente consulta
Cadastro de Funções/positionsSRJGETSomente consulta
Tipos de Afastamento/Ausência/leaveOfAbsenceTypeRCMGETSomente consulta
Tipos de Estabilidade/stabilityTypeRCCGETSomente consulta
Tipos de Treinamento/classesRA2GETSomente consulta
Adicionais de Periculosidade e Insalubridade/additionalSRAPUTAlteração
Estabilidade Funcional/stabilitycontrolRFXPOST, PUT, DELETEInclusão, Alteração, Exclusão
Marcações de Ponto/allowanceControlRF0POST, PUT, DELETEInclusão, Alteração, Exclusão
Necessidade de Treinamento/trainingNecessityRA2/RA3POST, PUT, DELETEInclusão, Alteração, Exclusão
Afastamentos / Ausências/leaveOfAbsenceControlSR8POST, PUT, DELETEInclusã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

...

idid3
label3. Autenticação dos webservices NG
title3. Autenticação dos webservices NG GPEM926

Parâmetros NG (GPEM926).

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

...

Image Removed

Card
idid4
label4. Habilitar o Job de Integração
title4. 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.

Image Removed

Informações
titleImportante

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

...

idid5
label5. O que será integrado
title5. O que será integrado

Finalizada a configuração o Protheus estará apto a integrar:

...

05. ASSUNTOS RELACIONADOS

06. ASSUNTOS RELACIONADOS

http://suporte.quirons.com.br/pt-BR/articles/4942561-configuracao-integracao-quirons-totvs

Exemplo de configuração do REST#872616691

...

Alterar Parâmetros (CFGX017 - SIGACFG)

DT Gravação de histórico do Quirons - Tela de Monitoramento

DT Monitor de Processamento Quírons Novo