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. 

Hierarquia/Envio da Chefia

No envio do funcionário é possível enviar a chefia dos funcionários, propriedades do json: 'matricula_chefia', 'nome_chefia' e 'email_chefia'.

Para envio dessas informações, a integração verifica se o funcionário está alocado em algum departamento, estando alocado será criado a estrutura hierárquica no protheus conforme configuração do parâmetro MV_ORGCFG para busca do responsável pelo departamento.

Exemplo de uma estrutura de departamento, onde a base é o departamento Suporte 2 e Suporte, ambos tem como responsável a matricula 000068 e o departamento superior é o departamento Liderança.

As chaves Keyini dos departamentos da hierarquia devem estar corretas para a busca dessas informações. 

O funcionário 000002 que será integrado está alocado no departamento Suporte 2, logo, a a chefia imediata dele é a matrícula 000068.

Matrícula da chefia na SRA - Cadastro do funcionário

Na integração deste funcionário, será validado a hierarquia e essas informações serão integradas no json do funcionário.

A matrícula da chefia também é concatenada com a filial.

Documentação auxiliar: Como configurar a hierarquia por departamentos (MV_ORGCFG=0)

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 GPEM943 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 GPEM943 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;

Localizações - Ahgora

A localização é uma propriedade criada no envio do funcionário.

Caso não seja definida nenhuma localização, não será enviada a propriedade 'localizacoes' no json do funcionário.

Requisitos para cadastro das localizações:

Foi efetuado a criação de tabelas no dicionário SX2, conforme estrutura abaixo:

Foi efetuado a criação de campos no dicionário SX3 conforme estrutura abaixo:

Foi efetuado a criação de índices no dicionário SIX conforme estrutura abaixo:

Funcionamento:

Ao abrir a tela da integração Ahgora, será mostrado o menu Localizações Ahgora

Ao clicar no menu, será validado se possuí a tabela RUL na base de dados, sendo assim, será mostrado a tela de cadastro de uma nova localização.

Primeiro Campo será filtrado os campos do cadastro do funcionário, tabela SRA.

Será permitido selecionar no máximo 4 campos.

Quando escolher essa opção, será gravado na tabela RUL os campos escolhidos na ordem de seleção concatenados por pipe, no envio do funcionário, será buscado essa localização, e será verificado o conteúdo dos campos escolhidos para montagem da localização.

Exemplo cadastro de localização através dos campos da SRA

Vou escolher dois campos, Filial e um outro campo customizado 

Na sequencia vou definir se quero usar para todas as filiais ou se vou querer escolher as filiais específicas.

Vou usar apenas para a filial 01 

Ao confirmar, o registro será salvo e a tabela recarregada.

No cadastro do funcionário tenho o seguinte conteúdo no campo RA_XLOCAL(Campo customizado), "01TESTE"

Como defini que a minha localização é a junção dos campos RA_FILIAL + RA_XLOCAL, logo, a minha localização será '0101TESTE'

No envio do funcionário será criado a localização no json de envio:

Localização Livre

Posso criar uma nova localização e utilizar o campo livre, ou seja, o conteúdo do campo será a minha localização.

Exemplo

Minha localização será 'Localização SP' e defini que ela será usada para todas as filais, ou seja, todos os funcionários integrados levarão essa localização no seu envio.

Tabela recarregada com a nova localização

Opção de alteração do funcionário.

Ao utilizar essa opção na inclusão da localização com 'Sim', será verificado na tabela de integração RUM, os registros correspondentes a filial da localização, caso exista e esteja com status 6-Integrados, será criado um registro de alteração na RUM para que seja possível enviar o funcionário com a localização criada.

Caso deixe com 'Não', o fluxo seguirá com a criação da localização, porém não será criado registro de alteração para funcionários já integrados.

Integração do funcionário.

Agora temos duas localizações, uma da filial 01 e a outra para todas as filiais.

Na integração do funcionário da filial 01, agora, serão integradas duas localizações no json de envio.

Exclusão

Ao selecionar o(s) registro(s), clique em 'Excluir', e confirme.

Após confirmar, será mostrado uma pergunta se deseja criar um registro de alteração para os funcionários.

É o mesmo cenário da inclusão, porém, como se trata da exclusão da localização, será realizada uma busca na tabela de integração pelos registros já integrados com status 6. Caso o registro exista, será criada uma alteração para que seja possível enviá-lo novamente, agora sem a localização excluída.

Caso responda 'Não', o fluxo seguirá com a exclusão da localização e não será criado registro de alteração para funcionários já integrados.

Localização excluída com sucesso

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 e do subunique 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 subunique.

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 e o subunique 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 subunique.

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 e do subunique 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 subunique.

Estrutura de Retorno:

Para o retorno de erro, seguir a estrutura abaixo.