Primeros pasos con la API de actividades de XeniCómo reservar una actividadCómo buscar etiquetas y categorías de actividadesCómo cancelar una reserva de actividadCómo comprobar la disponibilidad de la actividadCómo obtener detalles de la actividadCómo recuperar los detalles de la reserva de actividadesCómo buscar actividades con filtrosCómo buscar destinos de actividadesAPI de alquiler de coches: introducciónAPI de alquiler de coches: comprensión de los campos de respuestaCómo reservar un alquiler de cochesCómo obtener detalles del vehículo de alquiler y complementos de equipoCómo recuperar o cancelar una reserva de alquiler de cochesCómo buscar autos de alquiler disponiblesCómo buscar ubicaciones de recogidaCómo utilizar los filtros de búsqueda de alquiler de cochesMejores prácticas de integración de API de ofertasPreguntas frecuentes sobre la API de ofertasPrimeros pasos con la API de ofertas de XeniReferencia de encabezados y parámetros de solicitud de API de ofertasOfertas API Monedas admitidas y localizaciónCómo mostrar ofertas en su aplicaciónCómo buscar ofertas de hoteles por ubicaciónCódigos de error de la API de vuelos y solución de problemasPrimeros pasos con la API de vuelos de XeniCómo reservar un vueloCómo comprobar la disponibilidad y el precio de los vuelosCómo confirmar o cancelar una reserva de vueloCómo recuperar las reglas de tarifas de un vueloCómo recuperar los detalles de la reserva de un vueloCómo buscar aeropuertos usando AutocompletarCómo buscar vuelosCómo utilizar filtros, clasificación y paginación de búsqueda de vuelosCómo comprobar la disponibilidad y el precio de las habitacionesCómo filtrar los resultados de los alquileres vacacionalesCómo obtener detalles, comodidades y accesibilidad de la propiedad del resortCómo mantener y confirmar una reserva de resortCómo liberar una retención de resortCómo recuperar los detalles de la reserva del resortCómo buscar complejos turísticos disponiblesCómo buscar destinos turísticosCómo buscar ubicaciones de alquiler vacacionalCómo buscar alquileres vacacionalesCómo utilizar filtros de búsqueda y clasificación de complejos turísticosComenzando con la API de Xeni ResortsAPI de Resorts: comprensión de los estados y políticas de las reservasPrimeros pasos con la API de alquileres vacacionalesPreguntas frecuentes sobre alquileres vacacionalesTipos de propiedades admitidas para alquileres vacacionalesComprensión de la búsqueda asincrónica para alquileres vacacionalesAutenticación y firmas APIReserva de hoteles: API directa y pago SSOManejo de errores, límites de tasas y mejores prácticasPrimeros pasos con la API de Xeni HotelesGestión de reservas: estado, recuperación y cancelaciónConfirmación de precios y ciclo de vida del tokenRecuperar detalles del hotel y disponibilidad de habitacionesBúsqueda de hoteles: ubicaciones, filtros y paginaciónBuscando HotelesGestión de sesiones e ID de correlaciónAutenticación API y obtención de claves API

Gestión de reservas: estado, recuperación y cancelación

Última actualización: 2026-02-13

Gestión de reservas: estado, recuperación y cancelación

Una vez creada una reserva, puedes recuperar sus detalles y procesar cancelaciones a través de la API de Xeni Hotels. Este artículo cubre los puntos finales de gestión de reservas y los estados de reserva que encontrará.

Recuperar detalles de la reserva

Punto final

GET /hotels/api/v2/bookings/{booking_id}

Parámetros de ruta

XENIKBPH 26
ParámetroTipo RequeridoDescripción
bookingidXENIKBPH_32 stringSíEl ID de reserva devuelto cuando se creó la reserva.

Encabezados

XEN IKBPH48RequeridoXENIKBPH52
EncabezadoDescripción
Autoriza ciónSíVálido API firma.
x-correlación ion-idSíCorrelación ID de la sesión que creó la reserva.

Solicitud de ejemplo

