Saltar al contenido principal

API del Sistema Central de Reservas (CRS)

Tu experiencia de reserva. Nuestro motor de reservaciones.

Para grupos hoteleros y administradores de rentas vacacionales que construyen sus propios sitios, apps y centrales de reservaciones, y para los canales de venta que comercializan sus habitaciones. Una sola API busca en todo el portafolio, cotiza la estancia en el idioma y la moneda del huésped y la reserva en el mismo back office que cualquier reservación de OTA.

El sitio de reservas de Marivela Beach Resort con la Ocean View King para cinco noches: una tarifa no reembolsable y una flexible, cada una con su total y el ahorro de una promoción por estancia larga.
RespuestaPOST /api/v3/bookingsearch
{
  "propertyId": "2177",
  "roomTypes": [{
    "roomTypeName": "Ocean View King",
    "ratePlans": [{
      "ratePlanName": "Non-refundable saver",
      "rates": [{
          "date": "2026-11-16",
          "rate": 187.00,
          "ratePrePromo": 220.00
        }, …4 more nights]
    }]
  }]
}
  1. La habitación, por nombre e ID
  2. Cada plan de tarifas que puede vender la estancia
  3. El precio antes de la promoción, para que puedas mostrar el ahorro

Nuestro sitio de reservas alojado para Marivela Beach Resort, en el mismo motor que la API. La respuesta muestra la estructura documentada con los valores de la pantalla.

La API del CRS en cinco datos

  • 10 endpoints, JSON sobre HTTPS
  • Un token para cada propiedad de tu canal
  • El motor sobre el que corre nuestro propio motor de reservas
  • Contenido en el idioma de cada huésped, precios en su moneda
  • $0 en cuotas de integración

Una reservación, de la primera búsqueda al PMS del hotel

