Consultar las vacantes asignadas a un empleado

Este endpoint devuelve las vacantes que un empleado ha aceptado en un intervalo de tiempo determinado.

GET /api/v1/businesses/{businessId}/employees/{employeeId}/vacancies?from={yyyy-MM-dd}&to={yyyy-MM-dd}

Si los datos incluidos en la petición son correctos —tanto el businessId como el employeeId—, la respuesta contendrá el listado de vacantes aceptadas por el empleado.

Ejemplo de respuesta

{
    "vacancies": [
        {
            "id": "TV7",
            "product": "0001-G",
            "day": "2026-07-24",
            "publishToSiblings": true,
            "shifts": [
                {
                    "start": "2026-07-24T20:00:00+02:00",
                    "end": "2026-07-24T21:00:00+02:00"
                },
                {
                    "start": "2026-07-24T23:00:00+02:00",
                    "end": "2026-07-25T05:00:00+02:00"
                }
            ],
            "employees": [
                "1006370",
                "2677189"
            ],
            "acceptedEmployee": "2677189"
        }
    ]
}
Detalles

  • id: identificador externo de la vacante.

  • product: identificador externo del producto vinculado con la vacante.

  • day: día de la vacante en formato yyyy-MM-dd.

  • publishToSiblings: indica si la vacante se publicó también para los productos hermanos (true) o solo para el producto indicado (false).

  • shifts: turnos definidos para la vacante. Los campos start y end se devuelven en la hora local del servicio, incluyendo su zona horaria correspondiente.

  • employees: listado de identificadores externos de todos los empleados a los que se les ofreció la vacante.

  • acceptedEmployee: identificador externo del empleado que aceptó la vacante. Coincide con el employeeId de la petición.

Aspectos que tener en cuenta

Este endpoint solo devuelve las vacantes donde el empleado consultado es el aceptante (acceptedEmployee); las vacantes que se le ofrecieron pero que no aceptó no aparecen en el listado.

Si no hay vacantes aceptadas por el empleado para el periodo de tiempo indicado, la petición devolverá un listado vacancies vacío.

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

Si el parámetro to es anterior a from, la petición devolverá un error 400 Bad Request.

Enlaces de interés

¿Qué es una vacante?

¿Cómo registrar una vacante?