Obtener aptitudes por empleado

Este endpoint devuelve todas las aptitudes de un empleado.

GET /api/v1/businesses/{businessId}/people/{employeeId}/aptitudes

Si los datos incluidos en la petición son correctos —tanto el businessId como el employeeId—, la respuesta contendrá las aptitudes para el empleado en todos los productos donde tenga alguna aptitud definida, detallando la siguiente información:

  • productId: identificador externo del producto o sección donde el empleado tiene definida la aptitud.

  • aptitudes: listado de aptitudes.

    • locationId: identificador externo de la tarea a la que hace referencia la aptitud.

    • level: nivel de competencia en dicha tarea en un rango de 0 (no competente) a 3 (experto).

A continuación, se muestra un ejemplo de respuesta:

[
    {
        "productId": "008",
        "aptitudes": [
            {
                "locationId": "06",
                "level": 3
            }
        ]
    },
    {
        "productId": "0001-G",
        "aptitudes": [
            {
                "locationId": "02",
                "level": 3
            },
            {
                "locationId": "01",
                "level": 2
            }
        ]
    }
]

Tal y como se aprecia en el ejemplo, si un empleado tiene aptitudes en varios productos, en la lista aparecerán todas ellas.

Aspectos que tener en cuenta

Si el identificador del empleado no existe en el negocio, la petición devolverá un error 404 Not Found, especificando en el mensaje Person not found.

Si no hay aptitudes definidas para el empleado, la petición devolverá un array vacío [].

Enlaces de interés

¿Qué es una aptitud?

¿Qué es una tarea?