Reservas de grupo

Un grupo de reservas es un bloque de habitaciones del que se hace responsable
un titular comercial: una empresa que toma veinte habitaciones para un congreso.

El grupo agrega identidad encima de reservas corrientes — un
código compartido, un titular, una vista consolidada, acciones masivas y la
posibilidad de facturar habitaciones a una empresa. Cada habitación sigue
siendo una reserva corriente, que se edita, se mueve, se cancela y se carga por
los endpoints que ya existen. El grupo solo cubre lo que un grupo agrega.

Cómo se arma un grupo

Un grupo se compone de líneas: unidad + plan tarifario + fechas + ocupación,
opcionalmente con una cantidad. Cada línea se convierte en una o más reservas.

• Acotado a una propiedad. Las líneas de un grupo nunca cruzan propiedades.
• Identificado por su propio código — AXP-G000001, acuñado desde el mismo
  prefijo de propiedad que usa un código de reserva, pero desde su propio
  contador.
• Se crea todo o nada. O cada línea se vuelve reservas, o no se escribe nada.
  Una vista previa responde de antemano "qué cabe y cuánto cuesta" sin persistir
  nada.

El estado es derivado

Un grupo no tiene columna de estado. Su estado se calcula desde el estado vivo de
las reservas que lo integran. Las transiciones masivas mueven a los miembros; el
estado del grupo va detrás.

El titular no es el ocupante

El titular comercial es quien contrata y paga. Toda reserva creada bajo el
grupo arranca con ese titular como ocupante provisional, y la rooming
list reasigna después el ocupante real de cada habitación — normalmente cuando
la empresa por fin manda los nombres.

Esa separación es el punto entero del módulo, y es por lo que un grupo se puede
vender, cotizar y confirmar mucho antes de que nadie sepa quién duerme dónde.

Quién paga qué

Por defecto los cargos de cada habitación son del huésped que duerme en ella,
exactamente igual que en una reserva sin grupo. Un grupo puede, en cambio, rutear
algunos o todos los cargos de una habitación a la empresa, en la pestaña del
propio grupo.

Dos cosas que un lector no va a adivinar, así que se dicen sin rodeos:

• El balance_due y el payment_status de una habitación significan lo que
  debe su ocupante — nunca el precio completo de la habitación.
• Rutear los cargos de una habitación a una empresa nunca cambia el
  total_price de la habitación. Solo a quién se le pide pagarlo.

Esto se configura en dos partes: una regla de facturación dice qué lado debe
cada fuente de cargo, y el pagador de cada habitación dice a quién resuelve
"la empresa" para esa habitación. La regla de facturación aplica desde el
siguiente cargo publicado en adelante — no reescribe cargos que ya están en el
folio.

Una cuenta de grupo tiene entonces su propio estado de cuenta — lo que debe,
por habitación, y lo que ha pagado — más sus propios pagos y reembolsos. Un
reembolso está topado por lo que recibió la cuenta, no por su saldo: una
empresa que pagó un depósito mayor a lo que se le cobró puede recuperar el
depósito entero.

Tarifas negociadas

Una línea de grupo puede llevar una tarifa negociada con la empresa, y es la
última palabra sobre el precio de la noche — se aplica después de todo lo demás,
incluido un precio escrito a mano. Dos formas, y se comportan distinto a
propósito:

• Fija por noche — un número que alguien acordó. Reemplaza la noche entera, y
  se trata como un precio acordado: el huésped paga esa cifra y el impuesto
  sale de adentro, diga lo que diga el perfil de impuestos de la propiedad. La
  noche completa se toma como acordada, incluido cualquier fee de niño o infante
  que el plan hubiera sumado encima — partirla significaría facturar una noche
  como dos cargos, cuando a la empresa se le cotizó un total único de todas
  formas.
• Porcentaje — un descuento medido contra lo que la noche se habría vendido.
  Lo que llega al folio sigue siendo un precio de lista con un modificador
  encima, así que el perfil de impuestos sigue gobernando.

Dejar que las dos se comportaran igual le daría al operador dos cosas que se ven
iguales en pantalla y facturan distinto.

Visibilidad

Solo son visibles y administrables como grupos aquellos que un merchant creó
deliberadamente. Una reserva con quantity > 1 comparte un identificador de
grupo de reserva para mostrarse junta, pero no es un grupo de reservas y no tiene
nada de esta maquinaria.

En la API

• Merchant: POST /api/merchant/booking-groups/preview (no escribe nada),
  POST /booking-groups (todo o nada),
  PUT /booking-groups/{group}/rooming-list,
  PUT /booking-groups/{group}/billing-rule,
  PUT /booking-groups/{group}/payers, y
  /booking-groups/{group}/accounts/... para estados de cuenta, pagos y
  reembolsos.
• External: los grupos no se exponen. POST /bookings topa quantity en
  1 — las reservas de grupo son otro contrato.

Relacionado

• Reservas — cada habitación es una.
• Pagos y saldo — por qué balance_due es el único saldo confiable.
• Reglas de precio — dónde se sienta una tarifa negociada en el orden.