> For the complete documentation index, see [llms.txt](https://software-telematica-com.gitbook.io/suricato-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://software-telematica-com.gitbook.io/suricato-docs/pgrep/manual-do-pgrep-versao-7.2.0.0.md).

# Manual do PGREP Versão 7.2.0.0

## Visão Geral

Utilize este manual como o guia para configurar o Programa Gerenciador da Linha CodinREP. Ele orienta supervisores, recepcionistas, recursos humanos e segurança sobre a Coleta de Ponto e operações diversas.

Acompanhe as funções em linguagem dinâmica para aplicar o sistema ao seu tipo de negócio. Acesse a Ajuda interna na barra de navegação sempre que houver dúvidas sobre o cadastro.

O sistema PGReP possui um menu com quatro funções principais e subfunções para alimentar o banco de dados, registrando equipamentos, localidades e colaboradores autorizados. A partir disso, monitore a coleta de pontos, gerencie a segurança e gere registros para integração com qualquer software de Ponto Eletrônico.

## Regras de Negócio e Requisitos do Sistema

Certifique-se de que o seu computador atende às especificações abaixo antes de iniciar a instalação:

* **Sistema Operacional:** Windows 10 ou 11.
* **Configuração Mínima Recomendada:** Processador PIII 1.5 GHz, 512MB de Memória RAM, 20GB de Espaço em Disco Rígido e Placa de rede 10/100.
* **Navegador de Internet (Browser):** Mozilla Firefox 1.5 (ou superior), Google Chrome 95 (ou superior) ou Microsoft Edge 95 (ou superior).
* **Comunicação dos Equipamentos:** Rede TCP/IP utilizando a **Porta 1366** para comunicação com os REPs Telemática.
* **FaceTemplate:** Para que a Leitura Facial do PGREP funcione, é necessário ter instalado em sua máquina o serviço FaceTemplate.

### Requisitos de Maquina para Instalação do FaceTemplate

<table data-search="false"><thead><tr><th width="201">Atributo</th><th>Requisito Obrigatório</th><th>Exemplos e Observações</th></tr></thead><tbody><tr><td>Processador (CPU)</td><td>Arquitetura x86-64 (64 bits)</td><td>Processadores Intel ou AMD homologados.</td></tr><tr><td>Extensões Obrigatórias</td><td>AVX, OSXSAVE, AVX2 e FMA3</td><td>Extensões vetoriais habilitadas pelo sistema operacional.</td></tr><tr><td>Processadores Intel</td><td>4ª geração “Haswell” ou mais nova</td><td>Core i-4x em diante, Xeon E3 v3, E5 v3, E7 v3 ou mais novos.</td></tr><tr><td>Processadores AMD</td><td>Excavator (Carrizo/Bristol Ridge) ou qualquer geração Zen em diante</td><td>Ryzen 1000+ ou EPYC 7001+</td></tr><tr><td>Sistema Operacional</td><td>Windows compatível com AVX</td><td>Windows Server 2012 R2 ou mais novo.</td></tr><tr><td>Máquinas Virtuais (VMs)</td><td>O computador físico (host) deve ter AVX2</td><td>O software de virtualização (hypervisor) deve expor AVX/AVX2 para a VM.</td></tr><tr><td>Memória (RAM)</td><td>Mínimo de 2GB</td><td>Capacidade livre dedicada ao serviço.</td></tr><tr><td>Rede e segurança</td><td>Liberar a porta 60100/tcp no firewall</td><td>Configuração obrigatória para permitir a comunicação com a API.</td></tr><tr><td>Software necessário</td><td>PowerShell versão 7.5 ou superior</td><td>Necessário para execução de rotinas acessórias.</td></tr></tbody></table>

## Como instalar o PGREP

{% stepper %}
{% step %}
Execute o arquivo de instalação identificado como `setup.exe`.

{% hint style="warning" %}
Se o Windows exibir uma mensagem informando que "protegeu o computador", clique em **"Mais informações"** e depois selecione **"Executar assim mesmo"**.
{% endhint %}

<img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FewEGIS3OSxHwOzwoEMHT%2Funknown.png?alt=media&amp;token=e0825782-8730-443c-8bd8-0543aebaee53" alt="" height="509" width="539">
{% endstep %}

{% step %}
Clique em **Avançar**, selecione o local da instalação e defina se a permissão de acesso será para todos os usuários ou apenas para o usuário conectado.

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FPaK441FQikHuTJPcLWDL%2Fimage.png?alt=media&amp;token=13cca9f7-d11e-417d-be7b-f748d13b8c92" alt=""><figcaption><p><em>Assistente para instalação</em></p></figcaption></figure>
{% endstep %}

{% step %}
Após concluir a instalação, clique com o botão direito sobre o arquivo *PGReP.exe* e selecione **Executar como Administrador**.
{% endstep %}

{% step %}
Na tela de login, insira as credenciais padrão do sistema:

* **Login:** admin
* **Senha:** CODIN

<img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FOnwred3TQlb30bnl0K2J%2Funknown.png?alt=media&amp;token=d7b972c6-00b7-4775-b3a8-fd23947a93dc" alt="Login e senha" height="258" width="448">
{% endstep %}
{% endstepper %}

## FaceTemplate

Para utilizar o reconhecimento facial no PGREP, é obrigatório instalar e configurar o serviço FaceTemplate, que é o responsável por converter a foto do colaborador em código biométrico e enviá-la ao equipamento.

[→ Clique aqui para acessar o Manual de Instalação e Configuração do FaceTemplate](/suricato-docs/central-tecnica/instalacao-e-configuracao-de-servicos-e-funcionalidades/instalacao-e-configuracao-do-suricato-face/integracao-suricato-face-e-facetemplate.md)

## Como configurar o PGREP

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FTaLnERVFvg3JrXmMO2te%2Fimage.png?alt=media&amp;token=6c1698e1-4f42-4b84-affc-5ea9bcaf4ead" alt=""><figcaption></figcaption></figure>

#### Menu Configuração&#x20;

Acompanhe neste tópico o tema de configurações do PGReP. Utilize esta aba do programa para realizar as seguintes ações: cadastre os usuários para o sistema PGReP, importe os colaboradores, realize o backup do banco de dados `.mdb` do PGReP e execute algumas configurações do sistema.

{% stepper %}
{% step %}
**Configurações > Usuários**

Acesse o menu Configurações para localizar o cadastro dos usuários com permissão de acesso ao software PGReP.

Conceda aos usuários cadastrados a permissão para acessar as telas do programa. Utilize o login padrão "admin" e o nome de usuário "TSI".

* Utilize os botões na parte superior da tela para navegar (avançar, retornar), incluir, excluir ou modificar um usuário. A lista na parte inferior exibe todos os operadores cadastrados.
* Para cadastrar novos usuários preencha os campos vazios, todos são obrigatórios, e na edição, clique no nome, os campos se tornarão editáveis.

{% hint style="info" %}
**Atenção:** Ao clicar em **+** para cadastrar um novo usuário, e clicar no campo vazio, este campo deverá ser preenchido antes de seguir para o próximo, caso contrário, não será possível seguir.
{% endhint %}

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2F8gsvUKFChYqpvGn9jXZC%2Fimage.png?alt=media&amp;token=a0852b24-0a29-4ca0-95d7-5d43c6b6d6b1" alt=""><figcaption><p><em>Configurações > Usuários</em></p></figcaption></figure>
{% endstep %}

{% step %}
**Configurações > Importar**

<mark style="color:red;">**Atenção:**</mark>**&#x20;Antes de realizar a importação do arquivo, crie um** [**Grupo de Colaboradores**](/suricato-docs/pgrep/manual-do-pgrep-versao-7.2.0.0/cadastros-no-pgrep.md)**.**

Utilize esta tela para importar um arquivo com a listagem de colaboradores. Para que o sistema processe as informações corretamente, o arquivo `.txt` deve seguir rigorosamente o seguinte layout de posições:

* **Posições 01 a 52:** Nome do colaborador (máximo 52 caracteres, preenchido com espaços à direita para completar o campo);
* **Posições 53 a 64:** Número de matrícula do colaborador (12 dígitos, preenchido com zeros à esquerda);
* **Posições 65 a 76:** Número do PIS do colaborador (12 dígitos);
* **Posições 77 a 87:** Número do CPF do colaborador (11 dígitos, apenas números válidos).

{% hint style="info" %}
**Observação:** As linhas do arquivo devem estar organizadas em ordem decrescente de matrícula. O grupo de colaboradores é selecionado na própria interface do sistema no momento da importação.
{% endhint %}

Exemplo:

```
Vitoria Teste           00000128348509435438016441709753080
Eduarda Costa Almeida   00000000000512345678916441367107040
Daniel Ferreira Santos  00000000000412345678915227686803031
Carla Mendes Oliveira   00000000000312345678914446234724000
Bruno Henrique Lima     00000000000212345678913228209124005
```

<img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FWnBy4EOEMs5kUgIi3O9F%2Funknown.png?alt=media&amp;token=eff035b5-8dc2-4b87-ab8c-a826ea3dc526" alt="Configurações > Importar" height="300" width="567">
{% endstep %}

{% step %}
**Configurações > Backup do Banco**

Acesse esta tela para garantir a segurança dos seus dados guardados.

* Faça o backup do seu banco de dados clicando no botão '*Back up do Banco*' nesta tela e escolhendo a pasta de destino onde deseja salvar o arquivo `.mdb` gerado de forma segura.
* Você também pode *Visualizar o Arquivo*, clicando nesse botão.

<img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FT0odsq7igiRghW6nDnmh%2Funknown.png?alt=media&amp;token=13127466-fb72-4bb0-bf94-2bb469a97237" alt="Configurações > Backup do Banco" height="283" width="537">
{% endstep %}

{% step %}
**Configurações > Configuração do Sistema**

Acesse esta tela para ajustar o comportamento de comunicação do software:

* **Quantidade de Tentativas na Coleta:** Defina quantas vezes o sistema tentará falar com o CODIN antes de exibir o erro.
* **Time Out de Comunicação (segundos):** Defina o tempo limite de espera por resposta do equipamento.
* **Ativar Log de trailer:** Ative se necessário.
* **Local do arquivo único:** Indique a pasta onde será salvo o arquivo AFD extraído pelo PGREP.
* **Tipo de registro AFD:** Selecione o padrão utilizado.
* **Configuração do Face Template (Novo campo):** Forneça o IP e a porta do Face Template para a comunicação com os REPs faciais.
  {% endstep %}

{% step %}
**Botão de ajuda, botão de Minimizar, Maximizar e Fechar a página.**

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FTOZ2PpyYxoV4TdfyMd8P%2Fimage.png?alt=media&amp;token=b828d6dc-3c95-4045-a0af-594a0b559feb" alt=""><figcaption></figcaption></figure>

Conforme você clica em uma aba e/ou página, uma nova tela se abre. \
**Exemplo:** *Empresas, Locais e Grupos.*

* O botão com interrogação te direciona a página de **Ajuda**, o manual do Software.

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FiS72zp6L61SZhEXhqK3I%2Fimage.png?alt=media&amp;token=1978bdb3-9a80-4813-821a-0e2f245f643e" alt=""><figcaption></figcaption></figure>

* O botão de **minimizar** minimiza a tela.

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FrVfVWx1q5BE79w1kdkEg%2Fimage.png?alt=media&amp;token=1eb1c2e0-b35c-4f71-8f71-3c5780d128fb" alt=""><figcaption></figcaption></figure>

* O botão de **maximizar**, cria abas soltas no espaço do software ou as prende.

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2F1RekhtFafN1cobhM7v92%2Fimage.png?alt=media&amp;token=70fdf2d6-6ca3-4b43-95d3-972f54958185" alt=""><figcaption></figcaption></figure>

* E o botão de **Fechar**, fecha a tela.
  {% endstep %}
  {% endstepper %}

## FAQ - Perguntas Frequentes

<details>

<summary>Preciso liberar alguma porta de rede específica no meu firewall para que o PGReP consiga se comunicar com os equipamentos?</summary>

Sim. É necessário liberar a comunicação via rede TCP/IP utilizando especificamente a Porta 1366 para que o sistema consiga conversar e trocar dados com os relógios de ponto (REPs Telemática). Além disso, caso utilize REPs faciais, você também precisará indicar o IP e a porta configurados para o *Face Template* nas configurações do sistema.

</details>

<details>

<summary>Se o meu arquivo <code>.txt</code> de importação de colaboradores tiver os nomes e matrículas certos, mas estiver em ordem alfabética, o sistema vai importar normalmente?</summary>

Não. Para que a importação funcione e o sistema processe as informações corretamente, o arquivo `.txt` não deve apenas respeitar as posições exatas dos caracteres (Nome, Matrícula, PIS e CPF), mas também deve estar obrigatoriamente organizado em ordem decrescente de matrícula.

</details>

<details>

<summary>Posso usar qualquer banco de dados relacional, como MySQL ou SQL Server, para salvar as informações do PGReP?</summary>

Não. O banco de dados utilizado pelo sistema PGReP é exclusivamente o Microsoft Access (cujo arquivo possui a extensão `.mdb`). É através do backup desse arquivo `.mdb` que você garante a segurança dos dados armazenados no programa.

</details>

<details>

<summary>Tentei rodar o instalador <code>setup.exe</code> no Windows 10/11 e apareceu uma tela de aviso dizendo que o "Windows protegeu o seu computador". Como devo proceder?</summary>

Essa é uma mensagem comum de proteção do sistema operacional. Para prosseguir com a instalação, basta clicar no link "Mais informações" exibido na própria janela de aviso do Windows e, em seguida, selecionar a opção "Executar assim mesmo".

</details>

<details>

<summary>Como ajusto o sistema caso a comunicação com o relógio de ponto esteja caindo por instabilidade na rede antes de o equipamento responder?</summary>

Você deve acessar a tela Configurações > Configuração do Sistema. Nela, você pode ajustar o parâmetro Time Out de Comunicação (segundos) para aumentar o tempo limite de espera por resposta do equipamento, além de configurar a Quantidade de Tentativas na Coleta, que define quantas vezes o sistema tentará se comunicar com o CODIN antes de apresentar uma mensagem de erro na tela.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://software-telematica-com.gitbook.io/suricato-docs/pgrep/manual-do-pgrep-versao-7.2.0.0.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.