Nivel 1 · Conectado

Tamaños, precios y trasteros

Los tamaños del centro, el estado y el precio de cada trastero, y cada cambio al momento.

Primero los tamaños y después los trasteros. Si mandas tamaños o trasteros de un centro que aún no has mandado, la respuesta es 409 facility_not_ready.

Sus tamaños

PUT /facilities/{facilityId}/unit-types, con version y todos sus unitTypes: el id de cada uno, su name («S», «Talla M»), de hasta 40 letras, y, si quieres, su color (#RRGGBB). Si no lo mandas, el portal le pone uno. Los que no estén se quitan.

unit-types

{
  "version": "t-2026-10-26",
  "unitTypes": [
    { "id": "S", "name": "Talla S", "color": "#F2B33D" },
    { "id": "M", "name": "Talla M", "color": "#1E6B52" }
  ]
}

Sus trasteros

PUT /facilities/{facilityId}/units, con version y todos sus units. Los que no estén se quitan.

Campo	Tipo	Obligatorio	Notas
`id`	texto	Sí	Único en el centro. Es el mismo que su `data-unit-id` en el plano
`number`	texto	Sí	El que ve el inquilino en la puerta: «21», «A-3»
`areaM2`	número	Sí	Su superficie. El portal lo pone en su categoría: Armario, Vestidor, Habitación, Estudio, Piso o Casa
`status`	`available`, `occupied` o `blocked`	Sí	Libre, alquilado o que ahora no se puede alquilar
`monthlyPrice`	importe o `null`	Sí	Su precio al mes, con el IVA o sin él según `pricesIncludeVat`. `null` si no se alquila por el portal
`unitTypeId`	texto	No	Su tamaño, uno de `unit-types`
`floorId`	texto	No	Su planta, si el plano tiene varias

Nunca se manda nada de los inquilinos.

Un trastero que cambia

PUT /facilities/{facilityId}/units/{unitId}, con los mismos campos, en cuanto cambia: se alquila, se libera o cambia de precio. Así el portal tiene los libres al momento.

curl -X PUT https://api.findqbox.com/connect/v1/facilities/madrid-01/units/T-021 \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"number": "21", "areaM2": 2.6, "status": "occupied", "monthlyPrice": 49, "unitTypeId": "S"}'

El IVA

Manda los precios como los tenga el centro, con el IVA o sin él, y dilo en pricesIncludeVat. El portal calcula y enseña siempre el precio final, con el IVA de su país.