Punch/ListActivityPunch

 

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

 

Descripción

Obtener las marcas de actividad de un proyecto para un conjunto de usuarios, desde una fecha de checkpoint
hasta el momento actual. Devuelve las marcas asociadas al proyecto indicado, junto con su geolocalización. La empresa se
determina a partir del token de autenticación.

Request

Request Body

 

Campos	Tipo de dato	Descripción
CheckpointDate	String	Fecha desde la cual se consultan las marcas de actividad. Formato yyyyMMddHHmmss. Requerido
UserIdentifiers	String	Lista de identificadores de usuario separados por coma. Requerido
ProjectId	String	Identificador del proyecto cuyas marcas de actividad se desean obtener. Requerido

Ejemplo request

{
        "CheckpointDate": "20260501000000",
        "UserIdentifiers": "15715287,22765123",
        "ProjectId": "xit8BQ5HOO3ZejTzkmsEWA"
    }

 

Importante

• La consulta abarca desde la fecha CheckpointDate hasta el momento actual; el rango no puede
  exceder el máximo de meses permitido para consultas de asistencia.
• La fecha debe venir en formato yyyyMMddHHmmss; de lo contrario el request se rechaza.
• El campo UserIdentifiers es obligatorio y debe contener al menos un identificador válido.
• El campo ProjectId es obligatorio y debe corresponder a un proyecto válido.
• Las fechas se devuelven en formato yyyyMMddHHmmss.

Response

Response Body

La respuesta es un objeto base con los siguientes campos:

Campos	Tipo de dato	Descripción
Success	Boolean	Indica si la operación fue exitosa
Message	String	Mensaje asociado a la respuesta (vacío si la operación fue exitosa)
Response	Array	Lista de marcas de actividad (ver detalle abajo)

 

Response

 

Campos	Tipo de dato	Descripción
Date	String	Fecha y hora de la marca (yyyyMMddHHmmss)
GpsLatitude	String	Latitud GPS de la marca
GpsLongitude	String	Longitud GPS de la marca
PunchId	String	Identificador único de la marca
UserIdentifier	String	Identificador del usuario dueño de la marca (RUT/cédula u otro)
Origin	String	Origen de la marca (reloj, app, web, etc.)
Type	String	Tipo de marca (Ingreso / Salida)

 

Códigos

 

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

Ejemplo response

{
        "Success": true,
        "Response": [
            {
                "Date": "20260504070000",
                "GpsLatitude": "-33.4489",
                "GpsLongitude": "-70.6693",
                "PunchId": "TJfO5jDKx59qWuzijAVSdQ",
                "UserIdentifier": "15715287",
                "Origin": "AppManual",
                "Type": "Ingreso"
            }
        ]
    }