Saltar al contenido
Blog

Comparar APIs de viajes: puntúa los ejes, no a los proveedores

Redacción de Tekravel
Escrito con la ayuda de IA

Tienes tres presentaciones de proveedores abiertas en tres pestañas. Cada una trae una diapositiva con una larga lista de aerolíneas, otra con un número de hoteles, un sandbox, REST y JSON, y un correo de soporte. Montas una hoja de cálculo, marcas cada celda y la hoja termina en empate. Ese es el final habitual de una comparación de APIs de viajes hecha como lista de funcionalidades, y es el final equivocado: las diferencias que decidirán tu próximo año solo aparecen después de salir a producción. En la reserva que se completó en el proveedor pero dio timeout en tu lado, en el reembolso que nadie sabe tramitar, en la aerolínea que estaba en la lista pero que no se puede emitir por esta vía.

Este texto es para el desarrollador o el responsable técnico que tiene que tomar esa decisión y defenderla después. No clasifica proveedores. Te da ejes para comparar, un plan de prueba que dedica su tiempo a los fallos y unas pocas preguntas que revelan rápido si hablas con un proveedor o con el revendedor del proveedor de otro.

Por qué la lista de funcionalidades siempre acaba en empate

Una lista pregunta si una capacidad existe. Casi cualquier API de viajes puede decir que sí a casi cualquier fila, porque las filas están escritas al nivel de la página comercial: búsqueda, tarificación, reserva, cancelación, emisión, webhooks, sandbox. Lo que las separa no es si existe cancel, sino qué pasa cuando lo llamas sobre una reserva emitida doce horas antes de la salida, con una tarifa con penalización, por una vía cuyo contenido llegó de un tercero. La lista no tiene columna para eso.

Hay un segundo problema. Quien rellena la lista suele ser el propio proveedor. Estás puntuando su autorretrato.

Una comparación de APIs de viajes por ejes, no por proveedores

Sustituye la matriz proveedor × funcionalidad por ejes que puntúas tú, con pruebas reunidas durante la prueba. La tabla de abajo es la que usaríamos nosotros. Puedes ponderar las filas de otra manera —un negocio solo hotelero se preocupa menos por la emisión— y deberías discutirla antes de adoptarla.

EjeLo que pregunta la listaLo que de verdad hay que averiguarCómo suena una respuesta débil
Cobertura¿Cuántas aerolíneas y hoteles?Cuántos se pueden buscar, reservar Y emitir o confirmar por esta API, en tus mercadosUn único número grande sin desglose
Profundidad¿Hay endpoint de cancelación?Qué acciones posventa están automatizadas por fuente de contenido: void, reembolso, reemisión, corrección de nombre, servicios adicionales«De eso se encarga nuestro equipo de operaciones»
Integridad del precio¿Precios en tiempo real?Con qué frecuencia el precio al reservar difiere del de la búsqueda y cómo te lo comunica la API«Los precios siempre están en vivo»
Semántica de errores¿Están documentados los errores?Si el error dice en qué estado quedó la reserva, y no solo que algo fallóUn código genérico para cualquier fallo
Idempotencia—Si una llamada de reserva repetida puede crear una segunda reservaSilencio, y luego «nunca lo hemos visto»
Proveedor de registro—El contrato de quién, el número IATA de quién, por qué BSP se emite el billete«Trabajamos con todos los grandes GDS»
Acceso y soporte¿Hay sandbox?Quién responde cuando un PNR real se queda atascado, y en cuánto tiempoUn formulario de incidencias sin interlocutor con nombre

Dos de esas filas no tienen ninguna pregunta equivalente en una lista típica. No es casualidad: son las que más cuestan cuando fallan y las que una presentación comercial menos probablemente mencionará por iniciativa propia.

Cobertura no es profundidad

La lista de aerolíneas es la diapositiva más engañosa de cualquier presentación. Una lista de varios cientos de transportistas puede significar cosas distintas, y solo una es la que quieres.

Algunas de esas aerolíneas llegan por un GDS y se reservan y emiten de principio a fin. Otras llegan por conexiones NDC, donde la búsqueda puede funcionar bien pero el servicio posterior a la reserva —cambios, reembolsos parciales, añadir una maleta— puede seguir siendo manual para esa aerolínea. Otras son low cost cuyo contenido está agregado desde otro revendedor: puedes mostrarlas, a veces reservarlas, y luego el billete llega por una vía que no controlas, en un plazo que no puedes prometer al cliente. Y otras están en la lista porque alguna vez una tarifa apareció en una respuesta de búsqueda.

Una aerolínea que puedes mostrar pero no emitir no es cobertura. En un producto de venta al público es peor que su ausencia, porque el cliente la elige, paga y luego espera.

Los hoteles tienen la misma forma con otras palabras. El número de establecimientos mezcla los que el proveedor ha mapeado y los que no; tarifas estáticas cacheadas la semana pasada junto a disponibilidad en vivo; habitaciones en cupo con periodo de release junto a inventario en free-sale. Pide la cifra reservable en vivo en las ciudades que vendes y pregunta cómo fusionan los duplicados entre sus propios proveedores: el mismo hotel tres veces a tres precios es una incidencia de soporte esperando su momento.

La prueba práctica es estrecha. Anota las veinte rutas y las veinte ciudades hoteleras que concentran la mayor parte de tu volumen —Madrid–Cancún, Madrid–Bogotá, Barcelona–Dubái, por ejemplo— y pide al proveedor que te enseñe exactamente esas funcionando de principio a fin en el sandbox: búsqueda, precio, reserva, emisión o confirmación, cancelación. Quien tiene profundidad lo hará sin rodeos. Quien solo tiene la diapositiva empezará a hablar de la diapositiva.

