Punch/ListByUsersDates
Descripción
Muestra las marcas de uno o más usuarios específicos en un periodo de tiempo
Request
Request Body
| Campos | Largo | Requerido | Tipo de dato | Descripción |
|---|---|---|---|---|
| StartDate | 16 | Sí | String | Indica la fecha de inicio en formato YYYYMMDDHHMMSS del periodo en que se quiere consultar las marcas |
| EndDate | 16 | Sí | String | Indica la fecha de fin en formato YYYYMMDDHHMMSS del periodo en que se quiere consultar las marcas |
| UsersIds | Sí | String | Identificadores de usuarios separados por "," |
Importante
- En plataforma se puede ver en Reportes > Marca
- El campo UsersId puede contener el identificador de uno o más usuarios separados por coma.
- El periodo puede ser de máximo 62 días entre los campos StartDate y EndDate.
- Se pueden indicar como máximo 200 usuarios.
- Se puede devolver como máximo 1500 registros.
- El formato de fecha YYYYMMDDHHMMSS 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
MM: Minuto, por ejemplo: 32
SS: Segundo, por ejemplo 54
En resumen: 19870113183254
{
"StartDate": "20241002100000",
"EndDate": "20241002100000",
"UserIds": "167893215"
}Response
Response Body
| Campos | Tipo de dato | Descripción |
|---|---|---|
| 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 |
Importante
- Se devuelve una lista de objetos donde cada objeto contiene la información de una marca.
Códigos
| Código | Descripción |
|---|---|
| 200 | Éxito |
| 400 | Error en el request |
| 500 | Error no controlado, contactar a GV |
[
{
"Type": "Ingreso",
"Date": "20241002100000",
"Origin": "web",
"Longitude": "-72.9377408",
"Latitude": "-41.461239",
"Accuracy": "5.5",
"GroupDescription": "grupobase",
"UploadDate": "20241002100000",
"ShiftPunchType": "Salida",
"UserIdentifier": "167893215",
"AssignedInBook": true,
"BoxSn": "OGT7080057072700147",
"IdTask": "A4lTSTdv5OSN3Kk7XZZii4",
"IdProject": "B43ATKdv5OLN3Kk45ZZAj1",
"Checksum": "OU8S8_DXd-sFsaEAUUbsFnEkTNZNJ4Zh2FNJDu34EQDMAPcgfBhWd418_X30RRiA7WIECVJRmFypAiP2QNgMA18MjBZd3XZMbJYN0B0oetD9zTYlcVdAY33WX7gu-hp6"
}
]Postman
Ejemplo 1
Ejemplo 1
