Árvore de páginas

Carregando...

Versões comparadas

Chave

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

 CONTEÚDO

1. Versões
2.

...

Visão Geral
3. Parametrização e Exemplo de utilização

...

4. Documentação

01. VERSÕES

Informações
iconfalse

A partir dos patches:

    • 12.1.
  • 2403
    • 2503.
  • 2
    • 1
    • 12.1.
  • 2311
    • 2411.
  • 7
    • 6
    • 12.1.
  • 2307
    • 2407.
  • 13
    • 12
    • ou superiores.

02. VISÃO GERAL

Oferecer integração nativa entre o sistema de RH TOTVS Datasul e a Plataforma de Gestão de Desempenho Empresarial da Feedz by TOTVS. Isso garantirá sincronização para processos como avaliação de desempenho e PDI, agilizando as operações e promovendo maior integração entre eles.

03. EXEMPLO DE UTILIZAÇÃO

Os dados contratuais e movimentações dos funcionários armazenados no ERP poderão ser carregados e integrados à plataforma Feedz de forma online.

Os dados abrangidos na integração incluem:

    • Estabelecimento;
    • Empresa
    • Matricula do funcionário;
    • Cargo;
    • Unidade de Lotação;
    • Gestor direto e Colaborador;
    • Nome Social/Nome;
    • CPF;
    • E-mail;
    • Data de admissão;
    • Data de nascimento;
    • Data de demissão;
    • Tipo/Motivo de demissão.

04. FLUXO

 

...

id1
Card
id1
labelParametrização
titleParametrização
Informações
titleImportante

Se ocorrer o erro 'Secure Socket Layer (SSL) - Erro 54: unable to get local issuer certificate: for 4032bcee.0' durante o envio de um processo, será necessário parametrizar o certificado

...

defaulttrue
id2
labelIntegração TOTVS Feedz
titleSincronização

Ao acessar o programa Integração TOTVS Feedz - FP7800 no menu, você tem a opção de realizar integrações mais específicas, utilizando filtros conforme necessário. Isso pode ser feito aplicando seleção, parâmetros e impressão, conforme demonstrado na tela abaixo:

Informações
titleImportante

Segue abaixo alguns pontos importantes para integração do ERP Datasul TOTVS com a Plataforma Feedz.

  • E-mail: cadastrado na pessoa física - FP1440, é informação única por funcionário.
  • Nome Social: caso o nome social esteja informado campo Nome Social, no botão complemento do eSocial, no FP1440, a Feedz assume essa informação.
  • Múltiplos Vínculos: na plataforma Feedz, é permitido apenas um registro por pessoa. Portanto, ao integrar vários funcionários com o mesmo código de pessoa ou e-mail, a Feedz sobrescreverá e adotará o último cadastro integrado para o mesmo código de pessoa ou e-mail. Na Folha de Pagamento, a ordem de envio é baseada na data de admissão para o mesmo código de pessoa. Se a data de admissão for igual, a prioridade será determinada pela ordem no banco de dados.
  • Cargo, Unidade de Lotação e Estabelecimento:  essas informações sempre serão enviadas baseada na seleção do funcionário, ou seja essas informações só serão enviadas caso haja funcionários vinculadas a ela. Para consultar essas informações da Feedz, é preciso consultar os detalhes do funcionário.
  • Funcionário Transferido: Para funcionário com transferência no período. Não são enviadas as informações de desligamento da empresa origem, é somente atualizados as informações do funcionário com os dados atuais.
  • Geração do Lote de Envio : O envio é realizado por geração de lotes de 100 registros. 
    • Obs: Caso ocorra erro em algum registro do lote, este registro fica com erro, e os demais registro do lote serão processados. Caso seja gerado a consulta sem a marcação do campo "Imprimir Entidades" o lote em questão será apresentado com erro. Se marcado o campo "Imprimir Entidade" será demostrado o detalhamento do Lote com os registros processados e com erro.
  • Pasta Seleção:

Nesta tela o usuário informa a faixa de seleção para a consulta e ou sincronização.

Image Removed

  • Pasta Parâmetros:

Nesta tela o usuário informa os parâmetros para processar a consulta e ou sincronização.

    • Ambiente:
      • Produção/Sandbox: Indica qual ambiente as informações estão sendo integradas.
      • Chave de Integração: A chave é gerada para plataforma da Feedz. A utilização é pelo usuário, uma vez informado, não precisa ser informar novamente.

        Informações
        titleImportante

        Configuração Feedz para para geração do Token

        • Na tela Feedz, ir em Configurações / Integrações;
        • No campo Chave de Integração (API 2.0);
          • Clicar em Gerar Token;
        • No campo Ativar Integração ERP;
          • Em Sistema selecionar Datasul;
        • No campo Chave de Integração (API 2.0), copiar a chave gerada e colocar na tela de parâmetro do FP7800.
    • Ação:
      • Criar Processos: Indica que irá integrar as informações com base na pasta de seleção. É utilizado somente para a integração do funcionário.
      • Consultar Processos: Indica que irá fazer a consulta dos dados que tiveram o processo criado em "Criar Processos". Esse campo informado irá habilitar o campo de seleção em Consultar Processos/Data Inicio, inicial e final.

        Informações
        titleImportante

        Na tela Seleção pode ser informado o horário de inicio e término  do envio, desta forma o sistema é mais assertivo nos dados filtrados.

    • Relatórios:
      • Imprimir Entidades: Indica que na geração do arquivo .CSV, será gerado as informações dos registros processados e dos que tiveram erro durante a consulta do processamento.

Image Removed

  • Pasta Impressão:

Nesta tela o usuário informa os parâmetros para impressão em desktop ou em RPW.

Image Removed

Informações
titleInformações Técnicas

Para analisar do log, incluímos o localizador "PM_Feedz", isso facilitará a analise das informações, quais e por onde a integração passou pelos programas.

Image Removed

Informações
titleImportante

ATENÇÃO: Para evitar impacto na performance, recomenda-se que o agendamento seja programado para, no máximo, duas vezes ao dia.

...

id3
labelDe/Para
titleDe/Para

...

id3
labelDe/Para
titleDe/Para

...

FP0720 - Manutenção de Cargo

...

FP0060 - Manutenção Situação

Irá gravar o campo conforme regra abaixo:

  • Quando o campo Iniciativa for igual a "Funcionário", grava 1
  • Quando o campo Justa Causa, estiver desmarcado, grava 2
  • Quando o campo Justa Causa, estiver marcado, grava 3

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

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

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


Deck of Cards
id1
Card
defaulttrue
id1
labelParametrização
titleParametrização


  • No programa FP0540 - Manutenção Descentralizada HCM
    1. Na aba Ahgora marque a opção "Integra Ahgora PontoWeb" e cadastre os dados para a integração.
      1. Tipo de Ambiente:
        1. Produção ou Homologação
          1. Para o tipo de ambiente 'Homologação', a parametrização pode ser realizada no ambiente de Produção do TOTVS. Após finalizar os testes com o tipo 'Homologação', é possível alterar o tipo para 'Produção'. Essa mudança elimina a tabela de controle de envio, permitindo que os dados fiquem com o status 'Não Integrado', prontos para envio.
            1. Obs.: Essa opção permite parametrizar cadastros, como o do FP1500, com 'Utiliza Ponto Ahgora' e a data de elegibilidade preenchidos.
      2. Configurações conexão Ahgora:
        1. Usuário 
        2. Senha
        3. Endereço do servidor

Importante:

        • As informações de acesso ao ambiente da Ahgora devem ser solicitadas ao responsável do contrato da Ahgora.
        • No endereço do servidor, informa a base da URL ex: "https://api.ahgora.com.br".
        • Caso possua restrição em seu firewall, verifique se o endereço acima possuem liberação para conexão externa.

