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 DO 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 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 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
O Protheus também se comunica utilizando as APIs do Quírons.
A cada alteração de Funcionários, Dependentes, Cargos, por exemplo, será gravado um registro na tabela RJP que indicará que aquele cadastro deve ser enviado.
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 4. |
|
| 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. 
| 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. |
|
| 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 |
|
|
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:
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. |
06. ASSUNTOS RELACIONADOS
http://suporte.quirons.com.br/pt-BR/articles/4942561-configuracao-integracao-quirons-totvs
Exemplo de configuração do REST#872616691
DI Protheus X NG - Integração de Movimentos - Medicina e Segurança - RH.
Alterar Parâmetros (CFGX017 - SIGACFG)
