Saltar a contenido

Empleados

Qué es

Empleado Es el registro del colaborador dentro de Pontotel — concentra todos los datos necesarios para la gestión de punto, hoja, organización y parametrizaciones de rutina (jornada/escala).

Es normalmente la entidad central del dominio de RH en integraciones.

Por qué esto importa en una integración

  • Sincronización de registro: admisión, cambios y apagado reflejan el ERP/folha
  • Base para otros vínculos: usuarios, jornadas, escalas, vacaciones y alejamientos dependen del empleado
  • Clave de integración: codigo (matrícula) garantiza el mapeo entre sistemas a lo largo del tiempo

Establecer la clave de integración antes del inicio

Elija un campo estable como clave (por ejemplo: codigo o cpf) y mantenga ese patrón durante toda la integración. Evita duplicatas y facilita trazabilidad.

Reglas de negocio

  • CPF debe ser único por empleador
  • Matrícula (codigo) debe ser única por empleador (cuando sea informada)
  • El empleado sólo puede ser vinculado a un empleador activo
  • Desconectado se debe hacer vía is_active: false + data_demissao, no vía DELETE
  • Empleado inactivo no puede registrar nuevas marcas de punto

Relaciones

graph TD
    EMP["👤 Empregado"]
    EMP --> B["🏢 Empregador"]
    EMP --> C["📍 Local de Trabalho"]
    EMP --> D["📅 Escala"]
    EMP --> E["🔑 Usuário associado"]
    EMP --> F["🕐 Marcações de Ponto"]
    EMP --> G["🏖️ Férias"]
    EMP --> H["🏥 Afastamentos"]

Operaciones disponibles

Método Variable Descripción
GET /empregados/ Listar empleados
POST /empregados/ Crear empleado
GET /empregados/{id}/ Obtener empleado
PUT /empregados/{id}/ Actualizar (completo)
PATCH /empregados/{id}/ Actualizar (parcial)

Campos

Campo Tipo Obligatorio Descripción
id Integer — ID interno
empregador_id Integer Gálatas ID del empleador
local_trabalho_id Integer Recomendado Lugar de asignación
cpf string Gálatas CPF del colaborador
codigo string Recomendado Matrícula / código de integración (usá el código ERP)
nome string Gálatas Nombre completo
email string Recomendado Correo electrónico (utilizado para crear usuario automáticamente)
data_admissao date Gálatas Fecha de admisión
data_demissao date — Fecha de dimisión
escala_id Integer — Escala de trabajo
is_active boolean — Status (estándar: true)
created_at datetime — Fecha de creación
updated_at datetime — Última actualización

Ejemplo: Crear empleado

Solicitud

HTTP
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
POST /pontotel/api/v4/empregados/
Authorization: Bearer {token}
Content-Type: application/json

{
  "empregador_id": 42,
  "local_trabalho_id": 10,
  "cpf": "123.456.789-00",
  "codigo": "EMP-001",
  "nome": "Juan Pérez",
  "email": "joao.silva@empresa.com",
  "data_admissao": "2025-01-15",
  "escala_id": 200
}

Respuesta (201 Created)

JSON
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
{
  "id": 500,
  "empregador_id": 42,
  "local_trabalho_id": 10,
  "cpf": "123.456.789-00",
  "codigo": "EMP-001",
  "nome": "Juan Pérez",
  "email": "joao.silva@empresa.com",
  "data_admissao": "2025-01-15",
  "data_demissao": null,
  "is_active": true,
  "created_at": "2025-01-31T10:00:00-03:00"
}

Ejemplo: Desconectar empleado

HTTP
1
2
3
4
5
6
7
8
PATCH /pontotel/api/v4/empregados/500/
Authorization: Bearer {token}
Content-Type: application/json

{
  "is_active": false,
  "data_demissao": "2025-12-31"
}

Filtros disponibles

HTTP
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
# Por empregador
GET /empregados/?empregador_id=42

# Apenas ativos
GET /empregados/?is_active=true

# Por CPF (sem pontuação)
GET /empregados/?cpf=12345678900

# Por código de integração
GET /empregados/?codigo=EMP-001

# Admitidos em 2025
GET /empregados/?data_admissao_gte=2025-01-01&data_admissao_lte=2025-12-31

Errores comunes

Error Causa Solución
CPF duplicado Crear dos empleados con el mismo CPF en el mismo empleador Busca por CPF antes de crear
Empleado duplicado Falta de clave única estable Defina y use codigo como clave de integración
Actualización de escala sin viaje Escala referencia jornadas no registradas Cadastre jornadas antes de las escalas
Marcaciones negadas después de desconectar Empleado inactivo intentando registrar punto Confirme is_active antes de autorizar