Linha Datasul

Árvore de páginas

Versões comparadas

Versão antiga 1

changes.mady.by.user Julliano Machado Moreira

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Bruno Henrique de Almeida Simiao

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice

 CONTEÚDO

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

01. VERSÕES

Informações
iconfalse

A partir dos patches:

    • 12.1.25032511.15
    • 12.1.24112507.611
    • 12.1.24072503.1217
    • ou superiores.

02. VISÃO GERAL

Disponibilizamos um processo nativo no produto, com interface PO-UI, que permite a integração entre o Atração de Talentos (ATS) e 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

o reaproveitamento dos dados informados pelo candidato para a criação do registro de funcionário na 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".
        • Caso possua restrição em seu firewall, verifique se o endereço acima possuem liberação para conexão externa.

Image Removed

Deck of Cards
id1
Card
id5
labelConfiguração Integração Datasul X ATS
titleDocumentação Relacionada

VISÃO GERAL

SMARTLINK CLIENT DATASUL 

  O SmartLink Client é o componente responsável por realizar a comunicação entre o SmartLink Server e o ERP Datasul. Instalado na infraestrutura do próprio cliente (on-premise), ele atua como ponte para envio e recebimento de mensagens entre os sistemas.

      Para que a integração com o SmartLink ocorra corretamente no ambiente Datasul, é necessário configurar as credenciais de acesso à TOTVS Apps:

Informações
titleSiga os passos abaixo:

  1. Acesse o programa "Propriedades Integrações TOTVS" no Datasul.

  2. Na aba "SmartLink", cadastre um usuário do produto Datasul no campo “Usuário”.

    • O usuário deve possuir perfil de administrador ou ser o usuário padrão utilizado no recebimento e processamento de mensagens via SmartLink, além de ter acesso a todas as empresas que participarão da integração.

  3. Localize a área de configuração TOTVS Apps.

  4. Habilite a integração com a plataforma.

  5. Preencha obrigatoriamente os seguintes campos:

    • ClientId do RAC

    • Secret do RAC

Essas credenciais são fornecidas via TOTVS Apps e são essenciais para autenticar a comunicação entre o SmartLink Client e o Datasul.


GERENCIADOR DE MENSAGENS SMARTLINK CLIENT 

     

Aviso
titleRecomendação

Recomendamos que este programa deve ser acessado apenas por usuários administradores do produto Datasul, garantindo segurança e manutenção da integração.

       Verifique se os seguintes tipos de mensagens foram criados corretamente no cadastro de Tipos de Mensagens do SmartLink Client:

      Image Added

 

Informações
titleImportante

  • Esses registros são criados internamente pela TOTVS.

  • A criação ocorre automaticamente por meio da console de atualização do produto Datasul.

 Para maiores detalhes sobre o gerenciador de mensagens acessar o link abaixo: 

Gerenciador de Mensagens do Smart Link

INSTALAÇÃO SMARTLINK CLIENT

       A instalação do Smart Link Client deve ser realizada conforme as instruções disponíveis no link abaixo:

       Instalação Smart Link Client

 Para maiores detalhes sobre a integração Datasul x Smartlink Client, acessar o link abaixo:       

 Integração Datasul x Smarlink Client.

CONFIGURAÇÕES ERP DATASUL

Necessario Realizar a configuração do usuário e do TOTVS APPS

Image Added

PropriedadeDescrição
TOTVS Apps
Habilitar IntegraçãoHabilita a integração com o TOTVS Apps
Tipo de ambienteTipo de ambiente utilizado para a integração
ClientId do RAC:Client oAuth para a autenticação no RAC (necessário que seja um client oAuth e tenha permissão Resource Owner)
Secret do RACSenha do client oAuth
TenantId do RACTenant Id referente as credenciais do RAC (apenas leitura, não é necessário cadastrar).

MONITOR SMARTLINK SERVER

      O correto funcionamento do SmartLink via Behavior Sharing depende de um monitoramento eficiente das mensagens que trafegam entre os serviços. Para isso, está disponível o Monitor do Smart Link, ferramenta essencial para acompanhar o comportamento das filas dos Clients. Através dele, é possível verificar:

  • A quantidade de mensagens atualmente na fila, aguardando leitura pelo Client;

  • Qual mensagem está há mais tempo pendente na fila;

  • Os tipos de mensagens que estão sendo processadas ou aguardando processamento.


