Saltar al contenido
Blog

¿Cuántos proveedores de API hotelera necesitas? Cuenta el mapeo

Redacción de Tekravel
Escrito con la ayuda de IA

La búsqueda de hoteles salió en vivo el trimestre pasado con un solo proveedor y, durante un tiempo, nadie se quejó. Luego ventas te reenvía una captura de pantalla. Un cliente que prepara un viaje a Estambul encontró un cuatro estrellas en su móvil y pregunta por qué vuestra web ni siquiera lo muestra. No es un precio más alto: es que no aparece. El siguiente mensaje va dirigido a ti: ¿añadimos otro proveedor?

Probablemente sí. Pero cuántos proveedores de API hotelera necesitas no es una pregunta de cobertura que se responda con una cifra de cobertura. Cada proveedor que añades amplía el inventario y, a la vez, te envía hoteles que ya tienes, con otro nombre, otro identificador y coordenadas ligeramente distintas. La segunda integración es sobre todo código. Todo lo que viene después es sobre todo deduplicación, y ese es el coste que se olvida al contar proveedores.

Cada proveedor son dos flujos, no uno

Un proveedor de hoteles te entrega dos cosas muy distintas, y tratarlas como una sola es la raíz de casi todos los errores iniciales.

La primera es el contenido estático: nombres de establecimientos, direcciones, coordenadas, categoría, fotos, descripciones de habitaciones, servicios. Cambia despacio. Lo descargas en bloque, lo guardas y lo refrescas con un calendario que se mide en días. La segunda son las tarifas en vivo: qué hay disponible para estas fechas y esta ocupación, a qué precio y con qué condiciones de cancelación. Eso cambia entre la búsqueda y la reserva. Lo cacheas como mucho unos minutos y lo vuelves a comprobar en el prebook, diga lo que diga la búsqueda.

Dos vidas de caché, dos formas de fallar. El contenido estático caducado muestra la foto equivocada. Una tarifa caducada vende una habitación a un precio que el proveedor no respetará. Al añadir un proveedor añades los dos flujos, y el trabajo de verdad se esconde en el estático, porque es el que tienes que conciliar con todo lo que ya tienes.

Por qué el mismo hotel llega tres veces

Conecta tres proveedores en la misma ciudad y busca. Verás algo así: uno lo llama Grand Plaza Hotel Taksim, otro Grand Plaza Taksim, el tercero GRAND PLAZA HTL - ISTANBUL. Tres códigos internos. Tres juegos de coordenadas a pocos pasos unos de otros. Tres colecciones de fotos, una de ellas de antes de la reforma. Para el viajero, la web parece rota.

La solución es una capa de mapeo, y el campo por el que deduplicas no es el nombre. Es tu propio identificador canónico de establecimiento. El código de hotel de cada proveedor apunta a él mediante una tabla de correspondencias: proveedor, código del hotel en el proveedor, identificador canónico. El código del proveedor nunca se convierte en la clave primaria de tu catálogo, porque en cuanto entra un segundo proveedor, deshacer esa decisión sale carísimo.

Decidir que dos códigos son el mismo hotel es un problema de emparejamiento, y rara vez es limpio:

  • Un código de mapeo externo compartido, cuando los proveedores lo incluyen, es la señal más fuerte. No todos lo incluyen, ni para todos los establecimientos.
  • Coordenadas dentro de un radio pequeño más un nombre normalizado (sin «hotel», sin la ciudad, sin puntuación ni mayúsculas) atrapan casi todo lo demás.
  • Dirección y teléfono resuelven los casos ajustados. Dos hoteles de la misma cadena en la misma calle son justo el caso en que nombre y distancia coinciden y los hoteles son distintos.
  • Lo que queda va a una cola de revisión humana. No se publica a ojo.

Las habitaciones son más difíciles que los hoteles

