Asignar horario masivo

Entorno desarrollo

https://dev-api.talentify.cr

POST

/api/tiempo-laborado/horarios-masivos

Crea un único horario a partir de un patrón semanal y lo aplica a varias personas durante un rango de fechas.

Campos

Campo	Obligatorio	Descripción
`personas`	Sí	Lista de ids de personas.
`fechaDesde`	Sí	Inicio de vigencia (`DD/MM/YYYY`).
`fechaHasta`	Sí	Fin de vigencia (`DD/MM/YYYY`).
`horarioSemanal`	Sí	Lista de días con sus horas: `diaSemana` (ISO `1`–`7`), `horaEntrada` y `horaSalida` (`HH:mm`).
`descripcion`	No	Descripción del horario (por defecto `Horario`).
`color`	No	Color del horario.

Se busca una jornada que cubra el rango horario más amplio del patrón. Si no existe jornada adecuada o no hay días laborables, no se aplica ningún horario y responde 406. La respuesta incluye aplicados (cuántas personas) y errores (detalle por persona no aplicada).

Solicitud

Autorización

Bearer Token

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

Authorization: Bearer ********************

Parámetros de Header

Parámetros del Body application/json

Ejemplos

Respuestas

🟢200Éxito

application/json

Horario creado y aplicado a las personas.

Bodyapplication/json

🟠406No procesado

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location 'https://dev-api.talentify.cr/api/tiempo-laborado/horarios-masivos' \
--header 'Accept: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "personas": [
        5062,
        5063,
        5064
    ],
    "fechaDesde": "01/05/2026",
    "fechaHasta": "31/05/2026",
    "horarioSemanal": [
        {
            "diaSemana": 1,
            "horaEntrada": "08:00",
            "horaSalida": "17:00"
        },
        {
            "diaSemana": 2,
            "horaEntrada": "08:00",
            "horaSalida": "17:00"
        },
        {
            "diaSemana": 3,
            "horaEntrada": "08:00",
            "horaSalida": "17:00"
        },
        {
            "diaSemana": 4,
            "horaEntrada": "08:00",
            "horaSalida": "17:00"
        },
        {
            "diaSemana": 5,
            "horaEntrada": "08:00",
            "horaSalida": "16:00"
        }
    ],
    "descripcion": "Horario mayo",
    "color": "#3B82F6"
}'

Ejemplo de Respuesta

200 - Success

{
    "satisfactorio": true,
    "aplicados": 3,
    "horario": {
        "id": 1186,
        "descripcion": "Horario administrativo",
        "acumulativa": false,
        "continua": false,
        "activo": true,
        "porDefecto": false,
        "dias": [
            {
                "dia": 1,
                "horaEntrada": "08:00",
                "horaSalida": "17:30",
                "horas": 8,
                "minutos": 30
            },
            {
                "dia": 2,
                "horaEntrada": "08:00",
                "horaSalida": "17:30",
                "horas": 8,
                "minutos": 30
            },
            {
                "dia": 3,
                "horaEntrada": "08:00",
                "horaSalida": "17:30",
                "horas": 8,
                "minutos": 30
            },
            {
                "dia": 4,
                "horaEntrada": "08:00",
                "horaSalida": "17:30",
                "horas": 8,
                "minutos": 30
            },
            {
                "dia": 5,
                "horaEntrada": "08:00",
                "horaSalida": "17:30",
                "horas": 8,
                "minutos": 30
            },
            {
                "dia": 6,
                "horaEntrada": "08:00",
                "horaSalida": "14:30",
                "horas": 6,
                "minutos": 30
            }
        ],
        "diaDescanso": 7,
        "color": "#3B82F6",
        "jornada": {
            "id": 461,
            "tipo": "DIURNA",
            "pais": "CRC",
            "horaMinima": "05:00",
            "horaMaxima": "19:00",
            "horasSemanales": 48,
            "horasPorPeriodo": 240,
            "horasPorDia": 8,
            "activo": true,
            "fechaCreacion": "01/01/2025 09:00",
            "fechaActualizacion": null,
            "creadoPor": {
                "id": 509,
                "persona": 8061,
                "nombre": "Manfred",
                "primerApellido": "Juárez",
                "segundoApellido": "",
                "correoElectronico": "prueba@prueba.com",
                "nacionalidad": "CRC",
                "tipoIdentificacion": "01",
                "identificacion": "5435345"
            },
            "actualizadoPor": null
        },
        "fechaCreacion": "01/01/2025 09:00",
        "fechaActualizacion": null,
        "creadoPor": {
            "id": 509,
            "persona": 8061,
            "nombre": "Manfred",
            "primerApellido": "Juárez",
            "segundoApellido": "",
            "correoElectronico": "prueba@prueba.com",
            "nacionalidad": "CRC",
            "tipoIdentificacion": "01",
            "identificacion": "5435345"
        },
        "actualizadoPor": null
    },
    "errores": []
}

Modificado en 2026-06-17 23:15:10

Eliminar HorariosAplicados

Programar horario en una fecha

Asignar horario masivo

Campos#

Solicitud

Respuestas

Campos