...
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 |
---|
|
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 Cloak |
---|
| 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. ![](/download/attachments/793200883/1%20-%20MV_RHNG%2001.png?version=1&modificationDate=1696187405753&api=v2) ![](/download/attachments/793200883/1%20-%20MV_RHNG%2002.png?version=1&modificationDate=1696187406080&api=v2)
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 |
---|
default | true |
---|
id | id2 |
---|
label | 2. Monitor Integração NG |
---|
title | 2. 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
Opções disponíveis: Visualizar um registro no detalhe: Excluir da fila de integração: Forçar o reenvio de um registro já integrado: |
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.
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 |
---|
id | id4 |
---|
label | 4. Habilitar o Job de Integração |
---|
title | 4. 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 |
---|
| 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. |
|
Card |
---|
id | id2id5 |
---|
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 |
| . Carga Inicialtitle | 2. Carga Inicial
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 | 6. O que será integrado |
---|
| 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:
...
Image Added
...
Parâmetros de entrada:
Cloak |
---|
| 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:? | 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áriosParticipanteCandidato 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. |
|
Mais detalhes:
Cloak |
---|
|
Na primeira execução o processo pode ser um pouco demorado por isso será solicitada uma confirmação: Image Removed Image 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 |
---|
|
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 |
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
...
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.
...
Image Removed
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. Image Removed
Informações |
---|
| O programa GPEM923 funciona apenas como JOB e não possuiu interface visual, por esse motivo não é necessário incluí-lo no menu. |
|
...
id | id5 |
---|
label | 5. O que será integrado |
---|
title | 5. O que será integrado |
---|
Finalizada a configuração o Protheus estará apto a integrar:
...
05. 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