Catálogo e inventario

Espacio

Almacén o espacio alquilable de la cuenta.

Esquemas: SpaceDto, SpaceDetailDto

{
  "id": "id_8f2a1c",
  "name": "Example",
  "internalReference": "string",
  "isWarehouse": true,
  "collectionId": "string",
  "collectionName": "Example",
  "building": "string",
  "floor": 1,
  "location": {
    "address": "string",
    "city": "string",
    "postalCode": "string",
    "country": "ES",
    "lat": 1,
    "lng": 1
  },
  "createdAt": "2026-09-01T08:00:00Z",
  "updatedAt": "2026-09-01T08:00:00Z",
  "description": "string",
  "capacity": 1,
  "area": 1,
  "dimensions": "string",
  "amenities": [
    "string"
  ],
  "equipments": [
    "string"
  ],
  "pricingSettings": {
    "type": "periodPrice",
    "price": "1234.50",
    "period": "hour"
  },
  "insuranceEnabled": true,
  "discountEnabled": true,
  "depositValue": "1234.50",
  "bufferBefore": 1,
  "bufferBeforeUnit": "hour",
  "bufferAfter": 1,
  "bufferAfterUnit": "hour",
  "customFields": {
    "key": "string"
  }
}

Generado a partir del esquema

Un almacén que gestiona stock, o un espacio alquilable; isWarehouse los distingue. Los costes de mantenimiento del espacio no forman parte del contrato público. Los espacios están acotados a la suscripción que posee la clave. La lectura de detalle, GET /api/v1/spaces/{spaceId}, añade la descripción, capacidad, superficie, dimensiones, servicios, equipamiento, ajustes de precios, márgenes y campos personalizados.

Atributos

idstring

Identificador único del espacio.

namestring

Nombre del espacio.

internalReferencestring | null

Referencia interna del espacio, útil para casarla con sistemas externos; null si no tiene.

isWarehouseboolean

true si el espacio es un almacén que gestiona stock y puede ser el almacén principal de un pedido; false si es un espacio alquilable.

collectionIdstring | null

Identificador de la colección a la que pertenece; null si no está en ninguna.

collectionNamestring | null

Ruta completa de la colección, por ejemplo "Estudios > Fotografía"; null si no aplica.

buildingstring | null

Edificio en el que se encuentra; null si no aplica.

floornumber | null

Planta en la que se encuentra; null si no aplica.

locationobject

Ubicación física del espacio.

Mostrar atributos hijos

location.addressstring | null

Dirección postal; null si no se ha registrado.

location.citystring | null

Municipio; null si no está registrado.

location.postalCodestring | null

Código postal; null si no se ha registrado.

location.countrystring | null

País; null si no consta.

location.latnumber | null

Latitud en grados decimales; null si no está geolocalizado.

location.lngnumber | null

Longitud en grados decimales; null si no está geolocalizado.

createdAtstring<date-time>

Fecha de creación en ISO 8601 UTC.

updatedAtstring<date-time>

Fecha de la última modificación en ISO 8601 UTC.

descriptionstring | nullsolo en el detalle

Descripción del espacio; null si no tiene.

capacitynumber | nullsolo en el detalle

Capacidad en personas; null si no está definida.

areanumber | nullsolo en el detalle

Superficie en metros cuadrados; null si no está definida.

dimensionsstring | nullsolo en el detalle

Dimensiones en texto libre; null si no están definidas.

amenitiesstring[]solo en el detalle

Servicios adicionales disponibles (wifi, proyector...).

equipmentsstring[]solo en el detalle

Equipamiento fijo disponible en el espacio.

pricingSettingsobject | nullsolo en el detalle

Precios de alquiler del espacio; null si no está configurado. Los mismos campos que acepta PATCH /pricing.

Mostrar atributos hijos

pricingSettings.typestring | null

Modo de precio; null si no está configurado.

Opciones disponibles: periodPrice, fixedPrice, pricingStructure

pricingSettings.pricestring | null

Precio base de alquiler como cadena decimal; null si no está configurado.

Límites: patrón ^-?\d+\.\d{2}$

pricingSettings.periodstring | null

Unidad de periodo del precio; null si no está configurada.

Opciones disponibles: hour, day, week, month

insuranceEnabledbooleansolo en el detalle

Si el espacio admite seguro.

discountEnabledbooleansolo en el detalle

Si el espacio admite descuento.

depositValuestring | nullsolo en el detalle

Importe de la fianza como cadena decimal; null si no está definido.

Límites: patrón ^-?\d+\.\d{2}$

bufferBeforenumber | nullsolo en el detalle

Margen de tiempo reservado ANTES del alquiler; null si no hay.

bufferBeforeUnitstring | nullsolo en el detalle

Unidad del margen previo; null si no hay.

Opciones disponibles: hour, day

bufferAfternumber | nullsolo en el detalle

Margen de tiempo reservado DESPUÉS del alquiler; null si no hay.

bufferAfterUnitstring | nullsolo en el detalle

Unidad del margen posterior; null si no hay.

Opciones disponibles: hour, day

customFieldsobject<string, any>solo en el detalle

Valores de los campos personalizados por identificador de campo personalizado; las definiciones están en /api/v1/custom-fields.

Valores

bufferBeforeUnit: hour, day
bufferAfterUnit: hour, day

Lo devuelven

GET /api/v1/spaces — Listar almacenes y espacios
GET /api/v1/spaces/{spaceId} — Obtener un almacén o espacio

Lo modifican

PATCH /api/v1/spaces/{spaceId} — Actualizar un almacén o espacio
PUT /api/v1/spaces/{spaceId}/amenities — Reemplazar las comodidades y el equipamiento
PATCH /api/v1/spaces/{spaceId}/pricing — Actualizar los precios de un espacio

¿Te ha resultado útil esta página?

Ejemplo

Atributos

Valores

Lo devuelven

Lo modifican