Recent Posts

Recent Comments

Archives

Categories

Punch/AddMultiple

Publicado
Updated
ByJavier Jaure

 


POST https://customerapi.geovictoria.com/api/v1/Punch/AddMultiple

 

Descripción

Agregar múltiples marcas en una sola llamada (máximo 50). Cada marca debe incluir un identificador de
referencia único que permite conciliar el resultado de cada una. La empresa se determina a partir del token de autenticación.

Request

Request Body

El cuerpo es un arreglo de marcas. Cada marca tiene los siguientes campos:

Campos Tipo de dato Descripción
ReferenceIdentifier String Identificador de referencia de la marca dentro de la lista. Único por request. Requerido
Date String Fecha y hora de la marca. Formato yyyyMMddHHmmss. Requerido
UserIdentifier String Identificador del usuario (RUT/cédula u otro). Requerido
Type String Tipo de marca. Valores permitidos: Ingreso / Salida. Requerido
BoxSerialNumber String Número de serie del reloj (box) a asociar a la marca. Solo se aplica si la empresa tiene el privilegio
correspondiente (opcional)
ProjectId String Identificador del proyecto asociado a la marca (opcional)
TaskId String Identificador de la tarea asociada a la marca (opcional)
GpsLatitude String Latitud GPS de la marca (opcional)
GpsLongitude String Longitud GPS de la marca (opcional)
GpsError String Margen de error del GPS (opcional)
Comment String Comentario de la marca (opcional)

Ejemplo request

[
        {
            "ReferenceIdentifier": "REF-001",
            "Date": "20260504070000",
            "UserIdentifier": "65631998",
            "Type": "Ingreso"
        },
        {
            "ReferenceIdentifier": "REF-002",
            "Date": "20260504180000",
            "UserIdentifier": "65631998",
            "Type": "Salida"
        }
    ]

 

Importante

  • Se permite un máximo de 50 marcas por request.
  • El campo ReferenceIdentifier es obligatorio en cada marca y no puede
    repetirse     dentro del request.
  • El campo Type solo acepta los valores Ingreso o Salida.
  • Las fechas deben venir en formato yyyyMMddHHmmss.
  • La validación es todo o nada: si al menos una marca falla la validación, no se inserta
    ninguna     y la respuesta contiene un resultado por cada marca rechazada con el detalle del error.
  • Si todas las marcas se procesan correctamente, la respuesta contiene un único resultado con
    ReferenceIdentifier = “#AllPunches” y Message = “OK”.

Response

Response Body

La respuesta es un arreglo de resultados. Cada resultado tiene los siguientes campos:

Campos Tipo de dato Descripción
ReferenceIdentifier String Identificador de referencia de la marca asociada al resultado. Vale “#AllPunches” cuando todas las marcas se procesaron correctamente
Message String Resultado del procesamiento. “OK” si fue exitoso, o el mensaje de error correspondiente si la marca fue rechazada

 

Códigos

 

Código Descripción
200 Éxito
400 Error en el request

Ejemplo response

[
        {
            "ReferenceIdentifier": "#AllPunches",
            "Message": "OK"
        }
    ]
Tabla de contenidos