Hotel

El módulo Hotel administra hospedaje de punta a punta: catálogo de habitaciones, reservas, check-in/out, consumos en habitación, abonos, traslados y facturación al salir.

Menú en la app: Hotel (requiere permiso show_hotel)

Pantalla	Ruta
Dashboard	/hotel
Mapa de habitaciones	/hotel/rooms/map
Reservas	/hotel/reservations
Calendario	/hotel/reservations/calendar
Habitaciones	/hotel/rooms
Tipos de habitación	/hotel/room-types
Pisos	/hotel/floors
Configuración	/hotel/config

Por dónde empezar

Configura en este orden antes de la primera reserva:

1. Pisos — niveles del edificio
2. Tipos de habitación — tarifas y capacidad
3. Habitaciones — cada habitación física
4. Configuración hotel — hora de check-in y check-out
5. Revisa Cajas, Métodos de pago y Numeraciones para anticipos y checkout

Consejo

GridPOS puede guiarte con tours al crear el primer piso, tipo, habitación o reserva (?tour_step= en la URL).

---

Dashboard hotel

Ruta: /hotel

Panel operativo del día o del rango que elijas.

Barra superior

• Última actualización — hora del último refresco
• Rango de fechas — selector con formato YYYY-MM-DD, separador « a »
• Refrescar — actualiza KPIs y listas

KPIs principales

Tarjeta	Qué muestra
Ocupación	Porcentaje y {ocupadas}/{total} habitaciones
Disponibles	Habitaciones listas para asignar
Check-ins	Llegadas en el período
Check-outs	Salidas en el período

Check-ins y check-outs del período

Listas con acciones rápidas por reserva:

Botón	Cuándo
Ver (ojo)	Abre detalle de la reserva
Confirmar reserva	Solo estado Pendiente
Check-in	Deshabilitado si aún está Pendiente (debe confirmarse antes)
Deshacer check-in	Solo Check-in; requiere permiso undo_hotel_checkin
Anular	Requiere permiso cancel_hotel_reservation

El Check-out desde el dashboard redirige al mapa de habitaciones para completar la salida con cobro y factura.

Estado de habitaciones

Barras de progreso con conteo y porcentaje por estado: Disponible, Ocupada, Limpieza, Mantenimiento, Reservada, Fuera de Servicio.

Clic en Habitaciones clave (Disponibles, Ocupadas, etc.) → filtra el listado en /hotel/rooms?status=....

Accesos rápidos

• Nueva reserva → formulario
• Reservas → listado
• Habitaciones → catálogo
• Tipos → tarifas
• Enlace Ir al calendario

---

Configuración hotel

Ruta: /hotel/config

Horarios operativos

Campo	Default	Para qué sirve
Check-in	15:00	Desde esta hora el huésped puede ingresar
Check-out	13:00	Después de esta hora puede aplicarse noche extra en checkout

Vista previa: Jornada hotelera: entrada {hora} · salida {hora}
Toca Guardar horarios.

Enlaces relacionados

Desde esta pantalla accedes a tipos, pisos, habitaciones, métodos de pago, cajas, valores de billetes y numeraciones de facturación.

---

Pisos

Listado: /hotel/floors
Formulario: /hotel/floors/form

Organiza el edificio por niveles (Planta baja, Piso 2, etc.).

Campo	Obligatorio
Número de piso	Sí — ej. 1, 2, 3
Nombre	Sí — ej. Primer Piso
Descripción	No
Estado activo	Activo / Inactivo

Columnas del listado: Número de piso · Nombre · Descripción · Habitaciones · Estado · Acciones

---

Tipos de habitación

Listado: /hotel/room-types
Formulario: /hotel/room-types/form

Define categorías (Estándar, Suite, Familiar…) con capacidad y forma de cobro.

Información del tipo

Campo	Detalle
Nombre	Obligatorio
Capacidad base	Personas incluidas en tarifa base
Capacidad máxima	Tope de huéspedes
Descripción	Texto libre
Estado activo	Activo / Inactivo

