Registrar listado de incidencias

Este endpoint permite registrar una lista de incidencias para un mismo empleado.

POST /api/v1/import/incidences

A continuación, se expone una explicación detallada de cada uno de los campos que pueden conformar el cuerpo de la petición, siendo algunos de ellos obligatorios para que esta se realice de manera exitosa.

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

Cuerpo de la petición

Análisis del JSON 
{
  "lag": 0,
  "business": "string",
  "employeeId": "string",
  "incidences": [
    {
      "type": "string",
      "initTime": "string",
      "endTime": "string",
      "workedMinutes": 0,
      "from": "string",
      "to": "string",
      "id": "string",
      "orquestId": 0
    }
  ]
}
Detalles

  • lag*: número de días previos a la fecha actual que se consideran al gestionar la petición.

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

  • employeeId*: identificador del empleado vinculado con la incidencia.

  • incidences*: lista de incidencias vinculadas al empleado. Por cada una de las incidencias que se quieran registrar, se deben cumplimentar los siguientes campos:

    • type*: identificador del tipo de incidencia. Debe estar configurado previamente en Orquest.

    • initTime: hora de inicio de la incidencia. Debe estar en formato HH:mm con la siguiente expresión regular: ^([01]\d|2[0-3]):[0-5]\d$. Se considera la hora local, es decir, la zona horaria del servicio.

    • endTime: hora de finalización de la incidencia. Debe estar en formato HH:mm con la siguiente expresión regular: ^([01]\d|2[0-3]):[0-5]\d$. Se considera la hora local, es decir, la zona horaria del servicio.

    • workedMinutes*: número de minutos que el empleado ha trabajado desde el inicio de su jornada laboral hasta el comienzo de la incidencia. Si el empleado no ha trabajado, deberá especificarse 0.

    • from*: fecha en la que comienza la incidencia. Debe estar en formato yyyy-MM-dd.

    • to*: fecha en la que finaliza la incidencia. Debe estar en formato yyyy-MM-dd.

    • id: identificador externo de la incidencia.

    • orquestId: identificador de la incidencia en Orquest.

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:

{
  "lag": 0,
  "business": "BUSINESSID",
  "employeeId": "C14A658",
  "incidences": [
    {
      "type": "01",
      "initTime": "09:00",
      "endTime": "10:00",
      "workedMinutes": 60,
      "from": "2024-05-01",
      "to": "2024-05-01",
      "id": "C14-12547"
    },
    {
      "type": "03",
      "workedMinutes": 0,
      "from": "2024-05-12",
      "to": "2024-05-30",
      "id": "C14-12549"
    }
  ]
}

Aspectos que tener en cuenta

Esta petición generará una operación atómica que se puede revertir de forma automática si hay errores: el error se mostrará en la respuesta de la petición.

Si una incidencia no está definida en el catálogo de incidencias del negocio, no podrá ser asignada a ningún empleado.

Enlaces de interés

¿Qué es una incidencia?

¿Qué es el lag en una petición?

¿Cómo integrar incidencias?