Saltar al contenido
Blog

Proveedor de API de reservas de hoteles: júzgalo en la recepción

Redacción de Tekravel
Escrito con la ayuda de IA

La primera incidencia de soporte tras el lanzamiento rara vez trata de la búsqueda. Es un huésped en la recepción a las once de la noche, con un número de confirmación en el móvil, y un recepcionista que lo teclea dos veces y dice que el hotel no tiene ninguna reserva a ese nombre. El huésped os pagó. Vuestro sistema dice que la reserva está confirmada. Los dos dicen la verdad, y ese es el problema.

De eso trata realmente elegir un proveedor de API de reservas de hoteles. La mayoría de los equipos elige por lo que se ve en una demo: cuántos alojamientos devuelve una ciudad, qué limpio es el endpoint de disponibilidad, lo rápido que el SDK llega a un primer resultado. Eso importa. Pero es más o menos igual en todas partes, y nada de ello decide lo que pasa en la recepción.

Por qué la cobertura es la primera pregunta equivocada

Una búsqueda que devuelve más hoteles parece una API mejor. Pero un alojamiento que puedes mostrar y una reserva que el hotel respetará son dos promesas distintas, hechas por partes distintas del negocio del proveedor. La primera viene de un feed de contenido. La segunda viene de contratos, de la conectividad con los sistemas del propio hotel y de un servicio de soporte con alguien de guardia un sábado.

Si estás decidiendo cuántos proveedores conectar, esa pregunta tiene su propio artículo, y el problema de mapeo que describe es real. Este asume que ya estás eligiendo proveedor y pregunta cuánto vale su respuesta de reserva una vez que el huésped ha pagado.

Las cinco propiedades de un proveedor de API de reservas de hoteles que aparecen tras el pago

Reduce la documentación de un proveedor a las respuestas que tu sitio guardará cuando el dinero ya se haya movido. En estas filas, dos proveedores con endpoints de búsqueda idénticos resultan ser productos distintos.

PropiedadCómo es una buena respuestaQué te cuesta si falta
Condiciones de cancelaciónEstructuradas: un plazo, una penalización y la zona horaria del plazoTexto libre que alguien debe leer y un reembolso decidido a ojo
Quién cobra el dineroIndicado por tarifa: prepago a ti o pago en el hotel, y quién es el comerciante de registroUn huésped cobrado dos veces, por ti y en el check-out
El número de confirmación propio del hotelDevuelto, o entregado después por un canal documentadoSolo la referencia del proveedor, que no significa nada en recepción
Cambio de precio entre disponibilidad y reservaUn precio nuevo explícito o un rechazo claro, nunca una diferencia silenciosaLa diferencia entre la tarifa mostrada y la reservada sale de tu margen
Sin registro a la llegadaUn procedimiento con nombre y un contacto que responda fuera de horarioTu personal al teléfono con el hotel mientras el huésped espera en el vestíbulo

Puedes discrepar del orden. No puedes lanzar un sitio que cobra con tarjeta sin una respuesta para cada fila.

La cancelación es un dato, o es un pasivo

Mira de cerca la primera fila, porque es la que falla más en silencio. Muchas respuestas llevan la política de cancelación como una frase: cancelación gratuita hasta una fecha, después se cobra la primera noche. Para una persona se lee bien. Tu código no puede actuar sobre una frase sin interpretarla, y interpretarla es como los errores llegan a producción.

El detalle que muerde es la zona horaria. Un plazo de medianoche es un momento en la ciudad del hotel, otro en tu servidor y un tercero en el móvil del huésped. Si el proveedor no dice cuál, algún día tu sitio dirá a un huésped que aún puede cancelar gratis, le reembolsará y descubrirá que el hotel cobró la penalización igualmente. Nada lanzó un error. El dinero simplemente se fue.

Las tarifas no reembolsables merecen el mismo escrutinio. Un proveedor que las marca con claridad, en un campo y no solo en el nombre de la tarifa, ha pensado en el sitio que las vende. Pide ver ambos tipos en una respuesta real antes de firmar nada.

Qué nombre aparece en el extracto de la tarjeta del huésped

La segunda fila suena a contabilidad. En realidad es una cuestión de atención al cliente. Cuando una tarifa es de prepago, el huésped te paga a ti, tú o el proveedor pagáis al hotel, y el hotel no debería cobrar nada más al huésped salvo extras como el minibar o una tasa municipal cobrada en recepción. Cuando una tarifa es de pago en el hotel, tu sitio no cobra nada por la habitación y es el alojamiento quien carga la tarjeta del huésped, a menudo en el check-in o el check-out.

Ambos modelos funcionan. Lo que no funciona es un pago que no distingue entre ellos. Si el proveedor devuelve los dos tipos de tarifa con la misma forma y el modelo de pago enterrado en una descripción, tu sitio acabará cobrando a un huésped por una habitación que el hotel cobrará de nuevo. El huésped ve dos líneas en el extracto y llama al nombre de la primera, que es el tuyo.

Por eso la respuesta que quieres es por tarifa, en un campo, e incluye quién es el comerciante de registro. Esa última parte decide cuyo descriptor aparece en la tarjeta y quién gestiona un contracargo.

Preguntas para poner por escrito antes de firmar

Las demos muestran el camino feliz. Las respuestas escritas muestran si el proveedor ha vivido los demás. Envía estas y guarda las respuestas:

  • Enséñame una respuesta de reserva para una tarifa no reembolsable y otra para una tarifa con plazo de cancelación gratuita.
  • ¿En qué zona horaria se expresa ese plazo y dónde lo indica la respuesta?
  • ¿Cuándo llega el número de confirmación propio del hotel y cómo lo recibo si llega después de la llamada de reserva?
  • En una tarifa de pago en el hotel, ¿qué ve exactamente el huésped en su tarjeta, de parte de quién y cuándo?
  • Cuando un huésped llega y el hotel no tiene registro, ¿a quién llama él o yo, y en qué horario?

Un proveedor que responde a la última pregunta con un procedimiento ya lo ha vivido. Uno que responde con el nombre de una función, no. Lo mismo vale para los vuelos, donde lo que hay detrás de la API importa más que la API.

Lo que cuesta equivocarse

Cada fallo es pequeño y se repite. Un reembolso pagado de tu margen porque un plazo se leyó en la zona horaria equivocada. Un huésped cobrado dos veces porque una tarifa de pago en el hotel parecía prepago en tu checkout. Un empleado que dedica el inicio de cada semana a llamar a hoteles para reconfirmar reservas a mano porque el proveedor nunca devolvió un número que el hotel reconozca. Nada de esto aparece en un recuento de cobertura, y todo aparece en la bandeja de soporte durante el primer mes de tráfico real.

El trabajo para evitarlo es una tarde: leer cinco respuestas de reserva con la tabla de arriba al lado.

Dónde estamos nosotros

Tekravel ofrece APIs de hoteles y vuelos. El acceso empieza como una conversación y no como una clave de autoservicio, los servicios se activan por inquilino y el contenido de proveedores llega a un inquilino mediante grupos de proveedores, no mediante acuerdos uno a uno. No publicamos recuentos de alojamientos en esta página y preferimos que nos hagas las cinco preguntas de arriba antes que fiarte de una cifra. Si estás en esa fase, la página de la API es donde empieza la conversación.

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.