Forma de cobro (tarifa)

Selector ¿Cómo se cobra este tipo de habitación?

Por habitación

Precio fijo por noche, sin importar cuántas personas (dentro de capacidad).

• Precio por noche (habitación completa) — obligatorio

Por persona

Cobra según adultos, niños y adicionales.

Campo	Detalle
Precio por adulto por noche	Obligatorio — primeras N personas según capacidad base
Precio por niño por noche	Opcional
Precio por persona adicional (por noche)	Opcional — huéspedes sobre la capacidad base

Por pareja

Tarifa para dos personas, con opciones para single y adicional.

Campo	Detalle
Precio por pareja por noche (2 personas)	Obligatorio
Precio por persona adicional	Opcional
Precio por 1 persona (tarifa single)	Opcional — una sola persona en habitación doble

Al guardar, el sistema vincula un producto para facturación (visible al editar el tipo).

Eliminar un tipo requiere permiso delete_hotel_room_type.

---

Habitaciones

Listado: /hotel/rooms
Formulario: /hotel/rooms/form

Cada habitación física del hotel.

Campo	Obligatorio
Número de habitación	Sí
Nombre	Sí
Tipo de habitación	Sí
Piso	No
Capacidad	Sí
Número de camas	Sí
Precio base	Sí — puede heredar del tipo
Estado	Disponible, Ocupada, Limpieza, Mantenimiento, Reservada, Fuera de Servicio
Estado activo	Activa / Inactiva
Descripción	No
Amenidades	Tags — WiFi, TV, Aire acondicionado, Mini bar…

Filtros del listado

Estado · Tipo · Piso · Buscar (número o nombre)

Cambiar estado

Desde Cambiar estado en una fila:

• Nuevo estado: Disponible, Ocupada, Limpieza, Mantenimiento, Reservada, Fuera de Servicio
• Motivo o nota (opcional) — ej. Reparación aire acondicionado

Útil para marcar Limpieza tras un checkout antes de volver a Disponible.

Eliminar requiere permiso delete_hotel_room.

---

Reservas

Listado: /hotel/reservations
Nueva / editar: /hotel/reservations/form
Detalle: /hotel/reservations/{id}

Crear una reserva

Puedes crearla desde:

• Listado → Nueva reserva
• Dashboard → Nueva reserva
• Calendario → clic en celda vacía
• Mapa → Reservar en habitación disponible

Sección Huésped

Campo	Detalle
Huésped	Buscar cliente existente o Crear huésped (modal de contactos)
Adultos	Obligatorio — afecta tarifa si el tipo es por persona/pareja
Niños	Opcional

Fechas y habitación

Campo	Detalle
Check-in / Check-out	Obligatorios — calcula Noches automáticamente
Habitación	Solo habitaciones disponibles en ese rango
Tarifa por noche	Se calcula según tipo y huéspedes; editable

Pago anticipado (opcional)

Campo	Detalle
Monto anticipado	Abono inicial
Método de pago	Si monto > 0
Caja	Caja donde registra el ingreso

Resumen lateral

Noches · Tarifa/noche · Total · Anticipo · Saldo pendiente

Toca Guardar reserva.

Nota

Si vienes del calendario, verás alerta Desde calendario: {habitación} · {fecha} con datos precargados.

Estados de reserva

Estado	Significado	Badge
Pendiente	Creada, sin confirmar	Amarillo
Confirmada	Lista para recibir al huésped	Azul
Check-in	Huésped en habitación	Verde
Check-out	Estadía finalizada y cobrada	Gris
Cancelada	Anulada con motivo	Rojo
No show	No se presentó	Oscuro

Flujo operativo recomendado

Crear reserva → Confirmar → Check-in → Cuenta/consumos/abonos → Checkout → Check-out

1. Confirmar — desde dashboard o listado (reserva Pendiente)
2. Check-in — cuando llega el huésped (Confirmada → Check-in; habitación pasa a Ocupada)
3. Cuenta — cargar consumos durante la estadía
4. Checkout — cobrar saldo y emitir comprobante (Check-out)