Tu sitio, app o central de reservaciones pregunta. Nuestro motor responde con ofertas en vivo, las vuelve a validar al reservar y luego entrega la reservación como cualquier otra. Seis pasos, una reservación.

  1. Buscarpropertysearch

    Envía fechas, una moneda y un idioma, y filtra por organización, por lugar y radio, o por nombre de propiedad. Cada propiedad que puede vender esas fechas regresa con sus habitaciones y tarifas, con la misma estructura que la oferta de una sola propiedad. Sin fechas, obtienes la lista de propiedades.

    1. Buscar en todo, o en un destino
    2. Cada casa que puede vender las fechas
    3. Cada resultado trae sus tarifas
    SolicitudPOST /api/v3/propertysearch
    {
      "arrivalDate": "2026-12-04",
      "departureDate": "2026-12-07",
      "numberOfAdults": 4,
      "currencyCode": "USD",
      "language": "en",
      "orgIds": [7009]
    }
    
    El sitio de reservas de Hollow & Ridge Mountain Homes con diez casas para el 4 al 7 de diciembre, cada una con su ciudad, recámaras, baños, capacidad y precio por noche.
    Nuestro sitio alojado para un grupo de diez casas en la montaña: una búsqueda, cada casa que puede vender las fechas.
  2. Ofertabookingsearchbookingsearchaddons

    Cada habitación, cada tarifa y los extras

    bookingsearch regresa cada tipo de habitación con cada plan de tarifas que puede vender la estancia: la tarifa de cada noche, el precio antes de cualquier promoción, cargos, impuestos y la política de reservación. bookingsearchaddons lista los extras de la misma estancia, cada uno con su propia forma de precio.

    1. Por persona, por noche
    2. Por persona
    3. Según número de huéspedes o cantidad
    RespuestaPOST /api/v3/bookingsearchaddons
    {
      "successful": true,
      "addOns": [{
          "addOnName": "Breakfast on the terrace",
          "rate": 32.00,
          "rateType": 4
        }, {
          "addOnName": "Half-day snorkel trip with sea turtles",
          "rate": 95.00,
          "rateType": 3
        }, …]
    }
    
    Los extras de Marivela Beach Resort para la estancia: desayuno en la terraza a $32.00 por persona por noche y una excursión de esnórquel de medio día a $95.00 por persona, cada uno con selector de huéspedes.
    Los extras de Marivela para la misma estancia, en su sitio alojado.
  3. Cotizarbookcheck

    Cotiza el carrito antes de que alguien pague

    Envía la estancia con una línea de tarifa que indique el plan de tarifas. bookcheck completa la tarifa de cada noche, las líneas de cargos e impuestos y los totales, sin reservar nada. Vuelve a llamarlo cada vez que cambie el carrito.

    1. Cada noche frente a su precio antes de la promoción
    2. El cargo de limpieza, en su propia línea
    3. Los totales, antes y después de impuestos
    RespuestaPOST /api/v3/bookcheck
    {
      "successful": true,
      "reservation": {
        "roomTypes": [{
          "rates": [{
              "ratePlanId": "2",
              "date": "2026-11-16",
              "rate": 187.00,
              "ratePrePromo": 220.00
            }, …4 more nights],
          "addOns": [{
            "name": "Cleaning Fee",
            "type": 2,
            "rate": 25.00,
            "quantity": 5
          }]
        }],
        "addOns": [{
          "name": "Sales Tax",
          "type": 1,
          "rate": 79.26
        }],
        "totalBeforeTax": 1132.25,
        "totalAfterTax": 1211.51
      }
    }
    
    El resumen de reservación para cinco noches en la Ocean View King: tarifas de habitación 1,185.00, descuentos menos 177.75, cargos 125.00, impuestos 79.26 y un total de $1,211.51.
    El carrito de la misma estancia: la promoción, el cargo de limpieza y el impuesto, cotizados.
  4. Reservarbook

    Reservación 12563307

    Reserva, o entérate de por qué no

    Envía exactamente lo que regresó bookcheck, junto con el huésped. El motor vuelve a validar disponibilidad, tarifas y restricciones y recalcula la estancia. Si alguien más tomó la última habitación o el precio cambió, rechaza con el código 3 en lugar de sobrevender, y no se reserva nada.

    1. De dónde vino: aquí nuestro motor de reservas, en tu caso tu canal
    2. Estatus, totales y tipo de habitación
    3. La tarifa y el plan de tarifas de cada noche

    HTTP 200POST /api/v3/book

    {
      "successful": true,
      "messages": [],
      "reservationId": "12563307"
    }
    Una reservación en el back office de ChannelRUSH: su origen, estatus, totales, huésped, habitación y la tarifa de cada noche.
    Una reservación del motor de reservas, como la ve el hotel. Una reservación por API es el mismo registro, con tu canal como origen.
  5. Entregar

    Reservación 12563307

    Llega a donde el hotel ya trabaja

    La reservación aparece en las reservaciones de la propiedad junto a Booking.com, Expedia y cualquier otro canal. ChannelRUSH la envía al PMS del hotel y a sus correos de reservaciones, con un estatus de entrega que el hotel puede revisar y reenviar. La habitación se descuenta de cada otro canal, y los reportes del portafolio cuentan la reservación.

    1. Las reservaciones de cada canal, lado a lado
    2. Reservaciones de nuestro motor. Las tuyas aparecen igual, bajo tu canal
    3. Historial, correo y entrega al PMS de cada reservación
    Ejemplo: así aparece tu reservación
    12563307NewChannelRUSH CRS-> Tu canalMarivela Beach ResortHistory | Email | PMS
    Las reservaciones de un hotel en el back office de ChannelRUSH: reservaciones de Expedia, Booking.com y el motor de reservas, cada una con enlaces a su historial, correo y entrega al PMS.
    Reservaciones de prueba en una propiedad demo: Expedia y Booking.com junto a las de nuestro motor de reservas.
  6. Cambiarbookcancelreservations

    Reservación 12563307

    Cámbiala, cancélala, consúltala

    Para cambiar una reservación, envía la reservación completa otra vez a book con estatus 1. Para cancelar, envía estatus 2 o llama a cancel; cancelar dos veces no causa problemas. reservations regresa una reservación por ID o el feed de tu canal, y los webhooks mantienen tu copia al día.

    1. La reservación modificada, como la ve el hotel
    2. Su estatus: modificación
    CambiarPOST /api/v3/book
    {
      "reservation": {
        "reservationId": "12563307",
        "status": 1,
        …the whole reservation, as changed
      }
    }
    
    CancelarGET
    /api/v3/cancel/2177/12563307
    
    Una reservación modificada en el back office de ChannelRUSH, con su nuevo estatus, totales y tipo de habitación.
    Una reservación modificada del motor de reservas: el hotel ve la nueva versión.

