Punch/ListPending

 


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

 

Descripción

Obtener la lista de marcas pendientes desde el último checkpoint registrado para la empresa. Cada vez que se
consultan, las marcas quedan marcadas como entregadas; en la siguiente llamada solo se devolverán las marcas nuevas
(posteriores al checkpoint). La empresa se determina a partir del token de autenticación, por lo que este endpoint
no recibe parámetros.

Request

Request Body

Este endpoint no requiere cuerpo de solicitud. La empresa se obtiene del token de autenticación.

Importante

  • Devuelve únicamente las marcas pendientes acumuladas desde el último checkpoint. Para avanzar el checkpoint
    manualmente, usar el endpoint UpdateTimeOffCreationDateCheckpoint.
  • 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": "65631998",
            "AssignedInBook": true,
            "BoxSn": "CKQX212460008",
            "IdTask": "",
            "IdProject": "",
            "PunchId": "TJfO5jDKx59qWuzijAVSdQ",
            "Checksum": "SgKFLFZVO6hIIau03rOdt4d2hmjhIYZrEytONk4L09KHffa"
        }
]
Tabla de contenidos