Versões comparadas

Chave

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

...

Informações
iconfalse

A partir dos patches:

02. VISÃO GERAL

Disponibilizamos um processo nativo no produto em interface POUI que permite a integração entre TOTVS Folha de Pagamento RM e o Ponto Web (Ahgora). Através desse processo, é possível integrar três tipos de cadastros:

  • Funcionários: Todos os funcionários serão integrados conforme o filtro de seleção, incluindo alterações nos dados cadastrais. 
  • Afastamentos: Os afastamentos e férias serão integrados ao sistema Ponto Web da Ahgora, conforme o filtro de seleção.
  • Resultados: Toda a movimentação existente na Ponto Web  Ahgora, como horas extras e faltas, será integrada ao sistema de Folha de Pagamento RM.
  • Eventos/Verbas: Todas as verbas existentes no menu Administração de Pessoal | Eventos existentes na coligada.
  • Sindicatos: Todos os cadastros existentes no menu Administração de Pessoal | Sindicatos existentes na coligada.

...

Nessa nova tela, será exibido o menu para integração dos Afastamentos

Na tela inicial são apresentados filtros básicos para a seleção dos afastamentos que serão enviados. Como sugestão, a 'Data Afastamento De' vem preenchida com um mês anterior que a data atual e a 'Data Afastamento Até' com a data atual. Filtros de 'Filial' e 'Data Afastamento De' são obrigatórios. 

Image Removed

Para mais filtros, é necessário acessar a opção de 'Filtros Avançados'Image Removed. Na opção de 'Filtros Avançados', é possível realizar mais alguns filtros específicos além dos filtros já apresentados na primeira tela.

Image Removed

Selecionando os filtros na tela de filtros avançados ou na tela inicial, e ao clicar no botão 'Aplicar Filtros'Image Removed, o sistema buscará as informações dos afastamentos dos funcionários.

Apresentação das Informações

Ao aplicarmos os filtros será apresentada a seguinte tela:

Lista de Afastamentos

Ao obter a lista de funcionários, temos as colunas:

  • Status: Correspondente ao status do registro
    • Legenda verde, Tag 'NI' - Integrados
    • Legenda azul, Tag 'IN' - Não integrados
    • Legenda vermelha, Tag 'CI' - Com Inconsistências 
    • Legenda laranja, Tag 'AR' - Aguardando Retorno

Image Removed

  • Matrícula Ahgora: Codigo da coligada + Chapa do funcionário
  • Nome: Nome do funcionário
  • Tipo do afastamento: Tipo e descrição do afastamento
  • Dt. Início: Inicio do afastamento
  • Dt. Fim: Fim do afastamento
  • Movimento: Inclusão/Alteração  (status alteração ocorrerá sempre que o primeiro cadastro ja tenha sido enviado para ahgora)
  • Dt. Movimento: Data da movimentação (envio a ahgora)

Serão listados 100 registros por página, ao final da página será mostrado o botão para "carregar mais resultados" Image Removed.

Image Removed

Para realizar o envio, selecione o registro desejado e clique em "Integrar Afastamentos" Image Removed.

Image Removed

Image Removed

Image Removed

Ao integrar o registro, se ocorrer tudo certo, o registro será alterado para 'Aguardando Retorno'. Basta selecioná-lo novamente e atualizar o status para verificar o retorno da integração.

Image Removed

Image Removed

Ao final da atualização do status, o registro será alterado:

'IN' - Integrado: o registro foi integrado com sucesso.

Image Removed

'CI' - Com Inconsistências: Registro com erro fica com a legenda em vermelho, e você pode consultar o erro, na opção status que está localizada ao clicar nos 3 pontinhos na parte direita da tabela.

Image Removed

Image Removed

Erro é apresentado na tela:

Image Removed

Nessa nova tela, será exibido o menu para integração das Exclusões dos Afastamentos

Na tela inicial são apresentados filtros básicos para a seleção das exclusões dos afastamentos que serão enviados. Como sugestão, a 'Data Exclusões De' vem preenchida com um mês anterior que a data atual e a 'Data Exclusões Até' com a data atual. Filtros de 'Filial' e 'Data Exclusões De' são obrigatórios. 

Image Removed

Para mais filtros, é necessário acessar a opção de 'Filtros Avançados'Image Removed. Na opção de 'Filtros Avançados', é possível realizar mais alguns filtros específicos além dos filtros já apresentados na primeira tela.

Image Removed

Selecionando os filtros na tela de filtros avançados ou na tela inicial, e ao clicar no botão 'Aplicar Filtros'Image Removed, o sistema buscará as informações das Exclusões de afastamentos dos funcionários.

Apresentação das Informações

Ao aplicarmos os filtros será apresentada a seguinte tela:

Lista de Afastamentos

Ao obter a lista de funcionários, temos as colunas:

  • Status: Correspondente ao status do registro
    • Legenda verde, Tag 'NI' - Integrados
    • Legenda azul, Tag 'IN' - Não integrados
    • Legenda vermelha, Tag 'CI' - Com Inconsistências 
    • Legenda laranja, Tag 'AR' - Aguardando Retorno

Image Removed

  • Matrícula Ahgora: Codigo da coligada + Chapa do funcionário
  • Nome: Nome do funcionário
  • Tipo do afastamento: Tipo e descrição do afastamento
  • Dt. Início: Inicio do afastamento
  • Dt. Fim: Fim do afastamento
  • Movimento: Exclusão
  • Dt. Movimento: Data da movimentação (envio a ahgora)

Serão listados 100 registros por página, ao final da página será mostrado o botão para "carregar mais resultados" Image Removed.

Image Removed

Atenção: serão gravadas as exclusões dos afastamentos que possuam o status 'NI' - Integrados

Para realizar o envio, selecione o registro desejado e clique em "Integrar Exclusões" Image Removed.

Image Removed

Image Removed

Image Removed

Ao integrar o registro, se ocorrer tudo certo, o registro será alterado para 'Aguardando Retorno'. Basta selecioná-lo novamente e atualizar o status para verificar o retorno da integração.

Image Removed

Image Removed

Image Removed

Ao final da atualização do status, o registro será alterado:

'IN' - Integrado: o registro foi integrado com sucesso.

Image Removed

'CI' - Com Inconsistências: Registro com erro fica com a legenda em vermelho, e você pode consultar o erro, na opção status que está localizada ao clicar nos 3 pontinhos na parte direita da tabela.

Image Removed

Image Removed

Erro é apresentado na tela

Image Removed

Após a realização da ativação da integração com a Ahgora, o sistema começa a registrar automaticamente os novos eventos de admissão, alteração e exclusão relacionados aos funcionários e seus afastamentos. Para o envio a Ahgora.

Para realizar o agendamento desses envios acesse: Acesse RH | Folha de pagamento | Configurações | Parametrizador | 06.02 - Integrações | 06.02.11 - Ahgora.

Na aba Agendamento, você pode programar a integração dos registros que foram gravados para ocorrerem automaticamente, sem a necessidade de interação do usuário, tornando o processo mais dinâmico e produtivo. Isso funciona com o JobServer configurado para execução em modo 3 Camadas. Para mais informações sobre a configuração, clique aqui.

Image Removed

Para consultar os envios basta acessar RH | Folha de pagamento | Ambiente | Gerenciador de Jobs.

Serão criados dois jobs FopEnviarFuncionariosAfastamentosAhgoraProcess (envio dos funcionarios/afastamento e exclusões) e FopAtualizarStatusAhgoraProcess (Solicitação de atualização de status);

