Obtener fichajes por producto

Este endpoint devuelve los fichajes consolidados de un producto dentro de un periodo concreto no superior a 31 días.

GET /api/v2/businesses/{businessId}/products/{productId}/clockguards?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á los fichajes del producto con toda la información definida para ellos.

Los datos incluidos en la respuesta dependerán de la información que se haya enviado previamente asociada al registro.

A continuación, se exponen algunos ejemplos:

  • Ejemplo 1

  • Ejemplo 2

  • Ejemplo 3

Registros con toda la información posible, incluido identificador de la tarea, de la zona, localización geográfica, etc.

[
  {
    "employeeId": "2325",
    "locationId": "C14",
    "type": "WORK",
    "zoneId": "General",
    "checkIn": "2021-08-12T04:00:00Z",
    "latIn": 3.676432,
    "lonIn": 3.676432,
    "deviceIn": "12345",
    "checkOut": "2021-08-12T06:00:00Z",
    "latOut": 3.676432,
    "lonOut": 3.676432,
    "deviceOut": "12345",
    "comment": "No error.",
    "orquestId": 3565687
  },
  {
    "employeeId": "2325",
    "locationId": "C14",
    "type": "WORK",
    "zoneId": "General",
    "checkIn": "2021-08-13T04:00:00Z",
    "latIn": 3.676432,
    "lonIn": 3.676432,
    "deviceIn": "12345",
    "checkOut": "2021-08-13T08:00:00Z",
    "latOut": 3.676432,
    "lonOut": 3.676432,
    "deviceOut": "12345",
    "comment": "No error.",
    "orquestId": 3565688
  }
]

Registros solo con la información básica.

[
    {
        "employeeId": "1006350",
        "type": "WORK",
        "checkIn": "2024-05-10T07:00:00.000Z",
        "checkOut": "2024-05-10T12:00:00.000Z",
        "orquestId": 220030406
    },
    {
        "employeeId": "1006350",
        "type": "REST",
        "checkIn": "2024-05-10T10:00:00.000Z",
        "checkOut": "2024-05-10T10:30:00.000Z",
        "orquestId": 220030407
    },
    {
        "employeeId": "1006350",
        "type": "WORK",
        "checkIn": "2024-05-13T07:00:00.000Z",
        "checkOut": "2024-05-13T12:00:00.000Z",
        "orquestId": 220030408
    }
]

Si hay errores en el registro, por ejemplo, mismo tipo de fichaje (IN), la API devuelve los datos tal y como se han registrado:

[
    {
        "employeeId": "1006350",
        "type": "WORK",
        "checkIn": "2024-05-14T07:00:00.000Z",
        "orquestId": 220030409
    },
    {
        "employeeId": "1006350",
        "type": "WORK",
        "checkIn": "2024-05-14T12:00:00.000Z",
        "orquestId": 220030410
    }
]

Tal y como se aprecia en los ejemplos, esta petición devuelve los datos tal y como se han registrado, por lo que el nivel de detalle de la respuesta dependerá de los datos previamente enviados: por ejemplo, si el registro contiene el identificador del dispositivo de fichaje (device), la petición también devolverá esa información vinculada al registro.

Aspectos que tener en cuenta

Esta petición devuelve solo los fichajes consolidados.

La API devuelve los datos en orden de registro, en UTC y en formato yyyy-MM-ddTHH:mm:ss.SSSZ.

La respuesta contendrá los datos desde la fecha indicada en el parámetro from hasta la fecha indicada en el parámetro to, incluyendo los de ambos días.

El intervalo máximo permitido para la consulta es de 31 días. Si el período indicado en la URL es mayor, la solicitud devolverá un error 400 Bad Request, indicando en el mensaje The request exceded the maximum number of days allowed (31 days max).

Si no hay fichajes para el intervalo indicado en la URL, la petición devolverá un array vacío [].

Si el producto especificado en la URL no existe en el negocio, la petición devolverá un error 404 Not Found indicando not exists.

Enlaces de interés

¿Qué es un fichaje?

¿Cómo integrar fichajes?