→ Abrir en la app — Accede directamente a esta sección desde tu cuenta.
Códigos promocionales son cupones que el huésped introduce al reservar (ej. VERANO10). A diferencia de Promociones (packs automáticos), el descuento depende de que el cliente escriba el código.
Dónde está
Configuración > Códigos promocionales — /settings/promo-codes
Antes de empezar
Administrador o permiso de menú Configuración.
Motor de reservas activo si quieres visibilidad online.
Listado
Sección | Descripción |
En vigor | Códigos activos en rango de fechas |
Códigos caducados | Fuera de vigencia |
Códigos deshabilitados | Desactivados manualmente |
Columnas: Código, Nombre, Tipo, Valor, Cantidad, Vigencia, toggle Visible en motorAcciones: Añadir; popover Editar, Habilitar/Deshabilitar, Eliminar
Modal Añadir / Editar
Datos generales
Nombre, Código, Descripción, Activo, Mostrar en motor de reservas
Descuento
Tipo de descuento, Valor (≥ 0)
Vigencia y días
Desde / Hasta (inicio ≤ fin), Usos máximos (0 = sin límite), Aplicar solo en días concretos + Días de la semana
Botón Guardar.
¿Quién puede gestionar códigos?
A diferencia de usuarios o roles, la API no exige admin estricto: cualquier usuario con acceso JWT a la propiedad puede listar y mutar según permisos de menú Configuración en frontend. En la práctica, suele ser admin o revenue.
Visible en motor
El toggle Visible en motor / Mostrar en motor de reservas controla si el huésped puede seleccionar o aplicar el código en el motor. Puedes tener códigos solo para uso interno en recepción.
Validaciones
Nombre y código obligatorios
Fechas obligatorias y coherentes
Si activas días concretos, al menos uno seleccionado
Valor numérico ≥ 0
Códigos de error en el motor de reservas
Cuando el huésped introduce un cupón en el motor de reservas, puede ver estos mensajes (texto exacto según idioma del motor):
Mensaje | Causa habitual | Qué revisar en Configuración |
El código de cupón no es válido | Código inexistente o desactivado | Códigos promocionales — Activo, Código escrito igual (mayúsculas) |
El cupón no es válido para las fechas seleccionadas | Estancia fuera de Desde/Hasta o días no marcados | Vigencia y Días de la semana |
Selecciona hoteles antes de validar un cupón | Reserva multipropiedad sin hotel elegido | Flujo del motor — el huésped debe elegir hotel primero |
Error al validar el cupón | Fallo de red o API al validar | Reintento; si persiste, soporte |
En recepción, al Editar reserva, el selector Código promocional solo lista códigos en vigor (caducados no aparecen).
Problemas frecuentes
Listado vacío
Normal si no creaste códigos. Pulsa Añadir.