→ 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 el mismo rango de entrada y salida de la reserva, 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 Marketplace.
Dónde está
Marketplace → Cerraduras → ttlock → Configurar (abre Store → usar el lápiz para introducir las credenciales)
Configuración del addon: Configuración → Marketplace → tarjeta ttlock
Operativa: Accesos Rápidos → Puertas / Detalle de reserva → Control de accesos
Requisitos
Plan con addon Marketplace 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 Store. Desde ahí, usando el icono del lápiz, podrás introducir el usuario y contraseña de tu cuenta de ttlock.
Paso 2: Introduce credenciales TTLock
En Marketplace, 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: Sincronización de cerraduras con unidades alojativas (mapeo)
Al desplegarse el listado de puertas, veremos que cada línea/cerradura tiene su identificador entre paréntesis. Ese identificador es el que debemos rellenar en el campo Code de la pantalla Códigos de puerta que encontramos en los ajustes de la cuenta. Una vez completado el campo Code continuamos con el resto, para ttlock hay que completar:
Code: Identificador de la cerradura obtenido del Marketplace
Nombre: El nombre con que se mostrará en la webapp
Tipología: Elegir del desplegable la unidad del PMS que asociaremos a esta cerradura.
Tipo: ttlock
public: on para puertas públicas / off para puertas privadas (las puertas públicas son aquellas a las que deben acceder todas las reservas, una entrada principal, acceso a zonas comunes, etc.)
area: permite crear zonas de puertas para incluir puertas públicas de un grupo de unidades alojativas.
Producto: Aquí encontrarás un listado de todos los artículos que existen en la cuenta. Al seleccionar uno, esa cerradura/puerta solo será visible en el caso de tener ese artículo en la reserva.
Orden: Introduciendo un valor numérico, podrás definir el orden en el que se ven las puertas en la webapp.
Paso 6: 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
A la hora definida en el programa, Hotelgest solicitará los PINs necesarios para las llegadas del día a ttlock, incluyendo:
El lockId (identificador) 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, la webapp y en el informe de Llegadas.
Apertura remota
Desde Detalle de reserva → Abrir puertas puedes desbloquear la cerradura de la habitación. En Marketplace, 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 Marketplace y pulsa Guardar.
Qué sincroniza
Dirección | Qué ocurre | Dónde lo validas |
Hotelgest → TTLock | Genera PIN, desbloqueo remoto | Abrir puertas, listado en Marketplace |
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 Marketplace |
«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 Marketplace |
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.