Acciones por reserva (listado)

Acción	Estados permitidos
Ver reserva	Todos
Agregar abono	Pendiente, Confirmada, Check-in
Cuenta / Consumos	Check-in
Editar / Ampliar estadía	Pendiente, Check-in
Check-in	Confirmada
Check-out	Check-in → abre mapa
Ver factura	Check-out con venta generada
Deshacer check-in	Check-in (undo_hotel_checkin)
Anular	Pendiente, Confirmada, Check-in (cancel_hotel_reservation)
Eliminar	Pendiente, Cancelada, No show sin venta (delete_hotel_reservation)

Anular una reserva

Pide motivo obligatorio. La habitación vuelve a Disponible si estaba reservada u ocupada según el caso.

---

Cuenta de habitación (consumos)

Ruta: /hotel/reservations/{id}/account

Pantalla Cuenta de habitación — el POS de la habitación.

Panel izquierdo — Agregar a cuenta

Pestañas: Productos · Combos · Servicios

• Busca en el catálogo
• Clic en un ítem → se agrega al carrito de la cuenta
• Paginación si hay más de 24 ítems

Panel derecho — Cuenta

Lista de consumos con cantidad × precio, nota por línea.

Acción por ítem	Permiso
Editar precio/cantidad	edit_hotel_consumption_price
Agregar / editar nota	Todos con acceso
Eliminar línea	Según rol

Resumen:

• Hospedaje — noches × tarifa
• Consumos — suma de cargos
• Total
• Anticipo (−)
• Saldo pendiente

Botones principales

Botón	Qué hace
Guardar ({n})	Confirma consumos del carrito (debe estar vacío antes del checkout)
Imprimir orden	Comanda a cocina/barra
Pre-cuenta	Resumen para el huésped
Fechas / ampliar estadía	Extiende check-out (recalcula noches y total)
Checkout	Solo si no hay consumos sin guardar

Precaución

Guarda los consumos antes de hacer checkout. Si el carrito tiene ítems pendientes, el botón Checkout no procede.

---

Agregar abono

Modal Agregar abono — disponible en listado de reservas y mapa (habitación ocupada).

Campo	Detalle
Monto a abonar	Obligatorio
Método de pago	Obligatorio
Caja	Si hay varias cajas; si solo hay una, se muestra automáticamente

Muestra Anticipo actual y Anticipo después del abono. El abono reduce el saldo pendiente sin cerrar la estadía.

---

Checkout y facturación

El checkout se realiza desde:

• Mapa → botón Salida (habitación ocupada)
• Cuenta → botón Checkout

También puedes llegar con ?reservation_id= en el mapa (desde dashboard o listado).

Modal de checkout

Noches adicionales

Si el huésped sale después de la hora de check-out configurada, aparece panel Noches adicionales con:

• Badge de días extra
• Incluir en el cobro: Ninguna (0) · 1 noche · … · N noches
• Recalcula total de hospedaje

Cuenta del huésped

• Hospedaje ({n} noche(s))
• Consumos ({n} ítems) si aplica
• Subtotal
• Anticipo (−)
• Total a pagar

Si el saldo es ≤ 0: mensaje Cuenta saldada — confirmar para generar comprobante.

Facturación

Si tienes varias numeraciones, elige Tipo de facturación (numeración DIAN o POS).

Cobro

Tipo: Individual · Múltiple

• Selecciona método(s) de pago con montos
• En efectivo: atajos de billetes ($5.000 … $100.000), Valor recibido, Completo, Limpiar, Cambio
• Notas opcionales del checkout

Confirmar checkout → genera venta/comprobante → habitación Disponible → modal ¡Checkout exitoso! con Imprimir y Descargar.

Tras el checkout, en el listado de reservas usa Ver factura para reimprimir.

---

Mapa de habitaciones

Ruta: /hotel/rooms/map

Vista visual operativa — la pantalla que usa recepción durante el día.

Filtros

