Saltar a contenido

Jornadas

Qué es

Jornada define los horarios dentro de un día de trabajo: hora de entrada, hora de salida, intervalos y si hay trabajo previsto ese día.

Es la unidad fundamental usada por las escalas para montar la rutina del colaborador.

Tipos de Jornada

Tipo Descripción Comportamiento
Con trabajo Día con entrada/salida previstas Ausencia sin registro → falta
Sin trabajo Folga o descanso Ausencia no genera falta

Por qué importa

Si una jornada "sin trabajo" se asocia a un día de descanso, el sistema no espera marcado, correctamente. Pero si una jornada "con trabajo" se usa en un día que el colaborador no debería trabajar, puede generar falta incorrectamente.

Por qué esto importa en una integración

  • Jornada influencia la interpretación de los registros de punto y el cálculo de la hoja
  • En integraciones, el viaje es frecuentemente referenciado por su código
  • Debe ser cadastrada antes las escalas (depencia obligatoria)

Operaciones disponibles

Método Variable Descripción
GET /jornadas/ Listar jornadas
POST /jornadas/ Crear viaje
GET /jornadas/{id}/ Obtener viaje
PATCH /jornadas/{id}/ Actualizar

Campos

Campo Tipo Obligatorio Descripción
id Integer — ID interno
empregador_id Integer Gálatas Empleador al que pertenece
codigo string Recomendado Código de integración
nome string Gálatas Nombre descriptivo de la jornada
tipo string Gálatas com_trabalho o sem_trabalho
dia_semana Integer — Día (0=Seg, 6=Dom), cuando se fija
hora_entrada equipo — Horario de entrada
hora_saida equipo — Horario de salida
intervalo_minutos Integer — Duración del intervalo (minutos)

Ejemplo: Crear Jornada con trabajo

Solicitud

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

{
  "empregador_id": 42,
  "codigo": "JOR-PADRAO",
  "nome": "Jornada Padrão 8h",
  "tipo": "com_trabalho",
  "hora_entrada": "08:00:00",
  "hora_saida": "17:00:00",
  "intervalo_minutos": 60
}

Respuesta (201 Created)

JSON
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
{
  "id": 301,
  "empregador_id": 42,
  "codigo": "JOR-PADRAO",
  "nome": "Jornada Padrão 8h",
  "tipo": "com_trabalho",
  "hora_entrada": "08:00:00",
  "hora_saida": "17:00:00",
  "intervalo_minutos": 60
}

Ejemplo: Crear Jornada de Folga

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

{
  "empregador_id": 42,
  "codigo": "JOR-FOLGA",
  "nome": "Folga",
  "tipo": "sem_trabalho"
}

Errores comunes

Error Causa Solución
Falta generada erróneamente Jornada con trabajo en día de descanso Use tipo: sem_trabalho para descansos
Escala sin viaje Intentar crear escala antes de las jornadas Cadastre jornadas primero