Histórico da Página

Para integração com Ahgora, a elegibilidade do ponto é obrigatório, onde será enviado na integração do funcionário, se o ponto dele é obrigatório ou livre.

Essa configuração deve ser feita antes da integração dos funcionários.

Cadastro do Funcionário - Rotina GPEA010

Para alteração da elegibilidade do ponto do funcionário, onde será informado se ele possuí o ponto obrigatório ou ponto livre, o parâmetro que será usado é o MV_RHAHGOR, com o parâmetro habilitado, ao alterar o cadastro do trabalhador, clicar no menu 'Outras ações' > 'Integração Ahgora', será aberta a tela abaixo.

A tela também será aberta na inclusão do funcionário, ao confirmar o cadastro.

   Ao salvar, será criado um registro no histórico do trabalhador na tabela SR9, esse registro será usado posteriormente na integração do funcionário com o sistema da Ahgora.

Carga Inicial

Também foi desenvolvida uma rotina para efetuar a carga inicial referente a elegibilidade do colaborar para o ponto. No cadastro de funcionários, em "Outras Ações", deve ser utilizada a opção "Integração Ponto - Ahgora":

Será aberto um wizard onde poderá ser definidos alguns filtros:

E deve ser informado se existe ou não controle de ponto, a data de elegibilidade para o controle, e as filiais que serão processadas:

Inicialmente a tela abre vazia esperando que sejam informados os filtros.

Na tela inicial o filtro é genérico com filial, admissão de/até e qual status da integração deseja filtrar.

Para mais filtros, é necessário acessar a opção de 'Filtros Avançados'

Como sugestão, a 'Data Admissão De' vem preenchida com um mês anterior que a data atual e a 'Data Admissão Até' com a data atual.

Filtros de 'Filial' e 'Data Admissão De' são obrigatórios. 

Filtro 'Filial' aceita multivalores 

Na opção de 'Filtros Avançados', é possível realizar mais alguns filtros específicos além dos filtros já apresentados na primeira tela.

Selecionando os filtros na tela de filtros avançados ou na tela inicial, e ao clicar no botão 'Aplicar Filtros', o sistema buscará as informações dos funcionários.

Apresentação das Informações

Ao aplicarmos os filtros será apresentada a seguinte tela:

Lista de Funcionários

Ao obter a lista de funcionários, temos as colunas:

• Status → Correspondente ao status do registro. 

          - Legenda verde, Tag 'NI' - Integrados

          - Legenda azul, Tag 'IN' - Não integrados

          - Legenda vermelha, Tag 'CI' - Com Inconsistências 

          - Legenda laranja, Tag 'AR' - Aguardando Retorno

• Matrícula Ahgora → Matrícula composta por Empresa + Filial + Matrícula do funcionário no GPE, campo RA_MAT;
• Nome → Nome do funcionário, campo RA_NOME;
• Dt. Admissão → Campo RA_ADMISSA;
• Dt. Demissão → Campo RA_DEMISSA;
• Turno → Turno do funcionário, campo RA_TNOTRAB;
• Função → Função do funcionário, campo RA_CODFUNC;
• Movimento → Inclusão/Alteração;
• Dt. Movimento → Data da movimentação;

Serão listados 100 registros por página, ao final da página será mostrado o botão para carregar mais resultados.

Selecionando um registro para integração.

Ao integrar o registro, se ocorrer tudo certo, o registro será alterado para 'Aguardando Retorno'.

Com o registro com status com legenda laranja, 'Aguardando Retorno', será necessário atualizar o status para que seja feita a consulta com o sistema Ahgora, para que possamos saber se o registro foi aceito ou não.

Ao final da atualização do status, o registro será alterado, nesse caso alterou para 'IN' - Integrado, ou seja, o registro foi integrado com sucesso.

Registro com erro fica com a legenda em vermelho, e você pode consultar o erro, na opção status que está localizada ao clicar nos 3 pontinhoa na parte direita da tabela.

Status

Nesse caso, o retorno do erro para o registro foi o E-mail já cadastrado, erro esse enviado pela Ahgora, ou seja, ela não aceitou o registro, pois o e-mail já está cadastrado em outro funcionário.

Consulta lote

A segunda opção é a consulta do lote de envio para o ahgora.

Ao abrir a tela do lote, é possível salvar o arquivo .json.

Registros que serão enviados na integração

Alterações no Protheus 

Rotinas que irão gravar registros para integração do funcionário na tabela RUM(Lote integração Ahgora):

• GPEA010/GPEA265 - Cadastro do funcionário;
• GPEA180 - Transferência;
• GPEM040 - Desligamento;
• PONA160 - troca de turno;

Ao incluir um funcionário ou alterar um campo pertinente para Ahgora, será gerado um registro na tabela de integração.

O registro gerado será do tipo 'A', alteração, porém caso não exista, será criado como inclusão "I".