Estructuras documentadas de solicitud y respuesta, no capturas en vivo, con los valores de las pantallas. Las pantallas son nuestros sitios de reservas alojados y el back office de ChannelRUSH, en el mismo motor que la API.

Cuéntanos qué estás construyendo

Lo que lee tu API, el hotel lo configura una sola vez

Habitaciones, tarifas, políticas, promociones y contenido viven en el back office del CRS. Tu sitio los lee a través de la API, y el propio motor de reservas del hotel y cada canal leen la misma configuración.

Lo leebookingsearchbookcheckbook

Tus IDs, en el canal CRS del hotel

propertyId, roomTypeId y ratePlanId son los IDs de ChannelRUSH. El hotel los ve en su canal CRS, con las credenciales propias del canal y, si lo desea, un margen para ese canal.

El canal ChannelRUSH CRS en Marivela Beach Resort: usuario y contraseña enmascarados, Channel Property ID 2177 y la Ocean View King mapeada como tipo de habitación 134 con su plan NRF como 2.
  1. Las credenciales propias del canal
  2. propertyId
  3. roomTypeId
  4. ratePlanId

Lo leesettings

Las condiciones que leen los sitios de socios

La política de reservación de cada plan de tarifas viene con settings: qué se paga y cuándo, cuánto cuesta cancelar, si se pide tarjeta, y las notas propias del hotel para sitios de socios, por idioma.

La política no reembolsable de Marivela Beach Resort: 100% al reservar, tarjeta requerida en sitios de socios, cargo de cancelación del 100% y notas para sitios de socios por idioma.
  1. Si tu sitio pide tarjeta
  2. Cuánto cuesta cancelar, redactado para huéspedes
  3. Las notas del hotel para sitios de socios, por idioma

El idioma y la moneda de cada huésped

settings y cada búsqueda reciben un idioma y regresan el contenido que el Hotel CMS administra para él. Envía la moneda del huésped y los precios regresan convertidos.

GET /api/v3/settings/2177/de"currencyCode": "EUR"

La Ocean View King en el sitio de reservas de Marivela en alemán, con precios en euros.
Alemán, euros

GET /api/v3/settings/2177/es"currencyCode": "MXN"

La misma habitación en español, con precios en pesos mexicanos.
Español, pesos mexicanos

Y el resto del back office: los reportes del portafolio cuentan cada reservación por API, el asistente de IA responde preguntas sobre cualquier reservación, y la mensajería y las reseñas de huéspedes están en el mismo acceso.

Ver todo el CRS

Dos formas de entrar

Construye para tu propio portafolio, o vende habitaciones de hoteles que trabajan contigo.

Grupos hoteleros y administradores de rentas vacacionales

Tu propia reserva, en todo el portafolio

Un sitio de marca o de grupo con búsqueda en todas las propiedades, una app móvil, una central de reservaciones, un sitio para un destino o una submarca.

Antes
Un motor de reservas por propiedad, un sitio de grupo que solo enlaza, y un call center capturando reservaciones en el sistema de cada hotel.
Con ChannelRUSH
Una API responde por cada propiedad en cada idioma, y cada reservación llega al mismo back office que las de las OTAs.
  • Busca en todo el portafolio con una sola llamada
  • Las mismas tarifas, políticas y promociones que el propio motor de reservas de los hoteles
  • Cada reservación en las reservaciones y el PMS del hotel
Ver los sitios de grupo que alojamos

Canales de venta y puntos de venta

Tú generas reservaciones

Agencias, mayoristas, sitios de viaje y metabuscadores y herramientas de reservas corporativas: vende habitaciones de hoteles que trabajan contigo, con tarifas y disponibilidad en vivo.

Antes
Tarifas por correo, disponibilidad por teléfono, reservaciones capturadas en la recepción.
Con ChannelRUSH
Tu propio canal y token. Cada hotel te agrega, y tus reservaciones entran directo a su sistema, Powered by ChannelRUSH.
  • Contenido en cada idioma en que vendes
  • Las tarifas del hotel, o sus tarifas propias para tu canal
  • Tu nombre en cada reservación en el back office del hotel
