Punch/ListPending
Descripción
Muestra la información de las marcas
Request
No hay solicitud
Importante
- En plataforma se puede ver en Reportes > Marca
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”. |
| 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 |
| PunchId | String | Identificador cifrado de la marca |
| Checksum | String | Identificador cifrado de la operación asociada a la marca |
Importante
- Obtiene un listado con 1.000 marcas, iniciando la consulta desde el último registro listado anteriormente.
- Esta consulta se puede reestablecer con el siguiente endpoint: Punch/UpdateTimeOffCreationDateCheckpoint.
- Si es que no se configura la fecha arroja grupos de 1000 marcas generadas a partir de 01/01/2000. Si no quedan marcas por mostrar devuelve una lista vacía.
- Por ejemplo: si se tienen 2500 marcas de las cuales 1500 son a partir del 01/10/2024 y el resto es a partir del 01/09/2024. Además, se utiliza UpdateTimeOffCreationDateCheckpoint para indicar 01/09/2024 como fecha base. Cuando se utilice ListPending devolverá 1000 marcas, luego si se vuelve a utilizar solo devolverá 500 y si se vuelve a utilizar devolverá una lista vacía. Luego si vuelvo a poner 01/09/2024 como fecha base UpdateTimeOffCreationDateCheckpoint se repite el proceso al llamar a ListPending.
Códigos
| Código | Descripción |
|---|---|
| 200 | Éxito |
| 400 | Error en el request |
| 500 | Error no controlado, contactar a GV |
[
{
"Type": "Salida",
"Date": "20240801000000",
"Origin": "web",
"Longitude": "-72.9377408",
"Latitude": "-41.461239",
"Accuracy": "5.5",
"GroupDescription": "grupo base",
"UploadDate": "20240801000000",
"ShiftPunchType": "Salida",
"AssignedInBook": true,
"BoxSn": "OGT7080057072700147",
"IdTask": "aBl2S234AOwN4shk7XbciiA",
"IdProject": "WBlTS2dvAOwN4Kk7XZliiA",
"PunchId": "A4lTSTdv5OSN3Kk7XZZii4",
"Checksum": "OU8S8_DXd-sFsaEAUUbsFnEkTNZNJ4Zh2FNJDu34EQDMAPcgfBhWd418_X30RRiA7WIECVJRmFypAiP2QNgMA18MjBZd3XZMbJYN0B0oetD9zTYlcVdAY33WX7gu-hp6"
}
]Postman
Ejemplo 1
Ejemplo 1