Image 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
id2
labelParametrização Ahgora
titleParametrização Ahgora

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

    • 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


Card
id3
labelIntegração
titleIntegração

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

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

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

Image Added

Image Added


Deck of Cards
idIntegração
Card
defaulttrue
id3-1
labelFuncionários
titleFuncionários
Informações
titleAtualização Cadastral

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

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

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

    • 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 na tela principal.

Image Added

    • Após aplicarmos os filtros, será apresentada a seguinte tela:
      • Status: Correspondente ao status do registro
      • Matrícula Ahgora: Código da empresa + estabelecimento + matricula.
        • Obs.: As informações da matrícula Ahgora são as mesmas armazenadas no banco de dados, sem zeros à esquerda ou espaços em branco antes ou depois dos códigos.
          • Ex.: Empresa: 10, Estabelecimento: 1 e Matrícula: 99999929. Quando concatenados, o resultado será 10199999929.
      • Nome: Nome do funcionário.
      • Dt. Admissão: Data de admissão.
      • Dt. Demissão: Data de demissão.
      • Turno: Código do turno do funcionário.
      • Cargo: Código do cargo do funcionário.
      • Movimento: Inclusão/Alteração (status alteração ocorrerá sempre que o primeiro cadastro já tenha sido enviado para Ahgora).
      • Dt. Movimento: Data da movimentação (envio a Ahgora).

Image 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 Funcionários'. Image Added.

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

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


Card
id3-2
labelAfastamentos
titleAfastamentos
Informações
titleInclusão/Alteração do Afastamento
  • Para que a situação de afastamento seja carregada na tela de integração com a Ahgora, é necessário realizar a inclusão ou alteração do afastamento do funcionário.
  • As informações de afastamento seguem o filtro em que a data de início do afastamento seja menor ou igual à Data Afastamento Até, e a data de término do afastamento seja maior ou igual à Data Afastamento De.

Obs.: As situação de afastamento relacionadas a Transferência entra e saída e Desligamento, são desconsideradas no envio dos Afastamentos. Essas alterações são geradas pendencia de envio para o Funcionário.

Informações da tela

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

Image 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

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.

Image Added

Image Added

Card
id3-3
labelExclusão Afastamentos
titleExclusão Afastamentos
Informações
titleExclusão do Afastamento

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

Informações da tela

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

Image 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

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
id3-4
labelAgendamento
titleAgendamento do processo

Informações da Tela

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

Temos na aba de seleção:

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

Image 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
titleExecução

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

Card
id3-5
labelApuração de Resultados
titleApuração de Resultados
Informações

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

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

    • Tipo de requisição: POST
    • Endpoint: api/rh/ahgora/v1/results
    • Autenticação: Basic Authentication
      • Para autenticação com o RH Datasul, basta ter um usuário com permissões da acesso as informações do funcionário, e utilizar o Basic Authentication usuário e senha. 
      • Sugestão que seja um usuário genérico, para evitar recadastro caso ocorra alteração de permissões de usuário.
      • Tarefas Integração dos Resultados - Ahgora PontoWeb X RH Datasul
Deck of Cards
idApuração de Resultados
Card
defaulttrue
id3-5-1
labelCálculo
titleCálculo
Informações
titleParametrizações Cálculo
  • Quando as horas trabalhadas são retornadas:
    • Nesse caso, é necessário desmarcar o campo "Considera Carga Turno", na aba Cálculo do programa FP1500, para que sejam consideradas para cálculo apenas as horas contidas no FP2040.
  • Geração da Carga Turno:
    • Quando as informações das horas trabalhadas não são retornadas, é necessário gerar a Carga Turno utilizando os programas FP2540 ou FP2640. Se o estabelecimento não utiliza ponto eletrônico, será necessário parametrizar a composição da carga horária (turno mensal ou diário) para os turnos do respectivo estabelecimento.
  • Após o recebimento dos dados, o RH Datasul armazenará as informações no programa Manutenção Movimento c/ Controle Parcela - FP2040.

