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

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.
| Estado | De dónde viene | Frescura | ¿Se puede vender? | Qué mostrar |
|---|---|---|---|---|
| Precio de exploración | Búsqueda en caché o agregada, pensada para velocidad y amplitud | Posiblemente desactualizado y no calculado para tus pasajeros | No | Texto «desde» y aviso de que puede cambiar |
| Oferta tarificada | Consulta en vivo del itinerario, los tipos de pasajero y la tarifa exactos | Fresca en el momento de la llamada, con caducidad o señal de retarificación | Sí, hasta que caduque | El total, tasas desglosadas, condiciones de la tarifa |
| Importe emitido | Lo que la aerolínea o el sistema emisor cobró de verdad al hacer el pedido | Definitivo | Ya vendido | El 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.
- ¿El precio de la respuesta de búsqueda es en vivo o en caché, y se indica en la propia respuesta?
- ¿Hay una llamada de tarificación aparte para el itinerario exacto y es obligatoria antes de un pedido?
- ¿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?
- ¿Cómo se desglosan impuestos y recargos de la aerolínea, y pueden cambiar entre la tarificación y la emisión?
- ¿En qué moneda se calcula el precio y dónde se convierte si el cliente ve otra?
- ¿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.