Integrações BR

O principal caminho de adoção do VELIX no mercado brasileiro é a integração com os sistemas de RH e ponto que a empresa cliente já utiliza. Esta seção reúne guias técnicos para sincronizar cadastros de funcionários e batidas de ponto entre o VELIX e os ERPs/sistemas de ponto mais comuns no Brasil.

:::info Objetivo Cada guia foi escrito para que o time de TI do cliente avalie sozinho a viabilidade da integração, sem depender de uma reunião técnica com a Velix. :::

Guias disponíveis

Sistema	Tipo de integração	Página
TOTVS RM	REST + OAuth2 client_credentials	Guia
Senior RH / Senior X	SOAP (legado) + REST (X)	Guia
Datasul (TOTVS)	Progress 4GL via REST Bridge	Guia
Secullum / Dimep / Control iD	Exportação AFD (Portaria 671 MTE)	Guia
REP-C (Portaria 671 MTE)	Fonte de dados para REP homologado	Guia

Padrão comum

Todas as integrações seguem o mesmo modelo conceitual:

1. Sincronização de cadastro — o ERP é a fonte da verdade de admissões/demissões. Um job periódico (ou webhook do ERP, quando disponível) espelha os funcionários como Person no VELIX via POST /v1/persons, usando o identificador nativo do ERP como externalId.
2. Enroll biométrico — feito separadamente, geralmente via app-velix-onboarding ou pelo portal do colaborador (app-velix-id-portal), nunca automatizado a partir do ERP.
3. Exportação de batidas — quando o cliente precisa manter o REP-C homologado (Portaria 671 MTE) como sistema de registro oficial, o VELIX exporta as batidas no formato AFD para importação manual ou automatizada.

Autenticação

Todas as chamadas de sincronização usam o mesmo Bearer token descrito em Autenticação, com o escopo persons:manage. Recomenda-se criar uma API key dedicada para o job de sincronização (POST /v1/auth/api-keys), isolada da API key usada por outras integrações.