Image 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
titleImportante

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

Card
id3-5-2
labelAfastamento
titleAfastamento

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

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

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


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

Image 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
id4
labelDe/Para
titleDe/Para
Card
id1
labelDe/Para
titleDe/Para

1 - FUNCIONÁRIOS

DescriçãoCampo Tabela RH DatasulDescrição / Regra
Identificação do colaboradorfuncionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionario
Matricula do Funcionário
Enviar concatenado Empresa + Estabelecimento + Matricula
Nome do Funcionáriofuncionario.nom_pessoa_fisicNome do Funcionário
PIS do Funcionáriofuncionario.cod_pisNumero do PIS do Funcionário
Matrícula do E-Socialsped_participan.cod_matr_spedMatricula do eSocial
Data em que o Funcionário foi Admitidofuncionario.dat_admis_funcData de Admissão
Data de Demissãofuncionario.dat_desligto_funcData de Demissão
Código da escala/ turno do funcionáriofuncionario.cdn_turno_trabTurno do Funcionário
Data da alteração de escala/turnofunc_turno_trab.dat_inic_lotac_func_turno_trabData do ultimo histórico de turno
Tipo de Escala de Trabalhoturno_trab.idi_period_turno_trabEnviar sempre as horas padrão mensal do FP1400
Carteira de Trabalhofuncionario.cod_cart_trab -
funcionario.cod_ser_cart_trab -
funcionario.cod_unid_federac_cart_trab
Carteira de Trabalho do Funcionário
Título do Cargofuncionario.cdn_cargo_basic +
cargo.des_cargo
Código do Cargo + descrição
Descrição do departamento do Funcionáriofuncionario.cod_unid_lotacCódigo da Lotação + descrição
Gênero do Funcionáriorh_pessoa_fisic.idi_sexoSexo
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áriorh_pessoa_fisic.cod_id_federCPF, sem caracteres
RG do Funcionáriorh_pessoa_fisic.cod_id_estad_fisicCarteira Identidade
CNPJ da filial do Funcionáriorh_pessoa_jurid.cod_id_federCNPJ da Pessoa Juridica do estabelecimento sem caracteres
Data da atribuição do CNPJ da empresa ao funcionáriofuncionario.dat_admis_transf_funcData da transferência entre estabelecimentos
Código do centro de custo do funcionáriofuncionario.cdn_empresa
funcionario.cod_rh_ccusto
Centro Custo concatenado com Empresa + Código Centro de Custo
Regime de Trabalho do Funcionáriofuncionario.idi_tip_funcDE/PARA dos tipos conforme regra da Ahgora, dados preenchidos pela descrisão
Data de Nascimento do Funcionáriorh_pessoa_fisic.dat_nascimentoData Nascimento
Data de Alteração de Cargohistor_sal_func.dat_liber_salData da transferência entre cargos. Sempre considerado o último
Definição de carga horáriaturno_trab.qtd_hrs_padr_mes_rhQuantidade de horas mês
Ponto Obrigatóriofunc_aux_func.idi_elig_pontoDisponível somente quando habilita o produto do ponto
Data de troca da elegibilidade do registro de pontofunc_aux_func.dat_troca_elig_pontoEnviar a data quando passou a utilizar ponto, ou quando deixou de utilizar ponto.
Matrícula Chefia 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 Sindicatofuncionario.cdn_sindicatoCódigo do Sindicato
Data da alteração do código do sindicato
Data da inclusão. Sempre considerado o último
Telefonerh_pessoa_fisic.num_telefone rh_pessoa_fisic.num_telef_contatTelefone do funcionário
PIS
Preencher com true quando não tiver o PIS cadastrado e false quando tiver PIS cadastrado.
codInternofuncionario.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_horaSalário hora
Valor do salário do colaboradorfuncionario.val_salario_atualCaso o colaborar for mensalista, enviar o salário mensal
Caso o colaborar for horista, enviar o salário da hora

