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 QUÍRONS COM AS APIS DO PROTHEUS
Algumas informações são trocadas entre os sistemas 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 lado 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.
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 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 técnicos sobre as APIs podem ser consultados na documentação:
DI Protheus X NG - Integração de Movimentos - Medicina e Segurança - RH.
04. PARAMETRIZAÇÃO PROTHEUS x APIS QUÍRONS
O Protheus também envia dados utilizando as APIs do Quírons.
Para que as alterações feitas no Protheus sejam refletidas no Quírons, o cliente deve fazer as seguintes as seguintes configurações:
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 3. |
|
Card |
---|
id | id2 |
---|
label | 2. Carga Inicial |
---|
title | 2. 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: 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 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. |
|
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:
Informações |
---|
| Caso as tabelas de funcionários, dependentes e pessoas tiverem compartilhamentos diferentes, será necessário realizar a carga de cada uma de forma separada. |
|
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.
|
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.
|
Card |
---|
id | id5 |
---|
label | 5. O que será integrado |
---|
title | 5. O que será integrado |
---|
| Finalizada a configuração o Protheus estará apto a integrar: Tabela | Descrição |
---|
RD0 | Cadastro de Pessoas | SRA | Funcionários | SR7 | Histórico Funcional - Alterações Salariais | SRB | Dependentes | SRE | Histórico Funcional - Transferências | RA4 | Treinamentos | SQB | Departamentos | SQ3 | Cargos |
|
Card |
---|
id | id6 |
---|
label | 6. Documentações Relacionadas |
---|
title | 6. Documentações Relacionadas |
---|
|
|
|
05. ADAPTER
O
06. DE/PARA EMPRESAS
Em uma integração entre sistemas é comum os sistemas terem códigos diferentes, neste caso é muito importante ter um 'De/Para" (XXD), para que seja mapeado e retornado o valor interno de um determinado registro da tabela informada no cadastro de De/Para.
07. OBSERVAÇÕES
Para realizar integração com o Quírons na Baixa da Requisição (MATA185), nos parâmetros (F12) a primeira pergunta deve estar conforme imagem abaixo.
08. ASSUNTOS RELACIONADOS