Histórico da Página

CONTEÚDO CONTEÚDO

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

...

Informações

icon	false

A partir dos patches:

- 12.1.24112503.31
- 12.1.24072411.96
- 12.1.24032407.1512
- ou superiores.

02. VISÃO GERAL

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

...

Deck of Cards

id	1

Antes da integração, é necessário que os cadastros básicos já existam no sistema da Ahgora. Abaixo estão os dados e onde encontrá-los no RH Datasul:

- Eventos (Código Contábil Ahgora) - FP0020 - Manutenção Eventos - Analíticos
  - A informação deve ser concatenada com o código da empresa. Além disso, é necessário incluir a descrição do evento.
  - Para empresas que não utilizam eventos por empresa, a concatenação deve ser feita com o código da empresa do funcionário, em vez de usar um asterisco.
  - Exemplo: Empresa 10, evento 103 = "10103 - Horas Extras Noturnas (50%)".
- Turno (Escala Ahgora) - FP1400- Manutenção Turno de Trabalho
  - O turno é definido por banco e deve ser utilizado apenas o código do turno cadastrado no programa FP1400. Além disso, é necessário incluir a descrição correspondente do turno.
  - Exemplo: "103 - Produção - 07:30 as 17:30".
- Sindicato - FP0600 - Manutenção Sindicatos
  - O sindicato é definido por banco e deve ser utilizado apenas o código do sindicato cadastrado no programa FP0600. Além disso, é necessário incluir a descrição correspondente do sindicato.
  - Exemplo: "18 - SINDICATO DOS TECNOLOGOS".
- Centro de Custo - FP0660 - Manutenção Centros de Custo
  - O código de centro de custo precisa ser concatenada com o código da empresa do funcionário. Além disso, é necessário incluir a descrição do centro de custo.
  - Exemplo: Empresa 10, Centro de Custo 0040100 = "10004100 - Administração".
- Afastamento - FP0060 - Manutenção Situações
  - A situação de afastamento é definido por banco e deve ser utilizado apenas o código da situação cadastrado no programa FP0060. Além disso, é necessário incluir a descrição correspondente da situação.
  - Exemplo: "29 - Afastado por Doença Horas".

Card

default	true
id	1
label	Parametrização
title	Parametrizaçã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
    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".

Image Removed

Utiliza Ponto Ahgora
1. Na aba Cadastral, na inclusão ou alteração dos dados do funcionário, pode ser manutenido os dados para integração.
  1. Nas informações dos campos Utiliza Ponto Ahgora, temos
    - Ponto Obrigatório, para quem deve registrar o ponto.
    - Ponto Livre, para quem não precisa registrar o ponto.
    - Data Elegibilidade Ponto, data relacionada ao dado do campo bate ponto "ponto obrigatório ou livre", data que inicia a elegibilidade do ponto.

Image Removed

Card

id	2
label	Parametrização Ahgora
title	Parametrização Ahgora

1. 1. 1. 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.
        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 Added

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 Added

- 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 Added
  O programa possui opções de seleção por Empresa, Estabelecimento, Matrícula e Cargo Considera Demitidos e Data de referencia .
  - Se o cliente utiliza o ponto da TOTVS
    Ele pode selecionar a opção "Bate Entrada/Saída PE1700". Nesse caso, o programa buscará automaticamente as informações na Tela PE1700, aba Cálculo, campo " Bate Entrada/Saída".
    - Se o campo estiver marcado, o sistema definirá "Ponto Obrigatório".
    - Caso contrário, será atribuído "Ponto Livre".
    - O campo "Data Eleg. Ponto" será ajustado conforme a informação disponível na tela.
  - Se o cliente não utiliza o PE1700
    Ele poderá selecionar manualmente entre as opções "Ponto Obrigatório" ou "Ponto Livre".
  Ao final da execução, será gerado um arquivo .csv contendo a lista de funcionários ajustados.

Card

id	2
label	Parametrização Ahgora
title	Parametrização Ahgora

