Recent Posts

Recent Comments

Archives

Categories

Punch/AddFromBox

Publicado
Updated
ByJavier Jaure

 


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

 

Descripción

Crear una marca proveniente de un reloj (box) identificado por su terminal. Permite registrar una marca
asociada a un reloj físico, conservando un identificador externo del sistema de origen para conciliació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
TerminalId String Número de serie / identificador del reloj (box) que registra la marca. Requerido
ExternalId String Identificador de la marca en el sistema externo. Se devuelve en la respuesta como ReferenceIdentifier
(opcional)
Observation String Observación del cliente, en caso de necesitarla (opcional)

Ejemplo request

{
        "Date": "20260504070000",
        "UserIdentifier": "65631998",
        "Type": "Ingreso",
        "TerminalId": "CKQX212460008",
        "ExternalId": "EXT-00123",
        "Observation": ""
}

 

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 campo TerminalId es obligatorio: si no se envía, el request se rechaza.
  • El ExternalId enviado se devuelve como ReferenceIdentifier en la respuesta,
    para conciliar la marca con el sistema de origen.

Response

Response Body

La respuesta es un objeto con el resultado de la creación de la marca:

Campos Tipo de dato Descripción
ReferenceIdentifier String Identificador externo de referencia enviado en el request (ExternalId)
Message String Mensaje con el resultado del procesamiento de la marca

 

Códigos

 

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

Ejemplo response

{
        "ReferenceIdentifier": "EXT-00123",
        "Message": "OK"
}
Tabla de contenidos