Recent Posts

Recent Comments

Archives

Categories

Punch/ListByUsersDates

Publicado
Updated
ByJavier Jaure


POST https://customerapi.geovictoria.com/api/v1/Punch/ListByUsersDates

 

Descripción

Obtener las marcas de un conjunto de usuarios en un rango de fechas. A diferencia de la consulta paginada, aquí
se filtran las marcas por una lista explícita de identificadores de usuario. La empresa se determina a partir del
token de autenticación.

Request

Request Body

 

Campos Tipo de dato Descripción
StartDate String Fecha inicial de consulta. Formato yyyyMMddHHmmss. Requerido
EndDate String Fecha final de consulta. Formato yyyyMMddHHmmss. Requerido
UserIds String Lista de identificadores de usuario separados por coma. Requerido

Ejemplo request

{
        "StartDate": "20260501000000",
        "EndDate": "20260531235959",
        "UserIds": "15715287,22765123,21897352,76831428"
    }

 

Importante

  • La fecha de inicio debe ser menor o igual a la fecha de fin.
  • El campo UserIds es obligatorio y debe contener al menos un identificador válido.
  • Existen límites en la cantidad de días del rango, en la cantidad de
    usuarios     y en el total de registros de la respuesta. Si se exceden, el request se rechaza.
  • Las fechas se devuelven en formato yyyyMMddHHmmss.
  • Los campos sin valor (nulos) se omiten de la respuesta.
  • Los campos de geolocalización (Longitude, Latitude, Accuracy) solo aparecen si la marca tiene posición
    GPS.

Response

Response Body

La respuesta es un arreglo de marcas. Cada marca tiene los siguientes campos:

Campos Tipo de dato Descripción
Type String Tipo de marca (Ingreso / Salida)
Date String Fecha y hora de la marca (yyyyMMddHHmmss)
Origin String Origen de la marca (reloj, app, web, etc.)
Longitude String Longitud GPS de la marca. Solo aparece si la marca tiene geolocalización
Latitude String Latitud GPS de la marca. Solo aparece si la marca tiene geolocalización
Accuracy String Margen de error del GPS. Solo aparece si la marca tiene geolocalización
GroupDescription String Descripción del grupo asociado a la marca
JustifiedTimeJustification String Justificación del tiempo justificado. Solo aparece si la marca está justificada
UploadDate String Fecha de subida de la marca (yyyyMMddHHmmss)
ShiftPunchType String Tipo de marca dentro del turno (Entrada / Salida / SalidaColacion / etc.)
UserIdentifier String Identificador del usuario dueño de la marca (RUT/cédula u otro)
AssignedInBook Boolean Indica si la marca está asignada en el libro de asistencia
CallerId String Identificador de origen telefónico de la marca (ANI), si aplica
BoxSn String Número de serie del reloj que registró la marca
IdTask String Identificador de la tarea asociada a la marca (si aplica)
IdProject String Identificador del proyecto asociado a la marca (si aplica)
PunchId String Identificador único de la marca
Checksum String Checksum de validación de la marca

 

Códigos

 

Código Descripción
200 Éxito
400 Error en el request

Ejemplo response

[
        {
            "Type": "Ingreso",
            "Date": "20260504070000",
            "Origin": "RCGPRS",
            "GroupDescription": "dinatech mobile sas - 2001",
            "UploadDate": "20260504120057",
            "ShiftPunchType": "Entrada",
            "UserIdentifier": "15715287",
            "AssignedInBook": true,
            "BoxSn": "CKQX212460008",
            "IdTask": "",
            "IdProject": "",
            "PunchId": "TJfO5jDKx59qWuzijAVSdQ",
            "Checksum": "SgKFLFZVO6hIIau03rOdt4d2hmjhIYZrEytONk4L09KHffa"
        }
    ]
Tabla de contenidos