Antes da integração, é necessário que os cadastros básicos já existam no sistema da Ahgora. Abaixo estão os dados e onde encontrá-los no RH Datasul:

- Eventos (Código Contábil Ahgora) - FP0020 - Manutenção Eventos - Analíticos
  - Utilizar o código do evento.
  - Tabelas e Campos:
    - event_fp.cdn_event_fp
    - event_fp.des_event_fp
      - Obs.: No retorno dos resultados, programa dá prioridade para empresa do usuário, caso não encontre evento, utiliza o asterisco.
- Turno (Escala Ahgora) - FP1400- Manutenção Turno de Trabalho
  - O turno é definido por banco e deve ser utilizado apenas o código do turno cadastrado no programa FP1400. Além disso, é necessário incluir a descrição correspondente do turno.
  - Tabela e Campos:
    - turno_trab.cdn_turno_trab
    - turno_trab.des_turno_trab
- Sindicato - FP0600 - Manutenção Sindicatos
  - O sindicato é definido por banco e deve ser utilizado apenas o código do sindicato cadastrado no programa FP0600. Além disso, é necessário incluir a descrição correspondente do sindicato.
  - Tabelas e Campos:
    - sindicato.cdn_sindicato
    - rh_pessoa_jurid.nom_pessoa_jurid
- Centro de Custo - FP0660 - Manutenção Centros de Custo
  - O código de centro de custo é por empresa e precisa código da empresa onde ele esta cadastrado. Além disso, é necessário incluir a descrição do centro de custo.
  - Tabela e Campos:
    - rh_ccusto.cdn_empresa
    - rh_ccusto.cod_rh_ccusto
    - rh_ccusto.des_rh_ccusto
- Afastamento - FP0060 - Manutenção Situações
  - A situação de afastamento é definido por banco e deve ser utilizado apenas o código da situação cadastrado no programa FP0060. Além disso, é necessário incluir a descrição correspondente da situação.
  - Tabela e Campos:
    - sit_afast.cdn_sit_afast_func
    - sit_afast.des_sit_afast_func

De/Para

1 - FUNCIONÁRIOS

PFHSTHOR.CODHORARIOPreencher comtrue quando não tiver o PIS cadastrado e false quando tiver PIS cadastrado.

2 - AFASTAMENTOS

3 - EXCLUSÃO DE AFASTAMENTOS

Card

id	3
label	Integração
title	Integração

Para acessar o novo programa de integração dos produtos do RH Datasul com a Ahgora, vá ao menu e procure, por exemplo, pela palavra 'Ahgora'. Em seguida, será exibido o programa 'Integração Ahgora'.

Ao executar esse programa, será apresentada a aplicação com o menu 'Integração Ahgora', contendo itens como Funcionários e Afastamentos. No menu seguinte, 'Exclusão Ahgora', encontra-se a opção Afastamentos.

A seguir, detalharemos um pouco mais cada uma dessas opções.

Image Added

Deck of Cards

id	Integração

Card

default	true
id	3-1
label	Funcionários
title	Funcionários

Informações

title	Atualização Cadastral

Para que os dados do funcionário sejam carregados na tela de integração com a Ahgora, é necessário que haja alguma alteração nos dados cadastrais do funcionário.

- Abaixo estão listados os campos em que essa situação pode ocorrer:
  - Admissão
  - Nome
  - PIS
  - Data de Demissão
  - Alteração do Turno
  - CTPS
  - Alteração do Cargo
  - Alteração da Unidade de Lotação
  - Sexo
  - E-mail
  - CPF
  - RG
  - Transferência do Funcionário
  - Alteração do Centro de Custo
  - Data de Nascimento
  - Bate Ponto
  - Data de Troca de Elegibilidade do Ponto
  - Alteração do Chefe Imediato
  - Alteração de Sindicato
  - Telefone

Informações da tela

