Saltar al contenido
Blog

API de precios de vuelos: la cifra que ves aún no es una tarifa

Redacción de Tekravel
Escrito con la ayuda de IA

La demo funciona. Un desarrollador conecta una API de precios de vuelos a un calendario de los días más baratos para volar, la cuadrícula se llena de cifras y todos en la sala están contentos. Entonces el primer cliente real elige una fecha, ve una cifra menor en la página de resultados que en la de pago y escribe a soporte con una captura. Nada está roto. La API hizo lo que se le pidió: respondió a una pregunta sobre el precio, y el sitio tomó la respuesta por una promesa.

Un precio es una oferta con memoria corta

Una tarifa aérea no es una etiqueta fija pegada a un asiento. Es una clase que se abre y se cierra a medida que se venden asientos, y su cifra cambia con la mezcla de pasajeros, los vuelos exactos, las tasas de los aeropuertos implicados y la moneda en que se expresa la cotización. Una respuesta de precio es una instantánea tomada en un momento, para un conjunto de datos de entrada. Si la tratas como un hecho del pasado, construirás lo correcto; si la tratas como un hecho del presente, pasarás un mes en reembolsos.

Por eso la pregunta útil para un desarrollador nunca es solo cuál es el precio. Es qué tipo de precio es, qué antigüedad tiene y qué hará el sistema si resulta ser erróneo.

Tres cifras que se llaman precio

La mayoría de los proveedores devuelve las tres en algún lugar de su documentación, a menudo bajo el mismo nombre de campo. Sepáralas en tu modelo de datos desde el primer día.

EstadoDe dónde vieneFrescura¿Se puede vender?Qué mostrar
Precio de exploraciónBúsqueda en caché o agregada, pensada para velocidad y amplitudPosiblemente desactualizado y no calculado para tus pasajerosNoTexto «desde» y aviso de que puede cambiar
Oferta tarificadaConsulta en vivo del itinerario, los tipos de pasajero y la tarifa exactosFresca en el momento de la llamada, con caducidad o señal de retarificaciónSí, hasta que caduqueEl total, tasas desglosadas, condiciones de la tarifa
Importe emitidoLo que la aerolínea o el sistema emisor cobró de verdad al hacer el pedidoDefinitivoYa vendidoEl recibo, conciliado con la oferta

El precio de exploración es el que hace posibles los calendarios y las etiquetas «desde», y es algo estupendo de construir. Pero no es el mismo objeto que la segunda fila. El error es un único campo price en el que desembocan los tres.

En la práctica son tres tipos o tres tablas en el código, no uno con una bandera. El precio de exploración puede equivocarse un poco, porque solo invita a hacer clic. La oferta tarificada es un compromiso que estás a punto de asumir con tu nombre, así que se guarda con la hora de obtención, los datos que la produjeron y el identificador que el proveedor pedirá al hacer el pedido. El importe emitido es contabilidad. Cuando soporte pregunta por qué un cliente pagó una cifra distinta a la del correo, la respuesta está en el hueco entre filas, y solo puedes leerlo si guardaste las tres.

Qué debe traer una respuesta de precio

Una cifra suelta no basta para construir un pago. Al leer el ejemplo de respuesta de un proveedor, busca lo siguiente y desconfía de lo que llegue como texto libre.

  • La moneda, indicada en la respuesta y no supuesta desde tu cuenta.
  • Tarifa base e impuestos por separado, para mostrar el desglose y para que un cambio de tasas no parezca un cambio de tarifa.
  • Los tipos de pasajero para los que se calculó el precio. El precio de un adulto multiplicado por tres no es una tarifa familiar.
  • Condiciones de la tarifa y equipaje como datos estructurados, pues deciden si la opción barata lo es de verdad para tu cliente.
  • Una caducidad o señal de retarificación: una marca de tiempo, o la indicación explícita de que debes retarificar antes de pedir.

Esto último es lo que la gente se salta. Si nada en la respuesta dice cuánto vive la oferta, estás adivinando, y la conjetura se hace en producción.

Retarifica antes del pedido, no después

El ritmo más seguro lleva una regla dentro. Se busca para explorar. Cuando el cliente elige un itinerario, se pide una oferta tarificada en vivo para ese itinerario y esos pasajeros. Se muestra ese total al cliente. Solo entonces se crea el pedido. Si el precio en vivo difiere del de la página de resultados, se lo dices al cliente antes de que pague, con palabras claras, y no después.

Si te saltas el paso intermedio, heredas la diferencia. O cobras más de lo que vio el cliente y pierdes la venta en la página de pago, o respetas la cifra menor y la brecha sale de tu propio margen. Una agencia pequeña puede absorberlo algunas veces; no puede absorberlo como diseño.

Pregunta esto por escrito antes de integrar

La documentación describe el camino feliz. El comportamiento que te cuesta dinero está en las respuestas a una lista corta de preguntas, y conviene tenerlas en un correo y no en una llamada.

  1. ¿El precio de la respuesta de búsqueda es en vivo o en caché, y se indica en la propia respuesta?
  2. ¿Hay una llamada de tarificación aparte para el itinerario exacto y es obligatoria antes de un pedido?
  3. ¿Qué ocurre al pedir si el precio se movió: un rechazo, un precio nuevo en la respuesta o una emisión silenciosa por el nuevo importe?
  4. ¿Cómo se desglosan impuestos y recargos de la aerolínea, y pueden cambiar entre la tarificación y la emisión?
  5. ¿En qué moneda se calcula el precio y dónde se convierte si el cliente ve otra?
  6. ¿Cuánto tiempo sigue vigente una oferta tarificada y cómo lo sabrás?

Un proveedor que responde con precisión ha pensado en el pago. Uno que responde «siempre está actualizado» no te ha dado nada que puedas probar. Si no puedes probar el comportamiento tú mismo, es motivo para mirar el conjunto de otra manera antes de construir encima.

Cuánto cuesta equivocarse

Rara vez falla con estruendo. Falla como una pequeña caída en el paso de pago que nadie atribuye al precio, como tickets de soporte que empiezan por «el precio cambió», como un cliente que confió en la página de resultados y ya no lo hace. El personal acaba reconfirmando tarifas a mano antes de emitir. Alguien propone al final una regla que redondea los precios hacia arriba por prudencia, y entonces el sitio es caro justo en la pantalla donde la gente compara. Cada uno de esos costes es un impuesto sobre una decisión que era barata de tomar bien al principio.

Dónde se sitúa esta plataforma

La plataforma expone API de vuelos y hoteles, activadas por inquilino. El acceso empieza con una conversación y no con una clave de autoservicio, así que no hay un formulario que te entregue un token y una tabla de límites. Aquí no publicamos latencia, cobertura ni número de tarifas, porque una cifra que no podemos enseñarte a comprobar no merece imprimirse. Lo que sí puedes hacer es llevar las preguntas anteriores a esa conversación y pedir ver la respuesta de una oferta tarificada, no solo la de una búsqueda. Si estás en esa etapa, la página de API de viajes es donde empieza.

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.