Para transferência, caso exista o registro na tabela de integração, e esse registro ainda não estiver integrado, a transferência será abortada. 

Inicialmente a tela abre vazia esperando que sejam informados os filtros.

Na tela inicial o filtro é genérico com filial, afastamento de/até e qual status da integração deseja filtrar.

Para mais filtros, é necessário acessar a opção de 'Filtros Avançados'

Como sugestão, a 'Data Afastamento De' vem preenchida com um mês anterior que a data atual e a 'Data Afastamento Até' com a data atual.

Filtros de 'Filial' e 'Data Afastamento De' são obrigatórios. 

Apresentação das Informações

Ao aplicarmos os filtros será apresentada a seguinte tela:

Lista de Afastamentos

Ao obter a lista de afastamentos, temos as colunas:

• Status → Correspondente ao status do registro. 

          - Legenda verde, Tag 'NI' - Integrados

          - Legenda azul, Tag 'IN' - Não integrados

          - Legenda vermelha, Tag 'CI' - Com Inconsistências 

          - Legenda laranja, Tag 'AR' - Aguardando Retorno

• Matrícula Ahgora → Matrícula composta por Empresa + Filial + Matrícula do funcionário no GPE, campo RA_MAT;
• Nome → Nome do funcionário, campo RA_NOME;
• Tipo do afastamento → Tipo e descrição do afastamento, campos, R8_TIPOAFA + RCE_DESCRI;
• Dt. Início → Inicio do afastamento, campo R8_DATAINI;
• Dt. Fim→ Fim do afastamento, campo R8_DATAFIM;
• Movimento → Inclusão/Alteração;
• Dt. Movimento → Data da movimentação;

O processo de integração e retorno das informações funciona da mesma maneira demostrada na seção 'Integração Funcionários'

Registros que serão enviados na integração

Alterações no Protheus 

Rotinas que irão gravar registros para integração do afastamento na tabela RUM(Lote integração Ahgora):

• GPEA240 - Cadastro do Ausências;
• GPEM030/GPEM060 - Férias

Ao incluir uma ausência ou alterar um campo no afastamento pertinente para Ahgora, será gerado um registro na tabela de integração.

O registro gerado será do tipo 'A', alteração, porém caso não exista, será criado como inclusão "I".

Inicialmente a tela abre vazia esperando que sejam informados os filtros.

Na tela inicial o filtro é genérico com filial, exclusão de/até e qual status da integração deseja filtrar.

Para mais filtros, é necessário acessar a opção de 'Filtros Avançados'

Como sugestão, a 'Data Exclusão De' vem preenchida com um mês anterior que a data atual e a 'Data Exclusão Até' com a data atual.

Filtros de 'Filial' e 'Data Exclusão De' são obrigatórios. 

Apresentação das Informações

Ao aplicarmos os filtros será apresentada a seguinte tela:

Lista de Afastamentos

Ao obter a lista de afastamentos, temos as colunas:

• Status → Correspondente ao status do registro. 

          - Legenda verde, Tag 'NI' - Integrados

          - Legenda azul, Tag 'IN' - Não integrados

          - Legenda vermelha, Tag 'CI' - Com Inconsistências 

          - Legenda laranja, Tag 'AR' - Aguardando Retorno

• Matrícula Ahgora → Matrícula composta por Empresa + Filial + Matrícula do funcionário no GPE, campo RA_MAT;
• Nome → Nome do funcionário, campo RA_NOME;
• Tipo do afastamento → Tipo e descrição do afastamento, campos, R8_TIPOAFA + RCE_DESCRI;
• Dt. Início → Inicio do afastamento, campo R8_DATAINI;
• Dt. Fim→ Fim do afastamento, campo R8_DATAFIM;
• Movimento → Exclusão;
• Dt. Movimento → Data da movimentação;

O processo de integração e retorno das informações funciona da mesma maneira demostrada na seção 'Integração Funcionários'

Registros que serão enviados na integração

Alterações no Protheus 

Rotinas que irão gravar registros para integração da exclusão do afastamento na tabela RUM(Lote integração Ahgora):

• GPEA240 - Cadastro do Ausências;
• GPEM030/GPEM060 - Férias

Ao excluir o afastamento no GPE, será validado se existe o afastamento criado na tabela RUM, e se o mesmo está integrado, caso contrário, essa exclusão não será gerada na tabela de integração;

O registro gerado será do tipo 'E', exclusão.

Também foi disponibilizada a rotina GPEM942 para ser possível agendar no Schedule a realização da integração e consulta das integrações com Ahgora.

A rotina pode ser cadastrada no Schedule do módulo SIGACFG - Configurador para efetuar a integração automaticamente, conforme exemplo abaixo:

Exemplo de retorno gerado no console do appserver:

O JOB GPEM942 irá seguir a ordem abaixo:

1 - Serão integrados os funcionários contidos na tabela de integração RUM;

2 - Serão consultados o status da integração dos funcionários;

3 - Serão integrados os afastamentos contidos na tabela de integração RUM;

4 - Serão consultados os status da integração dos afastamentos;

5 - Serão integrados as exclusões dos afastamentos contidos na tabela de integração RUM;

6 - Serão consultados os status da integração das exclusões dos afastamentos;

Objetivo: Busca dos dados para listagem dos funcionários e envio dos funcionários selecionados para o back-end.

Tipo de requisição: GET/POST

Endpoint: /api/rh/v1/ahgora/funcionarios

Get:

Query Params:

Estrutura de Retorno:

Exemplo de Requisição:

GET: api/rh/v1/ahgora/funcionarios?page=1&pageSize=100&dataAdmissaoDe=2024-01-01T17:29:41-03:00&dataAdmissaoAte=2024-09-05T17:29:41-03:00&branchCode=01,02&situacao=

N,A&categoria=M,E&tipostatus=0,6&codCC=001%20%20%20%20%20%20&codCCAte=001%20%20%20%20%20%20&codFuncao=001%20%20&codFuncaoAte=001%20%20&turnoCode=001&turnoCodeAte=001

Se atentar com a paginação.

Post: /api/rh/v1/ahgora/funcionarios

A partir do filtro realizado, ao clicar em integrar funcionário, os dados serão enviados para o back-end.

Com os dados postados, o back-end se encarregará de montar o body para requisição de envio para o Ahgora: https://api.ahgora.com.br/people

Retorno do código unique de processamento retornado pela Ahgora

Devolver o retorno para o POUI com o status da integração para que seja atualizado a lista, nesse caso 'AR' (Aguardando retorno), pois ainda não foi feita a consulta do unique.

Estrutura de Retorno:

Para o retorno de erro, seguir a estrutura abaixo.

Objetivo: Busca dos dados para listagem dos afastamentos e envio dos afastamentos selecionados para o back-end.

Tipo de requisição: GET/POST

Endpoint: /api/rh/v1/ahgora/afastamentos

Get:

Query Params:

Estrutura de Retorno:

Exemplo de Requisição:

GET: api/rh/v1/ahgora/afastamentos?page=1&pageSize=100&dataAfastDe=2000-01-01T08:39:02-03:00&dataAfastAte=2024-09-06T08:39:02-03:00&branchCode=01&

matCode=&matCodeAte=&situacao=&categoria=&tipostatus=&codCC=&codCCAte=&codFuncao=&codFuncaoAte=&codDepto=&codDeptoAte=&turnoCode=&turnoCodeAte=

Se atentar com a paginação.

Post: /api/rh/v1/ahgora/afastamentos

A partir do filtro realizado, ao clicar em integrar afastamento, os dados serão enviados para o back-end.

Com os dados postados, o back-end se encarregará de montar o body para requisição de envio para o Ahgora: https://api.ahgora.com.br/absences

Obs* Caso não exista data fim, enviar uma fictícia, exemplo: 31/12/2099 

Retorno do código unique de processamento retornado pela Ahgora

Devolver o retorno para o POUI com o status da integração para que seja atualizado a lista, nesse caso 'AR' (Aguardando retorno), pois ainda não foi feita a consulta do unique.

Estrutura de Retorno:

Para o retorno de erro, seguir a estrutura abaixo.

Objetivo: Busca dos dados para listagem dos afastamentos excluídos e envio dos afastamentos excluídos selecionados para o back-end.

Tipo de requisição: GET/POST

Endpoint: /api/rh/v1/ahgora/afastamentos/exclusao

Get:

Query Params:

Estrutura de Retorno:

Exemplo de Requisição:

GET: api/rh/v1/ahgora/afastamentos/exclusao?page=1&pageSize=100&dataExcDe=2000-01-01T09:03:57-03:00&dataExcAte=2024-09-06T09:03:57-03:00&

branchCode=01&matCode=&matCodeAte=&situacao=&categoria=&tipostatus=&codCC=&codCCAte=&codFuncao=&codFuncaoAte=&codDepto=&codDeptoAte=&turnoCode=&turnoCodeAte=

Se atentar com a paginação.

Post:  /api/rh/v1/ahgora/afastamentos/exclusao

A partir do filtro realizado, ao clicar em integrar afastamento, os dados serão enviados para o back-end.

Com os dados postados, o back-end se encarregará de montar o body para requisição de envio para o Ahgora: https://api.ahgora.com.br/absences 

Retorno do código unique de processamento retornado pela Ahgora

Devolver o retorno para o POUI com o status da integração para que seja atualizado a lista, nesse caso 'AR' (Aguardando retorno), pois ainda não foi feita a consulta do unique.

Estrutura de Retorno:

Para o retorno de erro, seguir a estrutura abaixo.