- Na tela inicial, são apresentados filtros básicos para a seleção dos funcionários que serão enviados. Por padrão, o campo 'Data Admissão De' vem preenchido com um mês anterior à data atual, enquanto o campo 'Data Admissão Até' é preenchido com a data atual.
- Os filtros 'Estabelecimento' e 'Data Admissão De' são obrigatórios.

Image Added

Card

id	3
label	Integração
title	Integração

Para acessar o novo programa de integração dos produtos do RH Datasul com a Ahgora, vá ao menu e procure, por exemplo, pela palavra 'Ahgora'. Em seguida, será exibido o programa 'Integração Ahgora'.

Ao executar esse programa, será apresentada a aplicação com o menu 'Integração Ahgora', contendo itens como Funcionários e Afastamentos. No menu seguinte, 'Exclusão Ahgora', encontra-se a opção Afastamentos.

A seguir, detalharemos um pouco mais cada uma dessas opções.

Image Removed

Deck of Cards

id	Integração

Para que os dados do funcionário sejam carregados na tela de integração com a Ahgora, é necessário que haja alguma alteração nos dados cadastrais do funcionário.

- Abaixo estão listados os campos em que essa situação pode ocorrer:
  - Admissão
  - Nome
  - PIS
  - Data de Demissão
  - Alteração do Turno
  - CTPS
  - Alteração do Cargo
  - Alteração da Unidade de Lotação
  - Sexo
  - E-mail
  - CPF
  - RG
  - Transferência do Funcionário
  - Alteração do Centro de Custo
  - Data de Nascimento
  - Bate Ponto
  - Data de Troca de Elegibilidade do Ponto
  - Alteração do Chefe Imediato
  - Alteração de Sindicato
  - Telefone

Informações da tela

- Na tela inicial, são apresentados filtros básicos para a seleção dos funcionários que serão enviados. Por padrão, o campo 'Data Admissão De' vem preenchido com um mês anterior à data atual, enquanto o campo 'Data Admissão Até' é preenchido com a data atual.
- Os filtros 'Estabelecimento' e 'Data Admissão De' são obrigatórios.

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
  - Matrícula Ahgora: Código da empresa + estabelecimento + matricula.
  - Nome: Nome do funcionário.
  - Dt. Admissão: Data de admissão.
  - Dt. Demissão: Data de demissão.
  - Turno: Código do turno do funcionário.
  - Cargo: Código do cargo do funcionário.
  - Movimento: Inclusão/Alteração (status alteração ocorrerá sempre que o primeiro cadastro já tenha sido enviado para Ahgora).
  - Dt. Movimento: Data da movimentação (envio a Ahgora).

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

- 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

Card

default	true
id	3-1
label	Funcionários
title	Funcionários

Card

id	3-2
label	Afastamentos
title	Afastamentos

Informações

title	Inclusão/Alteração do Afastamento

Para que a situação de afastamento seja carregada na tela de integração com a Ahgora, é necessário realizar a inclusão ou alteração do afastamento do funcionário.

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 Modified. Nesta opção é possível realizar mais alguns filtros específicos além dos filtros já apresentados na tela principal.

Image RemovedImage Added

- Após aplicarmos os filtros, será apresentada a seguinte tela:

- - Status: Correspondente ao status do registro
  - IN - Integrado.
  - NI - Não Integrado.
  - CI - Com Inconsistência.
  - AR - Aguardando Retorno.
  - Matrícula Ahgora: Código da empresa + estabelecimento + matricula.
  - Nome: Nome do funcionário.
  - Tipo do afastamento: Situação e descrição do afastamento.
  - Dt. Início: Inicio do afastamento.
  - Dt. Fim: Fim do afastamento.

Image Removed

- - 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 Added

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

Image Removed

Image Added

Image RemovedImage Added

- 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 RemovedImage AddedImage Added

- 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 AddedImage Added

Image Removed

card

Card

id	3-32
label	Exclusão Afastamentos
title	Exclusão Afastamentos

Informações

