Distribución y Channel Manager

La distribución es cómo el inventario de una propiedad llega a las OTAs —
Booking.com, Airbnb, Expedia, Hostelworld — y cómo vuelven sus reservas.

Aloha Hospitality habla con un solo channel manager, que mantiene la lógica de
conexión de cada OTA detrás de una única API uniforme. Aloha Hospitality nunca habla el
dialecto de ninguna OTA en particular.

Cómo está montado

La cuenta del channel manager es de la plataforma y de marca blanca. Aloha Hospitality
crea ahí las propiedades de cada cuenta; los merchants nunca tienen ni ven
credenciales del channel manager. Cada cuenta de Aloha Hospitality recibe su propio
grupo del lado del channel manager, y las propiedades de esa cuenta viven
adentro.

flowchart TD
    AX["Aloha Hospitality<br/>una cuenta de la plataforma"] --> CM["Channel manager"]
    CM --> GA["Grupo: cuenta A"]
    CM --> GB["Grupo: cuenta B"]
    GA --> PA1["Propiedad A1"]
    GA --> PA2["Propiedad A2"]
    GB --> PB1["Propiedad B1"]
    PA1 --> RT1["room type"]
    RT1 --> RP1["plan tarifario"]
    OTA1["Booking.com"] -.-> CM
    OTA2["Airbnb"] -.-> CM
    OTA3["Expedia"] -.-> CM

La distribución es una feature por propiedad que habilita un admin de
plataforma. Se cobra por propiedad, así que restringirla por propiedad coincide
con cómo se vende. Una propiedad sin ella no se puede sincronizar.

Qué viaja

Estructura — la propiedad, sus unidades y sus
planes tarifarios se crean y se mantienen al día del
lado del canal. Cada unidad es su propio listing. Una casa completa padre y sus
hijas son listings separados, y el bloqueo entre ellas viaja como números de
disponibilidad, no como una relación que el canal entienda.

ARI — disponibilidad, tarifas y restricciones, empujadas automáticamente cada
vez que algo las cambia: una reserva, una edición de precio, un bloqueo de venta,
un movimiento entre room types. Las restricciones van noche por noche: estadía
mínima y máxima, cerrado a la llegada y cerrado a la salida, ya resueltas entre
el plan, la temporada y el precio diario (ver
Planes tarifarios).
Una noche sin máximo se envía explícitamente como "sin máximo", así que quitar un
máximo también llega al canal.

Un cambio en bloque (muchas unidades, planes o fechas a la vez) sale como un
solo envío por propiedad, no uno por fila, para no chocar con el límite de
peticiones del channel manager.

Lo que venden los canales son únicamente los planes tarifarios del canal de venta
ota. Un plan direct o api jamás se filtra a una lista de precios de un
canal.

Reservas — el canal le avisa a Aloha Hospitality, que trae la reserva completa y la
escribe como un hecho autoritativo.

Qué no sabe el canal

El canal sabe un room type y un número — "4, 4, 4, 3, 1, 1, 2". Nunca dice
qué habitación física.

La asignación de habitación es exclusivamente de Aloha Hospitality. Eso no es una
carencia; es lo que le permite a Aloha Hospitality ser inteligente con el inventario. El
canal dice "una Doble Deluxe"; Aloha Hospitality decide que esa es la 201.

Una reserva entrante es un hecho, no una solicitud

Una reserva de OTA ya ocurrió. El huésped reservó y pagó en otro lado, así que
Aloha Hospitality no puede rechazarla — registra la realidad.

• Si hay una habitación libre, se asigna. Caso normal.
• Si no hay ninguna libre, la reserva se crea igual, sin habitación asignada,
  y el conflicto queda registrado y señalado. Ver
  Disponibilidad y overbooking.

El precio es el precio del canal y nunca se recotiza. El canal de la reserva
es la OTA, y su estado se mapea desde el del propio canal. Las modificaciones y
cancelaciones del canal se aplican igual — reasignar o liberar la habitación; una
modificación cuyas fechas nuevas ya no caben también se señala como conflicto.

Los cargos de servicio que cobra el canal — limpieza, resort fees — se publican
como servicios adicionales en el folio, sin impuesto, nombrados desde el canal.
El impuesto del canal llega como
tax_source: ota.

Los precios que se empujan son una grilla, no una cotización

Lo que va al canal es la grilla de precios, no el resultado de cotizar una
estadía concreta. La cascada del propio canal deriva las variaciones desde sus
padres, así que lo que se manda son los padres.

En la API

• Merchant: los endpoints de estado del channel manager reportan el estado
  del push y si la estructura se desincronizó. Una propiedad desincronizada se
  resincroniza, no se parcha campo por campo.
• Nada del channel manager se expone en la External API pública.

Relacionado

• Disponibilidad y overbooking — por qué una reserva de OTA puede sobrevender y una interna no.
• Planes tarifarios — el canal de venta ota.
• Impuestos — impuesto declarado por el canal.