2 - AFASTAMENTOS

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

3 - EXCLUSÃO DE AFASTAMENTOS

DescriçãoCampo Tabela RH DatasulDescrição / Regra
Identificação do colaboradorfuncionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionario +
numero sequencial
Matricula do Funcionário
Enviar concatenado Empresa + Estabelecimento + Matrícula
Motivo do Afastamentosit_afast.cdn_sit_afast_funcSituação de Afastamento
Data e/ou hora Inicial do Afastamentosit_afast_func.dat_inic_sit_afast
sit_afast_func.num_horar_inic_sit_afast 
Data inicio do afastamento
Hora inicio: (00:00)
Hora Final: (24:00)
Data e/ou hora Final do Afastamentosit_afast_func.dat_term_sit_afast
sit_afast_func.num_horar_term_sit_afast 
Data fim do afastamento
Sem data fim, enviar vazio)
Código interno do Afastamentofuncionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionario +
numero 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
id5
labelDocumentação Relacionada
titleDocumentação Relacionada
Card
id1
labelDocumentação
Card
id6
labelVídeos
titleVídeos How To

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

Cloak
idHow To Linha Datasul
  • Este vídeo demonstra as parametrizações necessárias na Linha Datasul (Folha de Pagamento) para integração com o PontoWeb (PW) da Ahgora.

  • Este vídeo apresenta o processo de integração de funcionários da Linha Datasul (Folha de Pagamento) com o PontoWeb (PW) da Ahgora.

  • Este vídeo demonstra como integrar afastamentos e sua exclusão na Linha Datasul (Folha de Pagamento) com o PontoWeb (PW) da Ahgora.

  • Este vídeo demonstra como realizar o agendamento na Linha Datasul (Folha de Pagamento) para integração com o PontoWeb (PW) da Ahgora.

  • Este vídeo demonstra como consultar os resultados da integração da Linha Datasul (Folha de Pagamento) com o PontoWeb (PW) da Ahgora.

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

Cloak
idHow To Ahgora
  • Este vídeo irá demonstrar como realizar o cadastro de códigos de centro de custo no PW (PontoWeb) Ahgora para integração com a Linha Datasul (folha de pagamento).

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

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

...

id4
labelErros de Validação e seus Códigos

Lista de erros de validação e seus códigos

Alguns erros podem acontecer durante o processamento do lote enviado ou durante a validação dos itens do lote enviado, sendo eles:

Código

Mensagem

Detalhes

4998

Id do processo não encontrado

Significa que o processId informado na requisição de consulta de lotes está incorreto.

4999

Ocorreu um erro inesperado!

Representa erros genéricos ou inesperados que podem acontecer no servidor ou que podem ser gerados por algum aspecto incorreto não previsto do lote enviado.

5000

Token inválido ou expirado! / Bearer token não informado.

Isso indica que o token não foi informado na requisição ou informado não é válido. É necessário conferir se o token informado é igual à chave API na plataforma Feedz. Em caso afirmativo, é necessário gerar outra chave.

5000

Body vazio

Significa que foi enviada uma requisição para gravar um lote, mas sem nenhum dado.

5001

O total de itens enviados no corpo da requisição excede o limite de 100 registros. Todos os registros foram ignorados no processamento.

Ocorre ao enviar um lote com mais de 100 registros.

5003

A pessoa NPE (IntegrationId = IDN) está referenciando um gestor que não existe. Essa pessoa não será importada.

Esse erro ocorre ao tentar cadastrar um colaborador, vinculando a um gestor que ainda não foi cadastrado.

5004

A pessoa NPE (IntegrationId = IDN) está referenciando ela mesmo como chefe. Essa pessoa não será importada.

Esse erro ocorre ao tentar cadastrar um colaborador, vinculando ela mesma como gestora (integrationId = managerIntegrationId).

