...
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.
...
| 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 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. 
Opções disponíveisEntre as opções disponíveis é possível visualizar um registro no detalhe: 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.
* 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. 
| 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 | id4 | | 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 | id6 |
|---|
| label | 6 | label | 4. 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 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.
07. ASSUNTOS RELACIONADOS
http://suporte.quirons.com.br/pt-BR/articles/4942561-configuracao-integracao-quirons-totvsConfiguração Integração Quírons e 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