Informações
titleImportante

O Monitor exibe apenas as mensagens originadas nos TOTVS Apps, que têm como destino o SmartLink Client.

Image Added

Para maiores informações sobre uso e acesso ao monitor, consulte o link abaixo:

Monitor SmartLink

Card
id1
labelDocumentação


Card
defaulttrue
id1
labelParametrização
titleParametrização




Informações
titleImportante







Card
id2
labelFP1440
titleIntegração

É possível realizar a integração de um candidato na Pessoa Física na Folha de Pagamento RH Datasul através do programa FP1440 - Manutenção Pessoa Física.

    • Foi criado o campo Candidato no programa FP1440 que permite selecionar candidatos vindos do ATS:

Image Added

    • O campo Cadastro tem um zoom que permite filtrar e selecionar o candidato:
      • Aba Candidato:

Image Added

        • Na aba Candidato é possível realizar o filtro pelo ID do registro, Nome do Candidato e o Status do registro:
        • No browse são exibidos os campos 
          • ID do Registro
          • Nome do Candidato
          • CPF do candidato
          • Código do registro do candidato do ATS
          • Código da Vaga
          • Email do candidato
          • Status do registro do candidato, se está cadastrado ou com o cadastro com alguma pendência.


      • Aba Vaga:

Image Added

        • Na aba Vaga é possível realizar o filtro pelo ID do registro, Código do Registro do Candidato do ATS, Código da Vaga e da Data de Contratação:
        • No browse são exibidos os campos
          • ID do Registro
          • Código do registro do candidato do ATS
          • Código da Vaga
          • Nome do Candidato
          • Data de Contratação
          • CPF do candidato
          • Email do candidato
          • Status do registro do candidato, se está cadastrado ou com o cadastro com alguma pendência.


      • Aba CPF:

Image Added


        • Na aba CPF é possível realizar o filtro pelo ID do registro, CPF do candidato, Email do Candidato e a Data de Contratação:
        • No browse são exibidos os campos:
          • ID do Registro
          • Nome do Candidato
          • CPF do candidato
          • Data de Contratação
          • Código do registro do candidato do ATS
          • Código da Vaga
          • Email do candidato
          • Status do registro do candidato, se está cadastrado ou com o cadastro com alguma pendência.



      • É possível visualizar e exportar o JSON da integração do Candidato do ATS através do botão Ver Json

Image Added

Image Added


Informações
titleImportante


Exporta Json

Ao realizar a exportação do Json, é gerado um arquivo Json no diretório 'C:\Temp' com o código do candidato do ATS.

Card
id3
labelDe/Para
titleDe/Para
Card
id1
labelDe/Para
titleDe/Para


Card
id4
labelDocumentação Relacionada
titleDocumentação Relacionada
Card
id1
labelDocumentação


Card
id5
labelVídeos
titleVídeos How To
Deck of Cards
id1
Card
defaulttrue
id1
labelParametrização
titleParametrização
Informações
titleImportante

A integração com a Ahgora através do programa FP0540 é configurada no nível do banco de dados. Se a sua base de dados no Datasul contiver várias empresas, a parametrização fará com que todas se conectem a um único ambiente Ahgora. Caso prefira implementar a integração em etapas, é possível utilizar os filtros disponíveis nas telas para processar apenas as empresas necessárias, garantindo uma transição gradual e controlada.

  • Utiliza Ponto Ahgora
    1. 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. 
      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.