Tu canalBearer Un token
  • Hotel A
  • Hotel B
  • Hotel C
Cada hotel agrega tu canal, y tu token cubre a cada uno que lo hace.
¿Prefieres recibir tarifas y disponibilidad? La API OTA

La referencia de la API

JSON sobre HTTPS, camelCase, con enums como números. Diez endpoints en cuatro grupos, en un servidor de pruebas con su propia referencia en vivo, y en producción en crs.channelrush.net.

Diez endpoints

Configuración y contenido

GET/api/v3/connectioncheck
Verificar tu token y la conexión
GET/api/v3/settings/{propertyId}/{language}
El contenido, habitaciones, planes de tarifas, políticas, cargos e impuestos de una propiedad, en un idioma

Disponibilidad

POST/api/v3/ari
Tarifas, disponibilidad y restricciones por día, para tu propio caché o calendario

Reservas

POST/api/v3/propertysearch
Buscar una estancia en el portafolio, o listar sus propiedades
POST/api/v3/bookingsearch
Cada habitación y plan de tarifas que puede vender una estancia en una propiedad
POST/api/v3/bookingsearchaddons
Los extras de una estancia
POST/api/v3/bookcheck
Cotizar un carrito sin reservarlo
POST/api/v3/book
Crear, cambiar (estatus 1) o cancelar (estatus 2) una reservación
GET/api/v3/cancel/{propertyId}/{reservationId}
Cancelar una reservación por ID

Reservaciones

POST/api/v3/reservations
Una reservación por ID, o el feed de tu canal
Un token por canal
Tu token cubre cada propiedad que agrega tu canal. Envíalo como token bearer desde tu servidor: la API es solo de servidor a servidor.
El éxito viene en el cuerpo
Un resultado de negocio es HTTP 200 con successful y messages. El código 3 significa que cambió la disponibilidad o el precio: vuelve a cotizar el carrito.
Tu parte como punto de venta
Pide el apellido y el código postal antes de mostrar una reservación, muestra las cifras de la API y maneja el código 3.

Especificaciones y herramientas

La secuencia de reservación

  1. propertysearchsettingsEncontrar propiedades y cargar su contenido
  2. bookingsearchbookingsearchaddonsMostrar habitaciones, tarifas y extras
  3. bookcheckCotizar el carrito, de nuevo en cada cambio
  4. bookReservar lo que se cotizó
  5. Guardada, enviada al PMS y a los correos del hotel, disponibilidad ajustada
  6. reservationsConsultarla por ID, o desde el feed

Un kit para desarrolladores, no solo una especificación

  • Un cliente .NET tipado: reservar en cuatro llamadas, con utilidades para tarjetas.
  • Un sitio de reservas de ejemplo completo sobre la API: de la búsqueda a la confirmación, cambios, cancelación y búsqueda de reservación.
C#reservation.services.crs.client
// 1. What can be sold?
BookingSearchResponse available = await crs.BookingsearchAsync(new BookingSearchRequest
{
    PropertyId = "2177", ArrivalDate = arrival, DepartureDate = departure,
    NumberOfAdults = 2, NumberOfRooms = 1, CurrencyCode = "USD", Language = "en"
});

// 2. Describe the stay. One rate row naming the rate plan is enough.
Res res = new Res { PropertyId = "2177", Status = ReservationStatus.New, CurrencyCode = "USD" };
ResRoomType room = new ResRoomType(roomTypeId, arrival, departure) { NumberOfAdults = 2 };
room.Rates.Add(new ResRoomTypeRate { RatePlanId = ratePlanId, Date = arrival });
res.RoomTypes.Add(room);

// 3. bookcheck prices it: nightly rates, fee and tax lines, TotalBeforeTax / TotalAfterTax.
BookCheckResponse priced = await crs.BookcheckAsync(new BookCheckRequest { Reservation = res });

// 4. book exactly what bookcheck returned.
BookResponse booked = await crs.BookAsync(new BookRequest { Reservation = priced.Reservation });

Ambos se comparten con socios como código fuente. Pídelos en tu solicitud.

Desde el primer día: un sandbox en tu bandeja de entrada