title	Exclusão Inclusão/Alteraçã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

realizar a inclusão ou alteração do 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

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 Added

- Para mais filtros, é necessário acessar a opção de Image Added. Nesta opção 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

Image Added

- Após aplicarmos os filtros será apresentada a seguinte tela:

- - Status: Correspondente ao status do registro
    - IN - Integrado.
    - NI - Não Integrado.
    - CI - Com Inconsistência.
    - AR - Aguardando Retorno.
  - Matrícula Ahgora: Código da empresa + estabelecimento + matricula.
  - Nome: Nome do funcionário.
  - Tipo do afastamento: Situação e descrição do afastamento.
  - Dt. Início: Inicio Início do afastamento.
  - Dt. Fim: Fim do afastamento.

Image Removed

Image Added

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

Image RemovedImage AddedImage Removed

Image Added

- 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 Removed

Image Added

- 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 Added

id	3-4
label	Agendamento do processo
title	Agendamento do processo

Card

id	3-53
label	Apuração de ResultadosExclusão Afastamentos
title	Apuração de Resultados

Card

Exclusão Afastamentos

Informações

id

4

label

title

De/Para

Card

id	1
label	De/Para
title	De/Para

Descrição Ahgora

Campo Tabela RM

Descrição / Regra

Identificação do colaborador

PFUNC.CODICOLIGADA + PFUNC.CHAPA

Coligada + 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ário

PPESSOA.NOME

Nome do Funcionario, ou nome do chefe externo.
É permitido acentuação e caracteres especiais.

PIS do Funcionário

PFUNC.PISPASEP

Numero 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-Social

PFUNC.MATRICULAESOCIAL

Matricula do eSocial

Data em que o Funcionário foi Admitido

PFUNC.DATAADMISSAO

Data de Admissão. DD/MM/AAAA
Para o chefe externo deverá ser a data de inicio.

Data de Demissão

PFUNC.DATADEMISSAO

Data 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ário

Formula na tela do processo

Adicionar 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

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/turno

PFHSTHOR.DTMUDANCA

Data da Mudança do Horário do Funcionário.
Preencher com o último existente no histórico de horário.

Tipo de Escala de Trabalho

NÃO ENVIAR

Não existe essa informação na folha de pagamento.

Carteira de Trabalho

PPESSOA.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 Cargo

PHSTFCO.CODFUNCAO

Funçã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ário

PFUNC.CODSECAO

Seção do funcionário
Concater o Código + Descrição, separando com traço "-". Exemplo: 01.01.03-DEPARTAMENTO PESSOAL

Gênero do Funcionário

PPESSOA.SEXO

Sexo do Funcionário.
Preencher com F ou M.

E-mail do Funcionário

PPESSOA.EMAIL

Email do funcionário.
Múltiplos vínculos ter um email por funcionário, não pode ser repetido.

CPF do Funcionário

PPESSOA.CPF

CPF do Funcionário.
Preencher sem caracteres. Exemplo: 11122233344.
Para chefe externo busca tbm o CPF

RG do Funcionário

PPESSOA.CARIDENTIDADE

Carteira de Identidade.
Preencher apenas com o RG, podendo ter caracteres.
Exemplo: M-7.7777

CNPJ da filial do Funcionário

PSECAO.CGC (JOIN) PFUNC.CODSECAO

CNPJ da Seção do funcionário.
Preencher apenas com numeros, sem caracteres.

Data da atribuição do CNPJ da empresa ao funcionário

PFUNC.DTTRANSFERENCIA

Data da Transferencia entre filiais ou coligada.

Código do centro de custo do funcionário

PSECAO.NROCENCUSTOCONT

Coligada + Código do Centro de Custo da Seção do Funcionário.

Regime de Trabalho do Funcionário

DE/PARA NO PARAMETRIZADOR DO RM

Buscar 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ário

PPESSOA.DTNASCIMENTO

Data de Nascismento. DD/MM/AAAA

Data de Alteração de Cargo