Image Removed

    • 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

    • Informações Programa de CargaImage Removed

      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.

  • Situação de Falta Injustificada no FP0060 - Manutenção Situações
    • Quando os resultados da Ahgora são enviados ao Datasul, caso o funcionário tenha Falta Injustificada apurada no sistema da Ahgora, essas são criadas automaticamente no  programa Manutenção Histórico de Situações - FP1600, com a Origem Situação igual a "Int. Ahgora".
      • Essas faltas injustificadas criadas no FP1600 tem a seguinte regra:
        • Será considerada a primeira situação, seguindo a ordem crescente dos código de situações do Manutenção Situações - FP0060 - Folha de Pagamento, cujo o significado seja igual a Falta Injustificada, e o evento utilizado para apurar as horas de falta no FP2040 com a Origem igual a "Int. Ahgora" esteja informado nos campos Afast Diurno ou Afast Noturno do FP0060, aba  Ponto.
  • Eventos de Conversão Carga Turno - FP0080 - Atenção para o uso desta rotina.

    • Ao utilizar a rotina Manutenção Eventos Conversão Carga Turno - FP0080 para apuração das horas de falta consideradas na Folha de Pagamento, é importante observar que a integração da Ahgora já envia os resultados diretamente para a rotina Manutenção Movimento c/ Controle Parcela - FP2040.

    • Nessa situação, caso a situação de Falta Injustificada considerada pelo sistema com Origem Situação igual a "Int. Ahgora" no FP1600 esteja informada no FP0080, o sistema poderá duplicar as horas de falta, pois somará:

      • As horas apuradas pela integração da Ahgora (FP2040);
      • As horas calculadas pela parametrização do FP0080.
    • Neste caso, para evitar a duplicidade de horas de falta no cálculo da Folha de Pagamento, é necessário realizar um dos procedimentos abaixo:
      1. Caso todas as empresas da base Datasul estejam integradas com a Ahgora, recomendamos excluir os registros do FP0080, garantindo que o sistema considere apenas as horas apuradas pela integração da Ahgora.
      2. Caso contrário, os registros do FP0080 não devem ser excluídos, para que não haja impacto na Folha de Pagamento das empresas que não integram com a Ahgora. Já os eventos de falta injustificada enviados pela Ahgora e informados no FP2040 devem estar parametrizados nos campos Afast Diurno ou Afast Noturno do FP0060, aba  Ponto, para uma situação com significado Falta Injustificada diferente da utiliza pelas empresas que não integram com a Ahgora, e a situação de falta em questão não deve estar cadastrada no FP0080.
        1. Exemplo: 
          1. Consideramos que há a situação com significado Falta Injustificada com códigos 50 e 56 no FP0060.
          2. E também consideramos que o evento parametrizado no Ahgora, que é enviado como falta no FP2040 é o evento 106.
          3. Para a empresa que não está no Ahgora, caso utilize a conversão no FP0080, poderá direcionar a situação 50 para o evento 106. Assim o cálculo da folha de pagamento irá considerar as situações falta (código 50) lançadas no FP1600 para os funcionários, e irá apurar o valor do evento 106 na folha.
          4. Para a empresa que está no Ahgora, o evento 106 deve ser informado nos campos Afast. Diurno e/ou Afast. Noturno do FP0060 na situação 56 ( o evento 106 não deve estar informado para a situação 50), e s situação 56 não deve estar cadastrada no FP0080. Assim, as situações de falta da Ahgora integrados no FP2040, no evento 106, irão gerar automaticamente a situação 56 no FP1600 dos funcionário, fazendo com que a horas não sejam duplicadas devido a conversão carga turno.
Card
id2
labelParametrização Ahgora
titleParametrizaçã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:

  •  
    • 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
  •  
    • 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
id3
labelIntegração
titleIntegraçã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.

Image Removed

Image Removed

Deck of Cards
idIntegração
Card
defaulttrue
id3-1
labelFuncionários
titleFuncionários
Informações
titleAtualizaçã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
      • Nome Social

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.

Image Removed

    • Para mais filtros, é necessário acessar a opção de Image Removed. Nesta opção é possível realizar mais alguns filtros específicos além dos filtros já apresentados na tela principal.

Image Removed

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

Image Removed

    • Serão listados até 100 registros por página. Ao final da página, será exibido o botão 'Carregar mais resultados' Image Removed.
    • Para realizar o envio, selecione o(s) registro(s) desejado(s) e clique em 'Integrar Funcionários'. Image Removed.

Image Removed

Image Removed

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

Image RemovedImage Removed

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

Image RemovedImage Removed

    • Também está disponível a opção de consulta do lote enviado para o Ponto Web.
      • O botão Consulta Lote está localizado à direita da tabela, no menu de três pontos. Ao clicar nele, é possível visualizar todos os dados enviados para o Ponto Web, incluindo data, hora e informações cadastrais.

   Exibindo image.pngImage Removed

   Image Removed

