Hotel PMS — Administración hotelera

Proyecto en desarrollo: un panel de administración para un hotel de aproximadamente diez habitaciones en Colombia, pensado para un equipo de una a tres personas que con frecuencia trabaja desde el celular. Lo desarrollo con apoyo de inteligencia artificial (Claude Code), en español y con valores en pesos colombianos.

Las capturas de esta página usan datos ficticios: el hotel, los huéspedes y las cifras no son reales. Puede probar la demostración en línea: elija un rol en la pantalla de ingreso; los datos se reinician periódicamente.

El problema

En un hotel pequeño la operación suele repartirse entre cuadernos, hojas de cálculo y mensajes de WhatsApp: las reservas, los anticipos, el estado de limpieza de cada habitación y los consumos de los huéspedes no quedan en un solo lugar. A esto se suman las obligaciones legales en Colombia, como la Tarjeta de Registro Hotelero (TRA) y el reporte a Migración Colombia (SIRE) de los huéspedes extranjeros, que exigen capturar datos específicos en cada ingreso.

Qué hace

• Inicio del día: ocupación, llegadas, salidas, habitaciones por limpiar, ingresos por método de pago y alertas (salidas vencidas, posibles no show, stock bajo, reclamos abiertos y movimientos sin reportar a SIRE).
• Reservas: calendario tipo línea de tiempo (habitaciones por días), creación desde una celda libre, anticipos, origen de la reserva (presencial, teléfono, WhatsApp, agencia o plataforma externa), modificación, cancelación con motivo y no show con penalidad.
• Check-in por pasos: huésped, acompañantes, vehículo y parqueadero, pago y confirmación; reconoce huéspedes ya registrados por su documento.
• Cuenta del huésped: las noches se cargan una a una y se reajustan solas si cambian las fechas, la habitación o la hora real de salida; servicios y consumos se cargan a la habitación; recibo en PDF.
• Tarifas: precio base por tipo, temporadas, recargo de fin de semana y descuento por estadía larga, con un simulador noche por noche.
• Exención de IVA: para extranjeros no residentes, con los documentos de soporte guardados en la ficha del huésped.
• Inventario y ventas: punto de venta directo o con cargo a la habitación, entradas, salidas, ajustes por conteo y alerta de stock bajo.
• Limpieza: vista para el celular con acciones directas (empezar, lista, reportar daño); al hacer check-out la habitación pasa sola a limpieza.
• Postventa: encuesta de satisfacción enviada por WhatsApp o correo y seguimiento de comentarios y reclamos.
• Reportes y cumplimiento: ocupación, tarifa promedio (ADR), RevPAR, ingresos, ventas por producto y origen de reservas, exportables a Excel y PDF; datos de la TRA en Excel y archivo plano para el cargue en SIRE.
• Roles y auditoría: administración, recepción y limpieza; cada cobro, anulación y cancelación queda registrado con el usuario y la hora.

Cómo está hecha

01Interfaz · React + Vite

Recepción Calendario, check-in/out, cuenta y ventas

Vista móvil Limpieza y operación desde el celular

02Servidor · Node + Express

Motor de reservas Disponibilidad y tarifas por temporada, fin de semana y estadía larga

Cuenta y auditoría Cargos, pagos, anulaciones con motivo y registro por usuario

Reportes PDF, Excel, TRA y archivo plano SIRE

03Datos e integraciones

SQLite Módulo nativo node:sqlite, sin compilación

Facturación electrónica Adaptadores para proveedor tecnológico

Reservas en línea Mismo motor de disponibilidad

• React con Vite en la interfaz, diseñada primero para el celular: barra de navegación inferior en el teléfono y menú lateral en el escritorio.
• Node.js con Express y SQLite mediante el módulo nativo node:sqlite, de modo que la instalación no requiere compilar dependencias.
• Un único motor de disponibilidad y tarifas, compartido por recepción y por el futuro módulo de reservas en línea, que ya contempla reservas pendientes con retención temporal del inventario.
• El estado de cada habitación (ocupada o reservada) se calcula a partir de las reservas, para que nunca quede desincronizado.
• Recibos y reportes en PDF con PDFKit y exportaciones a Excel con ExcelJS.
• Facturación electrónica preparada mediante adaptadores para conectar el proveedor tecnológico que elija el hotel.

Estado actual

• Los trece módulos funcionan de extremo a extremo y el código está publicado en GitHub.
• Próximos pasos: el módulo de reservas en línea para huéspedes (se activará desde Configuración), la conexión con un proveedor de facturación electrónica y la validación del formato SIRE con la guía vigente de Migración Colombia antes de la puesta en marcha.

Capturas

Datos ficticios: el hotel, los huéspedes y las cifras no son reales.