| Card |
|---|
| default | true |
|---|
| id | 1 |
|---|
| label | Parametrização |
|---|
| title | Parametrização |
|---|
| - 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.
- No endereço do servidor, informa a base da URL ex: "https://api.ahgora.com.br".
- 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.
|
| 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: - Eventos (Código Contábil Ahgora) - FP0020 - Manutenção Eventos - Analíticos
- A informação deve ser concatenada com o código da empresa. Além disso, é necessário incluir a descrição do evento.
- Para empresas que não utilizam eventos por empresa, a concatenação deve ser feita com o código da empresa do funcionário, em vez de usar um asterisco.
- Exemplo: Empresa 10, evento 103 = "10103 - Horas Extras Noturnas (50%)".
-
- 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.
- Exemplo: "103 - Produção - 07:30 as 17:30".
-
- 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.
- Exemplo: "18 - SINDICATO DOS TECNOLOGOS".
-
- Centro de Custo - FP0660 - Manutenção Centros de Custo
- O código de centro de custo precisa ser concatenada com o código da empresa do funcionário. Além disso, é necessário incluir a descrição do centro de custo.
- Exemplo: Empresa 10, Centro de Custo 0040100 = "10004100 - Administração".
-
- 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.
- Exemplo: "29 - Afastado por Doença Horas".
|
| 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 |
|---|
| | 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 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.
- 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.
 
 
|
| 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.
|
| 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.
|
| Card |
|---|
| id | 3-4 |
|---|
| label | Agendamento do processo |
|---|
| title | Agendamento do processo |
|---|
|
|
| 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/v1/ahgora/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.
- Tarefas Integração dos Resultados - Ahgora PontoWeb X RH Datasul
|
| Informações |
|---|
| title | Parametrizações CalculoCálculo |
|---|
| - 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.
- Quando as horas trabalhadas são retornadas:
- Nesse caso, é necessário desmarcar o campo "Considera Carga Turno" na aba Cálculo do programa FP1500.
|
- 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.
 