Informações
titleEnvio Nome Social

Para envio do Nome Social, informado no FP1440.

    • Caso o nome social esteja preenchido no FP1440(Botão eSocial), ele será enviado no campo "nome" e o campo "checkbox_nome_social" será enviado como true, o nome cadastrado da pessoa física será enviado no campo "nome_registro".
    • Caso o nome social não esteja preenchido o nome social não sera enviado e o campo "checkbox_nome_social" será enviado como false, o nome cadastrado da pessoa física será enviado no campo "nome".
Card
id3-2
labelAfastamentos
titleAfastamentos
Informações
titleInclusã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. 

Image Removed

    • Para mais filtros, é necessário acessar a opção de Image Removed. Nesta opção é possível realizar mais alguns filtros específicos além dos filtros já apresentados tela principal.

Image Removed

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

Image Removed

    • Serão listados até 100 registros por página. Ao final da página, será exibido o botão 'Carregar mais resultados' Image Removed.
    • Para realizar o envio, selecione o(s) registro(s) desejado(s) e clique em 'Integrar Afastamentos'. Image Removed.

Image Removed

Image Removed

    • 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 Image Removed, para verificar o retorno da integração.

Image Removed

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

Image Removed

Image Removed

    • Também está disponível a opção de consulta do lote enviado para o Ponto Web.
      • O botão Consulta Lote está localizado à direita da tabela, no menu de três pontos. Ao clicar nele, é possível visualizar todos os dados enviados para o Ponto Web, incluindo data, hora e informações cadastrais.

Image Removed

Image Removed

Card
id3-3
labelExclusão Afastamentos
titleExclusão Afastamentos
Informações
titleExclusã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. 

Image Removed

    • Para mais filtros, é necessário acessar a opção de Image Removed. Nesta opção é possível realizar mais alguns filtros específicos além dos filtros já apresentados tela principal.

Image Removed

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

Image Removed

    • Serão listados até 100 registros por página. Ao final da página, será exibido o botão 'Carregar mais resultados' Image Removed.
    • Para realizar o envio, selecione o(s) registro(s) desejado(s) e clique em 'Integrar Afastamentos'. Image Removed.

Image Removed

Image Removed

    • 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 Image Removed, para verificar o retorno da integração.

Image Removed

    • 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.
    • Também está disponível a opção de consulta do lote enviado para o Ponto Web.
      • O botão Consulta Lote está localizado à direita da tabela, no menu de três pontos. Ao clicar nele, é possível visualizar todos os dados enviados para o Ponto Web, incluindo data, hora e informações cadastrais.

Image Removed

Image Removed

Card
id3-4
labelAgendamento
titleAgendamento 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.: .

Image Removed

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:

Image Removed

  • Status:
    • Aguardando Retorno: informações com status de aguardando retorno. (habilitado somente se o tipo de requisição for igual a Retorno).

Image Removed

Temos na aba de impressão:

    • Padrão já utilizada pelo Datasul.

Image Removed

Destaco neste ponto a execução da sincronização em RPW, desta forma é possível fazer o agendamento.

Image Removed

Informações
titleExecuçã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
id3-5
labelApuração de Resultados
titleApuraçã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.
      • Tarefas de Integração - Ahgora PontoWeb X RH Datasul
    • Será utilizado método POST para entrega de dados.
    • Ao criar a URL, caso tenha restrição de IPs, liberar para a lista abaixo, para entrega da apuração pelo PontoWeb:
Deck of Cards
idApuração de Resultados
Card
defaulttrue
id3-5-1
labelCálculo
titleCálculo
Informações
titleParametrizações Cálculo
  • Quando as horas trabalhadas são retornadas:
    • 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.

Image Removed

  • Os dados integrados têm a origem registrada como Int. Ahgora.

Image Removed

  • Após a integração, os dados ficam disponíveis para o cálculo da Folha de Pagamento ou Rescisão.

Image RemovedImage Removed

Informações
titleImportante

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
id3-5-2
labelAfastamento
titleAfastamento

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.

Image Removed

  • Após o recebimento dos dados, a situação de afastamento foi criada no FP1600.

Image Removed

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