5005

A pessoa NPE (IntegrationId = IDN) está referenciando um departamento que não existe. Essa pessoa não será importada.

Esse erro ocorre ao tentar cadastrar um colaborador, vinculando a um departamento que ainda não foi cadastrado.

5006

A pessoa NPE (IntegrationId = IDN) está referenciando uma unidade que não existe. Essa pessoa não será importada.

Esse erro ocorre ao tentar cadastrar um colaborador, vinculando a uma unidade que ainda não foi cadastrada.

5008

A pessoa NPE (IntegrationId = IDN) está referenciando um cargo que não existe. Essa pessoa não será importada.

Esse erro ocorre ao tentar cadastrar um colaborador, vinculando a um cargo que ainda não foi cadastrado.

5009

O ID de integração (IntegrationId) é obrigatório e não foi informado para a Pessoa NPE. Essa pessoa não será importada.

Ocorre ao enviar uma pessoa e não informar se id de integração.

5011

O nome (Name) é obrigatório e não foi informado para a Pessoa (IntegrationId = IDN). Essa pessoa não será importada.

Ocorre ao enviar uma pessoa e não informar seu nome.

512

O e-mail (Email) é obrigatório e não foi informado para a Pessoa 'NPE' (IntegrationId = IDN). Essa pessoa não será importada.

Ocorre ao enviar uma pessoa e não informar seu e-mail.

5013

A pessoa 'NPE' (IntegrationId = IDN) possui o mesmo e-mail de outra pessoa da lista de pessoas enviadas ou da base. Essa pessoa não será importada.

Essa validação existe para evitar cadastrar pessoas duplicadas na base. Assim não é possível cadastrar dois e-mails iguais para integrationIds diferentes e vice versa.

5014

A pessoa 'NPE' (IntegrationId = IDN) deve ter o nome digitado somente com caracteres com nome, sobrenome e apenas 1(um) espaço entre eles.

Esse erro ocorre ao informar um nome inválido.

5015

A pessoa 'NPE' (IntegrationId = IDN) não pode ter o apelido igual ao nome.

Ocorre quando o name é igual ao socialName.

5016

O email fornecido 'EML' para a pessoa 'NPE' (IntegrationId = IDN) não está em um formato válido.

Ocorre ao enviar uma pessoa com o e-mail em formato inválido.

5017

O registro com o nome 'NRA' não foi salvo durante o processamento porque o campo 'IntegrationId' não foi informado."

Ocorre ao enviar qualquer registro auxiliar e não informar o integrationId.

5018

O registro com o código 'IDN' não foi salvo durante o processamento porque o campo 'Name' não foi informado.

Ocorre ao enviar qualquer registro auxiliar e não informar o nome.

5030

Quando informado a data de demissão deve ser também informado o motivo (dismissalType).

Ocorre ao enviar data de demissão e não informar o motivo.

5031

Deve ser informado o motivo da demissão (dismissalType) apenas quando for informado a data de demissão.

Ocorre ao enviar motivo da demissão e não informar a data de demissão.

5032

A data de admissão não pode ser maior que a data de demissão.

Ocorre ao enviar uma data de admissão posterior à data de demissão.

5048

O ID de integração do líder (managerIntegrationId = MII) informado para a pessoa (personIntegrationId = IDN) não existe.

Ocorre ao tentar vincular pessoa e líder pela rota persons-bind e não ter esse líder cadastrado previamente na plataforma.

5049

O ID de integração da pessoa (personIntegrationId = IDN) informada não existe.

Ocorre ao tentar vincular pessoa e líder pela rota persons-bind e não ter esse colaborador cadastrado previamente na plataforma.

5050

Uma pessoa (personIntegrationId = IDN) não pode ser líder de sí próprio

Ocorre ao tentar vincular uma pessoa a ela mesma como líder (personIntegrationId = managerIntegrationId) através da rota persons-bind.

...