→ Abrir en la app — Accede directamente a esta sección desde tu cuenta.
ttlock conecta cerraduras compatibles con la plataforma TTLock con Hotelgest PMS. Permite generar PIN con ventana de entrada y salida, abrir puertas en remoto y, según configuración, enlace mágico para el huésped desde la webapp.
El alta y las credenciales las gestiona el hotel desde Store (Marketplace muestra Configurar, no Solicitar integración).
Dónde está
Marketplace → Cerraduras → ttlock → Configurar (abre Configuración → Store)
Configuración del addon: Configuración → Store → tarjeta ttlock
Operativa: Detalle de reserva → Abrir puertas (permiso Abrir puertas)
Requisitos
Plan con addon Store activo.
Cuenta de la app TTLock (usuario/teléfono o email y contraseña) con cerraduras emparejadas en el gateway TTLock.
Habitación asignada en la reserva antes de generar acceso.
Activación
Paso 1: Abre Marketplace > ttlock
En Cerraduras, pulsa Configurar en la tarjeta ttlock. El PMS te lleva a Configuración → Store.
Paso 2: Introduce credenciales TTLock
En Store, abre el addon ttlock e introduce:
User (Phone) — el usuario de tu cuenta TTLock (teléfono o email con el que accedes a la app)
Password — la contraseña de esa cuenta
Paso 3: Activa y guarda
Marca el checkbox de activación, pulsa Guardar y espera confirmación. Si las credenciales son incorrectas, verás un error al guardar o al listar puertas.
Paso 4: Comprueba el listado de puertas
Pulsa Listado de puertas (Solo Administradores). Deberías ver alias, identificador y nivel de batería de cada cerradura. Si aparece «No se detectan cerraduras o no eres administrador», revisa credenciales y permisos.
Paso 5: Prueba en una reserva
Reserva test con habitación asignada y fechas de hoy → Abrir puertas → genera PIN → valida en el teclado de la cerradura.
Funcionalidades
Generación de PIN
Al hacer check-in o pre-check-in, el PMS envía a TTLock:
El lockId de la cerradura vinculada a la habitación
Inicio y fin de validez según fechas de la reserva
Un PIN numérico para el teclado de la cerradura
El PIN aparece en el detalle de la reserva y en el informe de Llegadas.
Apertura remota
Desde Detalle de reserva → Abrir puertas puedes desbloquear la cerradura de la habitación. En Store, el listado de puertas incluye un botón Open para pruebas (solo administradores).
Enlace mágico y webapp
Según la configuración de la webapp del huésped, el huésped puede recibir acceso digital (PIN visible en check-in online o apertura desde la webapp cuando la reserva está En casa y dentro del periodo permitido).
⚠️ Advertencia: Usa la misma cuenta TTLock con la que gestionas las cerraduras en la app móvil. Si cambias la contraseña en TTLock, actualízala también en Store y pulsa Guardar.
Qué sincroniza
Dirección | Qué ocurre | Dónde lo validas |
Hotelgest → TTLock | Genera PIN, desbloqueo remoto | Abrir puertas, listado en Store |
TTLock → Hotelgest | Resultado de login u operación | Aviso en pantalla al guardar o abrir |
Hotelgest → huésped | PIN o acceso webapp | Informe Llegadas, webapp huésped |
Troubleshooting
Síntoma | Qué revisar |
«Por favor revisa usuario y contraseña» | User (Phone) o Password incorrectos en Store |
«not data ttlock» | Addon no activo o credenciales no guardadas |
Listado vacío | Cerraduras no vinculadas a la cuenta TTLock, gateway offline, o usuario sin rol administrador en el PMS |
PIN no abre | Fechas fuera de validez, teclado con longitud de PIN distinta, o cerradura no vinculada a esa habitación — contacta soporte |
«ERROR TTlock mapping» | Reserva sin habitación asignada o cerradura no configurada para esa habitación — contacta soporte |
Apertura remota falla | Cerradura sin batería, gateway desconectado, o credenciales incorrectas en Store |
User (Phone): qué poner exactamente
El campo acepta el identificador con el que inicias sesión en la app TTLock: puede ser un número de teléfono (formato internacional) o un email, según cómo creaste la cuenta. Debe coincidir con la cuenta que ve las cerraduras en la app móvil.
Zona horaria
Las fechas de validez del PIN se convierten desde la zona horaria configurada en el hotel a UTC antes de enviarse a TTLock. Revisa Configuración → Ajustes generales si el PIN deja de funcionar a primera hora o a última hora del día.