Card
id3-6
labelLocalizações
titleLocalizações
Informações
iconfalse

O menu Localizações está disponível a partir dos patches abaixo:

    • 12.1.2507.3
    • 12.1.2503.9
    • 12.1.2411.14
    • ou superiores.

Cadastro e Envio de Localizações

Foi implementada a funcionalidade de cadastro de Localizações no app de integração entre o Datasul Folha e o PontoWeb da Ahgora. Esse recurso permite definir previamente a localização que será vinculada ao funcionário durante o envio dos dados para a Ahgora.
Essa melhoria facilita a organização dos dados no PontoWeb e contribui para uma integração mais completa e estruturada.

Na tela inicial, são apresentados os botão Incluir e Excluir. 

    • Inicialmente vamos clicar no botão incluir e cadastras as localizações.

Image Removed

    • Na tela abaixo, estão disponíveis todos os campos necessários para o cadastro da localização.
      • Campos do cadastro do funcionário;
        • Foram considerados 44 campos do cadastro do funcionário para a montagem da localização. Para facilitar a visualização, o item abaixo pode ser expandido.
Expandir
titleCampos Cadastro

Código Empresa (FP1500)
Descrição Empresa (FP0500)
Código Estabelecimento (FP1500)
Descrição Estabelecimento (FP0500)
Código Matrícula (FP1500)
Nome Funcionário (FP1500)
Código Categoria Salarial (FP1500)
Descrição Categoria Salarial (FP1500)
Código Categoria eSocial (FP1500)
Código Tipo do Funcionário (FP1500)
Descrição do Tipo de Funcionário (FP1500)
Código Unidade de Lotação (FP1500)
Descrição Unidade de Lotação (FP0780)
Código Centro de Custo (FP1500)
Descrição Centro de Custo (FP0660)
Código Sindicato (FP1500)
Descrição Sindicato (FP0600)
Código Tipo Mao de Obra (FP1500)
Descrição Tipo Mão de Obra (FP0960)
Código Turno (FP1500)
Descrição Turno (FP1400)
Código Turma de Trabalho (FP1500)
Descrição Turma de Trabalhado (FP1400)
Código Unidade de Negócio (FP1500)
Descrição Unidade de Negócio (FP1460)
Código Local Entrega (FP1500)
Descrição local Entrega (FP1090)
Código País (FP1500)
Descrição Pais (FP0100)
Código Localidade (FP1500)
Descrição Localidade (FP1930)
Código Cargo (FP1500)
Descrição do Cargo (FP0720)
Cód. Nível Hierárquico (FP1500)
Descrição do Nível Hierárquico
Cód. FPAS (FP1500)
Percentual SAT (FP1500)
Código Tomador de Serviço (FP1210)
Descrição Tomador de Serviço (FP0870)
Código Agente Nocivo (FP1210)
Código Empresa Líder Imediato (FP9100)
Código Estabelecimento Líder Imediato (FP9100)
Código Matrícula Líder Imediato (FP9100)
Código do Usuário Líder Imediato (FP9100)
Nome Líder Imediato (FP1500)

      • Localização Livre;
        • Permite utilizar um valor livre como localização. O conteúdo informado no campo será considerado como a localização do funcionário.
      • Usar a localização para todos os estabelecimentos;
        • Quando esta opção for marcada, a localização informada acima será aplicada a todos os estabelecimentos da empresa.
        • Na tela principal, será exibido Todos no lugar do código do estabelecimento, e será destacado que a localização está definida para todas os estabelecimentos por meio do campo Usado em todas as filiais.
      • Estabelecimento;
        • Caso a opção Usar a localização para todos os estabelecimentos não esteja marcada, será possível selecionar um ou uns estabelecimento(s) específico(s) para aplicar a localização criada.
      • Criar registro de alteração do funcionário;
        • Se esta opção estiver definida como Sim, ao incluir a localização, o sistema verificará na tabela de integração se existem funcionários vinculados ao estabelecimento informado e que já tenham sido integrados. Se houver, será criado automaticamente um registro de alteração, permitindo o reenvio do funcionário com a nova localização.
          • A criação da pendência de envio será realizada para os campos de código e nome do funcionário. Os campos de descrição não estão disponíveis para geração de pendência de envio ao Ponto Web da Ahgora.
        • Caso esteja como Não, a localização será criada normalmente, mas não haverá criação de registros de alteração para funcionários já integrados.