Configuramos una cuenta de prueba en el servidor de pruebas con copias de nuestras tres propiedades demo, en inglés, alemán y español, y te enviamos por correo todo lo necesario para la primera llamada.

  1. Tu propio back office

    Un acceso al back office de pruebas, para ver la configuración y el inventario que leen tus llamadas.

  2. El servidor de pruebas

    Cada URL de la documentación corre en testcrs.channelrush.net.

  3. Swagger y tu token

    La referencia en vivo y el token bearer de tu canal.

  4. Tu primera llamada

    Lee los settings de una propiedad en inglés y luego búscala.

De: ChannelRUSH Support <support@channelrush.com>

Asunto: ChannelRUSH API Test Account Info - Your Company

Greetings,

We have set up your ChannelRUSH CRS API Test Account.

ChannelRUSH Extranet Login Info

https://test.channelrush.net
u: you@yourcompany.example
p: ••••••••
o: ••••

Documentation

testcrs.channelrush.net

https://testcrs.channelrush.net/api/v3/connectioncheck

Documentation - Swagger

https://testcrs.channelrush.net/index.html

Authorization: Bearer ••••••••

Next Steps

GET https://testcrs.channelrush.net/api/v3/settings/••••/en
El correo de bienvenida de nuestra herramienta de sandbox, abreviado, con todos los accesos y tokens enmascarados.

De la solicitud a reservaciones en vivo

01

Cuéntanos qué estás construyendo

Un sitio de marca, una app, una central de reservaciones o un canal de venta: la solicitud de abajo llega a nuestro equipo de integraciones.

02

Configuramos tu canal y tu sandbox

Tu propio canal y token en el servidor de pruebas, con tres propiedades demo en tres idiomas.

03

Construye y prueba

Contra el servidor de pruebas, con Swagger, ReDoc y, si los quieres, nuestro cliente tipado y el sitio de ejemplo.

04

Sal en vivo, hotel por hotel

Cada hotel agrega tu canal, y tu token de producción lo cubre en crs.channelrush.net.

Para grupos hoteleros, desarrolladores y canales de venta

Cuéntanos qué estás construyendo.

Un sitio de grupo, una app, una central de reservaciones o un canal que vende habitaciones: cuéntanos qué tienes en mente y cuántas propiedades abarca. Te responderemos con los siguientes pasos y un horario para una llamada técnica.

/ FAQ /

Preguntas Frecuentes

Cada punto de venta es su propio canal con un token bearer. El token cubre cada propiedad que ha agregado tu canal, así que un solo token sirve para todo el portafolio. Envíalo en el encabezado Authorization desde tu servidor: la API es solo de servidor a servidor.

Tus propias reservaciones regresan de book con su ID de reservación. La llamada reservations regresa una reservación por ID o el feed de tu canal, y los webhooks mantienen tu sistema al día con los cambios hechos en el hotel.

No. La API pasa los datos de la tarjeta, o un token que ya tienes, a la propiedad como garantía de la reservación. Los datos de tarjeta pasan por tus sistemas, así que estos quedan dentro del alcance de PCI. Si prefieres no manejar tarjetas, el motor de reservas alojado del hotel cobra a través de su pasarela de pago.

Tú. El hotel recibe sus correos de reservaciones y la reservación en su PMS; tu sitio o app confirma al huésped con tu propia voz.

Sí. Envía la reservación completa otra vez a book con estatus 1 para cambiarla, o con estatus 2 (o la llamada cancel) para cancelarla; cancelar dos veces no causa problemas. La política de cada plan de tarifas viene con settings, y tu sitio la aplica antes de cambiar o cancelar.

Cada idioma en que una propiedad tiene contenido: settings los lista, y tú pides uno por llamada. Envía la moneda del huésped y los precios regresan convertidos cuando difiere de la de la propiedad.

Sí. Configuramos el canal con sus propias credenciales y token. Cada hotel lo agrega y decide si vende las tarifas del CRS o sus propias tarifas y disponibilidad para ese canal, y su contenido se mapea por idioma. Las reservaciones llegan a las reservaciones del hotel con el nombre del canal.

Tu sitio o app es tuyo, de principio a fin. Detrás, las reservaciones aparecen en el back office del hotel con el nombre de tu canal y las OTAs se conectan a ChannelRUSH: una experiencia de reserva Powered by ChannelRUSH.