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.

  • 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"
    }
  ]
}

Aspectos que tener en cuenta

Las horas se deben enviar en UTC y la publicación se realiza considerando el huso horario del servicio. En el ejemplo expuesto en la petición, 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

Si los datos son correctos, la vacante se publicará y será visible en el apartado de Planificación > Oferta de turnos vacantes.

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

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