Con el establecimiento ya mapeado, las habitaciones siguen sin cuadrar. «Deluxe King», «Superior Room, 1 King Bed» y «Double Room - City View» pueden ser la misma habitación o tres distintas. La mayoría de los equipos compara las ofertas a nivel de establecimiento, por régimen, condiciones de cancelación y precio, en lugar de intentar mapear cada nombre de habitación entre proveedores. Es una decisión defendible. Tómala a propósito, y muestra al viajero suficiente de la descripción del proveedor para que sepa qué está reservando.

Un proveedor, varios o un agregador

Tres caminos, y la comparación honesta va de quién carga con el mapeo y con el riesgo de paridad de tarifas, no de la cobertura anunciada.

 CoberturaRiesgo de paridadEsfuerzo de integraciónQuién se ocupa del mapeo
Un proveedor, directoFuerte donde él es fuerte, escasa en el restoAlto: si su precio falla, no tienes segunda cotizaciónUna integración, los dos flujosNadie; un código por hotel
Varios proveedores, directoLa más amplia que puedes controlarMenor: eliges la mejor oferta por estanciaUna por proveedor, más la capa de mapeo y su mantenimientoTú, para siempre
Un agregadorAmplia, la deciden sus fuentesMixto: ves el precio que decide trasladarteUna integraciónEl agregador, con tu criterio sobre lo que se le escapa

Puedes discrepar de la fila del medio, y muchos equipos lo hacen: ser dueño del mapeo es ser dueño de la calidad de tus resultados, y algunos nunca lo cederían. La clave es que se trata de una decisión de plantilla tanto como técnica. La tabla de correspondencias no es un proyecto con fecha de fin.

Decidir el número

Cuenta mercados, no proveedores. Empieza con un proveedor fuerte donde más vendes. Lleva un registro de las búsquedas que volvieron vacías o escasas, y de las capturas que reenvía ventas. Añade el segundo cuando puedas nombrar las ciudades y los establecimientos que le faltan al primero, y comprueba que el candidato los cubre de verdad antes de firmar nada.

Cada incorporación debe cerrar un hueco que puedas listar. Si no puedes, el nuevo proveedor te enviará sobre todo duplicados de hoteles que ya vendes. Explicamos aparte cómo juzgar una API de viajes por sus criterios y no por su folleto; ese marco vale para cada candidato.

No integrarlo todo tú

Hay un cuarto camino: integrarte una vez con una plataforma que ya tiene las conexiones con proveedores. En esta plataforma el contenido de proveedores se comparte mediante grupos de proveedores, no con acuerdos uno a uno, y cada tenant ve los proveedores que sus grupos le conceden. Para un desarrollador, eso lleva la pregunta «qué proveedores hay detrás de mi búsqueda de hoteles» del código a la configuración: desarrollas contra una sola API hotelera, y la mezcla de proveedores pasa a ser un acuerdo comercial, no otro sprint de integración.

No elimina las preguntas de este artículo. Pregunta cómo se gestiona el mapeo para los proveedores que te concederían, y pruébalo en las ciudades que vendes, no en la ciudad de la demo. El acceso a las API de vuelos y hoteles empieza con una conversación y no con una clave de autoservicio: el momento justo para preguntar exactamente eso.

Lo que cuesta quedarse corto

El hotel que falta en la captura no es una reserva perdida. Es un cliente que ahora mira el móvil antes de escribirte y, unas cuantas veces después, en lugar de escribirte. La agencia no falló en el servicio. Su búsqueda simplemente no sabía que el establecimiento existía.

Integrar de más cuesta de otra manera: tres filas del mismo hotel en los resultados, tres políticas de cancelación que explicar al cliente, tres contratos y tres juegos de credenciales que rotar. Ninguno de los dos fallos aparece en el número de proveedores. Los dos aparecen en lo que el viajero ve en la página de resultados.

Construye la parte de tarifas en vivo para que aguante a los proveedores lentos; lo tratamos en el diseño de un cliente de API de disponibilidad hotelera. Después, deja que los huecos que sabes nombrar decidan cuántos proveedores hay detrás.

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.