Obtener aptitudes por servicio
Este endpoint devuelve las aptitudes de todos los empleados del servicio indicado en la petición.
GET /api/v1/businesses/{businessId}/services/{serviceId}/aptitudesSi los datos incluidos en la petición son correctos —tanto el businessId como el serviceId—, la respuesta contendrá las aptitudes para cada empleado en todos los productos del servicio donde tenga alguna aptitud definida, detallando la siguiente información:
-
employeeId: identificador externo del empleado.
-
aptitudes: listado de aptitudes dentro del servicio para el empleado.
-
productId: identificador externo del producto o sección donde el empleado tiene definida la aptitud.
-
aptitudes: listado de aptitudes para el empleado dentro del producto o sección.
-
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 el fragmento de una respuesta como ejemplo:
[
{
"employeeId": "000",
"aptitudes": [
{
"productId": "0001-G",
"aptitudes": [
{
"locationId": "02",
"level": 2
},
{
"locationId": "01",
"level": 2
},
{
"locationId": "03",
"level": 3
},
{
"locationId": "05",
"level": 3
},
{
"locationId": "06",
"level": 2
}
]
}
]
},
{
"employeeId": "001",
"aptitudes": [
{
"productId": "0001-G",
"aptitudes": [
{
"locationId": "02",
"level": 3
},
{
"locationId": "01",
"level": 2
}
]
},
{
"productId": "008",
"aptitudes": [
{
"locationId": "06",
"level": 3
}
]
}
]
}
]Tal y como se aprecia en el ejemplo, si un empleado tiene aptitudes en varios productos del servicio, en la lista aparecerán todas ellas.
Aspectos que tener en cuenta
Los datos de los empleados que NO tengan configurado el identificador externo en el sistema no se incluirán en la respuesta.
Si no hay aptitudes definidas para los empleados del servicio indicado, la petición devolverá un array vacío [].
Si el servicio indicado en la URL no existe en el negocio, la petición devolverá un error 404 Not Found, especificando en el mensaje not exits.