Escalas¶

Qué es¶

Escala es la estructura que organiza la secuencia de días trabajados y de descanso a lo largo de un ciclo de trabajo (por ejemplo: 6x1, 12x36, 5x2). Para cada día del ciclo, la escala apunta cual jornada El colaborador debe seguir.

Dependencia crítica: Jornadas antes de Escalas

La escala referencia jornadas por día. Antes de crear una escala, las jornadas que ella usará ya deben estar registradas.

Diferencia: Jornada vs. Escala¶

	Jornada	Escala
Define	Horarios del día (entrada/saída/intervalos)	Secuencia de días (ciclo trabajo/folga)
Granularidad	1 día	Ciclo repetible (p. ej.: 6x1)
Depende de	Nada	Jornadas previamente registradas
Ejemplo	"Segunda: 08h-17h, 1h intervalo"	"6 días con Jornada A, 1 día libre"

Tipos de escala comunes¶

Tipo	Descripción
`5x2`	5 días trabajados, 2 de descanso (semana convencional)
`6x1`	6 días seguidos, 1 de descanso
`12x36`	12 horas trabajadas, 36 horas de descanso (plantones)
`4x3`	Semana 4 días

Por qué esto importa en una integración¶

El colaborador debe estar asociado a una escala para que la rutina sea automatizada
Cambios de escala impactan hoja y cumplimiento — se registrará la fecha de vigencia
En integraciones, escala es frecuentemente referenciada por su código de integración

Operaciones disponibles¶

Método	Variable	Descripción
GET	`/escalas/`	Listar escalas
POST	`/escalas/`	Crear escala
GET	`/escalas/{id}/`	Obtener escala
PATCH	`/escalas/{id}/`	Actualizar

Campos¶

Campo	Tipo	Obligatorio	Descripción
`id`	Integer	—	ID interno
`empregado_id`	Integer	Gálatas	ID del empleado
`tipo`	string	Gálatas	Tipo de escala (por ejemplo: `5x2`, `12x36`)
`data_inicio`	date	Gálatas	Inicio de la vigencia
`data_fim`	date	—	Fin de la vigencia (null = en vigor)
`jornadas`	array	—	Jornadas por día del ciclo

Ejemplo: Crear escala¶

Solicitud¶

HTTP
POST /pontotel/api/v4/escalas/
Authorization: Bearer {token}
Content-Type: application/json

{
  "empregado_id": 500,
  "tipo": "5x2",
  "data_inicio": "2025-01-15"
}

Respuesta (201 Created)¶

JSON
{
  "id": 200,
  "empregado_id": 500,
  "tipo": "5x2",
  "data_inicio": "2025-01-15",
  "data_fim": null,
  "jornadas": []
}

Errores comunes¶

Error	Causa	Solución
Escala sin jornadas	Jornadas no registradas antes de la escala	Cadastre jornadas primero
Fechas superpuestas	Período de vigencia conflictivo con escala existente	Cierre la escala anterior antes de crear nueva