PHSTFCO.DTMUDANCA

Data 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ária

PFUNC.JORNADA_MENSAL

Jornada Mensal do Funcionário.
Preencher com a quantidade de horas mensais. Exemplo: 220

Ponto Obrigatório

PFHSTUTILIZACAMPOAHGORA.UTILIZAPONTO

Enviar true ou false.

Data de troca da elegibilidade do registro de ponto

PFHSTUTILIZACAMPOAHGORA.DTMUDANCA

Enviar a data quando passou a utilizar ponto, ou quando deixou de utilizar ponto.

Matrícula Chefia Imediata

PFUNC.CODICOLIGADA + PFUNC.CHAPA

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

Nome Chefia Imediata

PFUNC.NOME

Nome do chefe do Funcionario, ou nome do chefe externo.
É permitido acentuação e caracteres especiais.

e-mail Chefia Imediata

PPESSOA.EMAIL

Email do chefe do funcionário ou email do chefe externo do funcionário.

Código do Sindicato

PFUNC.CODSINDICATO

Coligada + Código do Sindicato do funcionário

Data da alteração do código do sindicato

PFSINDIC.DTMUDANCA

Data da mudança do Sindicato do Funcionário.

Telefone

PPESSOA.TELEFONE2

Número do Telefone Celular. Permite caracteres especiais.

Pis

PFUNC.PISPASEP

codInterno

PFUNC.CHAPA

Coligada + 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_anterior

PFUNC.CHAPAORIGEM

Preencher 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.JORNADA

Salario hora

Valor do salário do colaborador

PFUNC.SALARIO

Salario do funcionário

Descrição Ahgora

Campo Tabela RM

Descrição / Regra

Identificação do colaborador

PFHSTAFT.CHAPA
PFUFERIASPER.CHAPA

Coligada + Chapa
Matricula do Funcionario.
Busca da tabela de Afastamento e de Férias.

Motivo do Afastamento

PFHSTAFT.TIPO ou
F quando for férias

Coligada + Tipo de Afastamento.
Quando for férias enviar F
Terá um cadastro previo na AHGORA igual do RM.

Data e/ou hora Inicial do Afastamento

PFHSTAFT.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 Afastamento

PFHSTAFT.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 Afastamento

CHAVE

Informar a chave unica para identificar se irá incluir ou alterar. Verificar se pode ser Coligada + Chapa + Data Inicio.
Tratativa da Ahgora: Se já existir a chave ele susbstitui, senao inclui.

Campo Tabela RM

Descrição Ahgora

Descrição / Regra

PFMOVTEMP.CHAPA

matricula

Pode ser alfanumerica
Campo matrícula

PFMOVTEMP.ANOCOMP

anocom

Padrão AAAA

PFMOVTEMP.MESCOMP

mescom

Padrão MM
Ex. Janeiro enviar 01

-

campoAdicional

Informação do campo adicional no PW
Não é obrigatório

PFMOVTEMP.;CODEVENTO

rubrica

Será cadastrado no PW igual o sistema de destino

PFMOVTEMP.HORA
PFMOVTEMP.REF

referencia

Horas sexagesimal (serparador ",")
Ex: 1h30min, enviar 1,30
Dias em número inteiro
Ex: 3 dias, enviar 3

04. DOCUMENTAÇÃO

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

...

Exclusão do Afastamento

Para que a exclusão da situação de afastamento seja carregada na tela de integração com a Ahgora, é necessário eliminar a situação de afastamento do funcionário.

Informações da tela

- Na tela inicial, são apresentados filtros básicos para a seleção dos afastamento que serão enviados. Por padrão, o campo 'Data Exclusão De' vem preenchida com um mês anterior que a data atual e a 'Data Exclusão Até' com a data atual.
- Os filtros de 'Estabelecimento' e 'Data Exclusão De' são obrigatórios.

Image Added

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

Image Added

- 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 Added

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

Image Added

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

Image Added

