Huéspedes y check-in digital

Un huésped es una persona o una empresa con la que trata el hotel. Los
registros de huésped pertenecen a la cuenta, no a una propiedad, así que un
huésped que regresa es una sola persona en todos los hoteles que opera la cuenta.

Tipo de huésped	Requiere	Uso típico
Individual	Nombre y apellido	La persona que duerme en la habitación.
Empresa	Nombre de la empresa	Un titular comercial de un grupo, una parte a facturar.

Una reserva tiene un huésped como ocupante, y los acompañantes se adjuntan a la
reserva como sus propios registros de huésped — un acompañante es una persona
real con un registro real, no un nombre suelto en una lista. La capacidad se hace
valer contra los adultos y niños declarados de la reserva.

Check-in digital

El check-in digital es un flujo web de cara al huésped, que se abre desde su
propio teléfono, sin inicio de sesión. El huésped principal llena la lista de
huéspedes y cada adulto verifica su identidad antes de llegar, para que
recepción abra el día de la llegada una reserva ya completa.

Es una feature de pago, por propiedad. Donde no está habilitada, no aparece.

Nunca le hace check-in a nadie

Completar el check-in digital no toca el estado de la reserva. checked_in
sigue siendo exactamente lo que siempre fue: la llegada física, registrada por
recepción cuando el huésped está parado enfrente.

Una reserva puede terminar el check-in digital y aun así ser un no-show. Un
huésped puede llegar y que le hagan check-in sin haber abierto nunca el enlace.
Este flujo es captura de datos previa a la llegada, y nada más.

El enlace es la credencial

La puerta es un token opaco por reserva, no el código de reserva. Un código
de reserva nunca podría ser la puerta: los códigos no son únicos globalmente
entre cuentas, y son secuenciales y adivinables por diseño.

El token se acuña la primera vez que hace falta, no al crear la reserva, así que
una reserva que nunca necesita un enlace nunca tiene uno.

Los pasos

Paso	Qué hace el huésped
Portada	Ve la marca de la propiedad, elige idioma.
Reserva	Confirma la estadía. Fechas y unidad son de solo lectura — un huésped que cambiara sus propias fechas movería disponibilidad y precio, así que se renderizan como texto, nunca como selectores.
Huésped principal	Datos de contacto, dirección, fecha de nacimiento, documento de identidad.
Acompañantes	Agrega, edita y quita acompañantes, cada uno con fecha de nacimiento.
Identidad	Cada adulto se verifica a sí mismo, desde su propio enlace.
Términos	Acepta términos y privacidad, si la propiedad los configuró.
Listo	Recibe un código QR y un correo de confirmación.

Nada se guarda en un borrador: cada paso escribe directo al almacenamiento, así
que un huésped que abandona a mitad de camino ya dejó guardado lo que llenó.

Recepción puede distinguir qué campos escribió el huésped y cuáles escribió
recepción — el registro de actividad anota al huésped como su propia clase de
actor.

Verificación de identidad

La verificación de identidad la hace un proveedor externo y devuelve un
veredicto que recepción lee el día de la llegada. Un veredicto es una
decisión sobre una persona, así que deliberadamente no es algo que recepción
pueda cambiar con un interruptor.

En la API

Merchant: /api/merchant/guests (acotado a la cuenta — estos endpoints no
llevan X-Property), y los endpoints de lista de huéspedes de la propia
reserva para ocupantes y acompañantes.
External: una reserva se crea con un objeto guest o con un guest_id.
Un objeto guest siempre crea un registro de huésped nuevo — nunca se
fusiona con uno existente por correo. Para reutilizar un huésped existente hay
que mandar su id.

Relacionado

Reservas — donde se adjunta un huésped.
Comunicación con el huésped — qué se le manda, y en qué idioma.
Reservas de grupo — ocupantes provisionales y la rooming list.