Como Integrar a API do RHID Ponto ao seu ERP de Folha de Pagamento para Automatizar o Fluxo de Dados
Integrar a API do rhid ponto ao seu ERP de folha de pagamento é o caminho mais rápido e seguro para eliminar processos manuais de exportação de arquivos AFD/AFDT e automatizar o fechamento de ponto da sua empresa. O rhid ponto é a plataforma de controle de jornada em nuvem desenvolvida pela Secullum, que centraliza os registros de ponto dos colaboradores e disponibiliza uma API RESTful robusta para que desenvolvedores e equipes de TI possam sincronizar dados cadastrais, batidas e cálculos de horas diretamente com sistemas de gestão de RH (ERPs).
Para profissionais de tecnologia e administradores de sistemas, essa integração representa o fim das inconsistências geradas por importações manuais de arquivos de texto e garante total conformidade com a legislação trabalhista. Neste guia técnico completo, você compreenderá a arquitetura dessa API, os principais endpoints de integração, as melhores práticas de autenticação e como estruturar esse fluxo de dados de forma segura e escalável.
O que é a API do rhid ponto e como ela funciona?
A API do rhid ponto é uma interface de programação baseada no protocolo HTTP/HTTPS, que segue os princípios arquiteturais REST (Representational State Transfer). Ela foi projetada para permitir que sistemas externos interajam diretamente com o banco de dados do Ponto Secullum Web, realizando operações de leitura e escrita de forma segura e autenticada. A comunicação é feita por meio do envio de requisições padronizadas, e o retorno dos dados ocorre no formato JSON (JavaScript Object Notation), facilitando o parsing em praticamente qualquer linguagem de programação moderna, como C#, Java, Node.js, Python ou PHP.
Por meio dessa API, o seu ERP de folha de pagamento pode se comunicar de forma bidirecional com o sistema de ponto. Isso significa que, quando um novo colaborador é contratado e cadastrado no ERP, esses dados podem ser enviados automaticamente para o sistema de ponto. Da mesma forma, ao final do período de apuração, o ERP pode consumir os totais de horas trabalhadas, faltas, atrasos e horas extras calculados pelo sistema para gerar o holerite sem qualquer intervenção humana.
Benefícios técnicos da integração do rhid ponto com o ERP
A automação do fluxo de dados de jornada traz vantagens operacionais e de segurança que vão muito além da simples economia de tempo. Em primeiro lugar, a eliminação do tratamento manual de arquivos de texto (como o formato de exportação padrão das portarias do Ministério do Trabalho) mitiga drasticamente o risco de fraudes e erros operacionais. Quando o processo é manual, qualquer alteração indevida em um arquivo de texto antes da importação pode gerar passivos trabalhistas graves.
Além disso, a integração garante conformidade em tempo real com a Portaria 671/2021 do MTE, que exige alta precisão e inviolabilidade no registro e tratamento de dados de ponto. Ao conectar os sistemas via API, a empresa assegura que a trilha de auditoria permaneça intacta, desde a marcação no relógio físico ou aplicativo até o processamento final na folha de pagamento.
Outro ponto de destaque é a velocidade de processamento. Empresas que utilizam a integração conseguem fechar a folha de pagamento em metade do tempo habitual, liberando a equipe de Departamento Pessoal para atuar em análises estratégicas e auditorias preventivas, em vez de focar em digitação e conferência exaustiva de espelhos de ponto.
Arquitetura da integração: Endpoints essenciais para o fluxo de dados
Para desenhar uma integração eficiente com o ecossistema do rhid ponto, a equipe de desenvolvimento precisa mapear os endpoints corretos para cada etapa do fluxo de dados. A API da Secullum é estruturada de forma modular, permitindo o gerenciamento de diferentes entidades. Abaixo, apresentamos uma tabela com os principais endpoints utilizados em projetos de integração de folha de pagamento:
| Endpoint | Método HTTP | Descrição / Função no Fluxo |
|---|---|---|
/api/funcionarios | GET / POST / PUT | Sincroniza o cadastro de colaboradores do ERP para o sistema de ponto (e vice-versa). |
/api/batidas | GET / POST | Consulta as marcações brutas realizadas pelos colaboradores nos dispositivos ou aplicativo. |
/api/calculos | GET | Retorna os resultados consolidados de horas trabalhadas, extras, faltas e adicionais por período. |
/api/justificativas | GET / POST | Permite enviar ou consultar justificativas de ausências e atestados médicos integrados. |
Um fluxo de integração padrão geralmente segue a seguinte lógica cronológica: o ERP envia os novos funcionários cadastrados (POST em /api/funcionarios); diariamente ou semanalmente, o ERP consome as batidas brutas para acompanhamento (GET em /api/batidas); e, no fechamento do mês, o ERP consome o endpoint de cálculos (GET em /api/calculos) para obter os totais consolidados que irão compor a folha de pagamento.
Passo a passo para autenticação e consumo da API do rhid ponto
A segurança é um pilar fundamental na comunicação entre sistemas que lidam com dados sensíveis de colaboradores. A API do rhid ponto utiliza autenticação baseada em tokens de acesso (Bearer Token) transmitidos no cabeçalho (Header) das requisições HTTP. Para iniciar o desenvolvimento, siga o fluxo básico abaixo:
1. Geração das credenciais de acesso
O administrador do sistema deve acessar o painel administrativo do Ponto Secullum Web, navegar até a seção de configurações de integração e gerar uma chave de API (API Key) e um Client Secret específicos para a aplicação do ERP. Essas credenciais devem ser armazenadas de forma segura no ambiente do ERP (utilizando variáveis de ambiente ou cofres de senhas, nunca hardcoded no código-fonte).
2. Requisição do Token de Acesso
Antes de realizar qualquer chamada aos endpoints de dados, o ERP deve realizar uma requisição POST para o endpoint de autenticação (geralmente /api/oauth/token) enviando as credenciais. O servidor do RHID responderá com um JSON contendo o access_token e o tempo de expiração do mesmo.
3. Consumo dos Endpoints com o Token
Com o token em mãos, todas as requisições subsequentes devem incluir o cabeçalho de autorização. Veja um exemplo prático de estrutura de cabeçalho:
GET /api/calculos?dataInicio=2026-03-01&dataFim=2026-03-31 HTTP/1.1
Host: api.secullum.com.br
Authorization: Bearer SEU_TOKEN_AQUI
Accept: application/jsonSua aplicação deve ser projetada para monitorar a expiração do token e realizar o refresh de forma automática, evitando interrupções nas rotinas de sincronização agendadas (cron jobs).
Tratamento de erros e conciliação de dados de jornada
Em qualquer projeto de integração de sistemas, o tratamento de exceções é o que garante a resiliência da aplicação em produção. Quando lidamos com dados de ponto, falhas de rede, indisponibilidade temporária de APIs ou dados inconsistentes enviados por usuários podem ocorrer. Por isso, sua equipe de desenvolvimento deve implementar políticas rígidas de tratamento de erros.
Recomendamos a implementação de uma fila de mensageria (como RabbitMQ ou AWS SQS) ou uma tabela de log de sincronização no banco de dados do ERP. Caso uma tentativa de envio de cadastro de funcionário falhe devido a um erro de timeout (HTTP 504) ou limite de requisições (HTTP 429 – Too Many Requests), o sistema deve agendar uma nova tentativa automática utilizando a estratégia de exponential backoff (aumento progressivo do tempo de espera entre as tentativas).
Além disso, é fundamental validar os dados antes do envio. Certifique-se de que campos obrigatórios como CPF, PIS/PASEP, e ID de matrícula estejam no formato correto e não nulos, evitando que a API do rhid ponto retorne erros de validação (HTTP 400 – Bad Request) que exijam intervenção manual para correção.
⚠️ Material gratuito: Calculadora de Hora Extra
Baixe agora, é gratuito, e proteja sua empresa contra riscos trabalhistas.
Segurança da informação e conformidade com a LGPD na API
A integração de sistemas de ponto envolve o tráfego de dados pessoais e dados pessoais sensíveis (como dados biométricos e informações de saúde contidas em atestados médicos). Portanto, a segurança da informação deve ser tratada como prioridade máxima no desenvolvimento da integração, em total alinhamento com as diretrizes da Lei Geral de Proteção de Dados (LGPD).
Toda a comunicação entre o ERP e a API do rhid ponto deve ocorrer obrigatoriamente sob o protocolo HTTPS, garantindo a criptografia dos dados em trânsito. Além disso, o controle de acesso deve seguir o princípio do menor privilégio: as credenciais de API geradas no painel da Secullum devem ter apenas as permissões estritamente necessárias para a execução das tarefas do ERP (por exemplo, se o ERP apenas lê os dados de cálculo, a credencial não deve ter permissão de escrita ou exclusão de registros).
Para entender em detalhes como a plataforma protege essas informações sensíveis, vale a pena ler nosso artigo completo sobre a segurança de dados no RHID Ponto, que aborda a criptografia de biometrias e o armazenamento seguro em nuvem.
Como a Impacto Tecnologia apoia a sua equipe de TI na implantação
Desenvolver uma integração de sistemas do zero ou configurar conectores de ERPs de mercado exige conhecimento técnico especializado, tanto da API de destino quanto das regras de negócio que regem o controle de ponto. É nesse cenário que a Impacto Tecnologia atua como a parceira estratégica ideal para a sua empresa.
Como revendedora autorizada e especialista nas soluções da Secullum, a Impacto Tecnologia não apenas fornece as licenças do software, mas também oferece suporte técnico consultivo de alto nível para a equipe de TI da sua empresa. Nós auxiliamos no provisionamento correto das chaves de API, na interpretação da documentação técnica e na validação dos fluxos de dados, garantindo que a transição ocorra sem sobressaltos.
Se você está na fase de planejamento e quer garantir que está contratando a solução com a arquitetura correta para o seu cenário, recomendamos a leitura do nosso guia de avaliação para contratação do RHID Ponto, que traz um checklist técnico e contratual completo para apoiar sua decisão.
Fale com a Impacto Tecnologia
Preencha o formulário e nossa equipe entra em contato para entender a necessidade da sua empresa.
Perguntas frequentes sobre a API do RHID Ponto
1. A API do RHID Ponto possui limite de requisições (Rate Limit)?
Sim, para garantir a estabilidade e a alta disponibilidade da infraestrutura em nuvem, a Secullum aplica limites de requisições por minuto na API do RHID Ponto. É altamente recomendável que a sua equipe de TI implemente cache local para dados estáticos e evite requisições redundantes em intervalos muito curtos.
2. É possível enviar marcações de ponto retroativas via API?
Sim, a API permite o envio de marcações manuais ou correções, desde que o usuário associado às credenciais da API possua as permissões administrativas necessárias no sistema. Toda alteração retroativa gera um registro de auditoria, conforme exigido pela legislação trabalhista.
3. Quais ERPs de folha de pagamento são compatíveis com o RHID Ponto?
O RHID Ponto é compatível com praticamente qualquer ERP do mercado (como Totvs, Senior, Alterdata, Prosoft, Domínio, entre outros). A integração pode ser feita de forma nativa (caso o ERP já possua o conector homologado para Secullum) ou de forma personalizada consumindo a API RESTful diretamente.
4. Como a API lida com a sincronização de funcionários demitidos?
Ao atualizar o status de um colaborador para “Demitido” no ERP, uma requisição PUT ou POST enviada ao endpoint /api/funcionarios com a data de desligamento atualizará automaticamente o cadastro no RHID Ponto, bloqueando novas marcações de ponto nos relógios e aplicativos imediatamente.
5. Os dados de geolocalização das batidas de equipes externas estão disponíveis na API?
Sim. Quando os colaboradores realizam a marcação de ponto pelo aplicativo do RHID utilizando dispositivos móveis, as coordenadas geográficas (latitude e longitude) são capturadas e disponibilizadas no payload de retorno do endpoint de batidas, permitindo auditoria de rotas pelo ERP.
6. Preciso pagar alguma taxa adicional para utilizar a API do RHID Ponto?
O acesso à API do RHID Ponto está condicionado ao plano de assinatura contratado do Ponto Secullum Web. Planos corporativos geralmente já incluem o acesso completo aos endpoints de integração. Para confirmar as condições comerciais e obter suporte na liberação das chaves, entre em contato com a equipe comercial da Impacto Tecnologia.