Asignar una trayectoria formativa

Este endpoint permite asignar todos los cursos de una trayectoria formativa a varios empleados de un servicio, a partir de una fecha de inicio común.

POST /api/v2/businesses/{businessId}/services/{serviceId}/training-paths/{trainingPathId}/assignments/bulk

A continuación, se expone una explicación detallada de cada uno de los campos que pueden conformar el cuerpo de la petición, siendo algunos de ellos obligatorios para que esta se realice de manera exitosa.

Todos los campos de esta petición son obligatorios.

Cuerpo de la petición

Análisis del JSON 
{
  "employeeIds": [
    "string"
  ],
  "startDate": "string"
}
Detalles

  • employeeIds*: lista de identificadores externos de los empleados a los que se asigna la trayectoria. No puede contener empleados repetidos.

  • startDate*: fecha de inicio de la trayectoria, que corresponde a su día 1. Formato yyyy-MM-dd.

Ejemplo de la petición

Una vez realizado el análisis de los distintos campos, se muestra un ejemplo de la petición:

POST /api/v2/businesses/BUSINESSID/services/SERVICEID/training-paths/TPID/assignments/bulk
{
  "employeeIds": [
    "000001"
  ],
  "startDate": "2026-10-19"
}

Si la petición es correcta, la respuesta será un 201 Created con una asignación de curso por cada empleado y cada curso de la trayectoria.

Consideraciones

Asignar una trayectoria formativa equivale a asignar cada uno de sus cursos por separado: se crea una asignación de curso por cada empleado y por cada curso de la trayectoria.

La fecha de cada entrenamiento se calcula a partir de startDate y del día que tiene el entrenamiento en el calendario de la trayectoria. La fecha de cada asignación (date) es la de su primer entrenamiento.

La petición no es idempotente: si se repite, se crean asignaciones duplicadas para los mismos empleados.

Códigos de error

Además de los errores comunes, este endpoint puede devolver los siguientes códigos:

Código Mensaje Descripción

404 Not Found

Training path not found: <trainingPathId>

El trainingPathId indicado no existe en el negocio.

Person <personId> not found in service

Alguno de los empleados no tiene contrato o asociación al servicio durante todo el periodo de la trayectoria. El mensaje incluye el identificador interno de Orquest del empleado.

400 Bad Request

Training path has no courses

La trayectoria formativa no tiene cursos.

Training path order is inconsistent with course

El calendario de la trayectoria no es coherente con la definición actual de alguno de sus cursos.

Enlaces de interés

¿Qué es un curso? ¿Y una trayectoria formativa?

¿Qué es una asignación de curso?