Integración de proveedores de hoteles
Integración de la API de Hotelbeds: contenido, mapeo y reservas en vivo
Una integración de la API de Hotelbeds son dos trabajos, no uno. Usted descarga y almacena el contenido hotelero y después reserva sobre tarifas en vivo. PHPTRAVELS hace ambas cosas dentro de su módulo de hoteles, con su propio contrato y sus propias claves de Hotelbeds.
- Sincronización de la Content API
- Flujo de la Booking API
- Tarifas BOOKABLE y RECHECK
- Mapeo de hoteles
Cómo encajan las API de Hotelbeds
Integración de la API de Hotelbeds: el contenido a un lado, la reserva al otro
Hotelbeds divide sus API hoteleras en dos. La Content API devuelve datos estáticos: descripciones, imágenes, servicios, regímenes y habitaciones. La Booking API devuelve la disponibilidad y los precios en vivo y realiza la reserva. Elija un paso en el centro para ver qué llamadas utiliza.
Content API
Estática, almacenada en su sistema- Lista de hoteles
hotels · from=1&to=1000Todos los hoteles de su cartera, en páginas de hasta 1.000 hoteles por solicitud. - Servicios, regímenes y habitaciones
facilities · boards · roomsLas tablas de códigos que convierten los códigos de la Booking API en palabras que sus clientes entienden. - Imágenes
photos.hotelbeds.com/giata/Rutas parciales de imagen, unidas al servidor de fotos de Hotelbeds en el tamaño que necesite. - Cambios diarios
lastUpdateTimeTras la primera carga, una solicitud diaria con lastUpdateTime devuelve solo lo que ha cambiado.
Flujo de solicitudes
Booking API
En vivo, llamada por cada cliente- Disponibilidad
POST /hotelsHabitaciones, regímenes, precios y gastos de cancelación para sus códigos de hotel, fechas y ocupación. - Verificar tarifa
POST /checkratesPrecio y condiciones actualizados de una tarifa marcada como RECHECK, además de opciones de upselling. - Reserva
POST /bookingsConfirma el rateKey elegido con los nombres del titular y de los huéspedes y devuelve la referencia. - Cancelación
DELETE /bookings · simulateSimula una cancelación para mostrar el cargo o cancela la reserva de forma definitiva.
La mayoría de los proyectos fallidos con Hotelbeds mezclan los dos lados. Llaman a la Content API durante la búsqueda del cliente, lo que es lento y, como advierte Hotelbeds, puede provocar el bloqueo de sus credenciales. O buscan en vivo sin códigos guardados y no pueden mostrar imágenes ni servicios. PHPTRAVELS mantiene ambos lados separados: el contenido se sincroniza en segundo plano y solo las llamadas de disponibilidad, verificación de tarifa y reserva se ejecutan mientras el cliente espera.
Si busca información sobre el proveedor en sí, sus productos y cómo abrir una cuenta, lea el perfil del proveedor Hotelbeds. Esta página trata de la integración técnica.
Tipos de tarifa
Los cuatro campos de tarifa que cambian su proceso de pago
Cada tarifa de Hotelbeds incluye algunos atributos que deciden si puede reservarla directamente, qué precio puede mostrar y quién cobra el dinero. Son los que su motor debe leer en cada resultado.
| Campo | Primer caso | Segundo caso | Qué hace PHPTRAVELS |
|---|---|---|---|
Reservable o con verificaciónrateType | BOOKABLELa tarifa está actualizada. Puede reservarla sin otra llamada. | RECHECKDebe llamar primero a verificar tarifa para obtener el precio y las condiciones actualizados. | Ejecuta la verificación de tarifa antes del paso de pago en las tarifas RECHECK y muestra al cliente cualquier cambio. |
Neta o comisionablenet · sellingRate | netModelo neto: los precios son netos, así que usted añade su propio margen. | sellingRateModelo comisionable: la comisión ya está incluida en sellingRate y ese precio es definitivo. | Aplica sus reglas de margen a las tarifas netas y vende las tarifas comisionables a sellingRate. |
Precio de venta fijohotelMandatory | truehotelMandatory es true: debe vender a sellingRate. | false · nullFalse o vacío en una tarifa neta: puede fijar su propio margen. | Bloquea el precio mostrado en sellingRate cuando el hotel lo exige, diga lo que diga la regla de margen. |
Cuándo paga el clientepaymentType | AT_WEBEl pago se cobra al hacer la reserva, a través de su sitio web. | AT_HOTELEl cliente paga directamente al hotel. | Etiqueta la tarifa como pago ahora o pago en el hotel y adapta el proceso de pago. |
El modelo de precios que obtenga depende de su contrato con Hotelbeds. Como indica Hotelbeds, su gestor comercial le recomienda el modelo adecuado para su negocio.
Mapeo de hoteles
Relacione los hoteles de Hotelbeds con los hoteles que ya vende
Si tiene contratos propios o un segundo proveedor, el mismo hotel llegará con códigos distintos. El mapeo los vincula, de modo que el cliente ve un solo hotel con la mejor tarifa, no tres copias.
Cómo funciona el mapeo en PHPTRAVELS
Tras cada sincronización de contenido, PHPTRAVELS compara los hoteles de Hotelbeds con su lista de hoteles por nombre, dirección, ciudad y coordenadas. Las coincidencias claras se vinculan automáticamente. Las dudosas esperan la confirmación de una persona, y los hoteles sin coincidencia pueden importarse como nuevos alojamientos o ignorarse.
Los hoteles mapeados comparten una página, una galería y una puntuación de opiniones en el módulo Hoteles, mientras cada proveedor conserva sus propias tarifas y reglas. El mismo mapeo lo utilizan su sitio público y su Portal de viajes B2B.
- Harbour View HotelLisboa48291397%Vinculado
- Old Town SuitesPraga11735492%Vinculado
- Palm Court ResortDubái66201874%Revisar
- Casa Azul BoutiqueSevilla–0%Sin coincidencia
- Northern Lights LodgeTromsø90522766%Revisar
- Riverside ApartmentsBudapest33076198%Vinculado
Pantalla de ejemplo con hoteles y códigos ficticios.
Hotelbeds XML o JSON
Cada solicitud va firmada y las pruebas empiezan a pequeña escala
Muchos equipos siguen buscando Hotelbeds XML, pero la documentación actual muestra solicitudes JSON. En cualquier caso es el mismo conjunto de operaciones, y cada solicitud lleva dos cabeceras.
1# X-Signature = SHA256(api key + secret + unix time in seconds) 2TS=$(date +%s) 3SIG=$(printf "%s%s%s" "$API_KEY" "$SECRET" "$TS" | sha256sum | cut -d" " -f1) 4 5curl -X POST https://api.test.hotelbeds.com/hotel-api/1.0/hotels \ 6 -H "Api-key: $API_KEY" \ 7 -H "X-Signature: $SIG" \ 8 -H "Accept: application/json" \ 9 -H "Content-Type: application/json" \10 -d '{11 "stay": { "checkIn": "2026-11-14", "checkOut": "2026-11-17" },12 "occupancies": [{ "rooms": 1, "adults": 2, "children": 0 }],13 "hotels": { "hotel": [482913, 117354] }14 }'1516# hotel codes come from your stored Content API data, never a live content call
- Dos cabeceras
- Api-key con su clave y X-Signature: un hash SHA256 de su clave, su secreto y la hora actual en segundos.
- Servidor de pruebas
- Como indica Hotelbeds, los servidores de prueba son iguales a los de producción, pero las reservas allí no son reales y no se cobra a las tarjetas.
- 50 solicitudes al día
- Las claves nuevas abren un entorno de evaluación con una cuota de 50 solicitudes al día. La certificación amplía el límite.
- Sin llamadas de contenido en vivo
- Hotelbeds advierte que llamar a la Content API en tiempo real puede provocar el bloqueo de las credenciales. PHPTRAVELS nunca lo hace.
Planificador de sincronización
Cuántas llamadas a la Content API necesita su lista de hoteles
Como indica Hotelbeds, la lista de hoteles llega en páginas de hasta 1.000 hoteles y, tras la primera carga, una solicitud diaria con lastUpdateTime devuelve solo los cambios. Introduzca sus cifras para planificar la sincronización.
- Solicitudes para la primera carga completa
- 20
- Solicitudes por actualización diaria
- 3
- Días para una carga completa con la cuota de evaluación
- 1
Solo una estimación, para la lista de hoteles. Las tablas de códigos y las imágenes añaden algunas llamadas más. Con la cuota de evaluación de 50 solicitudes al día, pruebe primero con un solo destino.
Lista de verificación para el lanzamiento
Qué tener listo antes de pasar a producción
Hotelbeds le lleva de la evaluación a la certificación y luego a las claves de producción a través de su panel. Estos son los puntos que una integración de la API de Hotelbeds debe cubrir primero, y cómo los cubre PHPTRAVELS.
- Claves de evaluación añadidas en el panel, servidor de pruebas seleccionado
- Content API sincronizada con su base de datos, con una actualización diaria programada
- Hoteles mapeados con su lista, coincidencias dudosas revisadas
- Las tarifas RECHECK pasan por verificar tarifa antes del pago
- Se respeta sellingRate cuando hotelMandatory es true
- Comentarios de la tarifa y gastos de cancelación visibles antes de que el cliente pague
- El bono muestra la referencia de Hotelbeds y los comentarios de la tarifa
- Cancelación simulada primero y luego confirmada, con el cargo registrado
Los pasos de certificación y el acceso a producción los fija Hotelbeds según su contrato y mercado.
Coste
Una licencia para el motor, su propio contrato con Hotelbeds
PHPTRAVELS es una licencia de pago único con el código fuente. Hotelbeds es un acuerdo independiente entre usted y Hotelbeds, así que las tarifas netas y las claves siguen siendo suyas.
Hotelbeds es una de varias fuentes hoteleras que puede usar en paralelo. Vea cómo convive con RateHawk en la sección de API de viajes o compare proveedores en la lista de proveedores XML.
Preguntas frecuentes
Preguntas sobre la integración de la API de Hotelbeds
Lo que preguntan desarrolladores y empresas de viajes antes de conectar Hotelbeds.
Habla con ventasDos partes. Una sincronización en segundo plano con la Content API que guarda hoteles, imágenes, servicios, regímenes y habitaciones en su base de datos, y un flujo en vivo con la Booking API para disponibilidad, verificación de tarifa, reserva y cancelación. PHPTRAVELS ejecuta ambas en su módulo de hoteles.
Mucha gente aún la llama Hotelbeds XML, pero la documentación actual de Hotelbeds muestra solicitudes y respuestas JSON. Las operaciones son las mismas en ambos casos y PHPTRAVELS gestiona el formato por usted.
Una tarifa BOOKABLE ya está actualizada y puede reservarse de inmediato. Una tarifa RECHECK necesita antes una llamada de verificación de tarifa, que devuelve el precio y las condiciones actuales. PHPTRAVELS hace esa llamada antes del paso de pago.
Es lento, y Hotelbeds advierte que usar la Content API en tiempo real puede provocar el bloqueo de las credenciales. El contenido debe descargarse por páginas, almacenarse y actualizarse una vez al día con lastUpdateTime, que es como funciona PHPTRAVELS.
Sí. Usted se registra en Hotelbeds, firma el contrato y recibe su propia clave API y su secreto. Las claves nuevas funcionan en un entorno de evaluación con 50 solicitudes al día hasta que complete la certificación.
Sí. El mapeo de hoteles vincula el mismo alojamiento entre fuentes, de modo que los clientes ven un solo hotel con la mejor tarifa disponible, mientras cada fuente conserva su propio margen y sus reglas.
Los planes de PHPTRAVELS empiezan en como licencia de pago único con el código fuente. Su contrato con Hotelbeds es independiente y se acuerda directamente con Hotelbeds. Consulte la página de precios o pida un presupuesto a ventas.
Sigue explorando
Más sobre la plataforma
- API de hotelesAPIs de bedbanks, OTA, GDS y conexión directa explicadas
- Perfil del proveedor HotelbedsQuién es Hotelbeds y cómo conectarlo a PHPTRAVELS
- Integración con BedsonlineHoteles y tarifas de agente de Bedsonline en tu motor
- Motor de reservas hoteleroReservas directas en la web de su hotel
- HotelesBancos de camas y contratos directos
- Integración de la API de RateHawkHoteles de RateHawk en tu motor de reservas, conector listo