• Pestañas de piso: Todos + cada piso (con conteo)
• Estado: multiselect — Disponible, Ocupada, Reservada, Limpieza, Mantenimiento, Fuera de Servicio
• Actualizar

Chips resumen: Disponibles · Ocupadas · Reservadas · Limpieza · Mantenimiento · Fuera de Servicio

Tarjeta de habitación

Muestra número, piso, tipo, capacidad, badge de estado y tarifa.

Estado	Color	Acciones típicas
Disponible	Verde	Reservar
Ocupada	Rojo	Traslado, Consumo, Abono, Salida
Reservada	Azul	Ver →
Limpieza	Ámbar	Ver →, cambiar a Disponible
Mantenimiento / Fuera de servicio	Celeste / Gris	Nota + cambiar estado

En habitación ocupada, el popover de precio muestra: Hospedaje · Consumos · Total · Anticipo · Pendiente.

Clic en la tarjeta → formulario de la habitación.

Traslado de huésped

Solo habitaciones ocupadas.

Campo	Detalle
Origen / Huésped	Solo lectura
Habitación destino	Solo disponibles
Razón del traslado	Opcional
Ajustar tarifa a la nueva habitación	Recalcula tarifa según tipo destino

Cambiar fechas (ampliar estadía)

Desde mapa o cuenta: ajusta Check-in y Check-out; recalcula noches, total y saldo. La salida debe ser posterior al check-in.

---

Calendario de reservas

Ruta: /hotel/reservations/calendar

Matriz habitación × días del mes.

Toolbar

• Navegación de mes (‹ ›)
• Hoy
• Refrescar
• Nueva reserva

Filtros

Pestañas de piso + estadísticas: {n} en el mes · {n} llegadas hoy · {n} salidas hoy

Interacción

Acción	Resultado
Clic celda vacía	Nueva reserva con room_id y fecha precargados
Clic barra de reserva	Detalle de la reserva
Hover	Tooltip: huésped, código, fechas, estado

Colores de reservas

Estado	Color	Leyenda
Pendiente	Gris	Pendiente
Confirmada	Verde	Confirmada
Check-in	Azul	En habitación
Check-out	Gris claro	Finalizada

La barra muestra nombre del huésped y {n}n si son varias noches.

Hint: Celda vacía: nueva reserva · Barra: ver detalle

---

Permisos del módulo

Permiso	Acceso
show_hotel	Dashboard y configuración
show_hotel_rooms	Habitaciones y mapa
show_hotel_reservations	Listado de reservas
show_hotel_calendar	Calendario
show_hotel_room_types	Tipos de habitación
show_hotel_floors	Pisos
cancel_hotel_reservation	Anular reservas
undo_hotel_checkin	Deshacer check-in
delete_hotel_reservation	Eliminar registro
delete_hotel_room / delete_hotel_room_type	Eliminar catálogo
edit_hotel_consumption_price	Ajustar precio/cantidad en cuenta

Asigna permisos en Configuración → Roles.

---

Preguntas frecuentes (hotel)

¿Por qué no puedo hacer check-in?

La reserva debe estar Confirmada. Si está Pendiente, usa Confirmar reserva primero.

¿Cómo cobro minibar o restaurante a la habitación?

Con la reserva en Check-in, entra a Cuenta / Consumos y agrega productos, combos o servicios. Guarda y cobra en el Checkout.

¿Qué pasa si el huésped sale tarde?

En el checkout, el sistema detecta noches adicionales según la hora de check-out configurada. Elige cuántas noches extra incluir en el cobro.

¿Cómo paso a un huésped a otra habitación?

Desde el mapa, habitación ocupada → Traslado → elige habitación destino disponible.

¿La habitación sigue en Limpieza después del checkout?

Tras checkout exitoso queda Disponible. Si tu operación usa estado Limpieza intermedio, cámbialo manualmente desde el listado o mapa antes de asignar al siguiente huésped.

---

Relacionado

• Contactos — clientes
• POS
• Cajas y cierres
• Factura electrónica
• Productos y servicios — catálogo que se carga a la cuenta