Consultar cambios incrementales
Este endpoint permite consultar los cambios registrados en las incidencias desde una fecha concreta. El objetivo que se persigue es poder realizar peticiones recurrentes para mantener actualizados los datos de manera más sencilla.
GET /api/v2/businesses/{businessId}/incidences/incremental?since={yyyy-MM-ddTHH:mm:ss.mss}La respuesta es paginada, es decir, contiene una cabecera next que indica la URL de la siguiente petición incremental: para obtener la siguiente página, se debe realizar una petición a esa URL. La última página no contiene la cabecera, lo que indica que la paginación ha terminado.
Si los datos incluidos en la petición son correctos, la petición devuelve las incidencias que han cambiado desde una fecha dada (since) hasta la fecha actual. Orquest solo almacena los últimos 45 días de cambios incrementales, por lo que la consulta deberá considerar ese intervalo de tiempo.
[
{
"employeeId": "string",
"businessDay": "2024-05-07",
"incidences": [
{
"type": "string",
"initTime": "09:00",
"endTime": "10:00",
"workedMinutes": 0,
"from": "2024-05-07",
"to": "2024-05-07",
"id": "string",
"orquestId": 3456
}
]
}
]Aspectos que tener en cuenta
Dada la naturaleza compleja de los datos, hay ocasiones en las que no se puede determinar si un elemento ha cambiado realmente o no. Por ejemplo, ante cambios masivos, cuando la modificación se realiza en bloque y no se lleva a cabo una comparación exhaustiva. En este sentido, es posible que se tenga en cuenta que han cambiado las incidencias de un día, independientemente de cuántas incidencias hayan cambiado en él.
|
El uso de este endpoint requiere que la funcionalidad sea activada previamente por el equipo de Orquest, dado su coste de cómputo y memoria al realizar auditorías sobre ciertas entidades. Por tanto, será necesario analizar el caso de uso y gestionar su habilitación. |
Enlaces de interés
¿Qué es una incidencia?