Obtener asociaciones a servicio actuales

Este endpoint permite consultar las asociaciones a servicio actuales de un servicio.

GET /api/v1/businesses/{businessId}/services/{serviceId}/service-associations/current

Si los datos incluidos en la petición son correctos —tanto el businessId como el serviceId—, la respuesta será un 200 OK con todas las asociaciones a servicio con fecha de inicio anterior a la fecha actual y fecha de fin posterior a la fecha actual (o no establecida).

Ejemplo de respuesta

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

[
    {
        "ownerProduct": "0001-G",
        "product": "0001-G",
        "from": "2021-06-25",
        "splitPresence": true,
        "unplannable": false,
        "employeeId": "152015",
        "service": "0001"
    },
    {
        "ownerProduct": "0001-G",
        "product": "0001-G",
        "from": "2021-06-25",
        "splitPresence": true,
        "unplannable": false,
        "employeeId": "1006357",
        "service": "0001"
    },
    {
        "ownerProduct": "0001-G",
        "product": "0002",
        "from": "2024-10-08",
        "to": "2024-10-15",
        "splitPresence": false,
        "unplannable": false,
        "employeeId": "152015",
        "service": "0002"
    }
]
Detalles

  • ownerProduct*: identificador externo del producto o sección al que pertenece el empleado.

  • product*: identificador externo del producto o sección donde va a trabajar el empleado. Puede ser igual al ownerProduct; si es distinto, se trata de una cesión.

  • from*: fecha de inicio de la asociación a servicio en formato yyyy-MM-dd.

  • to: fecha de finalización de la asociación a servicio en formato yyyy-MM-dd. Puede ser null, indicando que no hay fecha de fin establecida.

  • splitPresence: determina si se trata de un turno partido. El valor por defecto es true.

  • unplannable: determina si el empleado será ignorado por el planificador, por lo que deberá planificarse a mano. El valor por defecto es false.

  • id: identificador externo de la asociación a servicio.

  • employeeId: identificador externo del empleado.

  • service: identificador externo del servicio o tienda.

Consideraciones

La petición devolverá todas las asociaciones a servicio y cesiones en las que el ownerProduct coincida con los productos del servicio indicado en la URL.

Las cesiones regulares no aparecen en la respuesta.

Si no hay asociaciones a servicio actuales, la petición devolverá un array vacío [].

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 una asociación a servicio? ¿Y una cesión?