Como podemos ayudarte?
Punch/PaginatedListByDate
Descripción
Muestra las marcas de los usuarios en un periodo paginadas
Request
Request Body
| Campos | Largo | Requerido | Tipo de dato | Descripción |
|---|---|---|---|---|
| Page | 10 | Sí | String | Indica el número de página que se quiere ver |
| StartDate | 8 | Sí | String | Indica la fecha de inicio en formato yyyyMMdd del periodo en que se quiere consultar las marcas |
| EndDate | 8 | Sí | String | Indica la fecha de fin en formato yyyyMMdd del periodo en que se quiere consultar las marcas |
Importante
- En plataforma se puede ver en Reportes > Marca
- El periodo consultado no puede exceder los 3 meses.
- El formato de fecha yyyyMMdd se descompone en:
YYYY: Año, por ejemplo: 1987
MM: Mes, por ejemplo: 01
DD: Día, por ejemplo: 13
HH: Hora, por ejemplo: 18
En resumen: 19870113
{
"Page": "1",
"StartDate": "20240801",
"EndDate": "20241002"
}Response
Response Body
| Campos | Tipo de dato | Descripción |
|---|---|---|
| Punches | Lista | Contiene la lista de objetos que representan a cada uno de las marcas |
| - Type | String | Indica el tipo de marca, es decir Ingreso o Salida |
| - Date | String | Indica la fecha de la marca en formato YYYYMMDDHHMMSS |
| - Origin | String | Indica el origen de la marca, por ejemplo, web, app, etc |
| - Longitude | String | Indica la coordenada de longitud de la marca |
| - Latitude | String | Indica la coordenada de latitud de la marca |
| - Accuracy | String | Indica la precisión de las coordenadas de longitud y latitud de la marca |
| - GroupDescription | String | Indica el nombre del grupo asociado de la marca |
| - UploadDate | String | Indica la fecha en la que se cargó en el sistema la marca en formato YYYYMMDDHHMMSS |
| - ShiftPunchType | String | Indica el tipo de marca, es decir “Entrada”, “Salida”, “EntradaColación”, “SalidaColación”. |
| - UserIdentifier | String | Identificador del usuario (Ej: Rut, DNI, etc) |
| - AssignedInBook | Boolean | Indica si la marca está asignada en el libro de asistencia (visible en libro de Asistencia) |
| - BoxSn | String | Indica el número de serie del reloj que registró la marca |
| - IdTask | String | Identificador cifrado de la tarea asociada a la marca |
| - IdProject | String | Identificador cifrado del proyecto asociada a la marca |
| - Checksum | String | Identificador cifrado de la operación asociada a la marca |
| IsLastPage | Boolean | Indica si es la |
| CurrentPage | String | Identificador cifrado de la operación asociada a la marca |
| TotalOfPages | String | Identificador cifrado de la operación asociada a la marca |
Importante
- Si el campo punches está vacío significa que los primeros usuarios evaluados no tienen marcas y por ende no hay información que mostrar en esa página.
Códigos
| Código | Descripción |
|---|---|
| 200 | Éxito |
| 400 | Error en el request |
| 500 | Error no controlado, contactar a GV |
{
"Punches": [
{
"Type": "Ingreso",
"Date": "20240909165000",
"Origin": "app",
"Longitude": "-70.8763037",
"Latitud": "-33.2934262",
"Accuracy": "5.5",
"GroupDescription": "Grupo base",
"UploadDate": "20240909195100",
"ShiftPunchType": "Entrada",
"UserIdentifier": "111111111",
"AssignedInBook": true,
"BoxSn": "OGT7080057072700147",
"IdTask": "WBlTS2dvAOwN4Kk7XZliiA",
"IdProject": "A4lTSTdv5OSN3Kk7XZZii4",
"Checksum": "OU8S8_DXd-sFsaEAUUbsFnEkTNZNJ4Zh2FNJDu34EQDMAPcgfBhWd418_X30RRiA7WIECVJRmFypAiP2QNgMA18MjBZd3XZMbJYN0B0oetD9zTYlcVdAY33WX7gu-hp6"
}
],
"IsLastPage": false,
"CurrentPage": 1,
"TotalOfPages": 2
}Postman
Ejemplo 1
Ejemplo 1