Image Removed

      • Abaixo temos os dados criados:
        • Lista com os campos.

Image Removed

Image Removed

        • Localização Livre informada.

Image Removed

        • Utiliza para todos os estabelecimentos.

Image Removed

        • Não utiliza todos os estabelecimento, com o campo habilitado para inclusão.

Image Removed

Image Removed

Image Removed

        • Atualiza a localização para os funcionário já integrados.

Image Removed

        • Tela principal com os dados criados.

Image Removed

    • Para excluir uma localização, selecione o registro desejado e clique no botão Excluir. O sistema exibirá mensagens de confirmação antes de realizar a exclusão, garantindo que a ação seja intencional.

Image Removed

Image Removed

Image Removed

Image Removed

Card
id4
labelDe/Para
titleDe/Para
Card
id1
labelDe/Para
titleDe/Para

1 - FUNCIONÁRIOS

DescriçãoCampo Tabela RH DatasulDescrição / RegraIdentificação do colaboradorfuncionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionarioMatricula do Funcionário
Enviar concatenado Empresa + Estabelecimento + MatriculaNome do Funcionáriofuncionario.nom_pessoa_fisicNome do FuncionárioPIS do Funcionáriofuncionario.cod_pisNumero do PIS do FuncionárioMatrícula do E-Socialsped_participan.cod_matr_spedMatricula do eSocialData em que o Funcionário foi Admitidofuncionario.dat_admis_funcData de AdmissãoData de Demissãofuncionario.dat_desligto_funcData de DemissãoCódigo da escala/ turno do funcionáriofuncionario.cdn_turno_trabTurno do FuncionárioData da alteração de escala/turnofunc_turno_trab.dat_inic_lotac_func_turno_trabData do ultimo histórico de turnoTipo de Escala de Trabalhoturno_trab.idi_period_turno_trabEnviar sempre as horas padrão mensal do FP1400Carteira de Trabalhofuncionario.cod_cart_trab -
funcionario.cod_ser_cart_trab -
funcionario.cod_unid_federac_cart_trabCarteira de Trabalho do FuncionárioTítulo do Cargofuncionario.cdn_cargo_basic +
cargo.des_cargoCódigo do Cargo + descriçãoDescrição do departamento do Funcionáriofuncionario.cod_unid_lotacCódigo da Lotação + descriçãoGênero do Funcionáriorh_pessoa_fisic.idi_sexoSexoE-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áriorh_pessoa_fisic.cod_id_federCPF, sem caracteresRG do Funcionáriorh_pessoa_fisic.cod_id_estad_fisicCarteira IdentidadeCNPJ da filial do Funcionáriorh_pessoa_jurid.cod_id_federCNPJ da Pessoa Juridica do estabelecimento sem caracteresData da atribuição do CNPJ da empresa ao funcionáriofuncionario.dat_admis_transf_funcData da transferência entre estabelecimentosCódigo do centro de custo do funcionáriofuncionario.cdn_empresa
funcionario.cod_rh_ccustoCentro Custo concatenado com Empresa + Código Centro de CustoRegime de Trabalho do Funcionáriofuncionario.idi_tip_funcDE/PARA dos tipos conforme regra da Ahgora, dados preenchidos pela descrisãoData de Nascimento do Funcionáriorh_pessoa_fisic.dat_nascimentoData NascimentoData de Alteração de Cargohistor_sal_func.dat_liber_salData da transferência entre cargos. Sempre considerado o últimoDefinição de carga horáriaturno_trab.qtd_hrs_padr_mes_rhQuantidade de horas mêsPonto Obrigatóriofunc_aux_func.idi_elig_pontoDisponível somente quando habilita o produto do pontoData de troca da elegibilidade do registro de pontofunc_aux_func.dat_troca_elig_pontoEnviar a data quando passou a utilizar ponto, ou quando deixou de utilizar ponto.Matrícula Chefia ImediataEnviar a matricula do líder imediato da tabela de permissõesNome Chefia ImediataNome do líder imediatoe-mail Chefia Imediatae-mail líder imediatoCódigo do Sindicatofuncionario.cdn_sindicatoCódigo do SindicatoData da alteração do código do sindicatoData da inclusão. Sempre considerado o últimoTelefonerh_pessoa_fisic.num_telefone rh_pessoa_fisic.num_telef_contatTelefone do funcionárioPISPreencher com true quando não tiver o PIS cadastrado e false quando tiver PIS cadastrado.codInternofuncionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionarioMatricula do Funcionário
Enviar concatenado com separador pipe "|"
Enviar concatenado Empresa + Estabelecimento + MatriculaMatricula AnteriorPreencher com a matricula do funcionário transferido.Define o custo hora do funcionário, utilizado para cálculos financeiros.histor_sal_func.val_salario_horaSalário horaValor do salário do colaboradorfuncionario.val_salario_atualCaso o colaborar for mensalista, enviar o salário mensal
Caso o colaborar for horista, enviar o salário da hora

