Recent Posts

Recent Comments

Archives

Categories

Punch/AddActivityPunch

Publicado
Updated
ByJavier Jaure

 


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

 

Descripción

Crear una marca de actividad (ingreso o salida) asociada a un proyecto y, opcionalmente, a una
tarea. Las marcas de actividad permiten registrar el tiempo trabajado sobre un proyecto específico y
requieren geolocalización. 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. Requerido
TaskId String Identificador de la tarea asociada a la marca (opcional)
GpsLatitude String Latitud GPS de la marca. Requerido
GpsLongitude String Longitud GPS de la marca. Requerido
GpsError String Margen de error del GPS. Requerido
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": "xit8BQ5HOO3ZejTzkmsEWA",
        "TaskId": "sDzBzlFnefikfhnZoFXLiw",
        "GpsLatitude": "-33.4489",
        "GpsLongitude": "-70.6693",
        "GpsError": "10",
        "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.
  • Los campos GpsLatitude, GpsLongitude y GpsError son
    obligatorios y tienen un largo máximo permitido.
  • El campo ProjectId es obligatorio y debe corresponder a un proyecto válido. El
    TaskId es opcional, pero si se envía debe ser válido.
  • El comentario puede ser obligatorio según los privilegios de la empresa. Si es obligatorio y
    no
    se envía, el request se rechaza.

Response

Response Body

La respuesta es el identificador único de la marca de actividad 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