Completar una reserva

POST /api/v1/bookings/{bookingId}/complete

Marca una reserva confirmada como completada. Manual y nada más: ninguna tarea programada marca una reserva como completada por sí sola, y una reserva pasada que se queda en CONFIRMED no se señala.

No toca ni el precio, ni los pagos, ni el estado financiero.

Autorización

Rol en la organizaciónEste endpoint
ownerPermitido
adminPermitido
memberPermitido

Ejemplo

bash
curl -X POST -H "x-api-key: $VILLASLOT_API_KEY" \
  "https://villaslot.app/api/v1/bookings/5b2c…/complete"

Respuesta

  • 200 OK — la reserva, status: "COMPLETED".

Qué rechaza

  • 409 Conflict — el estado ha cambiado mientras tanto.
  • 422 Unprocessable Entity — la reserva no estaba CONFIRMED: una reserva provisional, cancelada o caducada no se puede completar.
  • 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.