¿Qué es la integración XML hotelera? Diferencia entre datos estáticos y dinámicos
La integración XML hotelera conecta una agencia o plataforma con el sistema de un proveedor mediante un servicio web. Los datos estáticos (nombre, dirección, coordenadas, habitaciones, imágenes) cambian poco y se almacenan de antemano. Los dinámicos (disponibilidad, precio, cancelación) se consultan en vivo en cada búsqueda y se vinculan al registro estático por el código de proveedor.
- Autor
- Equipo editorial de hotelmapping.org
- Última actualización:
- 10 min de lectura
¿Qué significa integración XML hotelera?
Las agencias online, en lugar de introducir a mano la información y el precio de los hoteles que venden, se conectan mediante un servicio web a proveedores como bedbanks, mayoristas, plataformas de reserva o channel managers. La información del hotel, el precio y la disponibilidad llegan automáticamente por esa conexión. En el sector, esta conexión se llama brevemente integración XML.
La integración tiene dos extremos. En uno, el proveedor ofrece como servicio su inventario y sus precios. En el otro, la agencia, el turoperador o el sitio de metabúsqueda llama a ese servicio, convierte la respuesta a su propio sistema y se la muestra a su cliente. A medida que crece el número de proveedores, crece este trabajo de conversión, porque cada proveedor envía el mismo hotel con su propio nombre, su propio código y su propia estructura de datos.
Para saber más sobre los tipos de proveedor, consulte la guía qué es un bedbank y las entradas del glosario bedbank y channel manager.
¿Por qué se dice “XML”?
XML (Extensible Markup Language) es un formato de texto en el que los datos se estructuran con etiquetas y que ha sido estandarizado por el W3C. La mayoría de los primeros servicios web del sector viajes se construyeron sobre SOAP y XML. Por eso arraigó la expresión “integración XML”.
Hoy muchos proveedores ofrecen API REST que usan JSON; algunos siguen trabajando con XML. En el lenguaje de negocio, ambos se denominan casi siempre “integración XML”. Técnicamente, lo importante no es el formato, sino el contenido de los datos y que ambas partes reconozcan el mismo hotel como el mismo hotel.
Diferencia entre datos estáticos y dinámicos
Los datos que llegan en una integración XML hotelera se dividen en dos grupos. Esta distinción es la base del diseño del sistema: determina qué dato se almacena, cuál se consulta cada vez y dónde se hace el mapeo.
| Característica | Datos estáticos | Datos dinámicos |
|---|---|---|
| Campos de ejemplo | Nombre del hotel, dirección, coordenadas, estrellas, descripción, imágenes, servicios, lista de tipos de habitación | Disponibilidad, precio, cupo, condición de cancelación, opciones de régimen en el momento |
| Velocidad de cambio | Lenta; en días o semanas | Rápida; en minutos o incluso segundos |
| Cómo se obtienen | Descarga masiva (dump completo), después los registros modificados (delta) | Consulta en vivo en cada búsqueda |
| Dónde se guardan | En su base de datos | En una caché de corta duración o no se guardan |
| Necesidad de mapeo | Alta; el mismo hotel se escribe distinto en cada proveedor | Indirecta; los códigos de la respuesta se vinculan al registro estático |
| Si hay un error | Hotel duplicado, ubicación incorrecta, contenido incompleto | Precio mostrado incorrecto, error de reserva |
¿Qué abarcan los datos estáticos?
Los datos hoteleros estáticos son la información que forma la identidad y la descripción de un establecimiento. Los campos típicos son estos:
- Código y nombre del hotel del proveedor
- Dirección, ciudad, país y código de destino del proveedor
- Coordenadas (latitud, longitud)
- Estrellas o categoría
- Textos descriptivos e imágenes
- Servicios del establecimiento y de las habitaciones
- Lista de tipos de habitación y, a veces, de regímenes
- Teléfono, correo electrónico, dirección web
Como estos datos cambian poco, no se piden de nuevo en cada búsqueda. La agencia los descarga de antemano, los guarda en su propia base de datos y los muestra en pantalla.
¿Qué abarcan los datos dinámicos?
Los datos dinámicos son la información vigente en ese momento para una fecha, habitación y número de personas determinados: si la habitación está disponible, cuál es el precio, qué opciones de régimen hay y cuál es la condición de cancelación. Esta información se obtiene en vivo del proveedor en cada petición de búsqueda. La respuesta contiene identificadores como código de hotel, código de habitación y código de régimen; para mostrar en pantalla un resultado con sentido, estos códigos deben combinarse con los datos estáticos.
El flujo de una integración XML hotelera típica
Aunque los nombres y detalles cambien de un proveedor a otro, la mayoría de las integraciones siguen pasos similares:
- Descarga del contenido estático: la lista de hoteles, las descripciones, las imágenes y los tipos de habitación se obtienen en bloque y se almacenan.
- Búsqueda (availability): el destino, las fechas y los datos de personas del usuario se envían al proveedor; los hoteles disponibles regresan con sus precios.
- Recomprobación (recheck o prebook): cuando el usuario elige una opción, se vuelven a validar precio y disponibilidad; las condiciones de cancelación quedan fijadas.
- Reserva (book): se crea la reserva con los datos del huésped; el proveedor devuelve un número de reserva.
- Consulta y cancelación: se consulta el estado de la reserva o se cancela.
El primer paso es de datos estáticos; los demás, de datos dinámicos. hotelmapping.org solo depura y mapea los datos que produce el primer paso; los pasos de búsqueda, reserva y cancelación quedan entre su sistema y su proveedor.
Ejemplo: el mismo hotel, dos proveedores, dos formatos
En el ejemplo siguiente, el hotel ficticio “Lara Palm Hotel” llega de dos proveedores. El primer proveedor envía XML:
<Hotel code="LPH-20931">
<Name>LARA PALM HTL</Name>
<Address>Guzeloba Mah., Lara Cad. No:112</Address>
<City code="AYT">Antalya</City>
<Position lat="36.8571" lng="30.7962"/>
<Category>5</Category>
<Rooms>
<Room code="DBL-SV">Double Room Sea View</Room>
<Room code="FAM-2B">Family Room 2 Bedrooms</Room>
</Rooms>
</Hotel>
El segundo proveedor envía el mismo hotel en JSON, con otro nombre y otro código:
{
"hotelId": "770512",
"hotelName": "Lara Palm Hotel - Adults Friendly",
"destination": "Lara / Antalya",
"latitude": 36.8569,
"longitude": 30.7965,
"stars": "5*",
"roomTypes": [
{ "id": "R1", "name": "DBL ROOM SEAVIEW" },
{ "id": "R4", "name": "Family Suite 2 Bdr" }
]
}
Si estos dos registros se usan sin mapear, el hotel aparece dos veces en el listado. Una vez mapeados, se reúnen bajo un único identificador permanente:
{
"hm_id": "HM-1052207",
"name": "Lara Palm Hotel",
"destination_id": "TR-07-MURATPASA-LARA",
"destination": ["TR", "Antalya", "Muratpaşa", "Lara"],
"geo": { "lat": 36.8570, "lng": 30.7963 },
"supplier_codes": {
"A": "LPH-20931",
"B": "770512"
},
"rooms": [
{ "hm_room_id": "HM-1052207-R02", "name": "Double Room, Sea View", "supplier_codes": { "A": "DBL-SV", "B": "R1" } },
{ "hm_room_id": "HM-1052207-R04", "name": "Family Room, 2 Bedrooms", "supplier_codes": { "A": "FAM-2B", "B": "R4" } }
]
}
Son datos de ejemplo; el nombre del hotel, la dirección y los códigos no pertenecen a un establecimiento real. Aquí el HM ID vincula ambos códigos de proveedor al mismo hotel. Las habitaciones se agrupan con la misma lógica; ese trabajo es el objeto del producto de mapeo de habitaciones.
¿Por qué los datos estáticos requieren mapeo?
Para una agencia que trabaja con un solo proveedor, el problema del mapeo es pequeño. En cuanto se añade el segundo proveedor, se crean dos registros del mismo hotel. Con cada proveedor más, el problema crece:
- Listado duplicado: el mismo hotel aparece en la búsqueda como varias tarjetas; el cliente no sabe cuál es la correcta. El impacto de este asunto en el negocio lo tratamos en el artículo coste de los hoteles duplicados.
- Comparación de precios rota: los precios que los proveedores dan para el mismo hotel no pueden reunirse en una sola tarjeta.
- Contenido incoherente: la descripción de un proveedor puede estar incompleta y las coordenadas de otro, equivocadas. Para combinar los campos correctos, primero hay que saber que los registros son el mismo hotel.
- Confusión de habitaciones y regímenes: “DBL ROOM SEAVIEW” y “Double Room Sea View” son la misma habitación; “AI” y “All Inclusive” son el mismo régimen. También estos deben vincularse a un código estándar.
El detalle del proceso de mapeo lo explicamos en la guía qué es el mapeo hotelero. En el lado del producto, su equivalente está en las páginas de mapeo hotelero, mapeo de regímenes y contenido hotelero.
¿Cómo se vincula la respuesta dinámica al registro estático?
Una respuesta de búsqueda suele llevar solo códigos. Por ejemplo, la respuesta de disponibilidad del proveedor B puede contener un fragmento como este:
{
"hotelId": "770512",
"offers": [
{ "roomId": "R1", "board": "AI", "price": { "amount": 412.50, "currency": "EUR" }, "refundable": true }
]
}
Para mostrar esta respuesta en pantalla, su sistema debe responder a estas preguntas: ¿qué hotel es “770512”? ¿Qué habitación es “R1”? ¿Qué tipo de régimen estándar es “AI”? Si el lado estático está mapeado, la respuesta se obtiene con una sola consulta: el código de proveedor se convierte en HM ID, el código de habitación en identificador de habitación HM y el código de régimen en código estándar. Así, las ofertas de distintos proveedores pueden mostrarse una al lado de otra en la misma tarjeta de hotel, bajo el mismo título de habitación y de régimen.
Como esta conversión se repite en cada búsqueda, debe ser rápida. Por eso los resultados del mapeo suelen guardarse de su lado como una tabla y, en el momento de la búsqueda, solo se consulta esa tabla. El origen de la tabla puede ser una API, un dump diario o una combinación de ambos. Para consultar códigos uno a uno también puede usarse la API de mapeo.
¿Cómo se mantienen actualizados los datos estáticos?
Los datos estáticos cambian despacio, pero cambian: los hoteles abren, cierran, cambian de nombre o de propietario; los proveedores eliminan códigos o asignan códigos nuevos. Para seguir estos cambios hay tres métodos habituales:
| Método | Cómo funciona | Cuándo conviene |
|---|---|---|
| Dump completo | Todo el catálogo se vuelve a descargar desde cero a intervalos determinados | Configuración inicial, catálogo pequeño, comprobación completa periódica |
| Delta dump | Solo se reciben los registros añadidos, modificados y eliminados desde el último volcado | Catálogo grande, actualización regular |
| Webhook | Cuando hay un cambio, la otra parte le envía una notificación | Cambios de código que requieren reacción rápida |
En el enfoque de delta dump es importante que también se notifiquen de forma explícita los registros eliminados o fusionados. De lo contrario, en su sistema queda un código de hotel que ya no existe y que provoca errores en la búsqueda.
Errores frecuentes en proyectos de integración
- No actualizar nunca los datos estáticos: tras la primera descarga, los datos envejecen; los hoteles cerrados siguen a la venta y los nuevos no aparecen.
- Considerar el código de proveedor como identificador único: el código de proveedor solo tiene sentido para ese proveedor. Si hay varios proveedores, necesita su propio identificador permanente.
- Mapear solo por nombre: hay hoteles distintos con el mismo nombre; en cambio, el mismo hotel llega con nombres distintos. Deben evaluarse en conjunto las coordenadas, la dirección, el teléfono y la dirección web.
- Dejar los códigos de habitación y de régimen como texto libre: en pantalla aparecen juntos “DBL ROOM SEAVIEW” y “Double Room Sea View”; la comparación se rompe.
- No validar las coordenadas: a veces los proveedores envían la coordenada del centro de la ciudad o de un punto equivocado. Eso estropea tanto la visualización en el mapa como el mapeo.
- No seguir los cambios de código: cuando un proveedor elimina un código y asigna uno nuevo, el mapeo anterior se rompe en silencio.
Lista de comprobación al conectar un proveedor nuevo
Antes de empezar una nueva integración XML, aclarar la respuesta a estas preguntas le facilitará el trabajo:
- ¿En qué formato y por qué canal llegan los datos estáticos (API, archivo, FTP)?
- ¿Con qué frecuencia se publican el dump completo y el delta; se notifican los registros eliminados?
- ¿Los tipos de habitación y de régimen están codificados o son texto libre?
- ¿Qué jerarquía siguen los códigos de destino?
- ¿Los códigos de la respuesta de búsqueda son idénticos a los de los datos estáticos?
- ¿Cuáles son las reglas de caché y de recomprobación?
Si está eligiendo un servicio de mapeo, hemos reunido preguntas más detalladas en el artículo 12 preguntas que hay que hacer al elegir una API de mapeo hotelero. La lista de conexiones de proveedor ya disponibles está en la página de integraciones; por ejemplo, la página de Hotelbeds muestra qué campos mapeamos en los datos estáticos de un bedbank.
¿Dónde encaja hotelmapping.org en esta estructura?
hotelmapping.org trabaja en el lado estático de la integración XML. Recibe los datos estáticos de sus proveedores, los normaliza y vincula el mismo hotel a un único HM ID permanente. Convierte los nombres de habitación, los regímenes y los códigos de destino en sus equivalentes estándar. Entrega el resultado como API REST y como dump diario, completo o delta.
Los pasos de precio, disponibilidad, reserva y cancelación quedan, en cambio, entre su sistema y su proveedor; hotelmapping.org no transporta ni almacena esos datos. Así, sin añadir una capa intermedia a su flujo dinámico, puede combinar los códigos de las respuestas de búsqueda con la tabla de mapeo de su lado. Los endpoints de la API y las respuestas de ejemplo están en la página de desarrolladores.
Preguntas frecuentes
¿Integración XML e integración API son lo mismo?
En el sector se usan casi siempre con el mismo sentido. La expresión "integración XML" viene de que los primeros servicios web usaban XML. Hoy muchos proveedores ofrecen una API REST basada en JSON; aun así, en el lenguaje de negocio estas conexiones suelen llamarse integración XML.
¿Con qué frecuencia hay que actualizar los datos estáticos?
No hay una única frecuencia correcta; depende de la velocidad de cambio del proveedor y del tamaño de su catálogo. El enfoque habitual es obtener al principio un dump completo y después procesar a intervalos regulares solo los registros que han cambiado (delta).
¿Es correcto guardar en caché los datos de precio y disponibilidad?
Una caché de corta duración puede acelerar la búsqueda, pero como precio y disponibilidad cambian rápido, antes de la reserva hay que volver a comprobarlos con el proveedor (recheck). La duración de la caché y las reglas de recomprobación pueden figurar en las condiciones de integración del proveedor; revíselas en la fase contractual.
¿Ofrece hotelmapping.org también los datos dinámicos?
No. hotelmapping.org trabaja solo en el lado de los datos hoteleros estáticos: mapeo hotelero, de habitaciones, regímenes y destinos, además de contenido hotelero. El flujo de precio, disponibilidad y reserva queda entre usted y su proveedor.
Fuentes
Equipo editorial de hotelmapping.org
Equipo de datos hoteleros de DIJI.TECH
El equipo de DIJI.TECH que trabaja en mapeo hotelero, integración de proveedores y software de viajes.
Productos relacionados
Soluciones de mapeo hotelero
Un HM ID permanente por establecimiento; códigos de proveedor e IDs cruzados en un único registro.
Soluciones de descripciones de hoteles
Para cada hotel, una descripción corta, media y larga, lista para vender, en TR, EN, DE, RU y AR.
Soluciones de Find Match API
Envíe nombre, dirección y coordenadas; reciba el HM ID y la puntuación de confianza. No requiere código de proveedor.
Artículos relacionados
- ¿Qué es el mapeo hotelero (hotel mapping) y cómo funciona? Guía completa ¿Qué es el mapeo hotelero? Cómo se unifican los registros de proveedores en un ID, el proceso de 9 pasos, umbrales de puntuación y medición de calidad.
- ¿Qué es un bedbank? Cómo trabajan las agencias con los bedbanks ¿Qué es un bedbank y cómo funciona? Conexión de agencias por XML/API, datos estáticos y dinámicos, modelo comercial y problema de hoteles duplicados.
- 12 preguntas que hay que hacer al elegir una API de mapeo hotelero 12 preguntas al elegir una API de mapeo hotelero: precisión, cobertura, permanencia de ID, habitaciones y regímenes, entrega y precio, y cómo verificarlas.