Qué probar durante la prueba: los caminos de error, no el camino feliz

Todos los sandboxes reservan con éxito un billete de ida en turista en una ruta tranquila. Para eso se construyeron. Tu tráfico real pasará una parte considerable de su vida en los otros caminos, y la prueba es el único momento barato para verlos.

Usa la prueba para recorrer esta lista y anota lo que devolvió la API junto a lo que resultó cierto después:

  • Cambio de precio entre búsqueda y reserva. ¿La reserva falla, se completa al nuevo precio o devuelve una respuesta distinta pidiendo confirmación? ¿Tu interfaz distingue los casos sin analizar el texto de un mensaje?
  • Oferta caducada. Busca, espera más que la vida útil de la oferta y reserva. ¿La caducidad es un error específico o el mismo que «proveedor caído»?
  • Agotado al reservar. Inventario que desaparece entre la tarificación y la reserva. ¿En qué estado queda la reserva y se libera la autorización de pago?
  • Reintento tras timeout. Envía una reserva, corta la conexión antes de la respuesta y vuelve a enviarla. ¿Tienes ahora un PNR o dos? Esta sola prueba dice más de un proveedor que todo el resto de la prueba junto.
  • Reserva creada, emisión fallida. ¿Puede la API informar de un PNR que existe pero no está emitido, y te da el plazo de emisión?
  • Fallo parcial. Una solicitud hotelera de varias habitaciones donde una se confirma y otra no. Un ida y vuelta cuyos tramos vienen de fuentes distintas.
  • Cancelación fuera del plazo gratuito. ¿Se muestra la penalización antes de confirmar o se descubre en la factura?
  • Caída del proveedor. Pregunta cómo simularla. Si no pueden, pregunta cómo aprendieron sus clientes el comportamiento.

En cada caso puntúas dos cosas. ¿La API te dice la verdad sobre el estado de la reserva? ¿Puede tu código actuar sobre esa verdad sin que una persona lea texto libre? Con una API que falla con claridad se convive mejor que con una que acierta de forma ambigua.

Hemos tratado con más detalle el lado aéreo en lo que la documentación de las APIs de reserva de vuelos no cuenta, y el diseño de un cliente para proveedores hoteleros lentos en el artículo sobre disponibilidad hotelera. Ambos acompañan bien un plan de prueba.

Preguntas que delatan a un agregador delgado

No hay nada malo en un agregador. La mayor parte del contenido de viajes llega a la mayoría de los vendedores a través de uno. El riesgo es el delgado: una capa que revende la API de otra capa, añade un margen y no posee ni el contrato con el proveedor ni el equipo operativo. Cuando algo se rompe, la respuesta tiene que subir dos empresas y volver.

Cinco preguntas lo sacan a la luz rápidamente:

  1. ¿Quién es el proveedor de registro de esta reserva? ¿Sobre el contrato de quién con la aerolínea o el hotel se apoya?
  2. ¿Con qué número IATA y por qué BSP se emite el billete? Si la respuesta es «el de un socio», pregunta quién recibe el ADM cuando se incumple una regla tarifaria.
  3. Cuando llamo a cancelar, ¿qué pasa en vuestro lado? ¿Una llamada automática al proveedor o una cola que atiende una persona?
  4. ¿Puedo ver el error de origen? Una capa delgada tiende a aplanar cualquier fallo en un único código, porque no entiende del todo los errores que recibe.
  5. ¿A quién llamo por una reserva real atascada, y a quién llama esa persona? Cuenta los eslabones.

Ninguna de estas respuestas descalifica por sí sola. El número IATA de un socio puede estar bien si el contrato dice claramente quién asume la nota de débito. Lo que importa es que el proveedor responda con precisión y rapidez. Las respuestas vagas aquí son las que recibirás después, en producción, a peor hora.

Lo que cuesta equivocarse

La integración es la parte barata. Las partes caras llegan después y no aparecen en ninguna estimación.

Un fallo de reserva duplicada significa un cliente cobrado dos veces y un PNR que hay que localizar y cancelar a mano, quizá cuando ya se cerró la ventana gratuita de void. Una reserva que se completó en origen mientras tu sistema registraba un fallo significa un asiento retenido y luego cancelado automáticamente, y un cliente que cree que tiene reserva. Una aerolínea que mostraste pero no pudiste emitir significa un reembolso, una disculpa y un cliente que no vuelve. Un ADM por una regla tarifaria que incumplió la vía del proveedor cae sobre quien es dueño del billete: asegúrate de antemano de si eres tú.

Y está el coste de cambiar. Cada rareza del proveedor que absorbes —un código de estado que significa dos cosas, un campo que a veces es texto— acaba en tu modelo de datos. Dos años después, la elección de API ya no es una integración que puedas sustituir en un sprint: es la forma de tu tabla de reservas. Esa es la verdadera razón para comparar con cuidado ahora.

Dónde encaja nuestra propia API en este marco

Ofrecemos APIs de vuelos y de hoteles. El acceso empieza con una conversación y no con una clave de autoservicio, algo que a algunos desarrolladores les parece lento; la razón es que en esa conversación se hacen las preguntas de arriba en ambos sentidos: qué rutas y ciudades necesitas, qué contenido podrás de verdad emitir o confirmar y quién se ocupa de qué después de la reserva. Si estás comparando, trae esta lista. La página de APIs de viajes es donde empieza esa conversación.

Elijas lo que elijas, elige a partir del registro de pruebas y no de la presentación. La presentación te dice lo que un proveedor quiere ser. Los caminos de error te dicen lo que es.

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.