GET /hotels/api/v2/bookings/XENI-1700000000-ABC123DEFAuthorization: {signature}x-correlation-id: {correlation_id}Content-Type: application/json

Ejemplo de respuesta

JSON
{
  "data": {
    "booking_id": "XENI-1700000000-ABC123DEF",
    "confirmation_number": "HTL-98765",
    "booking_status": "confirmed",
    "property": {
      "property_id": "XN00012345",
      "name": "Oceanview Resort & Spa"
    },
    "guest": {
      "title": "Mr",
      "first_name": "John",
      "last_name": "Smith",
      "email": "john.smith@example.com",
      "phone": {
        "country_code": "1",
        "number": "5551234567"
      }
    },
    "room": {
      "name": "Deluxe Ocean View King",
      "check_in": "2025-06-01",
      "check_out": "2025-06-05"
    },
    "pricing": {
      "total_price": 891.08,
      "base_price": 756,
      "taxes": 95.08,
      "fees": 40,
      "currency": "USD"
    },
    "cancellation_policy": "Free cancellation until 48 hours before check-in.",
    "created_at": "2025-05-20T14:30:00Z"
  }
}

*

Nota: Para obtener detalles completos sobre la creación de reservas (API directo y pago SSO), consulte Reservas de hoteles: API directo y pago SSO.

*

Cancelar una reserva

Punto final

PATCH /hotels/api/v2/bookings/{booking_id}

Cuerpo de solicitud

XENIKBPH88
CampoTipoXE NIKBPH83RequeridoDescripción
estadodereservaXENIKBPH94 _cadenaSíEstablecer a "CANCELLED" para cancelar la reserva.

Solicitud de ejemplo

PATCH /hotels/api/v2/bookings/XENI-1700000000-ABC123DEFAuthorization: {signature}x-correlation-id: {correlation_id}Content-Type: application/json

{  "booking_status": "CANCELLED"}

Ejemplo de respuesta

JSON
{
  "status": "success",
  "message": "Booking cancelled successfully",
  "data": {
    "booking_id": "XENI-1700000000-ABC123DEF",
    "booking_status": "CANCELLED"
  }
}

Importante: Es posible que se apliquen cargos por cancelación dependiendo de la política de cancelación de la tarifa. Siempre verifique los campos cancellation_policy y refundable de la respuesta de disponibilidad antes de cancelar. Las reservas no reembolsables pueden no ser elegibles para cancelación o pueden incurrir en un cargo completo.

*

Estados de reserva

El campo booking_status indica el estado actual de una reserva:

XENIKBPH_11 4
EstadoDescripción
confirmadoEl la reserva está confirmada y la reserva está activa.
CANCELADOEl la reserva ha sido cancelada.
pendienteLa reserva se está procesando. Vuelva a consultar en breve.

*

Formato de ID de reserva

Al crear reservas a través de la API directa, usted proporciona su propio booking_id. Recomendamos un formato que incluya:

  • Un prefijo reconocible (por ejemplo, XENI-)
  • Una marca de tiempo o identificador secuencial
  • Un sufijo aleatorio para la singularidad.

Ejemplo

XENI-1700000000-ABC123DEF

La API también devolverá un confirmation_number: este es un identificador independiente generado por el hotel o proveedor y puede ser necesario para el check-in.

*

Mejores prácticas- Almacenar ambos ID: Guarde tanto el bookingid como el confirmationnumber. El ID de reserva es para búsquedas de API; Es posible que necesite el número de confirmación en el hotel.

  • Consulta la política de cancelación antes de reservar: Muestra los términos de cancelación al huésped durante el flujo de reserva. Esto crea expectativas y reduce las disputas.
  • Maneje los errores de búsqueda con elegancia: Si no se encuentra una reserva por ID, puede deberse a que la sesión o el ID de correlación han caducado. Solicite al usuario que verifique el ID de la reserva.
  • Mantenga un registro local: Para fines de auditoría y soporte, guarde los detalles de la reserva en su propia base de datos junto con los datos de la reserva de Xeni.
*

_Artículo siguiente: Gestión de sesiones e ID de correlación
_

¿Te resultó útil este artículo?