Exibir origem

01. DADOS GERAIS

Produto:
Linha de Produto:
Segmento:
Módulo:
Função:	FP0540 - Manutenção Descentralização HCM FP1500 - Manutenção Funcionário FP1600 - Manutenção Histórico de Situações FP2040 - Movimento c/ Controle Parcela FP1600 - Manutenção Histórico de Situações FP1602 - Consultas Histórico de Situações FP1601 - Relatórios Histórico de Situações apiResultadosAhgora - Api de Resultados Integração Ahgora
Requisito/Story/Issue :	DRHROTDTS-15306 DRHROTDTS-15683 DRHROTDTS-15642 DRHROTDTS-15643 DRHROTDTS-15647 DRHROTDTS-16419 DRHROTDTS-16416

02. SITUAÇÃO/REQUISITO

A solução Ahgora PW (Ponto Web) é uma ferramenta robusta e amigável que permite a gestão de ponto eletrônico, incluindo cálculo de horas trabalhadas, afastamentos e horas extras. Atualmente integrada como a nova solução de ponto eletrônico da TOTVS, sua utilização pelos clientes Datasul é manual e baseada em arquivos de importação. Esse processo aumenta o risco de inconsistências nos dados e demanda trabalho significativo, especialmente na troca de informações como Funcionários, Afastamentos e Resultados.

03. SOLUÇÃO

Para facilitar o uso da integração com a solução Ahgora PW (Ponto Web), foram disponibilizados, nas telas abaixo, campos específicos para identificar a integração e informar se o funcionário registra ponto no produto Ponto Web da Ahgora. Essa melhoria busca reduzir a necessidade de processos manuais, minimizando riscos de inconsistência e aumentando a eficiência na gestão de dados entre os sistemas.

FP0540 - Manutenção Descentralização HCM

Foi adicionada uma nova aba "Ahgora" para permitir o cadastro dos dados necessários à integração com o produto Ahgora.

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

Linha Datasul > DRHROTDTS-14126 DT Integração Ahgora > image-2024-12-11_20-25-52.png

FP1500 - Manutenção Funcionário

Adicionado na aba Cadastral, os campos Bate Ponto e Data da Elegibilidade do ponto.

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

Linha Datasul > DRHROTDTS-14126 DT Integração Ahgora > image-2024-12-11_20-30-44.png

Pendencia de Integração Ahgora

Para a integração com a Ahgora, implementamos um controle automático de pendências.

- Na criação, alteração da data, ajuste de horas ou exclusão de uma situação, o programa gerará automaticamente uma pendência de integração com o Ponto Web da Ahgora.

Linha Datasul > DRHROTDTS-14126 DT Integração Ahgora > image-2024-12-23_9-27-5.png

Linha Datasul > DRHROTDTS-14126 DT Integração Ahgora > image-2024-12-23_9-27-50.png

- Da mesma forma, no cadastro de admissão de um funcionário ou na troca de turno, será criada uma pendência de integração com o Ponto Web da Ahgora.

Linha Datasul > DRHROTDTS-14126 DT Integração Ahgora > image-2024-12-23_9-20-8.png

Linha Datasul > DRHROTDTS-14126 DT Integração Ahgora > image-2024-12-23_9-19-1.png

- Para o funcionário temos outros campos que podem gerar a pendencia de envio, 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

FP2040 - Movimento c/ Controle Parcela

Com integração dos resultados, foi necessário a alteração no programa FP2040, para disponibilizar em tela os campos que informa essa integração.

- Adicionado na aba Movimento, nova coluna para identificar a origem da integração, Int. Ahgora.

Linha Datasul > DRHROTDTS-14126 DT Integração Ahgora > image-2025-1-17_13-46-52.png

- No botão Modificar:
  - Temos a possibilidade de alterar somente os dados abaixo:
    - Centro de Custo.
    - Tomador de Serviço.
    - Valor Unitário.
    - Situação (Ativo ou Suspenso).

Linha Datasul > DRHROTDTS-14126 DT Integração Ahgora > image-2025-1-17_13-50-36.png

Com o recebimento dos resultados apurados pela Ahgora, foi necessário identificar se a origem do resultado está relacionada a um afastamento por falta injustificada.

Caso seja uma falta injustificada, o sistema apresentará essa informação nos programas listados abaixo, permitindo a consulta e a exclusão, caso haja, por exemplo, um atestado informado no RH.

Com a apuração dos resultados pelo PontoWeb e a integração desses valores no Datasul, foi necessário incluir uma regra para que, quando a datafalta for retornada, o programa possa criar ou eliminar a situação de falta no FP1600.

Para isso, o programa de integração segue a seguinte lógica:

- Se o campo datafalta estiver informado.
- Se o evento correspondente ao dia da falta estiver relacionado no FP0060 a uma situação com significado 'Falta Injustificada', na aba Ponto, nos campos 'Afastamento Diurno' ou 'Afastamento Noturno', tanto para mensalistas quanto para horistas.
- Se não houver nenhuma situação de afastamento informada para o dia da falta.

- FP1600 - Manutenção Histórico de Situações
  - Coluna Origem da Situação, incluído o identificador "Int. Ahgora".
  - Botão Modificar, passa a ficar desabilitados quando a informação for origem Int. Ahgora.
  - Botão Filtro, disponibilizado filtro pela origem Int. Ahgora.

Linha Datasul > DRHROTDTS-14126 DT Integração Ahgora > image-2025-2-13_15-49-22.png

- FP1602 - Consultas Histórico de Situações
  - Coluna Origem da Situação, incluído o identificador "Int. Ahgora".
  - Botão Filtro, disponibilizado filtro pela origem Int. Ahgora.
- FP1601 - Relatórios Histórico de Situações
  - Incluído a origem Int. Ahgora, para geração dos relatórios.
    - Novo campo esta disponível para todas as opções de geração da tela.

- - Para identificação do afastamento com origem da integração com a Ahgora, estamos utilizando a letra H. Isso serve para os relatórios em txt e csv.

04. DEMAIS INFORMAÇÕES

05. ASSUNTOS RELACIONADOS

<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>