Consultar asociaciones a servicio por empleado
Este endpoint permite consultar las asociaciones a servicio de un empleado.
GET /api/v1/business/{businessId}/person/{personId}/service-associationsSi los datos incluidos en la petición son correctos —tanto el businessId como el personId—, la respuesta contendrá todas las asociaciones a servicio del empleado pasado por parámetro.
A continuación, se muestra un ejemplo de respuesta:
[
{
"ownerProduct": "0001-G",
"product": "0001-G",
"from": "2021-06-25",
"splitPresence": true,
"unplannable": false,
"roles": [],
"disponibility": [
{
"from": "2021-06-25",
"ranges": [
{
"dayType": "ALL",
"startMinuteDay": 0,
"duration": 1440
}
]
}
],
"regularCessions": [
{
"product": "0003",
"minutes": 240,
"days": [
"TUESDAY"
]
}
],
"service": "0001",
"person": {
"name": "John",
"surname": "Smith",
"birthday": "1987-05-07",
"employeeId": "152015",
"virtual": false
}
},
{
"ownerProduct": "0001-G",
"product": "0002",
"from": "2024-10-08",
"to": "2024-10-15",
"splitPresence": false,
"unplannable": false,
"roles": [],
"disponibility": [
{
"from": "2024-10-08",
"to": "2024-10-15",
"ranges": [
{
"dayType": "ALL",
"startMinuteDay": 0,
"duration": 1440
}
]
}
],
"service": "0002",
"person": {
"name": "John",
"surname": "Smith",
"birthday": "1987-05-07",
"employeeId": "152015",
"virtual": false
}
}
]Como se puede ver en el ejemplo, los datos de la respuesta dependen de la información que se haya definido para el empleado.
En este caso, el empleado tiene una asociación a servicio al producto 0001-G desde el 2021-06-25, con una cesión regular de cuatro horas los martes en 0003 y una cesión desde el 2024-10-08 al 2024-10-15 al producto 0002.
Aspectos que tener en cuenta
La petición devolverá todas las asociaciones a servicio y cesiones del empleado. Si hay cesiones regulares definidas dentro de alguna de las asociaciones, también aparecerán en la respuesta.
Si el identificador de empleado indicado en la URL no existe en el negocio, la petición devolverá un error 404 Not Found, especificando en el mensaje Employee not found.
Si no hay asociaciones a servicio para el empleado (ni activas ni finalizadas), la petición devolverá un array vacío [].
Enlaces de interés
¿Qué es una asociación a servicio? ¿Y una cesión?