- Ao final da atualização, o status do registro será alterado conforme o resultado:
  - Sem inconsistências: O status será atualizado para 'IN - Integrado', com a mensagem 'Registro integrado com sucesso.'
  - Com inconsistências: O status será atualizado para 'CI - Com Inconsistências'. Nesse caso, o erro pode ser consultado na opção 'Status', acessível ao clicar nos três pontos localizados à direita da tabela.

Card

id	3-4
label	Agendamento
title	Agendamento do processo

Informações da Tela

Para facilitar o envio e recebimento das informações, criamos o programa FP7820, que sincronizar as informações do funcionário, afastamento e exclusão do afastamento.

Temos na aba de seleção:

- Faixa de Estabelecimento: Podemos informar uma faixa De/Até do Estabelecimento.
- Faixa de Matricula: Podemos informar uma faixa De/Até da Matricula.
- Período para Sincronização (Hoje -) x dias: Programa considera a data de hoje menos 30 dias (ou valor informado em tela);
  - Inicio do Afastamento, data de hoje - 30 (ou valor informado em tela). Ex.: 15/12/2024 .
  - Termino do Afastamento, data de hoje. Ex.: 14/01/2025 .

Image Added

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 Added

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

Image Added

Temos na aba de impressão:

- Padrão já utilizada pelo Datasul.

Image Added

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

Image Added

Informações

title	Execução

Para o Afastamento, programa também utiliza a data de sincronização da aba de seleção, onde o filtro em que a data de início do afastamento seja menor ou igual à data de hoje, e a data de término do afastamento seja maior ou igual à data de hoje menos 30(ou valor informado em tela).

Card

id	3-5
label	Apuração de Resultados
title	Apuração de Resultados

Informações

Para a apuração dos resultados obtidos no PontoWeb, é necessário realizar a parametrização e a execução dos dados por meio da integração de Resultados do Integrador 2.0 da Ahgora PontoWeb com o RH Datasul, seguindo a documentação correspondente.

Segue parte importante necessária para parametrização, para mais detalhes pode ser consultado no link abaixo.

- Tipo de requisição: POST
- Endpoint: api/rh/ahgora/v1/results
- Autenticação: Basic Authentication
  - Para autenticação com o RH Datasul, basta ter um usuário com permissões da acesso as informações do funcionário, e utilizar o Basic Authentication usuário e senha.
  - Sugestão que seja um usuário genérico, para evitar recadastro caso ocorra alteração de permissões de usuário.
  - Tarefas Integração dos Resultados - Ahgora PontoWeb X RH Datasul

Deck of Cards

id	Apuração de Resultados

Card

default	true
id	3-5-1
label	Cálculo
title	Cálculo

Informações

title	Parametrizaçõ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 Added

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

Image Added

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

Image AddedImage Added

Informações

title	Importante

Após o cálculo dos valores do funcionário, não será possível reintegrar os dados. Para permitir uma nova integração, é necessário eliminar o cálculo da Folha Normal ou da Rescisão.

Card

id	3-5-2
label	Afastamento
title	Afastamento

Com a apuração dos resultados obtidos no PontoWeb, surgiu a necessidade de criar a situação de afastamento registrada no ponto. Dessa forma, o sistema passa a tratar automaticamente as faltas injustificadas.

Os dados apurados no PontoWeb são enviados nos resultados, onde o programa identifica as faltas injustificadas por meio da datafalta. Com isso, ele faz uma leitura no banco de dados para identificar a primeira situação de afastamento classificada como 'falta injustificada' no FP0060. Em seguida, verifica se o evento enviado está relacionado a essa situação de afastamento nos campos 'Afastamento Diurno' ou 'Afastamento Noturno', tanto para mensalistas quanto para horistas.

Se essa condição for atendida, o programa cria automaticamente a situação de afastamento no FP1600.

Tela com os dados parametrizados para recebimentos da situação de afastamento.

Image Added

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

Image Added

- 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

