Escanear códigos QR

El escaneo de permisos QR es la actividad principal del guardia. La app valida en línea cada código y registra el acceso automáticamente.

Pantalla "Escanear QR"

Toca la pestaña "Escanear" en la barra inferior, o el botón "Escanear QR" en el home.

Verás:

Elemento	Función
Marco de cámara	Coloca el QR dentro del recuadro
Instrucción	"Coloca el código QR dentro del recuadro"
Flash (top-right)	Toca para encender / apagar
Footer	Botón "Registro manual" para casos sin QR

Permisos de cámara

La primera vez la app pedirá permiso para usar la cámara. Si lo niegas, verás el botón "Solicitar permiso" para activarlo desde los ajustes del sistema.

Flujo de escaneo

Visitante muestra QR → Cámara lo detecta → "Validando permiso..." → Resultado → Registrar entrada

Paso a paso

Paso	Acción
1	Apunta la cámara al QR del visitante
2	La app detecta automáticamente (no hay botón "capturar")
3	Aparece el modal "Validando permiso..."
4	La app consulta el servidor para validar
5	Aparece el resultado: Acceso Autorizado o Acceso Denegado

Resultado: Acceso Autorizado

Verás una alerta verde con la confirmación. Datos visibles:

Campo	Descripción
Nombre del visitante	El que capturó el residente
Tipo de permiso	Único / Temporal / Frecuente / Proveedor
Otros datos	Vehículo, motivo (si están en el permiso)

Opciones:

Botón	Acción
Registrar entrada	Guarda el acceso con método QR
Escanear otro	Vuelve al escáner sin registrar

Resultado: Acceso Denegado

Verás una alerta roja. Posibles motivos:

Motivo	Significado
Expirado	El permiso pasó su fecha "Válido hasta"
Ya usado	Un permiso Único que ya se consumió o se agotaron las entradas
Cancelado	El residente canceló el permiso
No reconocido	El QR no corresponde a un permiso del coto

Para resolver, puedes:

• Pedirle al visitante que llame al residente
• Crear un registro manual del visitante (ver Registrar visitantes)

Cooldowns

Para evitar errores de doble escaneo, la app implementa cooldowns automáticos:

Tipo	Tiempo
Entre escaneos consecutivos	2 segundos
Mismo código repetido	5 segundos

Durante el cooldown verás el modal de procesamiento que evita registros duplicados.

Tipos de permiso que puedes ver

Tipo	Cuándo aparece
Único	Visita ocasional, una sola entrada
Temporal	Vigencia personalizada con o sin máximo de entradas
Frecuente	Personas recurrentes (empleada, niñera)
Proveedor	Servicios recurrentes (gas, jardinería)
Visita / Delivery / Servicio	Variantes que puede usar el sistema

Registrar salida

Cuando un visitante se retira, el flujo recomendado es usar Registro manual y seleccionar tipo "Salida". Ver la guía de Registrar visitantes.

Próximamente

• Registrar salida directamente desde el escaneo del mismo QR
• Modo offline para validar QRs sin conexión a internet
• Lector de QR físico integrado (si la caseta tiene hardware)

Solución de problemas

Problema	Acción
La cámara no enciende	Revisa permiso del sistema operativo
El QR no se lee	Pide al visitante limpiar pantalla / aumentar brillo
QR válido pero "Acceso Denegado"	Verifica la hora del dispositivo y conexión a internet
Lecturas duplicadas	Espera el cooldown automático (2-5 segundos)

Siguiente paso

Aprende a registrar visitantes manualmente cuando no traen QR.