Consultar incidencias de un producto
Este endpoint permite consultar las incidencias registradas vinculadas a un producto dentro de un periodo de tiempo determinado no superior a 30 días.
GET /api/v2/businesses/{businessId}/products/{productId}/incidences/from/{yyyy-MM-dd}/to/{yyyy-MM-dd}Si los datos incluidos en la petición son correctos —tanto el businessId como el productId—, la respuesta contendrá el listado de incidencias del producto en el intervalo de tiempo definido:
[
{
"personId": "1006350",
"from": "2024-05-08",
"to": "2024-05-08",
"initTime": "09:30",
"endTime": "10:00",
"workedMinutes": 30,
"type": {
"id": "01",
"name": "CITA MEDICA",
"shortName": "CM",
"fullDay": false,
"color": "#60b5ff",
"calculationType": "DURATION",
"holidays": false
}
},
{
"personId": "1006350",
"from": "2024-05-18",
"to": "2024-05-18",
"initTime": "08:30",
"endTime": "09:00",
"workedMinutes": 0,
"type": {
"id": "01",
"name": "CITA MEDICA",
"shortName": "CM",
"fullDay": false,
"color": "#60b5ff",
"calculationType": "DURATION",
"holidays": false
}
},
{
"personId": "1006351",
"from": "2024-05-08",
"to": "2024-05-18",
"workedMinutes": 0,
"type": {
"id": "02",
"name": "VACACIONES",
"shortName": "VAC",
"fullDay": true,
"color": "#5ea226",
"calculationType": "PROPORTIONAL",
"workedDays": 7,
"holidays": true
}
},
{
"personId": "1006351",
"from": "2024-05-01",
"to": "2024-05-01",
"initTime": "08:30",
"endTime": "09:00",
"workedMinutes": 30,
"type": {
"id": "01",
"name": "CITA MEDICA",
"shortName": "CM",
"fullDay": false,
"color": "#60b5ff",
"calculationType": "DURATION",
"holidays": false
}
}
]Tal y como se aprecia en el ejemplo, la petición devolverá la información que se haya definido previamente en el catálogo de incidencias: nombre, abreviatura, etc.
Aspectos que tener en cuenta
Los campos initTime y endTime devuelven la hora local, es decir, la zona horaria configurada para el servicio.
Si no hay incidencias para el periodo de tiempo indicado en la URL, la petición devolverá un array vacío [].
Si el producto indicado en la URL no existe en el negocio, la petición devolverá un error 404 Not Found, especificando en el mensaje not exits.
Si el intervalo indicado en la URL es superior a 30 días, la petición devolverá un error 406 Not Acceptable.
Enlaces de interés
¿Qué es una incidencia?