Asignar una vacante

Este endpoint permite asignar a un empleado una vacante previamente publicada.

POST /api/v1/businesses/{business}/vacancies/{vacancy}/acceptor/{employee}

Los datos que hay que incluir en la petición son los siguientes:

  • business: identificador externo configurado en Orquest para el negocio.

  • vacancy: identificador externo de la vacante. Debe definirse en la creación de vacantes por API; si la vacante se crea manualmente, el identificador externo se genera de manera automática.

  • employee: identificador externo del empleado al que se quiere asignar la vacante.

Consideraciones

Si los datos de la petición son correctos, se creará una asignación con la tarea Vacante y se añadirá el nombre del empleado en la columna Aceptada por del apartado de Planificación > Oferta de turnos vacantes.

Esta petición no comprueba que el empleado estuviera entre los ofertados originalmente para la vacante (campo employees de registrar una vacante). Se recomienda comprobar por cuenta propia, antes de asignar, que el employee indicado es uno de los que figuraban en la oferta original.

Códigos de error

Además de los errores comunes, este endpoint puede devolver los siguientes códigos:

Código Mensaje Descripción

404 Not Found

Vacancy not found

El identificador de la vacante no existe.

400 Bad Request

Vacancy already assigned

La vacante ya ha sido aceptada por otro empleado.

Vacancy expired

La fecha límite de la vacante (expiration) ya ha pasado.

Vacancy overlapped by person incidence

La vacante solapa con una incidencia del empleado.

Enlaces de interés

¿Qué es una vacante?

¿Cómo registrar una vacante?