Saltar al contenido
Blog

API de reservas de hotel y vuelo: un viaje, dos reservas

Redacción de Tekravel
Escrito con la ayuda de IA

El ticket dice: «añadir hoteles al flujo de vuelos, un solo pago, un solo total». Es una petición razonable de producto y suena a un día de trabajo, porque la búsqueda de vuelos ya existe y la página de pago también. Tres semanas después el equipo discute qué debe pasar cuando la aerolínea confirma y el hotel no. Una API de reservas de hotel y vuelo no es una integración con dos clases de resultado. Son dos integraciones que comparten una cesta.

Cuanto antes lo admita el código, menos habrá que reescribir. Lo que sigue es lo que las guías de integración se saltan: en qué se diferencian las dos mitades, cuál confirmar primero y qué tiene que ser un viaje en su modelo de datos.

Las dos mitades no se comportan igual

Ambas vuelven en JSON con un precio y una referencia, así que por el cable se parecen. No se parecen en lo que le prometen una vez que tiene la referencia.

PreguntaVueloHotel
Qué tiene tras reservarUna reserva (PNR) que aún no es un billeteUna confirmación que suele ser ya lo que vendió
Cuánto vale el precioHasta que la tarifa se revalora al reservar, y puede diferir de la búsquedaHasta que caduca la tarifa, y una tarifa puede cambiar entre la disponibilidad y la reserva
Qué la confirmaLa emisión del billete, a menudo con un límite de tiempoLa confirmación del proveedor, a veces inmediata, a veces pendiente
Cómo se deshaceUn void si se detecta pronto, si no un reembolso según las reglas de la tarifa, a menudo con penalizaciónUna cancelación según la política de la tarifa, gratuita hasta una fecha en muchas tarifas
Qué cambia el importe tardeTarifa, impuestos, a veces la moneda de la tarifaImpuestos y tasas pagados en destino, régimen de comidas, la habitación realmente asignada

Se puede discrepar de una fila, porque los proveedores difieren, pero no de la forma: una mitad tiene un paso de emisión y la otra una ventana de cancelación, y no coinciden en el tiempo. Vimos el lado aéreo de la secuencia en integración de una API de reservas de vuelos y el problema de los proveedores lentos del lado hotelero en API de disponibilidad hotelera: diseño del cliente. Este artículo empieza donde acaban esos, en la unión.

¿Cuál se reserva primero?

Nadie le dice que es una decisión de diseño, y es la que fija lo que cuesta un fallo.

Un cliente compra un vuelo y un hotel para las mismas fechas. Usted envía una reserva y luego la otra. Pueden pasar tres cosas: salen las dos, falla una, o falla una después de que la otra haya salido bien. La primera es un buen día. Las otras dos deciden su cola de soporte.

Si emite el billete primero y el hotel rechaza, tiene un cliente con asiento a una ciudad sin habitación, ya cobrado, y un reembolso sobre un billete con penalización. Si reserva el hotel primero y falla el vuelo, retiene una habitación que a menudo se cancela gratis, así que la reparación es barata. El riesgo contrario también es real, porque una tarifa no cancelable es lo peor de retener; lea por tanto las condiciones de cancelación de la tarifa antes de dejarla ir primero.

Es una regla práctica, no una ley, y lo importante es elegir el orden a propósito. Confirme la mitad más fácil de deshacer antes que la más difícil, compruebe el precio de ambas justo antes de que ninguna confirme, y anote qué hace en cada uno de los tres desenlaces. Los revisores rara vez lo preguntan. Los clientes siempre lo descubren.

Un viaje, dos reservas

La forma que aguanta es un registro de viaje que posee dos reservas, cada una con su referencia, su estado y sus condiciones. El cliente ve un total. Su base de datos ve dos filas, y el total es una suma que usted calcula, no algo que exista en el proveedor.

Mantenga los dos estados separados. «Confirmado» para el hotel y «emitido» para el vuelo no son el mismo estado, y una única columna de estado que los aplane acabará diciendo «reservado» sobre un viaje a medio reservar.

Mantenga también separadas las condiciones de cambio, y muéstrelas. Un total visible oculta que cambiar las fechas es una modificación gratuita en una mitad y una tasa en la otra. Si su interfaz ofrece «cambiar fechas» como un solo botón, decida qué hace cuando solo se puede mover una mitad, antes de que un cliente lo descubra por usted. Lo mismo vale para el margen: si añade el suyo por servicio, como la mayoría de los vendedores, el total del viaje son dos márgenes, y un reembolso sobre una mitad debe saber cuál devuelve. El dinero es donde un viaje unido se encarece, porque las líneas se liquidan en plazos distintos y el reembolso del vuelo no llega cuando entra en vigor la cancelación del hotel.

Dónde está esta plataforma

Con claridad: la plataforma expone API de vuelos y de hoteles, y el acceso empieza como una conversación y no como una clave de autoservicio. Los servicios se activan por inquilino, de modo que uno que vende hoteles y no excursiones no carga con la superficie de excursiones. Nada aquí promete una única llamada que reserve ambas mitades de forma atómica, y no debería diseñar como si existiera. Trátelas como las dos reservas que son, bajo un viaje que usted posee.

Si quiere ver las llamadas y condiciones reales antes de construir en torno a ellas, empiece por la página de API de viajes y lleve el orden en que piensa reservar. Si aún está decidiendo qué le da el acceso gratuito, API gratuita de reservas de hotel expone las clases de gratuito.

Lo que cuesta equivocarse

La versión cara es la silenciosa. Un cliente tiene el billete a una ciudad y la habitación ha desaparecido, y lo primero que usted sabe es un mensaje de noche, desde un aeropuerto. Más barato pero real: un pago que muestra un total tranquilizador y luego, tras una comprobación de precio, un segundo número que el cliente no aceptó; un reembolso que devuelve el vuelo y olvida el hotel; y un estado «reservado» cuando el proveedor dice otra cosa.

Nada de eso requiere una solución ingeniosa. Requiere que el viaje sea un objeto real, que el orden sea una decisión escrita y que se revisen de nuevo ambos precios en el último momento antes de que ninguna reserva confirme. Constrúyalo una vez y el pago podrá parecer tan simple como pedía el ticket.

Redacción de Tekravel

Mesa de tecnología de viajes

La mesa de tecnología de viajes de Tekravel escribe para el sector: propietarios de agencias, consolidadores y los desarrolladores que los integran. Cada artículo se comprueba contra la plataforma que describe antes de publicarse.