2 - AFASTAMENTOS

DescriçãoCampo Tabela RH DatasulDescrição / RegraIdentificação do colaboradorfuncionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionario +
numero sequencialMatricula do Funcionário
Enviar concatenado Empresa + Estabelecimento + MatrículaMotivo do Afastamentosit_afast.cdn_sit_afast_funcSituação de AfastamentoData e/ou hora Inicial do Afastamentosit_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 Afastamentosit_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 Afastamentofuncionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionario +
numero sequencialSequência Afastamento
Informar chave única para identificar. Concatenar informações(empresa, estabelecimento, matricula e Sequência).Ação a ser realizadaInclusão ou alteração é 'INS'

3 - EXCLUSÃO DE AFASTAMENTOS

DescriçãoCampo Tabela RH DatasulDescrição / RegraIdentificação do colaboradorfuncionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionario +
numero sequencialMatricula do Funcionário
Enviar concatenado Empresa + Estabelecimento + MatrículaMotivo do Afastamentosit_afast.cdn_sit_afast_funcSituação de AfastamentoData e/ou hora Inicial do Afastamentosit_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 Afastamentosit_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 Afastamentofuncionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionario +
numero sequencialSequência Afastamento
Informar chave única para identificar. Concatenar informações(empresa, estabelecimento, matricula e Sequência).Ação a ser realizadaObrigatório o envio do DEL quando for exclusão de informação
Card
id5
labelDocumentação Relacionada
titleDocumentação Relacionada
Card
id1
labelDocumentação

Card
id6
labelVídeos
titleVídeos How To
Toggle Cloak
idHow To Linha Datasul
How To | Integração Folha Pagamento linha Datasul com Ponto Web Ahgora - PW

Cloak
idHow To Linha Datasul
  • Este vídeo demonstra as parametrizações necessárias na Linha Datasul (Folha de Pagamento) para integração com o PontoWeb (PW) da Ahgora.
  • Este vídeo apresenta o processo de integração de funcionários da Linha Datasul (Folha de Pagamento) com o PontoWeb (PW) da Ahgora.
  • Este vídeo demonstra como integrar afastamentos e sua exclusão na Linha Datasul (Folha de Pagamento) com o PontoWeb (PW) da Ahgora.
  • Este vídeo demonstra como realizar o agendamento na Linha Datasul (Folha de Pagamento) para integração com o PontoWeb (PW) da Ahgora.
  • Este vídeo demonstra como consultar os resultados da integração da Linha Datasul (Folha de Pagamento) com o PontoWeb (PW) da Ahgora.

Toggle Cloak
idHow To Ahgora
How To | Integração Ponto Web Ahgora - PW com Folha Pagamento linha Datasul

Cloak
idHow To Ahgora
  • 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).
Informações
titleImportante

Reenvio de Dados Sem Alterações no Cadastro

Quando for necessário reenviar os dados para a Ahgora, mesmo sem alterações no cadastro do funcionário, é possível realizar a atualização diretamente na tabela de controle:
Tabela/Campo: integr_ahgora_controle.idi_status_registro
Para isso, localize os registros com o valor 1 (Integrado) e altere para 2 (Não Integrado).
Essa modificação permite que o registro seja reenviado sem a necessidade de alteração manual no cadastro do funcionário.
Obs: Utilizar a chave da tabela.