Integración de API hotelera

Integración de la API de RateHawk: de la API key a reservas hoteleras en vivo

Conecta tu cuenta de RateHawk a PHPTRAVELS y vende hoteles y apartamentos de RateHawk en tu propia web y en tu portal de agentes. El conector ya está listo: añade tus claves de API, importa la base de datos hotelera, define tu margen y completa la certificación de RateHawk.

  • Conector de RateHawk listo
  • ETG API v3
  • Importación del dump de hoteles
  • Tu margen sobre tarifas netas

El proveedor

Qué es RateHawk y por qué las agencias lo conectan

RateHawk es la plataforma de reservas B2B de Emerging Travel Group (ETG) para agentes de viajes, turoperadores y empresas de viajes. Los socios reservan hoteles, apartamentos y otros alojamientos a tarifas netas, ya sea en el portal propio de RateHawk o mediante su API.

La API se llama ETG API. Su versión actual es la v3, una API REST con peticiones y respuestas en JSON que cubre búsqueda, reserva y cancelación. PHPTRAVELS incluye un conector de RateHawk en el módulo de alojamientos, de modo que los resultados de RateHawk aparecen junto a tus otros proveedores hoteleros y tus propios contratos.

Relacionado:HotelesMotor de reservas hoteleroAPIs de viajes

Ficha del proveedor
Empresa
RateHawk, parte de Emerging Travel Group
Tipo
Plataforma B2B de alojamiento para profesionales del turismo
Inventario
Más de 2,6 millones de opciones de alojamiento, según RateHawk
Socios de API
Más de 700 clientes de API, según indicó RateHawk en 2024
API
ETG API v3 · REST · JSON
En PHPTRAVELS
Conector listo en el módulo de alojamientos

El flujo de reserva de ETG API v3

Cómo funciona una reserva de RateHawk, fase a fase

Toda reserva de RateHawk pasa por las mismas cinco fases. Cada una indica las llamadas de la ETG API que hay detrás y lo que PHPTRAVELS hace por ti.

  1. 01

    Búsqueda

    Llamadas de la ETG API

    Búsqueda por región · por coordenadas geográficas · por IDs de hotel

    PHPTRAVELS

    Busca por ciudad, zona del mapa o lista de hoteles, con fechas, huéspedes y residencia del viajero, y muestra tarifas netas en vivo con tu margen.

  2. 02

    Página del hotel

    Llamadas de la ETG API

    Retrieve hotelpage

    PHPTRAVELS

    Carga todas las habitaciones y tarifas del hotel elegido: régimen, impuestos, política de cancelación y tipo de pago.

  3. 03

    Prerreserva

    Llamadas de la ETG API

    Prebook rate · Retrieve rate info

    PHPTRAVELS

    Comprueba justo antes del pago que la tarifa elegida sigue disponible a ese precio y detiene el pago si ha cambiado.

  4. 04

    Reserva

    Llamadas de la ETG API

    Crear, iniciar y comprobar el proceso de reserva

    PHPTRAVELS

    Crea la reserva, envía los datos de los huéspedes, sigue el estado hasta que se confirma y guarda el ID de pedido de RateHawk.

  5. 05

    Tras la reserva

    Llamadas de la ETG API

    Retrieve bookings · Cancel booking · Webhooks de estado

    PHPTRAVELS

    Envía el bono, muestra la reserva en el panel y en la cuenta del cliente, y gestiona las cancelaciones según la política de la tarifa.

Datos estáticos

Importa una vez la base de datos hotelera de RateHawk y mantenla actualizada

Los resultados de búsqueda solo incluyen tarifas. Nombres, direcciones, fotos, servicios y descripciones proceden de los datos estáticos de ETG, que PHPTRAVELS importa en tus páginas de hotel.

  • Dump de regiones

    Países, ciudades y zonas, para que los viajeros puedan buscar por destino.

  • Dump de hoteles

    El archivo completo de contenido hotelero: nombres, direcciones, coordenadas, fotos, servicios y descripciones.

  • Dump incremental

    Solo lo que ha cambiado desde la última importación, para que el catálogo siga actualizado sin una recarga completa.

  • Dump de opiniones

    Puntuaciones y textos de opiniones de huéspedes para mostrar en las páginas de hotel, si tu acuerdo los incluye.

Importación de contenido hotelero
  • Dump de regiones100%
  • Dump de hoteles100%
  • Dump incremental64%
  • Dump de opiniones30%

Pantalla de ejemplo. Las cifras dependen de tu cuenta y de tus idiomas.

Además de los archivos dump, ETG ofrece una Content API para obtener datos hoteleros bajo demanda.

API key y sandbox

Cómo funciona la autenticación de la API de RateHawk

La ETG API usa autenticación HTTP Basic. Tu key ID es el nombre de usuario y tu API key es la contraseña, y se envían por HTTPS en cada petición.

Una petición de búsqueda en el sandbox (ejemplo)
 1# HTTP Basic: key ID = username, API key = password 2curl -u "$KEY_ID:$API_KEY" \ 3  -H "Content-Type: application/json" \ 4  https://api-sandbox.ratehawk.com/api/b2b/v3/search/serp/hotels/ \ 5  -d '{ 6    "checkin": "2026-11-14", 7    "checkout": "2026-11-16", 8    "residency": "gb", 9    "language": "en",10    "currency": "USD",11    "guests": [{ "adults": 2, "children": [] }],12    "hids": [8473727]13  }'1415# 8473727 = the test hotel: a real booking if you book it
