Documentación / Guías / Escanear entradas
Especificación del protocoloReferencia de la APIGuías
Documentación / Guías / Escanear entradas
GUIDE · V1

Escanear entradas

Escaneo con cámara, resultados de validación, flujo de registro

Abrir el escáner

Toque Escanear entradas desde la pantalla de inicio para abrir el escáner de cámara.

Si es la primera vez, la aplicación le pedirá permiso de acceso a la cámara. Debe concederlo para usar el escáner.

Vista de cámara

El escáner muestra:

  • Imagen de cámara a pantalla completa
  • Un marco superpuesto que indica dónde apuntar
  • Un contador de escaneos de sesión en la parte inferior (por ejemplo, "5 escaneados")
  • Un botón de cerrar en la esquina superior

Escanear un QR code

  1. Apunte la cámara a un QR code de entrada
  2. El código se detecta automáticamente
  3. Una vibración háptica confirma la detección
  4. Aparece el modal de resultado

Un tiempo de espera de 3 segundos evita que el mismo QR code se escanee dos veces en rápida sucesión.

Después del escaneo, un modal muestra el resultado de la validación.

Icono de estado

La parte superior del modal muestra un círculo de color con un icono:

  • Círculo verde con marca de verificación para entradas válidas
  • Círculo ámbar con triángulo de advertencia para condiciones de advertencia
  • Círculo rojo con X para errores

Detalles de la entrada

Si el QR code contiene datos de entrada válidos, el modal muestra:

Campo Descripción
Titular Nombre del titular de la entrada
Tipo Tipo de entrada (por ejemplo, "Admisión General")
Evento Nombre del evento
Fecha Fecha y hora del evento
Registrado a las Hora del registro anterior (solo para entradas ya utilizadas)

Estados del resultado del escaneo

Estado Icono Color Significado
Entrada válida Marca de verificación Verde La entrada es válida y está lista para registrar
Ya registrada Advertencia Ámbar La entrada ya fue escaneada; se muestra la hora del registro
Entrada revocada X Rojo La entrada ha sido revocada por el organizador
Entrada expirada Advertencia Ámbar La fecha de expiración de la entrada ha pasado
Evento incorrecto Advertencia Ámbar La entrada es para un evento diferente al de los inscritos en este escáner
Entrada no encontrada X Rojo El ID de la entrada no es reconocido por el servidor
Entrada no válida X Rojo La verificación de firma digital falló (posible falsificación)
QR code no válido X Rojo El QR code no tiene un formato de entrada válido
No inscrito Advertencia Ámbar El escáner no está inscrito para el evento de esta entrada. Se muestra el nombre del evento
Emisor desconocido Advertencia Ámbar No se encontró la clave pública del emisor; no se puede verificar la firma
Ya usada (local) Advertencia Ámbar Ya escaneada localmente en esta sesión (detección de duplicados sin conexión)
Puerta incorrecta Advertencia Ámbar La entrada es válida pero no está asignada a la puerta de este escáner

Flujo de registro

Cuando una entrada es Válida:

  1. El modal muestra los detalles de la entrada y un botón Marcar como usada
  2. Toque Marcar como usada para registrar la entrada del asistente
  3. La aplicación envía el registro al servidor
  4. En caso de éxito: vibración háptica verde, el modal se cierra y el contador de escaneos se incrementa
  5. Si no desea registrar la entrada, toque Cancelar para cerrar el modal

Para todos los demás estados, el modal muestra un botón Cerrar para descartar y continuar escaneando.

Registro sin conexión

Si el servidor no es accesible cuando toca Marcar como usada:

  1. El registro se pone en cola localmente
  2. El modal muestra "Admitido (pendiente de sincronización)"
  3. La vibración háptica verde confirma la admisión
  4. El registro se guarda en el historial de escaneos local con estado "Pendiente de sincronización"

El registro en cola se sincronizará automáticamente cuando se restaure la conectividad. Consulte Modo sin conexión para más detalles.

Consejos

  • Mantenga el teléfono estable a unos 15-20 cm del QR code para mejores resultados
  • Asegure una iluminación adecuada; la cámara necesita ver claramente el QR code
  • Si un QR code no se detecta, intente ajustar el ángulo o la distancia
  • El contador de sesión se reinicia cada vez que sale y vuelve a entrar al escáner