Linha Datasul

Árvore de páginas

CONTEÚDO

1. Versões
2. Visão Geral
3. Parametrização e Exemplo de utilização
4. Documentação

01. VERSÕES

A partir dos patches:

    • 12.1.2411.3
    • 12.1.2407.9
    • 12.1.2403.15
    • ou superiores.

02. VISÃO GERAL

Disponibilizamos um processo nativo no produto, com interface PO-UI, que permite a integração entre a Folha de Pagamento RH Datasul e o PontoWeb Ahgora. Esse processo possibilita a integração de três tipos de cadastros:

      • Funcionários: Todos os funcionários serão integrados com base no filtro de seleção, incluindo eventuais alterações nos dados cadastrais.
      • Afastamentos: Informações sobre afastamentos e férias serão integradas ao sistema PontoWeb Ahgora, conforme os critérios de seleção definidos.
      • Resultados: Toda a movimentação registrada no PontoWeb Ahgora, como horas extras e faltas, será integrada ao sistema de Folha de Pagamento RH Datasul.

03. PARAMETRIZAÇÃO E EXEMPLO DE UTILIZAÇÃO


    • No programa FP0540 - Manutenção Descentralizada HCM
      1. Na aba Ahgora marque a opção "Integra Ahgora PontoWeb" e cadastre os dados para a integração.
        1. Tipo de Ambiente:
          1. Produção ou Homologação
            1. 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.
              1. Obs.: Essa opção permite parametrizar cadastros, como o do FP1500, com 'Utiliza Ponto Ahgora' e a data de elegibilidade preenchidos.
        2. Configurações conexão Ahgora:
          1. Usuário 
          2. Senha
          3. 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
      1. Na aba Cadastral, na inclusão ou alteração dos dados do funcionário, pode ser manutenido os dados para integração.
        1. 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.


    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".


    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.


      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.

        • 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.


      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.

      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: Inicio 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.

      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: Inicio 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.



      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
        • 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.

      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.

      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


      04.  DOCUMENTAÇÃO

      Tarefas Integração dos Resultados - Ahgora PontoWeb X RH Datasul

      DRHROTDTS-14126 DT Integração Ahgora