TOTVS | Conferência Ahgora 作者: Hagliberto Alves

A extensão TOTVS | Conferência Ahgora foi desenvolvida para apoiar a conferência técnica e operacional de frequência no ambiente web Ahgora/TOTVS.

Ela adiciona recursos de análise, visualização, cálculo e exportação às páginas de apuração de batidas, permitindo que usuários autorizados revisem jornadas, escalas, intervalos, horas extras, adicionais e verbas antes da utilização das informações em procedimentos internos.

A extensão atua como uma ferramenta de apoio à conferência. Ela não substitui o Ahgora, não modifica permissões de acesso, não altera automaticamente registros no sistema e não envia lançamentos diretamente para sistemas de folha de pagamento.



A página de Cards apresenta uma visão consolidada das informações disponíveis para cada empregado, incluindo:

• matrícula e nome;
• departamento e filial;
• regime e tipo de escala;
• período da competência;
• totais das verbas calculadas;
• status do processamento;
• filtros e pesquisa;
• opções de exportação para conferência.

Os resultados podem ser atualizados progressivamente durante o pré-cálculo, permitindo acompanhar a disponibilidade dos dados sem aguardar necessariamente o término de toda a fila.


A página de Frequência oferece uma visualização horizontal do período completo da competência, com os empregados agrupados por departamento.

Entre os recursos disponíveis estão:

• filtros por empregado, departamento, filial, escala e regime;
• agrupamento por departamento;
• visualização das batidas registradas em cada dia;
• diferenciação visual dos dias sem ponto;
• opção para exibir somente os dias trabalhados;
• totais das verbas por empregado;
• atualização em tempo real durante o processamento;
• rolagem horizontal para análise de todo o período.

Ao posicionar o cursor ou clicar sobre um dia, é exibido um painel detalhado contendo:

• matrícula e nome do empregado;
• departamento e filial;
• escala e regime;
• data selecionada;
• quantidade de dias transcorridos na competência;
• horas trabalhadas;
• duração dos intervalos;
• entradas e saídas registradas;
• valores das verbas no dia;
• totais acumulados até a data selecionada.

O pré-cálculo permite processar os empregados disponíveis para a competência e preparar os dados utilizados nas páginas de Cards e Frequência.

Durante o processamento, a extensão apresenta:

• percentual concluído;
• quantidade de empregados processados;
• empregado atualmente em cálculo;
• resultados disponíveis em cache;
• quantidade de erros encontrados;
• possibilidade de exportar resultados parciais ou completos.

Para acelerar o processamento, a extensão pode utilizar até duas abas temporárias em paralelo. Essas abas são utilizadas somente durante o pré-cálculo e são fechadas ao término da operação.

Ao abrir apenas Cards ou Frequência, a extensão abre ou reutiliza uma única aba de visualização.


A extensão organiza e apresenta as seguintes verbas:

• 135 — Adicional Noturno;
• 136 — Hora Extra 50%;
• 137 — Hora Extra 100%;
• 145 — Ajuda de Custo;
• 147 — Intrajornada.

A Ajuda de Custo pode ser identificada de acordo com o tipo de jornada ou regra aplicada, incluindo:

• Ajuda de Custo Administrativa;
• Ajuda de Custo 12x36;
• Ajuda de Custo 24x72;
• escalas equivalentes configuradas na aplicação.

Os cálculos são realizados localmente com base nas informações exibidas pelo Ahgora e nas regras configuradas na extensão.


A extensão auxilia na conferência de diferentes tipos de jornada, incluindo:

• jornadas administrativas;
• escalas 12x36;
• escalas 24x72;
• regimes de hora extra;
• escalas equivalentes;
• jornadas com múltiplas entradas e saídas;
• dias com batidas ímpares ou incompletas;
• intervalos regulares ou reduzidos;
• dias sem ponto registrado.

Registros que precisam de atenção recebem diferenciação visual para facilitar a revisão pelo usuário.


A extensão permite gerar arquivos locais para conferência e auditoria, incluindo:

• CSV operacional;
• XLSX detalhado;
• HTML navegável;
• PDF;
• relatórios consolidados;
• arquivos agrupados por empregado ou departamento.

O arquivo CSV operacional pode ser gerado no formato:

Matrícula;Verba;Valor


As planilhas de conferência podem incluir informações como:

• matrícula;
• nome;
• departamento;
• filial;
• regime;
• escala;
• batidas;
• horas trabalhadas;
• intervalos;
• verbas;
• totais;
• observações;
• detalhamento por dia.

A geração dos arquivos ocorre diretamente no navegador e somente é iniciada após uma ação do usuário.


Ao tentar bloquear uma competência, a extensão apresenta uma confirmação detalhada antes de permitir que a operação prossiga.

Essa confirmação orienta o usuário a verificar previamente:

• batidas;
• justificativas;
• jornadas;
• intervalos;
• verbas;
• pendências da competência.

A extensão não realiza o bloqueio por meio de integração externa. Após a confirmação, ela apenas permite que o comando original do ambiente Ahgora continue.


A extensão foi projetada para processar as informações localmente no navegador.

Ela:

• não coleta dados para o desenvolvedor;
• não envia dados de frequência para servidores externos;
• não transmite matrículas, nomes ou resultados de cálculo;
• não utiliza publicidade;
• não utiliza analytics;
• não utiliza telemetria;
• não compartilha informações com terceiros;
• não captura nem armazena senhas do Ahgora;
• não possui servidor próprio para armazenamento de dados;
• não carrega código JavaScript remoto.

Os dados utilizados pela extensão são aqueles já disponibilizados ao usuário autenticado pelo próprio Ahgora/TOTVS.

Preferências, filtros, cache e resultados temporários podem ser armazenados localmente no navegador para melhorar o desempenho e evitar reprocessamentos desnecessários.

O usuário pode limpar esses dados locais utilizando os recursos disponíveis na própria extensão ou nas configurações do navegador.


A extensão funciona somente no domínio necessário para sua finalidade:

https://app.ahgora.com.br/*


As permissões são utilizadas para:

• executar os recursos de conferência dentro do Ahgora;
• armazenar localmente preferências e resultados temporários;
• abrir ou reutilizar as páginas internas de Cards e Frequência;
• gerenciar as abas temporárias utilizadas no pré-cálculo;
• gerar arquivos locais solicitados pelo usuário.

A extensão não contorna a autenticação do Ahgora e não permite acesso a informações que o usuário não esteja autorizado a visualizar.


O objetivo do TOTVS | Conferência Ahgora é:

• reduzir o retrabalho na conferência de frequência;
• organizar grandes volumes de informações;
• facilitar a identificação de inconsistências;
• padronizar a análise de jornadas e verbas;
• fornecer relatórios de apoio;
• melhorar a rastreabilidade da conferência;
• auxiliar usuários autorizados antes de procedimentos internos de folha ou auditoria.

Os resultados apresentados devem ser revisados pelo usuário responsável. A extensão funciona como ferramenta de apoio e não substitui a validação técnica, administrativa ou normativa da organização.