Activity
POST https://customerapi.geovictoria.com/api/v1/Activity
Descripción
Consultar las actividades (proyectos/tareas) registradas por uno o más usuarios de la empresa asociada al token
de autenticación, dentro de un rango de fechas. Devuelve el detalle de cada actividad con sus marcas de inicio y fin,
horas trabajadas y ubicación GPS. La empresa se determina a partir de las credenciales; no se envía en el request.
Request
Request Body
| Campos | Tipo de dato | Descripción |
|---|---|---|
| Identifier | String | Identificadores de los usuarios a consultar (ej. RUT, DNI), separados por coma. Ej. “12345678-9,11111111-1”. Requerido. |
| StartDate | String | Fecha de inicio del rango a consultar, formato yyyyMMdd (ej. 20260701). Requerido. |
| EndDate | String | Fecha de fin del rango a consultar, formato yyyyMMdd. Requerido. |
| IncludeAll | String | Determina qué usuarios se consideran según su estado. “0” = usuarios activos e inactivos; “1” = sólo usuarios activos. Sólo admite “0” o “1”. Requerido. |
{
"Identifier": "12345678-9,11111111-1",
"StartDate": "20260701",
"EndDate": "20260731",
"IncludeAll": "0"
}
Importante
- El campo Identifier es obligatorio y admite varios identificadores separados por
coma. - Las fechas usan el formato yyyyMMdd.
- El campo IncludeAll sólo admite los valores “0” o “1”; cualquier otro valor rechaza la
solicitud. - No se pueden consultar más de 200 usuarios por solicitud, y la cantidad total de registros
(días × usuarios) no puede superar 1500. - La empresa no se envía en el body: se determina a partir del token de autenticación.
Response
Response Body
La respuesta es un array de actividades con los siguientes campos:
| Campos | Tipo de dato | Descripción |
|---|---|---|
| Identifier | String | Identificador del usuario dueño de la actividad. |
| UserName | String | Nombre completo del usuario (nombre y apellido). |
| IdActivity | String | Identificador de la actividad (valor encriptado). |
| IdTask | String | Identificador de la tarea asociada (valor encriptado). Vacío si no aplica. |
| IdProject | String | Identificador del proyecto asociado (valor encriptado). Vacío si no aplica. |
| IdStartPunch | String | Identificador de la marca de inicio (valor encriptado). Vacío si no aplica. |
| IdEndPunch | String | Identificador de la marca de fin (valor encriptado). Vacío si no aplica. |
| StartDate | String | Fecha y hora de inicio de la actividad (formato yyyyMMddHHmmss). Vacío si no aplica. |
| EndDate | String | Fecha y hora de fin de la actividad (formato yyyyMMddHHmmss). Vacío si no aplica. |
| OriginStartPunch | String | Origen de la marca de inicio (ej. app, web, dispositivo). |
| OriginEndPunch | String | Origen de la marca de fin. |
| StartDateIsModified | Boolean | Indica si la fecha/hora de inicio fue modificada manualmente. |
| EndDateIsModified | Boolean | Indica si la fecha/hora de fin fue modificada manualmente. |
| WorkedHours | String | Horas trabajadas en la actividad. |
| ActivityEnabled | Boolean | Indica si la actividad está vigente. |
| StartPunchGPSLatitude | String | Latitud GPS de la marca de inicio. |
| StartPunchGPSLongitude | String | Longitud GPS de la marca de inicio. |
| EndPunchGPSLatitude | String | Latitud GPS de la marca de fin. |
| EndPunchGPSLongitude | String | Longitud GPS de la marca de fin. |
Códigos
| Código | Descripción |
|---|---|
| 200 | Éxito |
| 400 | Error en el request |
Ejemplo response
[
{
"Identifier": "12345678-9",
"UserName": "Juan Pérez",
"IdActivity": "AbC123XyZ==",
"IdTask": "DeF456UvW==",
"IdProject": "GhI789RsT==",
"IdStartPunch": "JkL012MnO==",
"IdEndPunch": "PqR345StU==",
"StartDate": "20260701080000",
"EndDate": "20260701170000",
"OriginStartPunch": "App",
"OriginEndPunch": "App",
"StartDateIsModified": false,
"EndDateIsModified": false,
"WorkedHours": "9.0",
"ActivityEnabled": true,
"StartPunchGPSLatitude": "-33.4489",
"StartPunchGPSLongitude": "-70.6693",
"EndPunchGPSLatitude": "-33.4489",
"EndPunchGPSLongitude": "-70.6693"
}
]