Recent Posts

Recent Comments

Archives

Categories

Punch/AddArtificial

Publicado
Updated
ByJavier Jaure


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

 

Descripción

Crear una marca artificial (ingreso o salida) para un usuario en una fecha y hora específica. Las marcas
artificiales son marcas agregadas manualmente vía API, no provenientes de un reloj. La empresa se determina a partir
del token de autenticación.

Request

Request Body

 

Campos Tipo de dato Descripción
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
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. Su obligatoriedad depende de la configuración de la empresa (ver Importante)

Ejemplo request

   {
        "Date": "20260504070000",
        "UserIdentifier": "65631998",
        "Type": "Ingreso",
        "ProjectId": "",
        "TaskId": "",
        "GpsLatitude": "",
        "GpsLongitude": "",
        "GpsError": "",
        "Comment": ""
    }

 

Importante

  • El campo Type solo acepta los valores Ingreso o
    Salida.
  • La fecha debe venir en formato yyyyMMddHHmmss; de lo contrario se rechaza el request.
  • El usuario debe existir y estar habilitado en la empresa.
  • El comentario puede ser obligatorio, opcional o no permitido según la configuración y los
    privilegios de la empresa. Si es obligatorio y no se envía, el request se rechaza; si no está permitido y se envía,
    también se rechaza.

Response

Response Body

La respuesta es el identificador único de la marca creada (texto encriptado).

Campos Tipo de dato Descripción
(valor) String Identificador único de la marca recién creada

 

Códigos

 

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

Ejemplo response

"TJfO5jDKx59qWuzijAVSdQ"
Tabla de contenidos