Registrar una vacante

Este endpoint permite crear una vacante y hacerla pública para los empleados indicados en la petición.

POST /api/v1/businesses/{businessId}/vacancies

Los campos obligatorios están marcados con un asterisco (*).

Cuerpo de la petición

Análisis del JSON 
{
  "id": "string",
  "product": "string",
  "day": "string",
  "expiration": "string",
  "employees": [
    "string",
    "string"
  ],
  "shifts": [
    {
      "start": "string",
      "end": "string"
    }
  ]
}
Detalles

  • id*: identificador externo de la vacante.

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

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

  • expiration*: fecha límite hasta la cual se puede postular a la vacante; una vez que ha pasado esa fecha, no se podrán aceptar solicitudes para la vacante. Se debe enviar en formato yyyy-MM-ddTHH:mm:ssZ.

  • employees*: listado de identificadores de los empleados a los que se notificará la publicación de la vacante. Solo se pueden incluir empleados que pertenezcan al mismo producto donde se publica la vacante.

  • shifts*: lista de turnos definidos para la vacante. Incluye, para cada intervalo, los siguientes campos:

    • start*: inicio del turno en formato yyyy-MM-ddTHH:mm:ssZ. Debe coincidir con la fecha para la que se publica la vacante.

    • end*: fin del turno en formato yyyy-MM-ddTHH:mm:ssZ. Puede ser posterior a la fecha para la que se publica la vacante, por ejemplo, en turnos que terminan después de las 00:00.

Ejemplo de la petición

Una vez realizado el análisis de los distintos campos, se muestra un ejemplo del cuerpo de la petición:

{
  "id": "0625-vac",
  "product": "0001-G",
  "day": "2024-06-25",
  "expiration": "2024-06-24T10:00:00Z",
  "employees": [
    "1006355",
    "1006356"
  ],
  "shifts": [
    {
      "start": "2024-06-25T10:00:00Z",
      "end": "2024-06-25T17:00:00Z"
    }
  ]
}

Si los datos son correctos, la vacante se publicará y será visible en el apartado de Planificación > Oferta de turnos vacantes. En el ejemplo expuesto, para un servicio en UTC+2, la vacante publicada sería la siguiente:

  • Turno: 25 jun. 2024 12:00 - 25 jun. 2024 19:00

  • Vencimiento: 24 jun. 2024 12:00

Aspectos que tener en cuenta

Las horas se deben enviar en UTC y la publicación se realiza considerando el huso horario del servicio.

Si la vacante ya existe, la petición devolverá un error 400 - Bad request indicando Vacancy already exists.

Si alguno de los empleados indicados en la petición (employees) no pertenece al producto donde se publica la vacante, la petición devolverá un error 400 Bad Request indicando en el mensaje Employees do not belong to product…​ .

Se pueden publicar diferentes vacantes para la misma fecha e intervalo siempre que los identificadores no coincidan.