id	4
label	De/Para
title	De/Para

Card

id	1
label	De/Para
title	De/Para

1 - FUNCIONÁRIOS

Descrição	Campo Tabela RH Datasul	Descrição / Regra
Identificação do colaborador	funcionario.cdn_empresa + funcionario.cdn_estab + funcionario.cdn_funcionario	Matricula do Funcionário Enviar concatenado Empresa + Estabelecimento + Matricula
Nome do Funcionário	funcionario.nom_pessoa_fisic	Nome do Funcionário
PIS do Funcionário	funcionario.cod_pis	Numero do PIS do Funcionário
Matrícula do E-Social	sped_participan.cod_matr_sped	Matricula do eSocial
Data em que o Funcionário foi Admitido	funcionario.dat_admis_func	Data de Admissão
Data de Demissão	funcionario.dat_desligto_func	Data de Demissão
Código da escala/ turno do funcionário	funcionario.cdn_turno_trab	Turno do Funcionário
Data da alteração de escala/turno	func_turno_trab.dat_inic_lotac_func_turno_trab	Data do ultimo histórico de turno
Tipo de Escala de Trabalho	turno_trab.idi_period_turno_trab	Enviar sempre as horas padrão mensal do FP1400
Carteira de Trabalho	funcionario.cod_cart_trab - funcionario.cod_ser_cart_trab - funcionario.cod_unid_federac_cart_trab	Carteira de Trabalho do Funcionário
Título do Cargo	funcionario.cdn_cargo_basic + cargo.des_cargo	Código do Cargo + descrição
Descrição do departamento do Funcionário	funcionario.cod_unid_lotac	Código da Lotação + descrição
Gênero do Funcionário	rh_pessoa_fisic.idi_sexo	Sexo
E-mail do Funcionário	rh_pessoa_fisic.nom_e_mail rh_pessoa_fisic.nom_mail_contat	E-mail e E-mail contato. Prioriza o informado e se ambos, considera o e-mail
CPF do Funcionário	rh_pessoa_fisic.cod_id_feder	CPF, sem caracteres
RG do Funcionário	rh_pessoa_fisic.cod_id_estad_fisic	Carteira Identidade
CNPJ da filial do Funcionário	rh_pessoa_jurid.cod_id_feder	CNPJ da Pessoa Juridica do estabelecimento sem caracteres
Data da atribuição do CNPJ da empresa ao funcionário	funcionario.dat_admis_transf_func	Data da transferência entre estabelecimentos
Código do centro de custo do funcionário	funcionario.cdn_empresa funcionario.cod_rh_ccusto	Centro Custo concatenado com Empresa + Código Centro de Custo
Regime de Trabalho do Funcionário	funcionario.idi_tip_func	DE/PARA dos tipos conforme regra da Ahgora, dados preenchidos pela descrisão
Data de Nascimento do Funcionário	rh_pessoa_fisic.dat_nascimento	Data Nascimento
Data de Alteração de Cargo	histor_sal_func.dat_liber_sal	Data da transferência entre cargos. Sempre considerado o último
Definição de carga horária	turno_trab.qtd_hrs_padr_mes_rh	Quantidade de horas mês
Ponto Obrigatório	func_aux_func.idi_elig_ponto	Disponível somente quando habilita o produto do ponto
Data de troca da elegibilidade do registro de ponto	func_aux_func.dat_troca_elig_ponto	Enviar a data quando passou a utilizar ponto, ou quando deixou de utilizar ponto.
Matrícula Chefia Imediata		Enviar a matricula do líder imediato da tabela de permissões
Nome Chefia Imediata		Nome do líder imediato
e-mail Chefia Imediata		e-mail líder imediato
Código do Sindicato	funcionario.cdn_sindicato	Código do Sindicato
Data da alteração do código do sindicato		Data da inclusão. Sempre considerado o último
Telefone	rh_pessoa_fisic.num_telefone rh_pessoa_fisic.num_telef_contat	Telefone do funcionário
PIS		Preencher com true quando não tiver o PIS cadastrado e false quando tiver PIS cadastrado.
codInterno	funcionario.cdn_empresa + funcionario.cdn_estab + funcionario.cdn_funcionario	Matricula do Funcionário Enviar concatenado com separador pipe "\|" Enviar concatenado Empresa + Estabelecimento + Matricula
Matricula Anterior		Preencher com a matricula do funcionário transferido.
Define o custo hora do funcionário, utilizado para cálculos financeiros.	histor_sal_func.val_salario_hora	Salário hora
Valor do salário do colaborador	funcionario.val_salario_atual	Caso o colaborar for mensalista, enviar o salário mensal Caso o colaborar for horista, enviar o salário da hora