HTTP BasicETG API v3api-sandbox.ratehawk.com → api.ratehawk.com
Dos hosts
Sandbox: api-sandbox.ratehawk.com. Pruebas y producción: api.ratehawk.com. Los antiguos hosts de worldota.net están obsoletos.
El hotel de prueba es real
Las claves de prueba solo pueden reservar el hotel de prueba con hid 8473727, y esa reserva es real, con responsabilidad financiera real. Cancélala justo después de la prueba.
Las claves se quedan en el servidor
PHPTRAVELS guarda el key ID y la API key en la configuración del servidor, nunca en el navegador ni en una app.
La residencia importa
Las tarifas dependen de la residencia del viajero, por eso el conector la envía en cada búsqueda.

Configuración en PHPTRAVELS

Configura el conector de RateHawk en cuatro pasos

Sin escribir código: el conector se configura en el panel de administración.

  1. 01Añade tus claves de APIPega el key ID y la API key de RateHawk, primero para el sandbox y después para producción.
  2. 02Importa la base de datos hoteleraCarga los dumps de regiones y de hoteles y programa las actualizaciones incrementales.
  3. 03Define margen y monedaMárgenes porcentuales o fijos, por canal, grupo de agentes o destino, en las monedas en las que vendes.
  4. 04Prueba y pasa a producciónHaz la reserva y la cancelación de prueba, supera la certificación y cambia a las claves de producción.
Proveedores › RateHawkRateHawk

Entorno

https://api-sandbox.ratehawk.comhttps://api.ratehawk.com

Key ID4127
API key••••••••••••••••
Margen12 % sobre tarifas netas
MonedaUSD · EUR · GBP
Residencia por defectoGB

Pantalla de configuración de ejemplo.

Certificación

Del acuerdo al acceso a producción

RateHawk solo abre producción cuando el acuerdo está firmado y tu integración supera su certificación.

  1. 1

    Firma el acuerdo de API

    Tú

    Contacta con RateHawk como empresa de viajes y firma el acuerdo de API para tus mercados.

  2. 2

    Recibe las claves del sandbox

    RateHawk

    RateHawk emite un key ID y una API key para el sandbox.

  3. 3

    Conecta e importa

    PHPTRAVELS

    Las claves se añaden a PHPTRAVELS, se importan los datos estáticos y se definen los márgenes.

  4. 4

    Supera la certificación

    RateHawk

    RateHawk revisa la integración, incluidos los flujos de reserva, estado y cancelación.

  5. 5

    Acceso a producción

    Tú

    Las claves de producción se añaden al panel y empiezan las reservas reales.

Portal, API o motor

Tres formas de vender hoteles de RateHawk

Tus agentes ya pueden reservar hoy en la web de RateHawk. La API, dentro de tu propio motor de reservas, es lo que pone los hoteles de RateHawk bajo tu marca.

  • Web de RateHawk

    Quién reserva
    Tus agentes, una reserva cada vez
    Qué marca
    RateHawk
    Qué requiere
    Registrarse como agente e iniciar sesión
  • Tu propio desarrollo con la API

    Quién reserva
    Tus clientes y agentes, online
    Qué marca
    La tuya
    Qué requiere
    Meses de desarrollo y certificación
  • PHPTRAVELS con RateHawk

    Quién reserva
    Tus clientes y agentes, online
    Qué marca
    La tuya
    Qué requiere
    Configuración, importación de contenido y certificación

Multiproveedor

RateHawk junto a tus otros proveedores hoteleros

RateHawk es un proveedor más del módulo de alojamientos. La misma búsqueda puede incluir tus otras APIs hoteleras y tus propios contratos, con márgenes y enrutamiento por proveedor.

  • Agoda
  • Amadeus
  • Booking.com
  • Hotelbeds
  • Hotelston
  • RateHawk
  • Stuba
  • TBO Holidays
  • Travelport
  • Wanderbeds

Lee la guía para agentes

Preguntas frecuentes

Preguntas sobre la integración de la API de RateHawk

Lo que preguntan las agencias antes de conectar RateHawk.

Habla con ventas

RateHawk no publica ninguna tarifa por el acceso a la API. Firmas un acuerdo de API y vendes sus hoteles a tarifas netas con tu propio margen. Tus costes son tu software de reservas, el hosting y los pagos.

Contacta con RateHawk como empresa de viajes y firma el acuerdo de API. RateHawk te emite entonces un key ID y una API key para el sandbox, y las claves de producción tras la certificación.

La documentación de la ETG API está online en docs.emergingtravel.com, con la B2B API, la Content API y las guías del sandbox y de certificación. No hay un PDF aparte para descargar; la documentación online es la versión vigente.

La ETG API es la API de Emerging Travel Group, la empresa detrás de RateHawk. Integración de la API de RateHawk e integración de la ETG API significan lo mismo; la versión actual es la v3.

PHPTRAVELS es una licencia de pago único desde 2499 US$ con el código fuente completo, y el conector de RateHawk está incluido en el módulo de alojamientos. Tus condiciones comerciales con RateHawk las acuerdas con RateHawk.

Sí, en api-sandbox.ratehawk.com. Ten en cuenta que las claves de prueba solo pueden reservar el hotel de prueba con hid 8473727, y esa reserva es real, así que cancélala justo después de probar.

Los agentes se registran e inician sesión en ratehawk.com para reservar en el portal. El acceso a la API es independiente: usa el key ID y la API key de tu acuerdo, no tu usuario del portal.

El conector ya existe, así que el tiempo se dedica al acuerdo, a añadir las claves, a importar el contenido hotelero y a la certificación de RateHawk, no al desarrollo.

Sí. El mismo conector sirve a tu web B2C y a tu portal de agentes B2B, con márgenes distintos por canal y grupo de agentes.

Cada tarifa lleva su política de cancelación, que se muestra antes del pago. Las cancelaciones se hacen desde el panel o desde la cuenta del cliente mediante la llamada de cancelación de reserva, según esa política.