...
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:
DI Protheus X NG - Integração de Movimentos - Medicina e Segurança - RH.
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 .Esses dados serão integrados através de um JOB que será configurado no passo 4.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 | id2id3 |
---|
label | 23. Autenticação dos webservices NG |
---|
title | 23. 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.
![](/download/attachments/793200883/4%20-%20GPEM926.png?version=1&modificationDate=1696461320310&api=v2)
* 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 a o suporte da NG. |
Card |
---|
id | id3id4 |
---|
label | 34. Habilitar o Job de Integração |
---|
title | 34. 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. ![](/download/attachments/793200883/3%20-%20JOB%20GPEM923.png?version=1&modificationDate=1696188265190&api=v2)
Informações |
---|
| 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 | id4id6 |
---|
label | 46. O que será integrado |
---|
title | 46. 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 |
---|
RD0SQG | 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 |
|
|
...
Preencher as perguntas e clicar em OK:
Image Removed
Image Added
Parâmetros de entrada:
Cloak |
---|
|
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. |
|
...
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
...
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