| Informações |
|---|
| 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 | 4 |
|---|
| label | De/Para |
|---|
| title | De/Para |
|---|
| | Card |
|---|
| id | 1 |
|---|
| label | De/Para |
|---|
| title | De/Para |
|---|
| 1 - FUNCIONÁRIOS | Descrição | Campo Tabela RH Datasul | Descrição / Regra | | Identificação do colaborador | funcionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionario | Matricula do Funcionário
Enviar concatenado Empresa + Estabelecimento + Matricula | | Nome do Funcionário | funcionario.nom_pessoa_fisic | Nome do Funcionário | | PIS do Funcionário | funcionario.cod_pis | Numero do PIS do Funcionário | | Matrícula do E-Social | sped_participan.cod_matr_sped | Matricula do eSocial | | Data em que o Funcionário foi Admitido | funcionario.dat_admis_func | Data de Admissão | | Data de Demissão | funcionario.dat_desligto_func | Data de Demissão | | Código da escala/ turno do funcionário | funcionario.cdn_turno_trab | Turno do Funcionário | | Data da alteração de escala/turno | func_turno_trab.dat_inic_lotac_func_turno_trab | Data do ultimo histórico de turno | | Tipo de Escala de Trabalho | turno_trab.idi_period_turno_trab | Enviar sempre as horas padrão mensal do FP1400 | | Carteira de Trabalho | funcionario.cod_cart_trab -
funcionario.cod_ser_cart_trab -
funcionario.cod_unid_federac_cart_trab | Carteira de Trabalho do Funcionário | | Título do Cargo | funcionario.cdn_cargo_basic +
cargo.des_cargo | Código do Cargo + descrição | | Descrição do departamento do Funcionário | funcionario.cod_unid_lotac | Código da Lotação + descrição | | Gênero do Funcionário | rh_pessoa_fisic.idi_sexo | Sexo | | E-mail do Funcionário | rh_pessoa_fisic.nom_e_mail rh_pessoa_fisic.nom_mail_contat | E-mail e E-mail contato. Prioriza o informado e se ambos, considera o e-mail | | CPF do Funcionário | rh_pessoa_fisic.cod_id_feder | CPF, sem caracteres | | RG do Funcionário | rh_pessoa_fisic.cod_id_estad_fisic | Carteira Identidade | | CNPJ da filial do Funcionário | rh_pessoa_jurid.cod_id_feder | CNPJ da Pessoa Juridica do estabelecimento sem caracteres | | Data da atribuição do CNPJ da empresa ao funcionário | funcionario.dat_admis_transf_func | Data da transferência entre estabelecimentos | | Código do centro de custo do funcionário | funcionario.cdn_empresa
funcionario.cod_rh_ccusto | Centro Custo concatenado com Empresa + Código Centro de Custo | | Regime de Trabalho do Funcionário | funcionario.idi_tip_func | DE/PARA dos tipos conforme regra da Ahgora, dados preenchidos pela descrisão | | Data de Nascimento do Funcionário | rh_pessoa_fisic.dat_nascimento | Data Nascimento | | Data de Alteração de Cargo | histor_sal_func.dat_liber_sal | Data da transferência entre cargos. Sempre considerado o ultimo | | Definição de carga horária | turno_trab.qtd_hrs_padr_mes_rh | Quantidade de horas mês | | Ponto Obrigatório | func_aux_func.idi_elig_ponto | Disponível somente quando habilita o produto do ponto | | Data de troca da elegibilidade do registro de ponto | func_aux_func.dat_troca_elig_ponto | Enviar a data quando passou a utilizar ponto, ou quando deixou de utilizar ponto. | | Matrícula Chefia Imediata |
| Enviar a matricula do lider imediato da tabela de permissões | | Nome Chefia Imediata |
| Nome do lider imediato | | e-mail Chefia Imediata |
| e-mail lider imediato | | Código do Sindicato | funcionario.cdn_sindicato | Código do Sindicato | | Data da alteração do código do sindicato |
| Data da inclusão. Sempre considerado o ultimo | | Telefone | rh_pessoa_fisic.num_telefone rh_pessoa_fisic.num_telef_contat | Telefone do funcionário | | PIS |
| Preencher com true quando não tiver o PIS cadastrado e false quando tiver PIS cadastrado. | | codInterno | funcionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionario | Matricula do Funcionario
Enviar concatenado com separador pipe "|"
Enviar concatenado Empresa + Estabelecimento + Matricula | | Matricula Anterior |
| Preencher com a matricula do funcionário tranaferido. | | Define o custo hora do funcionário, utilizado para cálculos financeiros. | histor_sal_func.val_salario_hora | Salário hora | | Valor do salário do colaborador | funcionario.val_salario_atual | Caso o colaborar for mensalista, enviar o salário mensal
Caso o colaborar for horista, enviar o salário da hora |
2 - AFASTAMENTOS | Descrição | Campo Tabela RH Datasul | Descrição / Regra | | Identificação do colaborador | funcionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionario +
numero sequencial | Matricula do Funcionario
Enviar concatenado Empresa + Estabelecimento + Matrícula | | Motivo do Afastamento | sit_afast.cdn_sit_afast_func | Situação de Afastamento | | Data e/ou hora Inicial do Afastamento | sit_afast_func.dat_inic_sit_afast
sit_afast_func.num_horar_inic_sit_afast | Data inicio do afastamento
Hora inicio: (00:00)
Hora Final: (24:00) | | Data e/ou hora Final do Afastamento | sit_afast_func.dat_term_sit_afast
sit_afast_func.num_horar_term_sit_afast | Data fim do afastamento
Sem data fim, enviar vazio) | | Código interno do Afastamento | funcionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionario +
numero sequencial | Sequência Afastamento
Informar chave unica para identificar. Concatenar informações(empresa, estabelecimento, matricula e Sequencia). | | Ação a ser realizada | Inclusão ou alteração é 'INS' |
|
3 - EXCLUSÃO DE AFASTAMENTOS | Descrição | Campo Tabela RH Datasul | Descrição / Regra | | Identificação do colaborador | funcionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionario +
numero sequencial | Matricula do Funcionario
Enviar concatenado Empresa + Estabelecimento + Matrícula | | Motivo do Afastamento | sit_afast.cdn_sit_afast_func | Situação de Afastamento | | Data e/ou hora Inicial do Afastamento | sit_afast_func.dat_inic_sit_afast
sit_afast_func.num_horar_inic_sit_afast | Data inicio do afastamento
Hora inicio: (00:00)
Hora Final: (24:00) | | Data e/ou hora Final do Afastamento | sit_afast_func.dat_term_sit_afast
sit_afast_func.num_horar_term_sit_afast | Data fim do afastamento
Sem data fim, enviar vazio) | | Código interno do Afastamento | funcionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionario +
numero sequencial | Sequência Afastamento
Informar chave unica para identificar. Concatenar informações(empresa, estabelecimento, matricula e Sequencia). | | Ação a ser realizada |
| Obrigatório o envio do DEL quando for exclusão de informação |
|
|
|
