No programa FP0540 - Manutenção Descentralizada HCM
Na aba Ahgora marque a opção "Integra Ahgora PontoWeb" e cadastre os dados para a integração.
Tipo de Ambiente:
Produção ou Homologação
Para o tipo de ambiente 'Homologação', a parametrização pode ser realizada no ambiente de Produção do TOTVS. Após finalizar os testes com o tipo 'Homologação', é possível alterar o tipo para 'Produção'. Essa mudança elimina a tabela de controle de envio, permitindo que os dados fiquem com o status 'Não Integrado', prontos para envio.
Obs.: Essa opção permite parametrizar cadastros, como o do FP1500, com 'Utiliza Ponto Ahgora' e a data de elegibilidade preenchidos.
Configurações conexão Ahgora:
Usuário
Senha
Endereço do servidor
Importante:
As informações de acesso ao ambiente da Ahgora devem ser solicitadas ao responsável do contrato da Ahgora.
Caso possua restrição em seu firewall, verifique se o endereço acima possuem liberação para conexão externa.
Utiliza Ponto Ahgora
Na aba Cadastral, durante a inclusão ou alteração dos dados do funcionário, é possível manter ou atualizar as informações para integração.
Nas informações dos campos Utiliza Ponto Ahgora, temos
Ponto Obrigatório, para quem deve registrar o ponto.
Ponto Livre, para quem não precisa registrar o ponto.
Data Elegibilidade Ponto, data relacionada ao dado do campo bate ponto "ponto obrigatório ou livre", data que inicia a elegibilidade do ponto.
Observação: Existe um programa de acerto para ajustar as informações mencionadas de forma automática. Para utilizá-lo, acesse com Ctrl + Alt + X e informe o caminho: prghur/spp/eSocial_Elegibilidade_Ponto.r
O programa possui opções de seleção por Empresa, Estabelecimento, Matrícula e Cargo Considera Demitidos e Data de referencia .
Se o cliente utiliza o ponto da TOTVS Ele pode selecionar a opção "Bate Entrada/Saída PE1700". Nesse caso, o programa buscará automaticamente as informações na Tela PE1700, aba Cálculo, campo " Bate Entrada/Saída".
Se o campo estiver marcado, o sistema definirá "Ponto Obrigatório".
Caso contrário, será atribuído "Ponto Livre".
O campo "Data Eleg. Ponto" será ajustado conforme a informação disponível na tela.
Se o cliente não utiliza o PE1700 Ele poderá selecionar manualmente entre as opções "Ponto Obrigatório" ou "Ponto Livre".
Ao final da execução, será gerado um arquivo .csv contendo a lista de funcionários ajustados.
Card
id
2
label
Parametrização Ahgora
title
Parametrização Ahgora
Antes da integração, é necessário que os cadastros básicos já existam no sistema da Ahgora. Abaixo estão os dados e onde encontrá-los no RH Datasul:
Obs.: No retorno dos resultados, programa dá prioridade para empresa do usuário, caso não encontre evento, utiliza o asterisco.
Turno (Escala Ahgora) - FP1400- Manutenção Turno de Trabalho
O turno é definido por banco e deve ser utilizado apenas o código do turno cadastrado no programa FP1400. Além disso, é necessário incluir a descrição correspondente do turno.
Tabela e Campos:
turno_trab.cdn_turno_trab
turno_trab.des_turno_trab
Sindicato - FP0600 - Manutenção Sindicatos
O sindicato é definido por banco e deve ser utilizado apenas o código do sindicato cadastrado no programa FP0600. Além disso, é necessário incluir a descrição correspondente do sindicato.
Tabelas e Campos:
sindicato.cdn_sindicato
rh_pessoa_jurid.nom_pessoa_jurid
Centro de Custo - FP0660 - Manutenção Centros de Custo
O código de centro de custo é por empresa e precisa código da empresa onde ele esta cadastrado. Além disso, é necessário incluir a descrição do centro de custo.
Tabela e Campos:
rh_ccusto.cdn_empresa
rh_ccusto.cod_rh_ccusto
rh_ccusto.des_rh_ccusto
Afastamento - FP0060 - Manutenção Situações
A situação de afastamento é definido por banco e deve ser utilizado apenas o código da situação cadastrado no programa FP0060. Além disso, é necessário incluir a descrição correspondente da situação.
Tabela e Campos:
sit_afast.cdn_sit_afast_func
sit_afast.des_sit_afast_func
Card
id
3
label
Integração
title
Integração
Para acessar o novo programa de integração dos produtos do RH Datasul com a Ahgora, vá ao menu e procure, por exemplo, pela palavra 'Ahgora'. Em seguida, será exibido o programa 'Integração Ahgora'.
Ao executar esse programa, será apresentada a aplicação com o menu 'Integração Ahgora', contendo itens como Funcionários e Afastamentos. No menu seguinte, 'Exclusão Ahgora', encontra-se a opção Afastamentos.
A seguir, detalharemos um pouco mais cada uma dessas opções.
Deck of Cards
id
Integração
Card
default
true
id
3-1
label
Funcionários
title
Funcionários
Informações
title
Atualização Cadastral
Para que os dados do funcionário sejam carregados na tela de integração com a Ahgora, é necessário que haja alguma alteração nos dados cadastrais do funcionário.
Abaixo estão listados os campos em que essa situação pode ocorrer:
Admissão
Nome
PIS
Data de Demissão
Alteração do Turno
CTPS
Alteração do Cargo
Alteração da Unidade de Lotação
Sexo
E-mail
CPF
RG
Transferência do Funcionário
Alteração do Centro de Custo
Data de Nascimento
Bate Ponto
Data de Troca de Elegibilidade do Ponto
Alteração do Chefe Imediato
Alteração de Sindicato
Telefone
Informações da tela
Na tela inicial, são apresentados filtros básicos para a seleção dos funcionários que serão enviados. Por padrão, o campo 'Data Admissão De' vem preenchido com um mês anterior à data atual, enquanto o campo 'Data Admissão Até' é preenchido com a data atual.
Os filtros 'Estabelecimento' e 'Data Admissão De' são obrigatórios.
Para mais filtros, é necessário acessar a opção de . Nesta opção é possível realizar mais alguns filtros específicos além dos filtros já apresentados na tela principal.
Após aplicarmos os filtros, será apresentada a seguinte tela:
Status: Correspondente ao status do registro
Matrícula Ahgora: Código da empresa + estabelecimento + matricula.
Obs.: As informações da matrícula Ahgora são as mesmas armazenadas no banco de dados, sem zeros à esquerda ou espaços em branco antes ou depois dos códigos.
Ex.: Empresa: 10, Estabelecimento: 1 e Matrícula: 99999929. Quando concatenados, o resultado será 10199999929.
Nome: Nome do funcionário.
Dt. Admissão: Data de admissão.
Dt. Demissão: Data de demissão.
Turno: Código do turno do funcionário.
Cargo: Código do cargo do funcionário.
Movimento: Inclusão/Alteração (status alteração ocorrerá sempre que o primeiro cadastro já tenha sido enviado para Ahgora).
Dt. Movimento: Data da movimentação (envio a Ahgora).
Serão listados até 100 registros por página. Ao final da página, será exibido o botão 'Carregar mais resultados' .
Para realizar o envio, selecione o(s) registro(s) desejado(s) e clique em 'Integrar Funcionários'. .
Ao integrar o registro, se tudo ocorrer corretamente, o status será alterado para 'Aguardando Retorno'. Em seguida, basta selecioná-lo novamente e atualizar o status para verificar o retorno da integração.
Ao final da atualização, o status do registro será alterado conforme o resultado:
Sem inconsistências: O status será atualizado para 'IN - Integrado', com a mensagem 'Registro integrado com sucesso.'
Com inconsistências: O status será atualizado para 'CI - Com Inconsistências'. Nesse caso, o erro pode ser consultado na opção 'Status', acessível ao clicar nos três pontos localizados à direita da tabela.
Card
id
3-2
label
Afastamentos
title
Afastamentos
Informações
title
Inclusão/Alteração do Afastamento
Para que a situação de afastamento seja carregada na tela de integração com a Ahgora, é necessário realizar a inclusão ou alteração do afastamento do funcionário.
As informações de afastamento seguem o filtro em que a data de início do afastamento seja menor ou igual à Data Afastamento Até, e a data de término do afastamento seja maior ou igual à Data Afastamento De.
Obs.: As situação de afastamento relacionadas a Transferência entra e saída e Desligamento, são desconsideradas no envio dos Afastamentos. Essas alterações são geradas pendencia de envio para o Funcionário.
Informações da tela
Na tela inicial, são apresentados filtros básicos para a seleção dos afastamento que serão enviados. Por padrão, o campo 'Data Afastamento De' vem preenchida com um mês anterior que a data atual e a 'Data Afastamento Até' com a data atual.
Os filtros de 'Estabelecimento' e 'Data Afastamento De' são obrigatórios.
Para mais filtros, é necessário acessar a opção de. Nesta opção é possível realizar mais alguns filtros específicos além dos filtros já apresentados tela principal.
Após aplicarmos os filtros será apresentada a seguinte tela:
Status:Correspondente ao status do registro
IN - Integrado.
NI - Não Integrado.
CI - Com Inconsistência.
AR - Aguardando Retorno.
Matrícula Ahgora: Código da empresa + estabelecimento + matricula.
Nome: Nome do funcionário.
Tipo do afastamento: Situação e descrição do afastamento.
Dt. Início: Início do afastamento.
Dt. Fim: Fim do afastamento.
Serão listados até 100 registros por página. Ao final da página, será exibido o botão 'Carregar mais resultados'.
Para realizar o envio, selecione o(s) registro(s) desejado(s) e clique em 'Integrar Afastamentos'. .
Ao integrar o registro, se tudo ocorrer corretamente, o status será alterado para 'Aguardando Retorno'. Em seguida, basta selecioná-lo novamente e atualizar o status , para verificar o retorno da integração.
Ao final da atualização, o status do registro será alterado conforme o resultado:
Sem inconsistências:O status será atualizado para 'IN - Integrado', com a mensagem 'Registro integrado com sucesso.'
Com inconsistências:O status será atualizado para 'CI - Com Inconsistências'. Nesse caso, o erro pode ser consultado na opção 'Status', acessível ao clicar nos três pontos localizados à direita da tabela.
Card
id
3-3
label
Exclusão Afastamentos
title
Exclusão Afastamentos
Informações
title
Exclusão do Afastamento
Para que a exclusão da situação de afastamento seja carregada na tela de integração com a Ahgora, é necessário eliminar a situação de afastamento do funcionário.
Informações da tela
Na tela inicial, são apresentados filtros básicos para a seleção dos afastamento que serão enviados. Por padrão, o campo '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.
Os filtros de 'Estabelecimento' e 'Data Exclusão De' são obrigatórios.
Para mais filtros, é necessário acessar a opção de. Nesta opção é possível realizar mais alguns filtros específicos além dos filtros já apresentados tela principal.
Após aplicarmos os filtros será apresentada a seguinte tela:
Status:Correspondente ao status do registro
IN - Integrado.
NI - Não Integrado.
CI - Com Inconsistência.
AR - Aguardando Retorno.
Matrícula Ahgora: Código da empresa + estabelecimento + matricula.
Nome: Nome do funcionário.
Tipo do afastamento: Situação e descrição do afastamento.
Dt. Início: Início do afastamento.
Dt. Fim: Fim do afastamento.
Serão listados até 100 registros por página. Ao final da página, será exibido o botão 'Carregar mais resultados'.
Para realizar o envio, selecione o(s) registro(s) desejado(s) e clique em 'Integrar Afastamentos'. .
Ao integrar o registro, se tudo ocorrer corretamente, o status será alterado para 'Aguardando Retorno'. Em seguida, basta selecioná-lo novamente e atualizar o status , para verificar o retorno da integração.
Ao final da atualização, o status do registro será alterado conforme o resultado:
Sem inconsistências:O status será atualizado para 'IN - Integrado', com a mensagem 'Registro integrado com sucesso.'
Com inconsistências:O status será atualizado para 'CI - Com Inconsistências'. Nesse caso, o erro pode ser consultado na opção 'Status', acessível ao clicar nos três pontos localizados à direita da tabela.
Card
id
3-4
label
Agendamento
title
Agendamento do processo
Informações da Tela
Para facilitar o envio e recebimento das informações, criamos o programa FP7820, que sincronizar as informações do funcionário, afastamento e exclusão do afastamento.
Temos na aba de seleção:
Faixa de Estabelecimento: Podemos informar uma faixa De/Até do Estabelecimento.
Faixa de Matricula: Podemos informar uma faixa De/Até da Matricula.
Período para Sincronização (Hoje -) x dias: Programa considera a data de hoje menos 30 dias (ou valor informado em tela);
Inicio do Afastamento, data de hoje - 30 (ou valor informado em tela). Ex.: .
Termino do Afastamento, data de hoje. Ex.: .
Temos na aba de parâmetros:
Tipo da Informação:
Funcionário: sincronização das pendencias encontradas para o funcionário.
Afastamento: sincronização dos afastamentos adicionados para o funcionário.
Exclusão Afastamento: sincronização dos afastamentos eliminados.
Tipo de Requisição:
Envio: permite o envio das informações para Ahgora.
Retorno: permite buscar o status das informações enviadas para Ahgora.
Status:
Não Integrado: informações com status de pendencia. (habilitado somente se o tipo de requisição for igual a Envio).
Com Inconsistência: informações com inconsistência. (habilitado somente se o tipo de requisição for igual a Envio).
Aguardando Retorno:
Status:
Aguardando Retorno: informações com status de aguardando retorno. (habilitado somente se o tipo de requisição for igual a Retorno).
Temos na aba de impressão:
Padrão já utilizada pelo Datasul.
Destaco neste ponto a execução da sincronização em RPW, desta forma é possível fazer o agendamento.
Informações
title
Execução
Para o Afastamento, programa também utiliza a data de sincronização da aba de seleção, onde o filtro em que a data de início do afastamento seja menor ou igual àdata de hoje, e a data de término do afastamento seja maior ou igual àdata de hoje menos 30(ou valor informado em tela).
Card
id
3-5
label
Apuração de Resultados
title
Apuração de Resultados
Informações
Para a apuração dos resultados obtidos no PontoWeb, é necessário realizar a parametrização e a execução dos dados por meio da integração de Resultados do Integrador 2.0 da Ahgora PontoWeb com o RH Datasul, seguindo a documentação correspondente.
Segue parte importante necessária para parametrização, para mais detalhes pode ser consultado no link abaixo.
Tipo de requisição:POST
Endpoint:api/rh/ahgora/v1/results
Autenticação:Basic Authentication
Para autenticação com o RH Datasul, basta ter um usuário com permissões da acesso as informações do funcionário, e utilizar o Basic Authentication usuário e senha.
Sugestão que seja um usuário genérico, para evitar recadastro caso ocorra alteração de permissões de usuário.
Nesse caso, é necessário desmarcar o campo "Considera Carga Turno", na aba Cálculo do programa FP1500, para que sejam consideradas para cálculo apenas as horas contidas no FP2040.
Geração da Carga Turno:
Quando as informações das horas trabalhadas não são retornadas, é necessário gerar a Carga Turno utilizando os programas FP2540 ou FP2640. Se o estabelecimento não utiliza ponto eletrônico, será necessário parametrizar a composição da carga horária (turno mensal ou diário) para os turnos do respectivo estabelecimento.
Após o recebimento dos dados, o RH Datasul armazenará as informações no programa Manutenção Movimento c/ Controle Parcela - FP2040.
Os dados integrados têm a origem registrada como Int. Ahgora.
Após a integração, os dados ficam disponíveis para o cálculo da Folha de Pagamento ou Rescisão.
Informações
title
Importante
Após o cálculo dos valores do funcionário, não será possível reintegrar os dados. Para permitir uma nova integração, é necessário eliminar o cálculo da Folha Normal ou da Rescisão.
Card
id
3-5-2
label
Afastamento
title
Afastamento
Com a apuração dos resultados obtidos no PontoWeb, surgiu a necessidade de criar a situação de afastamento registrada no ponto. Dessa forma, o sistema passa a tratar automaticamente as faltas injustificadas.
Os dados apurados no PontoWeb são enviados nos resultados, onde o programa identifica as faltas injustificadas por meio da datafalta. Com isso, ele faz uma leitura no banco de dados para identificar a primeira situação de afastamento classificada como 'falta injustificada' no FP0060. Em seguida, verifica se o evento enviado está relacionado a essa situação de afastamento nos campos 'Afastamento Diurno' ou 'Afastamento Noturno', tanto para mensalistas quanto para horistas.
Se essa condição for atendida, o programa cria automaticamente a situação de afastamento no FP1600.
Tela com os dados parametrizados para recebimentos da situação de afastamento.
Após o recebimento dos dados, a situação de afastamento foi criada no FP1600.
Na tela acima temos a seguinte regra:
Coluna Origem Situação, contem a informação de que o registro foi integrado com o status "Int. Ahgora".
Botão modificar fica desabilitando não permitindo a modificação.
Informações
Na integração dos resultados, o programa elimina todas as informações integradas no período. Da mesma forma que ocorre com o movimento parcelado no FP2040, o programa também remove as situações de afastamento com o status 'Int. Ahgora' no FP1600.
O botão 'Eliminar' fica habilitado conforme as regras da folha, permitindo que o usuário execute a eliminação enquanto o cálculo da folha não tiver sido iniciado.
Este vídeo irá demonstrar como realizar o cadastro de códigos de centro de custo no PW (PontoWeb) Ahgora para integração com a Linha Datasul (folha de pagamento).
Este vídeo irá demonstrar como realizar o cadastro de código do sheet no PW (PontoWeb) Ahgora para integração com a Linha Datasul (folha de pagamento).
Este vídeo irá demonstrar como realizar o cadastro de código contábil das horas adicionais no PW (PontoWeb) Ahgora para integração com a Linha Datasul (folha de pagamento).
