Modificar las reglas de reserva | VillaSlot Documentation

PATCH /api/v1/settings/booking

Cambia las reglas de reserva. Los campos ausentes del cuerpo conservan su valor actual.

Autorización

Rol en la organización	Este endpoint
`owner`	Permitido
`admin`	Permitido
`member`	Rechazado — `403`

Las reglas siguen el derecho a modificar la propia organización.

Cuerpo de la petición

Campo	Tipo	Descripción
`currency`	enum	`IDR`, `EUR` o `USD`
`timezone`	enum	`UTC`, `Asia/Makassar`, `Asia/Jakarta`, `Asia/Singapore`, `Asia/Dubai`, `Europe/Paris`, `Europe/London`, `America/New_York`
`bufferMinutes`	entero	De 0 a 480, el margen que se deja entre dos sesiones de fotos
`holdExpirationHours`	entero	De 1 a 720
`holdBlocksSlot`	booleano	Si una reserva provisional ocupa la franja
`publicBookingEnabled`	booleano	Abre la página de reserva pública
`minimumNights`	entero	De 1 a 30, para las estancias por noches
`turnoverGuardEnabled`	booleano	Protege la franja de check-out / check-in
`turnoverGuardMinimumMinutes`	entero	Duración mínima de una sesión que invade la franja: de 60 a 480, en horas enteras (60, 120… 480)

Ejemplo

bash

curl -X PATCH -H "x-api-key: $VILLASLOT_API_KEY" -H "content-type: application/json" \
  -d '{"bufferMinutes":45}' \
  "https://villaslot.app/api/v1/settings/booking"

Respuesta

200 OK — las reglas guardadas.

Qué rechaza

403 Forbidden — el portador de la clave es un member.
422 Unprocessable Entity — una moneda o una zona horaria no admitida, o un valor fuera de su rango.
401 Unauthorized — clave ausente o no válida, o clave cuyo portador ha dejado la organización.
404 Not Found — identificador desconocido, o identificador que pertenece a otra organización. Los dos son deliberadamente indistinguibles.
429 Too Many Requests — más de 120 peticiones en un minuto para esta clave.

Notas

Cambiar la zona horaria cambia cómo se leen los futuros pares date / startMinute. No mueve ni una sola reserva existente: se guardan como instantes.
Cambiar el margen solo se aplica a las reservas futuras; cada reserva conserva el margen fijado en su línea.

Políticas de conflicto con Airbnb

airbnbReservedPolicy acepta warn (por defecto) o block. De forma independiente, airbnbUnavailablePolicy acepta ignore, warn (por defecto) o block. Los campos omitidos conservan las políticas guardadas, incluidas las peticiones de clientes más antiguos. Se aplican los permisos OWNER/ADMIN.