API Ponto Gestor

---
title: API Ponto Gestor
slug: api-ponto-gestor
sistema:
  - "Gestão de Pessoal / eSocial [02]"
chamado: "0000499553"
categoria: user_manual
tipo: how-to
autor: José Luiz Pereira
setor: Qualidade
modulo: RH
versao_doc: 01
revisao: Paulo Bley
aprovado_em: mês FEV de 2026
versao_pipeline: 2.5.2
release: ""
publico: "Analistas e operadores de RH responsáveis pela importação de ponto"
keywords:
  - API
  - Ponto Gestor
  - PTRP
  - APICONFIG
  - importação de ponto
  - token de autenticação
  - integração
  - cartão ponto
ultima_revisao: "2026-06-11"
---

## Visão Geral

Este documento descreve o processo de integração entre o ERP Teorema e o Ponto Gestor via Interface de Programação de Aplicações (API), cobrindo desde o acesso ao endpoint base da API PTRP (Programa de Tratamento de Registro de Ponto) até a importação automática dos registros de ponto para a folha de pagamento.

O fluxo compreende:

- Acesso à API do Ponto Gestor (https://api.ptrp.com.br)
- Geração e cópia do Token de Autenticação no perfil do usuário do Ponto Gestor
- Cadastro da APICONFIG no módulo Administrador do Teorema
- Execução da importação do arquivo de ponto via API no módulo Gestão de Pessoal

## Acessar o Endpoint Base da API PTRP

**Caminho:** Navegador de internet > barra de endereços > `https://api.ptrp.com.br`

![Tela de login do PTRP com título "Programa de Tratamento de Registro de Ponto", campos Nome de usuário ou E-mail e Senha, checkbox Continuar conectado, botão ENTRAR e links Registrar, Esqueceu sua senha, Não recebeu as instruções de confirmação, Não recebeu as instruções de desbloqueio](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/api-ponto-gestor/api-ponto-gestor-05.png)

O endereço `https://api.ptrp.com.br` é o endpoint base onde os serviços da API ficam disponíveis. Acessá-lo valida a disponibilidade da API e serve de ponto de partida para as configurações de integração.

## Localizar o Nome do Usuário no Ponto Gestor

1. Acessar o sistema Ponto Gestor e realizar o login com as credenciais da empresa.
2. No canto superior direito da tela, clicar sobre o **nome do usuário logado** (ex.: "Teste Teorema Api").

![Painel Inicial do Ponto Gestor com menu superior contendo Cadastros, Ações em massa, Cartão Ponto, Relatórios e Ajuda; no canto superior direito o nome "Teste Teorema Api" está destacado por uma seta vermelha](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/api-ponto-gestor/api-ponto-gestor-06.png)

Clicar no nome do usuário exibe o menu suspenso com opções de perfil e configurações da conta.

## Acessar Meu Perfil no Ponto Gestor

1. Acessar o sistema Ponto Gestor e realizar o login.
2. Clicar sobre o nome do usuário logado no canto superior direito.
3. No menu suspenso exibido, clicar em **Meu Perfil**.

![Menu suspenso aberto no Ponto Gestor exibindo as opções: Tipo de usuário: Cliente, Meu Perfil (destacado), TESTE, Pagamentos, Exibir dados cliente, Alterar dados cliente, Domínios/IPs liberados, Usuários, Sair](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/api-ponto-gestor/api-ponto-gestor-07.png)

A opção **Meu Perfil** dá acesso às configurações individuais do usuário autenticado, incluindo o Token de Autenticação da API.

## Gerar ou Consultar o Token de Autenticação da API

1. Acessar o sistema Ponto Gestor e realizar o login.
2. Clicar no nome do usuário (canto superior direito) e selecionar **Meu Perfil**.
3. No modal exibido, localizar o campo **Token de Autenticação da API** na parte inferior.

![Modal "Usuário: 102030405060" com campos Nome, Sobrenome, CPF, Nome de usuário, E-mail, Nível, Funções, Divisão, Logou a última vez com o IP, datas de login e cadastro, Quantidade de logins realizados e falhos; na última linha o campo Token de Autenticação da API exibe valor mascarado, com botão de ícone de olho identificado como 2º e botão GERAR identificado como 1º](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/api-ponto-gestor/api-ponto-gestor-08.png)

**Verificar se já existe um token:**

- Clicar no botão com ícone de olho (identificado como **2º** na tela).
- Se forem exibidos letras e números, o Token de Autenticação já está gerado.

**Caso não exista token:**

- Clicar no botão **GERAR** (identificado como **1º** na tela).
- Em seguida, clicar novamente no botão do olho (**2º**) para visualizar o token criado.

> **Nota:** Na conta de testes da Teorema o token já está previamente gerado. Nesse caso, basta clicar no botão do olho (**2º**) para visualizar o Token de Autenticação.

Copiar o token exibido — ele será utilizado no cadastro da APICONFIG no módulo Administrador.

## Acessar Parâmetros Gerais no Módulo Administrador

**Caminho:** Teorema > módulo Administrador > menu Administrador > F – Parâmetros Gerais

1. Acessar o sistema Teorema e selecionar a empresa que utilizará a API.
2. Entrar no módulo **Administrador**.
3. No menu superior, clicar em **Administrador**.
4. Selecionar a opção **F – Parâmetros Gerais**.

![Módulo Administrador do Teorema com menu Administrador aberto e item "F - Parâmetros Gerais" destacado na lista de opções](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/api-ponto-gestor/api-ponto-gestor-09.png)

A tela Parâmetros Gerais permite configurar definições globais da empresa, incluindo integrações com APIs externas.

## Cadastrar a APICONFIG para Integração com o Ponto Gestor

**Caminho:** Teorema > módulo Administrador > Administrador > F – Parâmetros Gerais > aba API Config > botão Adicionar (+)

1. Acessar o sistema Teorema e selecionar a empresa.
2. Entrar no módulo **Administrador** > menu **Administrador** > **F – Parâmetros Gerais**.
3. Clicar na aba **API Config**.
4. Clicar no botão **Adicionar (+)**.

![Tela Parâmetros Gerais com aba API Config selecionada, colunas ID, Descrição, Tipo e Empresa, botão adicionar (+) destacado e mensagem "Sem Dados para Exibir" na grade](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/api-ponto-gestor/api-ponto-gestor-10.png)

No formulário exibido, preencher os campos conforme abaixo:

| Campo       | Valor                          |
|-------------|-------------------------------|
| Descrição   | apipontogestor                |
| Token       | Token de Autenticação copiado do Ponto Gestor |
| APIHOST     | https://api.ptrp.com.br       |

![Formulário de cadastro de APICONFIG com seção Config API (campos ID e Descrição) e seção Parâmetros (campos Token e APIHost preenchidos), e botões Cancelar e Confirmar](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/api-ponto-gestor/api-ponto-gestor-11.png)

Após o preenchimento, clicar em **Confirmar** para salvar o registro.

O cadastro da APICONFIG define o endereço base da API, armazena o token de autenticação e habilita a comunicação segura entre o ERP Teorema e o Ponto Gestor.

## Importar Arquivo de Ponto via API

**Caminho:** Teorema > módulo Gestão de Pessoal > menu Importações/Exportações > Importação Arquivo Ponto

1. Acessar o sistema Teorema e selecionar a empresa previamente configurada para utilização da API.
2. Entrar no módulo **Gestão de Pessoal**.
3. No menu superior, clicar em **Importações/Exportações**.
4. Selecionar **Importação Arquivo Ponto**.

![Módulo Gestão de Pessoal com menu Importações/Exportações aberto e item "Importação Arquivo Ponto" destacado na lista de opções](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/api-ponto-gestor/api-ponto-gestor-12.png)

Na tela **Importação do Arquivo de Cartão Ponto**:

1. Selecionar o **mês de competência** desejado no campo **Competência**.
2. Selecionar a **Configuração de Evento ID** utilizada pela empresa.
3. Informar o **Ponto** no campo correspondente.
4. Clicar no botão **Via API** na barra de ferramentas.

![Tela Importação do Arquivo de Cartão Ponto com seção Configuração API contendo campos Competência (02/2026), Configuração Evento Id e campo Ponto; checkboxes Acumulando e Complementar; seção Importação Individual com campo Funcionário e checkbox com Desligados; barra de ferramentas com botões Retornar, Importar e Via API; grade inferior Informações do Arquivo Importado com colunas Linha, Importado, Funcionário, Evento, Valor Arquivo, Valor Importado, Erro e Linha](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/api-ponto-gestor/api-ponto-gestor-13.png)

Após clicar em **Via API**, o sistema envia a requisição à API do Ponto Gestor usando a APICONFIG cadastrada (descrição `apipontogestor`, token e APIHOST) e realiza a importação automática dos registros de ponto para o período selecionado. O resultado de cada linha importada é exibido na grade **Informações do Arquivo Importado**.

---

> 📎 **Arquivos originais:** [api ponto gestor.docx](https://drive.google.com/uc?export=download&id=1AzmPbAVf57QVhDpNJ0BNKvj3gfqGRHrR) · [api ponto gestor.pdf](https://drive.google.com/uc?export=download&id=1ZFNpYZXQ6iQKQoL-a7XSfkogu-BJUGC_)

## Informações do documento

> Autor: José Luiz Pereira
> Setor: Qualidade
> Módulo: RH
> Chamado: 0000499553
> Versão do Sistema:
> Versão do documento: 01
> Revisão: Paulo Bley
> Aprovado em: mês FEV de 2026