Obtener cursos de un empleado

Este endpoint devuelve los cursos en los que tiene asignación un empleado, con la fecha y el estado de cada uno de sus entrenamientos.

GET /api/v2/businesses/{businessId}/services/{serviceId}/employees/{employeeId}/course-assignments?fromDate={yyyy-MM-dd}&toDate={yyyy-MM-dd}&courseId={courseId}

Si los datos incluidos en la petición son correctos, la respuesta devolverá la lista de asignaciones de cursos del empleado.

Ejemplo de respuesta

[
  {
    "id": "5f0c2e1a-7b3d-4c2e-9a41-0d6f1b2c3e4f",
    "courseId": "CRS-CAJ",
    "employeeId": "093222",
    "date": "2026-10-19",
    "approved": true,
    "approvedUntil": "2027-10-19",
    "trainings": [
      {
        "trainingId": "TRN-CAJ-NOR",
        "date": "2026-10-19",
        "status": "ATTENDED"
      },
      {
        "trainingId": "TRN-CAJ-TPV",
        "date": "2026-10-19",
        "status": "ATTENDED"
      },
      {
        "trainingId": "TRN-CAJ-ARQ",
        "date": "2026-10-20",
        "status": "PASSED"
      }
    ]
  }
]
Detalles

  • id: identificador externo de la asignación de curso. Lo genera siempre Orquest.

  • courseId: identificador externo del curso asignado.

  • employeeId: identificador externo del empleado.

  • date: fecha de inicio de la asignación, es decir, la fecha de su primer entrenamiento. Formato yyyy-MM-dd.

  • approved: indica si el curso está aprobado (true) o no (false).

  • approvedUntil: fecha hasta la que es válida la aprobación, en formato yyyy-MM-dd. No se incluye si el curso no está aprobado o si la aprobación no caduca, por lo que es necesario consultar approved para distinguir ambos casos.

  • trainings: entrenamientos de la asignación, ordenados por fecha. Para cada entrenamiento, se incluye la siguiente información:

    • trainingId: identificador externo del entrenamiento.

    • date: fecha en la que se realiza el entrenamiento, en formato yyyy-MM-dd.

    • status: estado del entrenamiento. Los valores posibles son PENDING (sin resultado registrado), ATTENDED (ha asistido), NOT_ATTENDED (no ha asistido), PASSED (superado) y FAILED (no superado).

Consideraciones

Los parámetros de la URL fromDate, toDate y courseId son opcionales:

  • Si se indica courseId, solo se devuelven las asignaciones de ese curso.

  • Los parámetros fromDate y toDate se aplican sobre la fecha de inicio de la asignación (date), ambas fechas incluidas. Una asignación que empieza antes de fromDate no se devuelve, aunque alguno de sus entrenamientos esté dentro del periodo.

Si el empleado no tiene asignaciones de cursos, la petición devolverá un array vacío [].

Estado del curso

El estado general de la asignación de un curso depende de la fecha actual y de los estados de sus entrenamientos:

  • Planificado: todos los entrenamientos son futuros.

  • En formación: hay entrenamientos pasados y futuros.

Si todos los entrenamientos son pasados:

  • Aprobado: todos los entrenamientos que se evalúan están en PASSED o, si ninguno se evalúa, todos están en ATTENDED.

  • Suspendido: algún entrenamiento está en FAILED.

  • No asistido: algún entrenamiento está en NOT_ATTENDED.

  • Pendiente de aprobación: en cualquier otro caso.

Para saber si el curso está aprobado y vigente, se deben consultar los campos approved y approvedUntil.

Si el curso se ha modificado después de crear la asignación, la asignación conserva la definición del curso que tenía en ese momento.

Códigos de error

Este endpoint no devuelve códigos de error propios que no se encuentren descritos en errores comunes.

Enlaces de interés

¿Qué es un curso?

¿Qué es la asignación de un curso?