Web scanner — escanear desde el navegador — Documentación Ticketera

Usar la cámara del celular para validar QRs de entrada desde cualquier navegador moderno, sin app ni hardware especial.

Introducción

El validador web de Ticketera es la herramienta que usan los scanners en puerta. Funciona desde el navegador de cualquier celular o tablet (Android o iOS) con cámara y conexión a internet. No requiere instalar nada.

Esta página explica cómo abrirlo, qué ve cuando escanea, y cómo interpretar cada resultado.

Requisitos

Celular o tablet (mejor celular — más práctico para mover).
Chrome, Safari o Firefox reciente.
HTTPS obligatorio: los navegadores bloquean el acceso a cámara en HTTP (con excepción de localhost para dev). ticketera.com usa HTTPS así que esto ya está cubierto.
Permiso de cámara otorgado al sitio.
Conexión a internet activa (o modo offline, ver siguiente página).

Abrir el validador

Ir al scanner

El scanner se loguea en ticketera.com/login con su email y password (o link mágico).
Accede al validador navegando a /dashboard/scanner o haciendo clic en el evento desde el menú lateral.
Si está invitado a varios eventos activos, el sistema le pide elegir a cuál validar. Si solo está en uno, entra directo.
La pantalla muestra el título "Validar entradas en puerta" con descripción "Escaneá el QR de cada asistente para validar su entrada".
Hace clic en Iniciar escáner. El navegador pide permiso para usar la cámara — el scanner le da OK.
El feed de la cámara aparece en vivo con un cuadro verde o blanco donde tiene que apuntar el QR.

Qué ve en cada escaneo

Cuando el scanner apunta la cámara a un QR, el sistema lo detecta automáticamente (no hay que tirar foto ni tocar botón). En menos de un segundo aparece un resultado:

QR válido

Pantalla completa con fondo verde (overlay que cubre toda la vista).
Ícono grande de tilde + texto: "VÁLIDO".
Datos del ticket:
- Tipo: ej General, VIP.
- Comprador: nombre completo.
- DNI (si el comprador lo cargó al pagar).
Vibración corta del celular (feedback háptico).
El ticket queda marcado como Usado. El próximo intento de escanear el mismo QR lo rechaza.

QR inválido — distintos motivos

Mensaje	Causa
Ya fue utilizado (usado: HH:MM:SS)	Alguien ya validó ese QR antes. Muestra cuándo.
Ticket de otro evento	El QR corresponde a un evento distinto al que estás validando.
Ticket para otra función	El QR es del mismo evento pero de una ocurrencia distinta (en eventos recurrentes).
QR no encontrado	No existe ese QR en la base (truco conocido, falsificación).
Ticket no válido (estado: X)	El ticket fue cancelado o reembolsado.
El escaneo se habilita 2 horas antes del evento	Estás tratando de validar antes de la ventana de ingreso.

En cada rechazo:

Pantalla completa con fondo rojo.
Ícono grande de X + texto: "INVÁLIDO".
Motivo del rechazo visible.
Vibración distinta (patrón de error).

Screenshot pendiente — Resultado de validación válida con datos del comprador

Ventana de escaneo

El sistema habilita el escaneo automáticamente 2 horas antes del inicio del evento. Si intentás escanear antes, cualquier QR se rechaza con "El escaneo se habilita 2 horas antes del evento".

Esto evita validaciones accidentales durante pruebas previas al evento. Si necesitás escanear antes (ej: para hacer un test piloto la semana anterior), escribinos a soporte@ticketera.com.ar y el equipo habilita una ventana extendida para tu evento.

Consejos operativos

Luz y estabilidad

Luz buena: si la puerta está muy oscura, poné un foco apuntando hacia donde el QR va a estar. Los QR mal iluminados tardan más o directamente no se leen.
Distancia: 15-30 cm entre cámara y QR funciona bien. Muy cerca desenfoca.
Pantalla brillo al máximo: si el comprador muestra el QR desde su celular con brillo bajo, pedile que suba el brillo.
QR arrugado o sucio: imprimí tu propio stand con instrucciones básicas para que el comprador prepare el QR antes de llegar a la cola.

Volumen alto

Un scanner mediano procesa ~1 QR cada 2-3 segundos, ~1.200-1.800 entradas/hora.
Para eventos con pico de entrada (3.000+ en 30 min), usá múltiples puertas con múltiples scanners en paralelo.
Monitoreá en vivo desde Ingresos cuántos van entrando por puerta.

Duplicados / QRs sospechosos

Si un QR aparece como "Ya fue utilizado" y la persona insiste que es la primera vez:

Mirá la hora de uso. Si es de hace minutos, puede ser otro asistente que usó el QR antes (screenshot, transferencia no autorizada).
Verificá el nombre del comprador — si el nombre no coincide, es casi seguro un QR "robado".
Decidí según tu política: dejar pasar (si sospechás que el primer ingreso fue accidental), o denegar acceso.

Preguntas frecuentes

¿Necesita instalar algo?

No. Solo abrir ticketera.com/login en el navegador. Opcional: agregar a la pantalla de inicio del celular como acceso directo.

¿Consume muchos datos del celular?

Muy poco — cada validación manda unos pocos bytes al servidor. Incluso escaneando cientos de entradas en un evento, el consumo de datos es insignificante. Lo que sí consume batería es la cámara.

La cámara se apaga sola después de un rato

Los celulares apagan cámara/pantalla por ahorro de batería. Si el scanner va a estar 2-3 horas validando, pedile que desactive el auto-bloqueo o que mueva la pantalla cada tanto. O que tenga cargador conectado.

¿Se puede escanear con la cámara frontal?

Por ahora se usa por default la cámara trasera. La frontal es posible pero ergonómicamente peor.

El QR del comprador está impreso y no lo lee

Asegurate de: buena luz, contraste alto (QR negro sobre papel blanco funciona mejor que color), QR no muy chico (mayor a 3 cm de lado). Si persiste, pedile al comprador que muestre el QR desde el email o /my-tickets.

¿Se puede usar el mismo celular para varios turnos de scanner?

Sí. Al final del turno, el scanner hace logout y el próximo se loguea con su cuenta. Cada escaneo queda trackeado con el usuario que lo hizo.

Siguientes pasos

Modo offline — qué pasa si se cae internet.
Monitorear accesos en vivo — dashboard con el conteo de ingresos.
Invitar scanners — dar de alta nuevos scanners.