Cómo liberar una retención de resort
Si una reserva se encuentra en el estado HOLD y ya no desea continuar, puede liberarla. Al liberar una retención se cancela la reserva pendiente y se libera la habitación para otros huéspedes. Esta acción no se puede deshacer.
Punto final
PUT {{apihost}}/resorts/api/v2/itineraries?referencenumber={reference_number}&status=RELEASE
Encabezados requeridos
| Encabezado | Valor | Requerido |
|---|---|---|
Content-Type | application/json | Sí |
x-api-key | Su clave API | Sí |
x-correlation-id | Identificador de correlación único | Sí |
Parámetros de consulta
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
reference_number | cadena | Sí | El número de referencia de la reserva de la respuesta de retención |
status | cadena | Sí | Debe ser "RELEASE" |
Cuerpo de solicitud
El cuerpo de la solicitud debe estar vacío.
Solicitud de ejemplo
PUT {{apihost}}/resorts/api/v2/itineraries?referencenumber=XRN-2026040100123&status=RELEASE
Ejemplo de respuesta
JSON
{
"status": 200,
"data": {
"reference_number": "XRN-2026040100123",
"status": "RELEASED"
}
}Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
reference_number | cadena | El número de referencia de la reserva |
status | cadena | El estado de la reserva actualizado: "RELEASED" |
Cuándo liberar una retención
Escenarios comunes en los que deberías liberar una retención:
- Error en el pago: el pago del huésped no se pudo procesar después de que se creó la retención.
- Cancelación del huésped: el huésped decide no continuar antes de que se confirme la reserva.
- Tiempo de espera: ha transcurrido el tiempo de espera interno de su aplicación para completar la reserva.
- Error en los detalles del viajero: se envió información incorrecta y es necesario crear una nueva reserva.
Manejo de errores
417 — Reserva no en estado de RETENCIÓN
Si la reserva ya ha sido confirmada, liberada o se encuentra en otro estado que no permite la liberación, la API devuelve un error 417:
JSON
{
"message": "Booking is not in HOLD state",
"status": 417
}Esto ocurre cuando:
- La reserva ya fue confirmada (estado:
CONFIRMED) - La reserva ya fue liberada (estado:
RELEASED) - La retención expiró automáticamente
Mejores prácticas
- Liberar inmediatamente: si sabe que la reserva no se confirmará, libere la retención inmediatamente para liberar inventario.
- Verifique el estado antes de publicar: si no está seguro del estado actual de la reserva, primero recupere los detalles de la reserva utilizando el punto final de reserva GET para verificar que todavía se encuentra en el estado
HOLD. - Manejar 417 con elegancia: una respuesta 417 no necesariamente indica un error en su lógica. Es posible que la retención haya expirado automáticamente. Registre la respuesta y actualice su estado local en consecuencia.
- Las reservas liberadas son definitivas: una vez que se libera una retención, no se puede restablecer. El huésped tendría que volver a realizar todo el proceso de búsqueda, disponibilidad, precios y reserva.
Artículo siguiente: Cómo recuperar detalles de la reserva del resort