> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roomdoo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cerraduras inteligentes — conceptos básicos

> Cómo funciona la integración de smartlocks en Roomdoo: códigos por reserva, registro de accesos y proveedores soportados.

## Cómo funciona una cerradura inteligente con Roomdoo

Una **cerradura inteligente** (smartlock) es una cerradura electrónica que se abre con un código de acceso en lugar de con una llave física. Roomdoo se conecta con varios proveedores de smartlocks (Omnitec, TTLock, etc.) para que:

* Cada **reserva** tenga su propio código único de acceso a la habitación
* Los códigos sean **válidos solo durante la estancia** del huésped
* Quede registro de **cuándo se ha usado cada código**
* No haga falta entregar llaves físicas en recepción

<Note>
  Roomdoo es quien decide cuándo se crea, cuándo se activa y cuándo deja de funcionar cada código. La cerradura física recibe esa información a través del proveedor (Omnitec, TTLock...), que está conectado a Roomdoo.
</Note>

## Componentes del sistema

| Concepto                 | Qué es                                                                                    |
| ------------------------ | ----------------------------------------------------------------------------------------- |
| **Proveedor**            | La marca de la cerradura (Omnitec, TTLock, etc.). Cada uno funciona con su propio sistema |
| **Habitación**           | La habitación física a la que está asignada una cerradura concreta                        |
| **Reserva**              | El periodo de estancia de un huésped en una habitación                                    |
| **Código**               | El número PIN que abre la puerta. Asociado a una reserva y a su habitación                |
| **Historial de accesos** | Cada vez que se usa un código queda registrado: fecha, hora y código usado                |

## Ciclo de vida de un código

<Steps>
  <Step title="Se crea automáticamente al confirmar la reserva">
    Cuando una reserva pasa a estado confirmado y la habitación tiene cerradura inteligente, Roomdoo le pide al proveedor un código nuevo.
  </Step>

  <Step title="Se activa al empezar la estancia">
    El código se activa el día del check-in. Antes de esa fecha, el código existe pero no abre la cerradura.
  </Step>

  <Step title="Deja de funcionar al hacer check-out">
    Al terminar la estancia, el código deja de funcionar automáticamente. Si el huésped intenta usarlo después, la cerradura no abre.
  </Step>

  <Step title="Todo uso queda registrado">
    Cada vez que alguien abre la puerta queda anotado en el historial, con fecha y hora.
  </Step>
</Steps>

<Tip>
  Si una reserva se modifica (cambio de fechas o de habitación), Roomdoo se encarga de anular el código anterior y generar uno nuevo cuando procede. No hay que hacerlo a mano.
</Tip>

## Proveedores soportados

Roomdoo se conecta con los siguientes proveedores:

* **Omnitec** — ver documentación específica
* **TTLock** — ver documentación específica

Cada proveedor funciona con su propio sistema, pero el comportamiento dentro de Roomdoo es el mismo: una reserva genera un código que se activa en el check-in y deja de funcionar en el check-out.

<Note>
  Si necesitas usar otro proveedor de cerraduras que no aparece en la lista, [contacta con soporte](#cuando-contactar-con-soporte). Podemos añadir más proveedores, pero requiere trabajo de desarrollo específico para cada uno.
</Note>

## Casos comunes de soporte

<AccordionGroup>
  <Accordion title="El huésped llega y el código no le funciona">
    Causas posibles, de la más a la menos frecuente:

    1. **El código aún no se ha activado.** El código se activa el día del check-in a la hora que tengas configurada (habitualmente a partir de las 15:00). Si el huésped llega antes, el código todavía no abre.
    2. **La reserva no está confirmada.** Si está en estado preliminar o pendiente, todavía no se ha generado código.
    3. **La cerradura está sin batería o desconectada.** Comprueba el estado físico de la cerradura.
    4. **Cambiaste algo en la reserva hace poco.** Si modificaste las fechas o la habitación recientemente, el código nuevo puede no haber llegado todavía a la cerradura.

    Comprueba primero el estado de la reserva en Roomdoo y la fecha y hora actuales. Si todo parece bien y aun así no funciona, [contacta con soporte](#cuando-contactar-con-soporte).
  </Accordion>

  <Accordion title="Quiero generar un código manualmente para una visita o limpieza">
    Los códigos se generan automáticamente para reservas reales. Para casos especiales (visita técnica, limpieza, mantenimiento) suele haber una **cuenta maestra** del proveedor que permite acceso permanente o códigos especiales fuera del flujo de reservas.

    [Contacta con soporte](#cuando-contactar-con-soporte) para saber cómo se gestiona este caso en tu instalación concreta.
  </Accordion>

  <Accordion title="Veo accesos a una habitación fuera del horario de estancia">
    Roomdoo guarda cada apertura. Si ves accesos fuera del horario de estancia:

    1. **Puede ser personal de limpieza** con su propio código maestro
    2. **Puede ser un acceso del huésped antes o después de la estancia oficial** (early check-in, late check-out negociado)
    3. **Si no encaja con ningún huésped ni con personal autorizado**, puede ser un incidente de seguridad. Revisa con tu equipo y, si procede, [contacta con soporte](#cuando-contactar-con-soporte) para revisar el historial a fondo.
  </Accordion>

  <Accordion title="Una habitación no genera código aunque tenga cerradura inteligente">
    Comprueba que la habitación esté **asociada al proveedor correspondiente** en la configuración. Si una habitación no está asociada, Roomdoo no sabe que tiene cerradura inteligente y no genera código.

    Esa asociación se hace una sola vez durante el alta inicial. Si una habitación nueva no genera códigos, suele ser que falta este paso — [contacta con soporte](#cuando-contactar-con-soporte).
  </Accordion>
</AccordionGroup>

## Cuándo contactar con soporte

Contacta con soporte de Roomdoo si:

* Una **cerradura concreta** no responde, no recibe códigos o no los registra
* Necesitas **añadir o quitar habitaciones** del sistema de cerraduras inteligentes
* Necesitas conectar con un **proveedor nuevo** que no esté soportado actualmente
* Hay **accesos no autorizados** que necesitas revisar
* Se ha **actualizado el firmware o cambiado las credenciales** del proveedor

<Warning>
  No cambies códigos directamente desde la app del proveedor (Omnitec, TTLock) sin pasar por Roomdoo. Si lo haces, Roomdoo dejará de saber qué código está activo en cada cerradura, y los próximos huéspedes pueden encontrarse con la puerta cerrada.
</Warning>