Para gerar as credenciais de Resultados para cadastro na Ahgora 

  • Realize a configuração do DefaultDB. Informações em : Configurando DefaultDB
  • Usuário e senha que serão fornecidos: Criar um usuário do sistema Folha de pagamento que possua permissão (01.06 - Ahgora), conforme aba "Parametrização"
  • API para recebimento da apuração é composta por servidor: maquina onde o RM está instalado + ApiPort do host e o caminho fixo "/api/rh/v1/ahgora/results".                                                    Exemplo: http://servidor:ApiPort/api/rh/v1/ahgora/results 
  • API para listagem de sindicatos é composta por servidor: maquina onde o RM está instalado + ApiPort do host e o caminho fixo "/api/rh/v1/ahgora/sindicatos".                                                    Exemplo:http://servidor:ApiPort/api/rh/v1/ahgora/sindicatos
    Deck of Cards
    id1

    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 RM:

    • Sindicatos - Tabela PSINDIC

    Image Removed

    Image Removed

    Importante: Código precisa ser igual ao cadastro do RM

    • Horários no RM => Escala Ahgora - Tabela AHORARIO

    Image Removed

    Image Removed

    Importante: Código precisa ser igual ao cadastro do RM

    • Eventos no RM => Rubrica na Ahgora- Tabela PEVENTO

    Image Removed

    Image Removed

    Importante: código precisa ser igual ao cadastro do RM

    • Centro de Custos - Tabela PCCUSTO

    Image Removed

    Image Removed

    Importante: código precisa ser igual ao cadastro do RM.

    • Tipo de Afastamentos - Tabela PCODAFAST

    Image Removed

    Image Removed

    Através do menu Administração de Pessoal | Ahgora, é possível realizar a integração dos dados , utilizando os filtros disponíveis na tela.

    Ao acessar o novo menu criado, abre-se uma nova tela com as opções:

    Image Removed

    Image Removed

    Nessa nova tela, será exibido o menu para integração dos funcionários

    Na tela inicial são apresentados filtros básicos para a seleção do funcionários que serão enviados. Como sugestão, a 'Data Admissão De' vem preenchida com um mês anterior que a data atual e a 'Data Admissão Até' com a data atual. Filtros de 'Filial' e 'Data Admissão De' são obrigatórios. 

    Image Removed

    Para mais filtros, é necessário acessar a opção de 'Filtros Avançados'Image Removed. Na opção de 'Filtros Avançados', é possível realizar mais alguns filtros específicos além dos filtros já apresentados na primeira tela.

    Image Removed

    Selecionando os filtros na tela de filtros avançados ou na tela inicial, e ao clicar no botão 'Aplicar Filtros'Image Removed, o sistema buscará as informações dos funcionários.

    Apresentação das Informações

    Ao aplicarmos os filtros será apresentada a seguinte tela:

    Lista de Funcionários

    Ao obter a lista de funcionários, temos as colunas:

    • Status: Correspondente ao status do registro
      • Legenda verde, Tag 'NI' - Integrados
      • Legenda azul, Tag 'IN' - Não integrados
      • Legenda vermelha, Tag 'CI' - Com Inconsistências 
      • Legenda laranja, Tag 'AR' - Aguardando Retorno

    Image Removed

    • Matrícula Ahgora: Codigo da coligada + Chapa do funcionário
    • Nome: Nome do funcionário
    • Dt. Admissão: data de admissão
    • Dt. Demissão: data de demissão
    • Horário: codigo do horário do funcionário
    • Função: Função do funcionário
    • Movimento: Inclusão/Alteração (status alteração ocorrerá sempre que o primeiro cadastro ja tenha sido enviado para ahgora)
    • Dt. Movimento: Data da movimentação (envio a ahgora)

    Serão listados 100 registros por página, ao final da página será mostrado o botão para "carregar mais resultados" Image Removed.

    Image Removed

    Para realizar o envio, selecione o registro desejado e clique em "integrar funcionários" Image Removed.

    Image Removed

    Image Removed

    Image Removed

    Ao integrar o registro, se ocorrer tudo certo, o registro será alterado para 'Aguardando Retorno'. Basta seleciona-ló novamente e atualizar o status para verificar o retorno da integração.

    Image Removed

    Image Removed

    Image Removed

    Ao final da atualização do status, o registro será alterado:

    'IN' - Integrado: o registro foi integrado com sucesso.

    Image Removed

    'CI' - Com Inconsistências: Registro com erro fica com a legenda em vermelho, e você pode consultar o erro, na opção status que está localizada ao clicar nos 3 pontinhos na parte direita da tabela.

    Image Removed

    Image Removed

    Erro é apresentado na tela

    Image Removed

    Card
    id1
    labelParametrização
    titleParametrização

    1) Acesse o menu Serviços Globais | Segurança | Perfis, selecione o sistema Folha de pagamento, edite o perfil desejado, vá em acesso a menus e permita o acesso 01.06 - Ahgora


    2) Acesse RH | Folha de pagamento | Configurações | Parametrizador | 06.02 - Integrações | 06.02.11 - Ahgora

    2.1)  Na aba Gerais:  Marque a opção "ativa" e cadastre os dados para a integração.

    Tipo de Ambiente:

      • Produção ou Homologação

    Configurações conexão Ahgora:

      • Usuário 
      • Senha
      • Endereço do servidor: Endpoint da Ahgora. Campo é de preenchimento obrigatório, caso tenha envio especifico para envio de funcionário ou afastamento é necessario o preenchimento dos campos completos abaixo.
        • Exemplo: https://api.ahgora.com.br/
      • Serviço Funcionário: Endpoint da Ahgora para o envio do Funcionário. Não é obrigatório o preenchimento.  Caso não seja preenchido será considerado o default da Ahgora (people).
      • Serviço Afastamento: Endpoint da Ahgora para o envio do Afastamento. Não é obrigatório o preenchimento.  Caso não seja preenchido será considerado o default da Ahgora (absences).
    ⚠️


    Aviso
    titleATENÇÃO:
    1. As informações de acesso ao ambiente da Ahgora devem ser solicitadas ao responsável do contrato da Ahgora. 
    2. Caso possua restrição em seu firewall, verifique se o endereço https://api.ahgora.com.br
     possuem
    1. possuem liberação para conexão externa.

    Gerar Funcionários

    1. Para utilização das integrações de Resultados, Sindicatos e Eventos é necessário a habilitação da licença I, que permite o acesso às APIs que disponibilizam estes dados. Caso você não possua a licença I, entre em contato com seu ESN.

    ⚠️ ATENÇÃO:

    Gerar Funcionários

    Gerar todos os funcionários, incluindo líderes e líderes externos, independentemente de baterem ponto
    Gerar todos os funcionários, incluindo líderes e líderes externos, independentemente de baterem ponto
    Ao selecionar esta opção, serão gerados gatilhos para todos os colaboradoresfuncionários, sem exceção, que batem ou não ponto, inclusive lideres internos e lideres externos. 

    Gerar somente funcionários e líderes que batem ponto
    Essa opção gera gatilhos apenas para funcionários e líderes (funcionários) que realizam marcação de ponto. Os líderes externos não são incluídos, pois não possuem o campo de marcação de ponto em seus cadastros. 

    Gerar funcionários e líderes que batem ponto, além dos líderes que não batem ponto
    Com essa opção, serão gerados gatilhos para todos os funcionários e líderes que batem ponto, além dos líderes externos que não efetuam marcação de ponto..

    ⚠️ ⚠️ ATENÇÃO:

        • Esses parâmetros estão disponíveis a partir dos patches mencionados no DT - Integração RM x Ahgora – Opção para Não Enviar Funcionários que Não Batem Ponto
        • A identificação de colaboradores que batem ponto ou não será realizada por meio da marcação disponível no menu Menu Funcionários | Aba Registro | Aba Ahgora.
        • A opção "Integrar todos os colaboradores: Gerar todos os funcionários, incluindo líderes e líderes externos, que batem ou não ponto" será definida como opção padrão (default) no sistema.


    2.2) Na aba Agendamento: Você pode programar a integração dos registros que foram gravados para ocorrerem automaticamente, sem a necessidade de interação do usuário, tornando o processo mais dinâmico e produtivo. Isso funciona com o JobServer configurado para execução em modo 3 Camadas. Para mais informações sobre a configuração, clique aqui.


    2.3) Na aba Fórmula para localizações: É possível associar fórmulas para o envio de campos que serão usados para geração de relatórios na Ahgora.

    Image Removed

    2.4) Na aba Filiais: A partir da inclusão do registro da filial, o sistema realiza a geração dos gatilhos de Funcionários e Afastamentos exclusivamente para as filiais cadastras nessa aba.

    Exemplo:

    O Funcionário 00001 está lotado na Filial 01, enquanto o Funcionário 00002 está lotado na Filial 09.

    Com a parametrização conforme o print acima, apenas o gatilho de integração para o Funcionário 00001 será gerado.

    3) Utiliza Ponto Ahgora

    3.1) Acesse Administração de Pessoal | Funcionários | Submenu Registros, será exibida a nova aba "Ahgora", onde você poderá marcar a opção de utilização de ponto.(A aba só será exibida após a parametrização do item 2).

     Nesta aba será realizada a vinculação de fórmulas onde o usuário poderá definir qual campo do funcionário deseja enviar no campo "Localização" da integração com o Ponto Web (Ahgora).

    Para isso o usuário deverá criar uma fórmula através do menu Administração de Pessoal | Fórmulas e incluir a fórmula nessa aba:


    Image Added


    Exemplos de fórmulas que podem ser criadas:

    1) Retornar o campo NOME do funcionário, deverá criar a formula abaixo:

    image-2025-2-5_18-2-51.pngImage Added


    2) Retornar um texto livre "DESENVOLVIMENTO RM", deverá criar a formula abaixo:

    image-2025-2-5_18-2-7.pngImage Added 


    ⚠️ ATENÇÃO:


    2.4) Na aba Filiais: A partir da inclusão do registro da filial, o sistema realiza a geração dos gatilhos de Funcionários e Afastamentos exclusivamente para as filiais cadastras nessa aba.

    Exemplo:

    O Funcionário 00001 está lotado na Filial 01, enquanto o Funcionário 00002 está lotado na Filial 09.

    Com a parametrização conforme o print acima, apenas o gatilho de integração para o Funcionário 00001 será gerado.


    3) Utiliza Ponto Ahgora

    3.1

    Image Removed

    3.2) Alteração Global: Caso deseje realizar a marcação do campo para um grupo especifico de funcionários acesse  Administração de Pessoal | Alterações Cadastrais | Alteração Campos do Cadastro selecione o campo "O funcionário utiliza ponto ahgora: - UTILIZAPONTOAHGORA", cadastre a fórmula para a alteração sendo "true" parâmetro marcado e "false" parâmetro desmarcado e selecione os funcionários desejados, e execute o processo.

    Image Removed

    Exemplo da fórmula

    Image Removed

    3.3) Acesse o menu Serviços Globais | Segurança | Perfis, e conceda permissão para acesso ao histórico da aba "Ahgora".

    Image Removed

    3.4) Acesse Administração de Pessoal | Funcionários | Anexos | Históricos | Histórico Utiliza Ponto Ahgora, para visualizar o histórico cadastrado para o campo "Utiliza Ponto Ahgora".

    Image Removed

    Card
    id2
    labelParametrização Ahgora
    titleParametrização Ahgora
    Card
    id3
    labelIntegração
    titleIntegração
    Deck of Cards
    idIntegração
    Card
    id3-1
    labelFuncionários
    titleFuncionários
    Aviso
    iconfalse
    titleATENÇÃO:

    Foram implementados os campos CODCOLIGADAANTERIOR, CHAPAANTERIOR e CODFILIALANTERIOR na tabela PINTEGRACAOENVIOAHGORA.

    Esses campos permitem que, na primeira integração após o funcionário ser transferido, as informações de origem sejam enviadas corretamente para o sistema Ponto Web (Ahgora), garantindo o tratamento adequado da alteração.

    As versões contendo essa atualização estão disponíveis no DT - Integração RM X Ahgora - Adequação da Matrícula na Transferência.

    Card
    id3-2
    labelAfastamentos
    titleAfastamentos
    Card
    id3-3
    labelExclusão Afastamentos
    titleExclusão Afastamentos
    Card
    id3-4
    labelAgendamento do processo
    titleAgendamento do processo
    Card
    id3-5
    labelApuração de Resultados
    titleApuração de Resultados

    Submenu Registros, será exibida a nova aba "Ahgora", onde você poderá marcar a opção de utilização de ponto.(A aba só será exibida após a parametrização do item 2).

    Image Added


    3.2) Alteração Global: Caso deseje realizar a marcação do campo para um grupo especifico de funcionários acesse  Administração de Pessoal | Alterações Cadastrais | Alteração Campos do Cadastro selecione o campo "O funcionário utiliza ponto ahgora: - UTILIZAPONTOAHGORA", cadastre a fórmula para a alteração sendo "true" parâmetro marcado e "false" parâmetro desmarcado e selecione os funcionários desejados, e execute o processo.

    Image Added


    Exemplo da fórmula SQL

    Image Added

    Exemplo da fórmula ORACLE

    Image Added


    3.3) Acesse o menu Serviços Globais | Segurança | Perfis, e conceda permissão para acesso ao histórico da aba "Ahgora".

    Image Added


    3.4) Acesse Administração de Pessoal | Funcionários | Anexos | Históricos | Histórico Utiliza Ponto Ahgora, para visualizar o histórico cadastrado para o campo "Utiliza Ponto Ahgora".

    Image Added





    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 RM:

    • Sindicatos - Tabela PSINDIC

    Image Added

    Image Added

    Importante: Código precisa ser igual ao cadastro do RM


    • Horários no RM => Escala Ahgora - Tabela AHORARIO

    Image Added

    Image Added

    Importante: Código precisa ser igual ao cadastro do RM


    • Eventos no RM => Rubrica na Ahgora- Tabela PEVENTO

    Image Added

    Image Added

    Importante: código precisa ser igual ao cadastro do RM


    • Centro de Custos - Tabela PCCUSTO

    Image Added

    Image Added


    Importante: código precisa ser igual ao cadastro do RM.


    • Tipo de Afastamentos - Tabela PCODAFAST

    Image Added

    Image Added

    Card
    id3
    labelIntegração
    titleIntegração

    Através do menu Administração de Pessoal | Ahgora, é possível realizar a integração dos dados , utilizando os filtros disponíveis na tela.

    Ao acessar o novo menu criado, abre-se uma nova tela com as opções:

    Image Added

    Image Added


    Deck of Cards
    idIntegração
    Card
    id3-1
    labelFuncionários
    titleFuncionários

    Nessa nova tela, será exibido o menu para integração dos funcionários

    Na tela inicial são apresentados filtros básicos para a seleção do funcionários que serão enviados. Como sugestão, a 'Data Admissão De' vem preenchida com um mês anterior que a data atual e a 'Data Admissão Até' com a data atual. Filtros de 'Filial' e 'Data Admissão De' são obrigatórios. 

    Image Added


    Para mais filtros, é necessário acessar a opção de 'Filtros Avançados'Image Added. Na opção de 'Filtros Avançados', é possível realizar mais alguns filtros específicos além dos filtros já apresentados na primeira tela.

    Image Added

    Selecionando os filtros na tela de filtros avançados ou na tela inicial, e ao clicar no botão 'Aplicar Filtros'Image Added, o sistema buscará as informações dos funcionários.

    Apresentação das Informações

    Ao aplicarmos os filtros será apresentada a seguinte tela:

    Lista de Funcionários

    Ao obter a lista de funcionários, temos as colunas:

    • Status: Correspondente ao status do registro
      • Legenda verde, Tag 'NI' - Integrados
      • Legenda azul, Tag 'IN' - Não integrados
      • Legenda vermelha, Tag 'CI' - Com Inconsistências 
      • Legenda laranja, Tag 'AR' - Aguardando Retorno

    Image Added

    • Matrícula Ahgora: Codigo da coligada + Chapa do funcionário
    • Nome: Nome do funcionário
    • Dt. Admissão: data de admissão
    • Dt. Demissão: data de demissão
    • Horário: codigo do horário do funcionário
    • Função: Função do funcionário
    • Movimento: Inclusão/Alteração (status alteração ocorrerá sempre que o primeiro cadastro ja tenha sido enviado para ahgora)
    • Dt. Movimento: Data da movimentação (envio a ahgora)


    Serão listados 100 registros por página, ao final da página será mostrado o botão para "carregar mais resultados" Image Added.

    Image Added


    Para realizar o envio, selecione o registro desejado e clique em "integrar funcionários" Image Added.

    Image Added

    Image Added

    Image Added


    Ao integrar o registro, se ocorrer tudo certo, o registro será alterado para 'Aguardando Retorno'. Basta selecioná-lo novamente e atualizar o status para verificar o retorno da integração.

    Image Added

    Image Added

    Image Added


    Ao final da atualização do status, o registro será alterado:

    'IN' - Integrado: o registro foi integrado com sucesso.

    Image Added

    'CI' - Com Inconsistências: Registro com erro fica com a legenda em vermelho, e você pode consultar o erro, na opção status que está localizada ao clicar nos 3 pontinhos na parte direita da tabela.

    Image Added

    Image Added

    Erro é apresentado na tela

    Image Added

    Aviso
    iconfalse
    titleATENÇÃO:

    Foram implementados os campos CODCOLIGADAANTERIOR, CHAPAANTERIOR e CODFILIALANTERIOR na tabela PINTEGRACAOENVIOAHGORA.

    Esses campos permitem que, na primeira integração após o funcionário ser transferido, as informações de origem sejam enviadas corretamente para o sistema Ponto Web (Ahgora), garantindo o tratamento adequado da alteração.

    As versões contendo essa atualização estão disponíveis no DT - Integração RM X Ahgora - Adequação da Matrícula na Transferência.

    Card
    id3-2
    labelAfastamentos
    titleAfastamentos

    Nessa nova tela, será exibido o menu para integração dos Afastamentos

    Na tela inicial são apresentados filtros básicos para a seleção dos afastamentos que serão enviados. Como sugestão, a 'Data Afastamento De' vem preenchida com um mês anterior que a data atual e a 'Data Afastamento Até' com a data atual. Filtros de 'Filial' e 'Data Afastamento De' são obrigatórios. 

    Image Added


    Para mais filtros, é necessário acessar a opção de 'Filtros Avançados'Image Added. Na opção de 'Filtros Avançados', é possível realizar mais alguns filtros específicos além dos filtros já apresentados na primeira tela.

    Image Added

    Selecionando os filtros na tela de filtros avançados ou na tela inicial, e ao clicar no botão 'Aplicar Filtros'Image Added, o sistema buscará as informações dos afastamentos dos funcionários.

    Apresentação das Informações

    Ao aplicarmos os filtros será apresentada a seguinte tela:

    Lista de Afastamentos

    Ao obter a lista de funcionários, temos as colunas:

    • Status: Correspondente ao status do registro
      • Legenda verde, Tag 'NI' - Integrados
      • Legenda azul, Tag 'IN' - Não integrados
      • Legenda vermelha, Tag 'CI' - Com Inconsistências 
      • Legenda laranja, Tag 'AR' - Aguardando Retorno

    Image Added

    • Matrícula Ahgora: Código da coligada + Chapa do funcionário
    • Nome: Nome do funcionário
    • Tipo do afastamento: Tipo e descrição do afastamento
    • Dt. Início: Inicio do afastamento
    • Dt. Fim: Fim do afastamento
    • 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 100 registros por página, ao final da página será mostrado o botão para "carregar mais resultados" Image Added.

    Image Added


    Para realizar o envio, selecione o registro desejado e clique em "Integrar Afastamentos" Image Added.

    Image Added

    Image Added

    Image Added



    Ao integrar o registro, se ocorrer tudo certo, o registro será alterado para 'Aguardando Retorno'. Basta selecioná-lo novamente e atualizar o status para verificar o retorno da integração.

    Image Added

    Image Added


    Ao final da atualização do status, o registro será alterado:

    'IN' - Integrado: o registro foi integrado com sucesso.

    Image Added


    'CI' - Com Inconsistências: Registro com erro fica com a legenda em vermelho, e você pode consultar o erro, na opção status que está localizada ao clicar nos 3 pontinhos na parte direita da tabela.

    Image Added

    Image Added


    Erro é apresentado na tela:

    Image Added

    Card
    id3-3
    labelExclusão Afastamentos
    titleExclusão Afastamentos

    Nessa nova tela, será exibido o menu para integração das Exclusões dos Afastamentos

    Na tela inicial são apresentados filtros básicos para a seleção das exclusões dos afastamentos que serão enviados. Como sugestão, a 'Data Exclusões De' vem preenchida com um mês anterior que a data atual e a 'Data Exclusões Até' com a data atual. Filtros de 'Filial' e 'Data Exclusões De' são obrigatórios. 

    Image Added

    Para mais filtros, é necessário acessar a opção de 'Filtros Avançados'Image Added. Na opção de 'Filtros Avançados', é possível realizar mais alguns filtros específicos além dos filtros já apresentados na primeira tela.

    Image Added

    Selecionando os filtros na tela de filtros avançados ou na tela inicial, e ao clicar no botão 'Aplicar Filtros'Image Added, o sistema buscará as informações das Exclusões de afastamentos dos funcionários.

    Apresentação das Informações

    Ao aplicarmos os filtros será apresentada a seguinte tela:

    Lista de Afastamentos

    Ao obter a lista de funcionários, temos as colunas:

    • Status: Correspondente ao status do registro
      • Legenda verde, Tag 'NI' - Integrados
      • Legenda azul, Tag 'IN' - Não integrados
      • Legenda vermelha, Tag 'CI' - Com Inconsistências 
      • Legenda laranja, Tag 'AR' - Aguardando Retorno

    Image Added

    • Matrícula Ahgora: Código da coligada + Chapa do funcionário
    • Nome: Nome do funcionário
    • Tipo do afastamento: Tipo e descrição do afastamento
    • Dt. Início: Inicio do afastamento
    • Dt. Fim: Fim do afastamento
    • Movimento: Exclusão
    • Dt. Movimento: Data da movimentação (envio a Ahgora)


    Serão listados 100 registros por página, ao final da página será mostrado o botão para "Carregar mais resultados" Image Added.

    Image Added

    Atenção: serão gravadas as exclusões dos afastamentos que possuam o status 'NI' - Integrados


    Para realizar o envio, selecione o registro desejado e clique em "Integrar Exclusões" Image Added.

    Image Added

    Image Added


    Image Added


    Ao integrar o registro, se ocorrer tudo certo, o registro será alterado para 'Aguardando Retorno'. Basta selecioná-lo novamente e atualizar o status para verificar o retorno da integração.

    Image Added

    Image Added

    Image Added


    Ao final da atualização do status, o registro será alterado:

    'IN' - Integrado: o registro foi integrado com sucesso.

    Image Added


    'CI' - Com Inconsistências: Registro com erro fica com a legenda em vermelho, e você pode consultar o erro, na opção status que está localizada ao clicar nos 3 pontinhos na parte direita da tabela.

    Image Added

    Image Added


    Erro é apresentado na tela

    Image Added

    Card
    id3-4
    labelAgendamento do processo
    titleAgendamento do processo

    Após a realização da ativação da integração com a Ahgora, o sistema começa a registrar automaticamente os novos eventos de admissão, alteração e exclusão relacionados aos funcionários e seus afastamentos. Para o envio a Ahgora.

    Para realizar o agendamento desses envios acesse: Acesse RH | Folha de pagamento | Configurações | Parametrizador | 06.02 - Integrações | 06.02.11 - Ahgora.

    Na aba Agendamento, você pode programar a integração dos registros que foram gravados para ocorrerem automaticamente, sem a necessidade de interação do usuário, tornando o processo mais dinâmico e produtivo. Isso funciona com o JobServer configurado para execução em modo 3 Camadas. Para mais informações sobre a configuração, clique aqui.

    Image Added

    Para consultar os envios basta acessar RH | Folha de pagamento | Ambiente | Gerenciador de Jobs.

    Serão criados dois jobs FopEnviarFuncionariosAfastamentosAhgoraProcess (envio dos funcionários/afastamento e exclusões) e FopAtualizarStatusAhgoraProcess (Solicitação de atualização de status);



    Card
    id3-5
    labelApuração de Resultados
    titleApuração de Resultados

    Para gerar as credenciais de Resultados para cadastro na Ahgora 

    1. Realize a configuração do DefaultDB. Informações em : Configurando DefaultDB
    2. Usuário e senha que serão fornecidos: Criar um usuário do sistema Folha de pagamento que possua permissão (01.06 - Ahgora), conforme aba "Parametrização"
    3. API para recebimento da apuração é composta por servidor: maquina onde o RM está instalado + ApiPort do host e o caminho fixo "/api/rh/v1/ahgora/results".                                                    Exemplo: http://servidor:ApiPort/api/rh/v1/ahgora/results 
    4. API para listagem de sindicatos é composta por servidor: maquina onde o RM está instalado + ApiPort do host e o caminho fixo "/api/rh/v1/ahgora/sindicatos".                                                    Exemplo:http://servidor:ApiPort/api/rh/v1/ahgora/sindicatos
    5. API para listagem de eventos/verbas é composta por servidor: maquina onde o RM está instalado + ApiPort do host e o caminho fixo "/api/rh/v1/ahgora/verbas".                                                  Exemplo: http://servidor:ApiPort/api/rh/v1/ahgora/verbas


    IMPORTANTE:

    • Método de autenticação Basic;
    • Será utilizado método post para entrega de dados;
    • Ao criar a URL, liberar porta para acesso externo;
    • Caso tenha restrição de IPs, liberar para a lista abaixo, para entrega da apuração pelo Ponto Web:


    Após a apuração do ponto na Ahgora, realize o envio para o RM das informações.

    O RM guardará as informações recebidas em Folha Mensal | Consulta | Consulta Movimento da Integração.

     Image Added


    Poderá ser encontrada com o tipo de lançamento Ahgora.

    Image Added


    Caso o parâmetro "Utiliza controle de faltas para cálculo de avos" esteja marcado, o sistema guardará as faltas no histórico de faltas.

    Image Added


    Acesse Administração de pessoal | Funcionários | Anexos | Movimento | Controle de Faltas para Cálculo de Avos.

    Image Added


    Para processar os eventos para a folha de pagamento será necessário o processamento no grupo de eventos com o novo tipo criado. Acesse Folha Mensal | Lançamentos | Grupo de eventos.

    Image Added


    Selecione o grupo de eventos que irá lançar o movimento e clique em editar.

    Image Added


    Marque o parâmetro "Lançar eventos da integração com outros aplicativos" na aba Identificação.

    Image Added


    Será criado a aba "Integração com outros aplicativos ", selecione a nova integração "TOTVS Ahgora" e faça o lançamento.

    Image Added

    Image Added


    Verifique que os valores foram lançado corretamente para o envelope de pagamento.

    Image Added

    Importante:

      • Caso seja necessário remover algum evento, será preciso realizar uma nova carga de envio dos eventos da Ahgora. Em seguida, será necessário reprocessar os passos descritos anteriormente para garantir a correção dos lançamentos no envelope de pagamento.
      • Sempre que a integração for processada, o sistema substituirá os eventos existentes com base nos seguintes campos: coligada, chapa, ano, mês e origem do evento.


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

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

    Para possibilitar o envio deste campo é necessário a vinculação de fórmulas através do menu RH | Folha de pagamento | Configurações | Parametrizador | 06.02 - Integrações | 06.02.11 - Ahgora | Aba Fórmula para Localizações

    Image Added


    ATENÇÃO:

    • Caso não seja definida nenhuma localização, não será enviada a propriedade 'localizacoes' no json do funcionário.
    • Para o desenvolvimento das fórmulas será possível utilizar funções retornando campos do cadastro do funcionário ou a criação de novos campos, desde que estes retornem em string até 100 caráteres.
    • Campos strings do banco que possuem mais de 100 caracteres serão truncados.
    • O gatilho não será acionado se o contexto da fórmula for alterado. Se for necessário fazer alguma alteração, crie uma nova fórmula e substitua a atual.


    Exemplo de criação de Fórmula:

    Image Added


    Image Added


    Após a vinculação das fórmulas no parametrizador, sempre que houver integração de um funcionário (Inclusão/Alteração) as localizações serão enviadas.


    Image Added


    Image Added



  • API para listagem de eventos/verbas é composta por servidor: maquina onde o RM está instalado + ApiPort do host e o caminho fixo "/api/rh/v1/ahgora/verbas".                                                  Exemplo: http://servidor:ApiPort/api/rh/v1/ahgora/verbas
  • IMPORTANTE:

    • Método de autenticação Basic;
    • Será utilizado método post para entrega de dados;
    • Ao criar a URL, liberar porta para acesso externo;
    • Caso tenha restrição de IPs, liberar para a lista abaixo, para entrega da apuração pelo PontoWeb:

    Após a apuração do ponto na Ahgora, realize o envio para o RM das informações.

    O RM guardará as informações recebidas em Folha Mensal | Consulta | Consulta Movimento da Integração.

     Image Removed

    Poderá ser encontrada com o tipo de lançamento Ahgora.

    Image Removed

    Caso o parâmetro "utiliza controle de faltas para cálculo de avos" esteja marcado, o sistema guardará as faltas no histórico de faltas.

    Image Removed

    Acesse Administração de pessoal | Funcionários | Anexos | Movimento | Controle de Faltas para Cálculo de Avos.

    Image Removed

    Para processar os eventos para a folha de pagamento será necessário o processamento no grupo de eventos com o novo tipo criado. Acesse Folha Mensal | Lançamentos | Grupo de eventos.

    Image Removed

    Selecione o grupo de eventos que irá lançar o movimento e clique em editar.

    Image Removed

    Marque o parâmetro "Lançar eventos da integração com outros aplicativos" na aba Identificação.

    Image Removed

    Será criado a aba "Integração com outros aplicativos ", selecione a nova integração "TOTVS Ahgora" e faça o lançamento.

    Image Removed

    Image Removed

    Verifique que os valores foram lançado corretamente para o envelope de pagamento.

    Image Removed

    Importante:

      • Caso seja necessário remover algum evento, será preciso realizar uma nova carga de envio dos eventos da Ahgora. Em seguida, será necessário reprocessar os passos descritos anteriormente para garantir a correção dos lançamentos no envelope de pagamento.
      • Sempre que a integração for processada, o sistema substituirá os eventos existentes com base nos seguintes campos: coligada, chapa, ano, mês e origem do evento.

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

    Para possibilitar o envio deste campo é necessário a vinculação de fórmulas através do menu RH | Folha de pagamento | Configurações | Parametrizador | 06.02 - Integrações | 06.02.11 - Ahgora | Aba Fórmula para Localizações

    Image Removed

    ATENÇÃO:

    • Caso não seja definida nenhuma localização, não será enviada a propriedade 'localizacoes' no json do funcionário.
    • Para o desenvolvimento das fórmulas será possível utilizar funções retornando campos do cadastro do funcionário ou a criação de novos campos, desde que estes retornem em string até 100 caráteres.
    • Campos strings do banco que possuem mais de 100 caracteres serão truncados.
    • O gatilho não será acionado se o contexto da fórmula for alterado. Se for necessário fazer alguma alteração, crie uma nova fórmula e substitua a atual.

    Exemplo de criação de Fórmula:

    Image Removed

    Image Removed

    Após a vinculação das fórmulas no parametrizador, sempre que houver integração de um funcionário (Inclusão/Alteração) as localizações serão enviadas.

    Image Removed

    Image Removed

    Preencher comtrue quando não tiver o PIS cadastrado e false quando tiver PIS cadastrado.

    2 - AFASTAMENTOS

    Card
    id4
    labelDE/PARA
    titleDE/PARA
    Card
    id1
    labelDe/Para
    titleDe/Para

    1 - FUNCIONÁRIOS

    DESCRIÇÃO NA AHGORACAMPO DA TABELA RMDESCRIÇÃO | REGRA
    Identificação do colaboradorPFUNC.CODICOLIGADA + PFUNC.CHAPAColigada + Chapa do Funcionário
    Não pode haver matricula repetida na mesma coligada. As matrículas serão enviadas sem caracteres especiais.
    Nome do FuncionárioPPESSOA.NOMENome do Funcionário.
    É permitido acentuação e caracteres especiais.
    Nome SocialPPESSOA.NOMESOCIAL

    Para os funcionários que possuem Nome Social, o json será gerado conforme o detalhamento abaixo:

    • "nome": "NOME SOCIAL",
    • "checkbox_nome_social": true,
    • "nome_registro": "NOME"
    PIS do FuncionárioPFUNC.PISPASEPNumero do PIS do Funcionário.
    Enviar somente números.
    Quando não houver, deverá preencher o campo "
    sem_pis" com true
    Matrícula do E-SocialPFUNC.MATRICULAESOCIALMatricula do eSocial
    Data em que o Funcionário foi AdmitidoPFUNC.DATAADMISSAOData de Admissão. DD/MM/AAAA
    Data de DemissãoPFUNC.DATADEMISSAOData de Demissão. DD/MM/AAAA
    Transferência do tipo "5" não é considerado como demissão, mandar esse campo em branco para esse tipo.
    Localizações do funcionárioFormula na tela do processoAdicionar um campo na interface onde o usuário possa informar uma fórmula personalizada. Este campo será aberto, permitindo que qualquer campo do cadastro do funcionário seja utilizado. A funcionalidade visa facilitar a criação de filtros e a geração de relatórios no sistema Ahgora. Trata-se de um campo flexível, definido pelo usuário, que oferece maior liberdade e precisão na manipulação de dados e relatórios.
    Código da escala/ turno do funcionário
    PFHSTHOR.CODHORARIO
    Horário do Funcionário - Histórico Horário
    Preencher com o último existente no histórico de horário.
    Coligada + Código
    Data da alteração de escala/turnoPFHSTHOR.DTMUDANCAData da Mudança do Horário do Funcionário.
    Preencher com o último existente no histórico de horário.
    Tipo de Escala de TrabalhoNÃO ENVIARNão existe essa informação na folha de pagamento.
    Carteira de TrabalhoPPESSOA.CARTEIRATRAB
    PPESSOA.SERIECARTTRAB
    PPESSOA.UFCARTTRAB
    Carteira de Trabalho
    Concatenar os 3 campos (numero, série e UF), separando os campos com barra "/". Exemplo: 9999/999/MG
    Título do CargoPHSTFCO.CODFUNCAOFunção do Funcionário => Histórico de Função
    Preencher com o último existente no histórico de função.
    Concatenar o Código + Descrição, separando com traço "-". Exemplo: 001-ANALISTA DE SISTEMAS
    Descrição do departamento do FuncionárioPFUNC.CODSECAOSeção do funcionário
    Concatenar o Código + Descrição, separando com traço "-". Exemplo: 01.01.03-DEPARTAMENTO PESSOAL
    Gênero do FuncionárioPPESSOA.SEXOSexo do Funcionário.
    Preencher com F ou M.
    E-mail do FuncionárioPPESSOA.EMAILE-mail do funcionário.
    Múltiplos vínculos ter um e-mail por funcionário, não pode ser repetido.
    CPF do FuncionárioPPESSOA.CPF

    CPF do Funcionário.
    Preencher sem caracteres. Exemplo: 11122233344.

    RG do FuncionárioPPESSOA.CARIDENTIDADECarteira de Identidade.
    Preencher apenas com o RG, podendo ter caracteres.
    Exemplo: M-7.7777
    CNPJ da filial do FuncionárioPSECAO.CGC (JOIN) PFUNC.CODSECAOCNPJ da Seção do funcionário.
    Preencher apenas com números, sem caracteres.
    Data da atribuição do CNPJ da empresa ao funcionárioPFUNC.DTTRANSFERENCIAData da Transferência entre filiais ou coligada.
    Código do centro de custo do funcionárioPSECAO.NROCENCUSTOCONTColigada + Número do Centro de Custo da Seção do Funcionário. Caminho Seções | Dados Contábeis | Número do Centro de Custo
    Regime de Trabalho do FuncionárioDE/PARA NO PARAMETRIZADOR DO RM

    É realizado um DE/PARA interno pelo produto, considerando os campos:

    • Tipo de Recebimento
    • Código Recebimento
    • Categoria

    Veja o mapeamento do DE/PARA no item 1-1 abaixo.

    Data de Nascimento do FuncionárioPPESSOA.DTNASCIMENTOData de Nascimento. DD/MM/AAAA
    Data de Alteração de CargoPHSTFCO.DTMUDANCAData da Mudança da Função
    Card
    id3-6
    labelLocalizações
    titleLocalizações
    Card
    id4
    labelDe/Para
    titleDe/Para
    PFHSTHOR.CODHORARIOData da Mudança do Horário
    Card
    id1
    labelDe/Para
    titleDe/Para

    1 - FUNCIONÁRIOS

    Descrição AhgoraCampo Tabela RMDescrição / Regra
    Identificação do colaboradorPFUNC.CODICOLIGADA + PFUNC.CHAPAColigada + Chapa
    Chapa do Funcionário.
    Quando for chefe externo preencher o código do chefe externo.
    Não pode haver matricula repedita na mesma coligada.
    Nome do FuncionárioPPESSOA.NOMENome do Funcionario, ou nome do chefe externo.
    É permitido acentuação e caracteres especiais.
    PIS do FuncionárioPFUNC.PISPASEPNumero do PIS do Funcionário.
    Enviar somente números.
    Quando não houver, deverá preencher o campo "
    sem_pis" com true
    Matrícula do E-SocialPFUNC.MATRICULAESOCIALMatricula do eSocial
    Data em que o Funcionário foi AdmitidoPFUNC.DATAADMISSAOData de Admissão. DD/MM/AAAA
    Para o chefe externo deverá ser a data de inicio.
    Data de DemissãoPFUNC.DATADEMISSAOData de Demissão. DD/MM/AAAA
    Transferência do tipo "5" não é considerado como demissão, mandar esse campo em branco para esse tipo.
    Para o chefe externo deverá ser a data fim
    Localizações do funcionárioFormula na tela do processoAdicionar um campo na interface onde o usuário possa informar uma fórmula personalizada. Este campo será aberto, permitindo que qualquer campo do cadastro do funcionário seja utilizado. A funcionalidade visa facilitar a criação de filtros e a geração de relatórios no sistema Ahgora. Trata-se de um campo flexível, definido pelo usuário, que oferece maior liberdade e precisão na manipulação de dados e relatórios.
    Código da escala/ turno do funcionárioHorário do Funcionário - Histórico Horário
    Preencher com o último existente no histórico de horário.
    Coligada + Código
    Data da alteração de escala/turnoPFHSTHOR.DTMUDANCA
    do Funcionário.
    Preencher com o último existente no histórico de
    horário
    função.
    Tipo de Escala de TrabalhoNÃO ENVIARNão existe essa informação na folha de pagamento.
    Carteira de TrabalhoPPESSOA.CARTEIRATRAB
    PPESSOA.SERIECARTTRAB
    PPESSOA.UFCARTTRAB
    Carteira de Trabalho
    Concatenar os 3 campos (numero, série e UF), separando os campos com barra "/". Exemplo: 9999/999/MG
    Título do CargoPHSTFCO.CODFUNCAOFunção do Funcionário - Histórico de Função
    Preencher com o último existente no histórico de função.
    Concater o Código + Descrição, separando com traço "-". Exemplo: 001-ANALISTA DE SISTEMAS
    Descrição do departamento do FuncionárioPFUNC.CODSECAOSeção do funcionário
    Concater o Código + Descrição, separando com traço "-". Exemplo: 01.01.03-DEPARTAMENTO PESSOAL
    Gênero do FuncionárioPPESSOA.SEXOSexo do Funcionário.
    Preencher com F ou M.
    E-mail do FuncionárioPPESSOA.EMAILEmail do funcionário.
    Múltiplos vínculos ter um email por funcionário, não pode ser repetido.
    CPF do FuncionárioPPESSOA.CPFCPF do Funcionário.
    Preencher sem caracteres. Exemplo: 11122233344.
    Para chefe externo busca tbm o CPF
    RG do FuncionárioPPESSOA.CARIDENTIDADECarteira de Identidade.
    Preencher apenas com o RG, podendo ter caracteres.
    Exemplo: M-7.7777
    CNPJ da filial do FuncionárioPSECAO.CGC (JOIN) PFUNC.CODSECAOCNPJ da Seção do funcionário.
    Preencher apenas com numeros, sem caracteres.
    Data da atribuição do CNPJ da empresa ao funcionárioPFUNC.DTTRANSFERENCIAData da Transferencia entre filiais ou coligada.
    Código do centro de custo do funcionárioPSECAO.NROCENCUSTOCONTColigada + Código do Centro de Custo da Seção do Funcionário.
    Regime de Trabalho do FuncionárioDE/PARA NO PARAMETRIZADOR DO RMBuscar a descrição do DE/PARA que será criado no parametrizador do RM, para PFUNC.CATEGORIAESOCIAL X TABELA AHGORA.
    Preencher com a Descrição.
    Data de Nascimento do FuncionárioPPESSOA.DTNASCIMENTOData de Nascismento. DD/MM/AAAA
    Data de Alteração de CargoPHSTFCO.DTMUDANCAData da Mudança da Função do Funcionário.
    Preencher com o último existente no histórico de função.
    Definição de carga horáriaPFUNC.JORNADA_MENSALJornada Mensal do Funcionário.
    Preencher com a quantidade de horas mensais. Exemplo: 220
    Ponto ObrigatórioPFHSTUTILIZACAMPOAHGORA.UTILIZAPONTOEnviar true ou false.
    Data de troca da elegibilidade do registro de pontoPFHSTUTILIZACAMPOAHGORA.DTMUDANCAEnviar a data quando passou a utilizar ponto, ou quando deixou de utilizar ponto.
    Matrícula Chefia ImediataPFUNC.CODICOLIGADA + PFUNC.CHAPAColigada + Chapa do chefe do funcionário ou código do chefe externo.
    Nome Chefia ImediataPFUNC.NOMENome do chefe do Funcionario, ou nome do chefe externo.
    É permitido acentuação e caracteres especiais.
    e-mail Chefia ImediataPPESSOA.EMAILEmail do chefe do funcionário ou email do chefe externo do funcionário.
    Código do SindicatoPFUNC.CODSINDICATOCódigo do Sindicato do funcionário
    Data da alteração do código do sindicatoPFSINDIC.DTMUDANCAData da mudança do Sindicato do Funcionário.
    TelefonePPESSOA.TELEFONE2Número do Telefone Celular. Permite caracteres especiais.
    PisPFUNC.PISPASEP
    codInternoPFUNC.CHAPAColigada + Chapa
    Chapa do Funcionário.
    Quando for chefe externo preencher o código do chefe externo.
    Não pode haver matricula repedita na mesma coligada.
    matricula_anteriorPFUNC.CHAPAORIGEMPreencher com a chapa do registro demitido.
    Este campo deve ser preenchido quando houve transferencia do tipo "5" e o funcionário ativo tiver uma nova chapa.
    Define o custo hora do funcionário, utilizado para cálculos financeiros.PFUNC.SALARIO / PFUNC.JORNADASalario hora
    Valor do salário do colaboradorPFUNC.SALARIOSalario do funcionário
    Definição de carga horáriaPFUNC.JORNADA_MENSALJornada Mensal do Funcionário.
    Preencher com a quantidade de horas mensais. Exemplo: 220
    Ponto ObrigatórioPFHSTUTILIZACAMPOAHGORA.UTILIZAPONTOEnviar true ou false.
    Data de troca da elegibilidade do registro de pontoPFHSTUTILIZACAMPOAHGORA.DTMUDANCAEnviar a data quando passou a utilizar ponto, ou quando deixou de utilizar ponto.
    Matrícula Chefia ImediataPFUNC.CODICOLIGADA + PFUNC.CHAPA

    Coligada + Chapa do chefe/supervisor do funcionário ou código do chefe/supervisor externo.

    As matrículas serão enviadas sem caracteres especiais.

    Para identificar o chefe/supervisor, é feita a verificação nas seguintes tabelas:

    • Chefe/Supervisor interno (quando o chefe/supervisor é um funcionário): PSUBSTCHEFE e PSUBSTSUP

    • Chefe/Supervisor externo (quando o chefe/supervisor não é funcionário): PCHEFEEXTERNO e PSUPERVEXTERNO

    Nome Chefia ImediataPFUNC.NOME

    Nome do chefe/supervisor do Funcionário, ou nome do chefe/supervisor externo.
    É permitido acentuação e caracteres especiais.

    Para identificar o chefe/supervisor, é feita a verificação nas seguintes tabelas:

    • Chefe/Supervisor interno (quando o chefe/supervisor é um funcionário): PSUBSTCHEFE e PSUBSTSUP

    • Chefe/Supervisor externo (quando o chefe/supervisor não é funcionário): PCHEFEEXTERNO e PSUPERVEXTERNO

    e-mail Chefia ImediataPPESSOA.EMAIL

    E-mail do chefe/supervisor do funcionário ou e-mail do chefe/supervisor externo.

    Para identificar o chefe/supervisor, é feita a verificação nas seguintes tabelas:

    • Chefe/Supervisor interno (quando o chefe/supervisor é um funcionário): PSUBSTCHEFE e PSUBSTSUP

    • Chefe/Supervisor externo (quando o chefe/supervisor não é funcionário): PCHEFEEXTERNO e PSUPERVEXTERNO

    Código do SindicatoPFUNC.CODSINDICATOCódigo do Sindicato do funcionário
    Data da alteração do código do sindicatoPFSINDIC.DTMUDANCAData da mudança do Sindicato do Funcionário.
    TelefonePPESSOA.TELEFONE2Número do Telefone Celular. Permite caracteres especiais.
    PisPFUNC.PISPASEPPreencher comtrue quando não tiver o PIS cadastrado e false quando tiver PIS cadastrado.
    codInternoPFUNC.CHAPAColigada + Chapa
    Chapa do Funcionário.
    Não pode haver matricula repetida na mesma coligada.
    matricula_anteriorPFUNC.CHAPAORIGEM

    Preencher com a chapa do registro demitido.
    Este campo deve ser preenchido quando houve transferência do tipo "5" e o funcionário ativo tiver uma nova chapa.

    Veja mais detalhes no link DT - Integração RM X Ahgora - Tratativa para Transferido

    Define o custo hora do funcionário, utilizado para cálculos financeiros.PFUNC.SALARIO / PFUNC.JORNADASalario hora
    Valor do salário do colaboradorPFUNC.SALARIOSalario do funcionário


    1-1 - MAPEAMENTO (DE/PARA) DO CAMPO REGIME DE TRABALHO DO FUNCIONÁRIO

    DESCRIÇÃO NA AHGORARM - CAMPO TIPO DE RECEBIMENTO
    autonomoA - Autônomo
    CLTN - Normal (Exceto para Categoria 106 ou Tipo de Recebimento H)
    R - Rural ou
    U - Outros ou
    I - Cedido ou
    V - Contrato verde/Amarelo ou
    X - Expatriado
    comissionadoO - Comissionista ou
    M - Misto
    conselheiroC - Conselheiro
    estagiarioT - Estagiário
    estatutarioE - Estatutário
    folhaconfidencialD - Diretor
    horistaN - Normal e Tipo de Recebimento H
    intermitenteN - Normal e Categoria 106
    menoraprendizZ - Aprendiz
    pensaovitaliciaS - Pensionista ou
    W - Beneficiário
    rdaNão tem mapeamento no RM
    temporarioP - Temporário ou
    B - Temporário ou
    F - Temporário/Comissionista
    terceirizadoNão tem mapeamento no RM


    2 - AFASTAMENTOS

    Descrição / Regra
    DESCRIÇÃO AHGORACAMPO DA TABELA RMDESCRIÇÃO | REGRADescrição AhgoraCampo Tabela RM
    Identificação do colaboradorPFHSTAFT.CHAPA
    PFUFERIASPER.CHAPA
    Coligada + Chapa (As matrículas serão enviadas sem caracteres especiais)
    Matricula do Funcionário.
    Busca da tabela de Afastamento e de Férias.
    Motivo do AfastamentoPFHSTAFT.TIPO ou
    F quando for férias
    Coligada + Tipo de Afastamento.
    Quando for férias enviar
    F
    Terá um cadastro prévio na AHGORA igual do RM.
    Data e/ou hora Inicial do AfastamentoPFHSTAFT.DTINICIO
    PFUFERIASPER.DATAINICIO
    Data inicio do afastamento ou do gozo das férias.
    Informar a hora 00:00. YYYY-MM-DDTHH:MM
    Data e/ou hora Final do AfastamentoPFHSTAFT.DTFINAL
    PFUFERIASPER.DATAFIM
    Data inicio do afastamento ou do gozo das férias. YYYY-MM-DDTHH:MM
    Informar 24:00 quando for o dia integral. Caso não tenha data fim, deverá enviar vazio. A Ahgora irá preencher com da fim 31/12/2050, quando chegar vazio.
    Código interno do AfastamentoCHAVE

    Informar a chave única para definir se a operação será de inclusão ou alteração. Verificar se a chave pode ser composta por Coligada + Chapa + Data de Início.

    Tratativa na Ahgora: Se a chave já existir, o sistema substitui; caso contrário, realiza a inclusão.


    3 - RESULTADO

    Campo Tabela
    CAMPO DA TABELA RM
    Descrição AhgoraDescrição / Regra
    DESCRISÇÃO NA AHGORADESCRIÇÃO | REGRA
    PFMOVTEMP.CHAPAmatriculaPode ser alfanumérica
    Campo matrícula(As matrículas serão enviadas sem caracteres especiais)
    PFMOVTEMP.ANOCOMPanocomPadrão AAAA
    PFMOVTEMP.MESCOMPmescomPadrão MM
    Exemplo: Janeiro enviar 01
    -campoAdicionalInformação do campo adicional no PW
    Não é obrigatório
    PFMOVTEMP.;CODEVENTOrubricaSerá cadastrado no PW igual o sistema de destino
    PFMOVTEMP.HORA
    PFMOVTEMP.REF
    Horas ou Referencia

    Poderá enviar em horas ou dias, dependente da configuração do evento no RM.

    Exemplo:

      • Dias: 3 dias => enviar 3. Número inteiro.
      • Horas: 1h30min => enviar 1,30. As horas sãosexagesimal (separador ",") 

    ATENÇÃO: Ao salvar a hora neste campo, o sistema realiza a conversão automática de horas para minutos.

    Exemplo: Caso o Ponto Web Ahgora envie 1,04 horas, ao gravar na tabela PFMOVTEMP.HORA, o sistema fará o seguinte cálculo de conversão:

        • 1 hora = 60 minutos

        • 0,04 horas = 4 minutos

        • Total: 64 minutos


    Esse valor (64) será salvo no campo PFMOVTEMP.HORA. No entanto, na visualização do menu Folha Mensal | Consulta | Consulta Movimento da Integração, continuará aparecendo como 1,04, pois o sistema converte os minutos de volta para o formato hora.decimal apenas para exibição.


    4 - LISTAGEM DE EVENTOS/VERBAS

    Campo Tabela Descrição / Regra
    CAMPO DA TABELA RMDescrição AhgoraDESCRISÇÃO NA AHGORADESCRIÇÃO | REGRA
    PEVENTO.CODIGOCódigo da rubricaCampo alfanumérico.
    PEVENTO.DESCRICAODescrição da rubricaDescrição do evento.
    GCOLIGADA.CGCCNPJ da empresaCNPJ da coligada.
    PEVENTO.PROVDESCBASECategoria da rubrica

    Provento/Desconto - Utilizado para compor campo 'categoria' da api 'api/rh/v1/ahgora/verbas'; PEVENTO.PROVDESCBASE + '-' + PEVENTO.VALHORDIAREF).

    Exemplo: 'Provendo-Valor'.

    PEVENTO.VALHORDIAREFCategoria da rubrica

    Valor/Hora/Dia/Referência - Utilizado para compor campo 'categoria' da api 'api/rh/v1/ahgora/verbas'; PEVENTO.PROVDESCBASE + '-' + PEVENTO.VALHORDIAREF).

    Exemplo: 'Provendo-Valor'.


    5 - LISTAGEM DE SINDICATOS

    Campo Tabela Descrição / Regra
    CAMPO DA TABELA RMDescrição AhgoraDESCRISÇÃO NA AHGORADESCRIÇÃO | REGRA
    PSINDIC.CODIGOCódigo do sindicatoCampo alfanumérico.
    PSINDIC.NOMEDescrição do sindicatoNome do sindicato.
    GCOLIGADA.CGCCNPJ da empresaCNPJ da coligada.
    Card
    id4
    labelVideos
    titleVideos

    Vídeos RM

    How To | Linha RM integração com a Ahgora Parte 1 #TOTVS_RH_Linha_RM - Parametrizaçõeshttps://youtu.be/4DIaY1flp50
    How To | Linha RM integração com a Ahgora Parte 2 #TOTVS_RH_Linha_RM - Integração Folha X Ponto Webhttps://youtu.be/h9i8oQWtARE
    How To | Linha RM integração com a Ahgora Parte 3 #TOTVS_RH_Linha_RM - Exclusão dos Envioshttps://youtu.be/HFS_U7A4gho
    How To | Linha RM integração com a Ahgora Parte 4 #TOTVS_RH_Linha_RM - Agendamento Jobhttps://youtu.be/XahxvJGw-vo
    How To | Linha RM integração com a Ahgora Parte 5 #TOTVS_RH_Linha_RM - Apuração de Resultadoshttps://youtu.be/RCYPyp3MWtc
    How To | Linha RM integração com a Ahgora Parte 6 #TOTVS_RH_Linha_RM - Campo Localizaçõeshttps://youtu.be/K7_k1CNMJ7k


    Vídeos Ahgora - Ponto Web

    How To | PW - Ponto Web Ahgora integração com Linha RM Parte 1 #TOTVS_RH_Linha_RM - Cadastros de Códigos Internos das Escalashttps://youtu.be/QhUh7WPoZI4
    How To | PW - Ponto Web Ahgora integração com Linha RM Parte 2 #TOTVS_RH_Linha_RM - Cadastros de Códigos dos Centros de Custoshttps://youtu.be/8gEbO6oYM4M
    How To | PW - Ponto Web Ahgora integração com Linha RM Parte 6 #TOTVS_RH_Linha_RM - Cadastros de Códigos Internos dos Motivos de Afastamentoshttps://youtu.be/pv15MK8ZLGA
    How To | PW - Ponto Web Ahgora integração com Linha RM Parte 7 #TOTVS_RH_Linha_RM - Cadastros de Códigos Contábeis das Horas Adicionais dos Sindicatoshttps://youtu.be/sRQXBuo0uGs



    ...