Conectar Nuki con Boris

Nuki es la cerradura inteligente más habitual en pisos turísticos. Boris se conecta a Nuki Web con un token de API y emite un código de teclado por reserva.

1. Obtener el token

Entrá en web.nuki.io → Menú → API → Generate API token. Activá los permisos de lectura de cerraduras y de gestión de autorizaciones: sin ese segundo permiso Boris puede listar las puertas pero no emitir códigos.

Pegá el token en Boris, guardá y pulsá Probar conexión → Importar puertas.

2. Elegir qué recibe el huésped

• PIN de teclado — Boris genera un código de seis dígitos por reserva. Requiere un Nuki Keypad emparejado con la cerradura; sin teclado físico el código no tiene dónde escribirse.
• Nada — para huéspedes que ya usan la app de Nuki. En ese caso el email del huésped es obligatorio, porque la autorización se emite contra su cuenta.

Qué hace Boris dentro de Nuki

• Por reserva crea una autorización en la cerradura con allowedFromDate y allowedUntilDate. El código caduca solo aunque la revocación no llegue a ejecutarse.
• Al revocar, borra esa autorización de la cerradura.
• La apertura remota usa la acción unlock (no unlatch: Boris no tira del picaporte).
• Importa el histórico de aperturas para el registro de accesos.

Cosas a tener en cuenta

• Nuki aplica los cambios de forma asíncrona. La API acepta la orden y la cerradura la recoge en segundos a través del Bridge o del WiFi. Un código recién creado puede tardar un momento en funcionar.
• La cerradura necesita conexión permanente (Nuki Bridge o modelo con WiFi). Una cerradura solo-Bluetooth no recibe códigos desde la nube.
• Los códigos de teclado de Nuki son de seis dígitos, no pueden empezar por cero ni por la secuencia «12». Boris los genera respetando esa regla.
• El número de autorizaciones por cerradura es limitado: conviene dejar que Boris revoque al terminar la estancia en vez de acumular códigos vencidos.