Locations

Locations

Ubicaciones con geocercas para control de fichaje geolocalizado.

POST /api/companies/{companyId}/locations/v1

Crear ubicación

Ubicación creada

Parámetros

Nombre	Tipo	Requerido	Descripción
companyId	string	✅

Request Body (requerido ✅)

{
    "name": "Taller Central",
    "type": "BRANCH",
    "address": "Calle 123",
    "latitude": -34.6037,
    "longitude": -58.3816,
    "geoRadiusMeters": 0
  }

Respuestas

201

Ubicación creada exitosamente

{
    "id": "00000000-0000-0000-0000-000000000000",
    "companyId": "00000000-0000-0000-0000-000000000000",
    "name": "name",
    "type": "BRANCH",
    "address": "address",
    "latitude": 0,
    "longitude": 0,
    "geoRadiusMeters": 0,
    "active": true,
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  }

---

GET /api/companies/{companyId}/locations/v1

Listar ubicaciones activas

Lista de ubicaciones

Parámetros

Nombre	Tipo	Requerido	Descripción
companyId	string	✅

Respuestas

200

Lista de ubicaciones

{
    "id": "00000000-0000-0000-0000-000000000000",
    "companyId": "00000000-0000-0000-0000-000000000000",
    "name": "name",
    "type": "BRANCH",
    "address": "address",
    "latitude": 0,
    "longitude": 0,
    "geoRadiusMeters": 0,
    "active": true,
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  }

---

GET /api/companies/{companyId}/locations/v1/{id}

Obtener ubicación por ID

Datos de la ubicación

Parámetros

Nombre	Tipo	Requerido	Descripción
companyId	string	✅
id	string	✅

Respuestas

200

Datos de la ubicación

{
    "id": "00000000-0000-0000-0000-000000000000",
    "companyId": "00000000-0000-0000-0000-000000000000",
    "name": "name",
    "type": "BRANCH",
    "address": "address",
    "latitude": 0,
    "longitude": 0,
    "geoRadiusMeters": 0,
    "active": true,
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  }

---

PATCH /api/companies/{companyId}/locations/v1/{id}

Actualizar ubicación

Ubicación actualizada

Parámetros

Nombre	Tipo	Requerido	Descripción
companyId	string	✅
id	string	✅

Request Body (requerido ✅)

{
    "name": "name",
    "type": "BRANCH",
    "address": "address",
    "latitude": 0,
    "longitude": 0,
    "geoRadiusMeters": 0,
    "active": true
  }

Respuestas

200

Ubicación actualizada

{
    "id": "00000000-0000-0000-0000-000000000000",
    "companyId": "00000000-0000-0000-0000-000000000000",
    "name": "name",
    "type": "BRANCH",
    "address": "address",
    "latitude": 0,
    "longitude": 0,
    "geoRadiusMeters": 0,
    "active": true,
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  }

---

DELETE /api/companies/{companyId}/locations/v1/{id}

Desactivar ubicación

Ubicación desactivada

Parámetros

Nombre	Tipo	Requerido	Descripción
companyId	string	✅
id	string	✅

Respuestas

204

Ubicación desactivada exitosamente

---

Schemas

CreateLocationRequest

Campo	Tipo	Requerido	Descripción
name	string ej: “Taller Central”	✅
type	LocationType	✅
address	string ej: “Calle 123”	❌
latitude	number (double) ej: -34.6037	❌
longitude	number (double) ej: -58.3816	❌
geoRadiusMeters	integer	❌	Radio de geocerca en metros

LocationResponse

Campo	Tipo	Requerido	Descripción
id	string (uuid)	❌
companyId	string (uuid)	❌
name	string	❌
type	LocationType	❌
address	string	❌
latitude	number (double)	❌
longitude	number (double)	❌
geoRadiusMeters	integer	❌
active	boolean	❌
createdAt	string (date-time)	❌
updatedAt	string (date-time)	❌

UpdateLocationRequest

Campo	Tipo	Requerido	Descripción
name	string	❌
type	LocationType	❌
address	string	❌
latitude	number (double)	❌
longitude	number (double)	❌
geoRadiusMeters	integer	❌
active	boolean	❌