Consultar 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 contendrá 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.

Aspectos que tener en cuenta

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 [].

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.

Enlaces de interés

¿Qué es una asociación a servicio? ¿Y una cesión?