Recent Posts

Recent Comments

Archives

Categories

Punch/PaginatedListByDate

Publicado
Updated
BySantiago






POST
https://customerapi.geovictoria.com/api/v1/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

Ejemplo request

{
    "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 última página
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



Ejemplo response

{
    "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

Tabla de contenidos