2 - AFASTAMENTOS

Descrição	Campo Tabela RH Datasul	Descrição / Regra
Identificação do colaborador	funcionario.cdn_empresa + funcionario.cdn_estab + funcionario.cdn_funcionario + numero sequencial	Matricula do Funcionário Enviar concatenado Empresa + Estabelecimento + Matrícula
Motivo do Afastamento	sit_afast.cdn_sit_afast_func	Situação de Afastamento
Data e/ou hora Inicial do Afastamento	sit_afast_func.dat_inic_sit_afast sit_afast_func.num_horar_inic_sit_afast	Data inicio do afastamento Hora inicio: (00:00) Hora Final: (24:00)
Data e/ou hora Final do Afastamento	sit_afast_func.dat_term_sit_afast sit_afast_func.num_horar_term_sit_afast	Data fim do afastamento Sem data fim, enviar vazio.
Código interno do Afastamento	funcionario.cdn_empresa + funcionario.cdn_estab + funcionario.cdn_funcionario + numero sequencial	Sequência Afastamento Informar chave única para identificar. Concatenar informações(empresa, estabelecimento, matricula e Sequência).
Ação a ser realizada	Inclusão ou alteração é 'INS'

3 - EXCLUSÃO DE AFASTAMENTOS

Descrição	Campo Tabela RH Datasul	Descrição / Regra
Identificação do colaborador	funcionario.cdn_empresa + funcionario.cdn_estab + funcionario.cdn_funcionario + numero sequencial	Matricula do Funcionário Enviar concatenado Empresa + Estabelecimento + Matrícula
Motivo do Afastamento	sit_afast.cdn_sit_afast_func	Situação de Afastamento
Data e/ou hora Inicial do Afastamento	sit_afast_func.dat_inic_sit_afast sit_afast_func.num_horar_inic_sit_afast	Data inicio do afastamento Hora inicio: (00:00) Hora Final: (24:00)
Data e/ou hora Final do Afastamento	sit_afast_func.dat_term_sit_afast sit_afast_func.num_horar_term_sit_afast	Data fim do afastamento Sem data fim, enviar vazio)
Código interno do Afastamento	funcionario.cdn_empresa + funcionario.cdn_estab + funcionario.cdn_funcionario + numero sequencial	Sequência Afastamento Informar chave única para identificar. Concatenar informações(empresa, estabelecimento, matricula e Sequência).
Ação a ser realizada		Obrigatório o envio do DEL quando for exclusão de informação

Card

id	5
label	Documentação Relacionada
title	Documentação Relacionada

Card

id	1
label	Documentação

Card

id	6
label	Vídeos
title	Vídeos How To

Toggle Cloak

id	How To Linha Datasul

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

Cloak

id	How 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

id	How To Ahgora

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

Cloak

id	How 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).

Este vídeo irá demonstrar como realizar o cadastro de código contábil das horas adicionais no PW (PontoWeb) Ahgora para integração com a Linha Datasul (folha de pagamento).

Árvore de páginas

Versões comparadas

Versão antiga 18

Nova versão Atual

Chave

CONTEÚDO CONTEÚDO

02. VISÃO GERAL

04. DOCUMENTAÇÃO