Guía del escaneador: validar entradas y retiros

Si sos escaneador, tu trabajo es validar QR. Hay dos casos según lo que tengas que controlar.

Al iniciar sesión entrás directo a escanear, sin pasar por la pantalla de bienvenida. En la puerta te pregunta primero qué vas a leer con tres botones grandes —ENTRADAS (rojo), CONSUMICIONES (blanco) y MESAS (dorado)— y lo que elijas queda hasta que toques ← Cambiar, arriba a la izquierda. En la barra (gastro) vas directo a la cámara de pedidos. Tu pantalla de inicio (invitaciones, estadísticas, ayuda) sigue en el menú de arriba a la derecha.

1. Entradas en la puerta (rol scanner)

1. Elegí ENTRADAS y escaneá el QR de cada entrada.
2. Si el QR no lee, validá a mano en Validación manual: un solo campo donde escribís el nombre, el mail, el teléfono, el DNI (con o sin puntos) o el código de un pedido, y la pantalla se da cuenta sola. Cada entrada sale en un renglón con su estado («no entró todavía», «entró 23:41») y el botón Validar al costado.

El resultado sale arriba, con un color y una forma para leerlo de lejos: ADELANTE (verde, círculo), YA ENTRÓ (rojo, con un reloj: dice a qué hora entró y quién la escaneó), NO PASA (rojo, octógono: anulada, reembolsada, vencida o no existe), NO ES DE ACÁ (ámbar, triángulo: es de otro evento, con Cambiar evento ahí mismo) y No se pudo validar (gris, con Reintentar y Validación manual). El detalle está en la guía «Escanear entradas en la puerta».

Si sobre la cámara aparece «El lector no cargó» o «El lector dejó de leer», tocá Reintentar lector (la cámara no se reinicia); si sigue igual, usá Validación manual desde el mismo aviso. Pasa lo mismo en la pantalla de la barra, donde el aviso te lleva a la validación manual de la barra. Si dice que el lector está tardando, podés prender la cámara igual: apenas carga, lee solo. Si dice que esta versión de la app no puede leer QR, validá a mano y avisale a soporte.

Si lo que falla es la cámara —«Permiso de cámara denegado», «Cámara ya está en uso por otra aplicación», «La cámara no entrega imagen» o «La cámara se cortó»—, el aviso también aparece sobre la cámara, en la puerta y en la barra: tocá Reintentar cámara o usá Validación manual, que están ahí mismo. Si pasa con un resultado en pantalla, lo ves al tocar Escanear otra entrada (puerta) o Siguiente pedido (barra).

En la Validación manual de la puerta, como en la de la barra, hay un solo campo y un solo botón. Ahí también va el código del pedido de consumiciones, el que la persona ve en su pantalla (#4821, o #JTF5JY en las consumiciones que vienen incluidas con la entrada): escribilo tal cual lo ve, con el #. El cursor ya está en el campo, así que si usás un lector de códigos podés disparar directo.

Ese criterio busca consumiciones, no entradas: una entrada no tiene número de pedido. Y ojo con el código corto tipo #4821: es un número que arranca de cero cada noche, así que sólo se busca dentro de la jornada en curso. Si el pedido es de otra noche, buscalo por el número largo del voucher o por el nombre.

Estadísticas: cuántos entraron y cuántos faltan (rol scanner)

En el menú → Estadísticas ves la noche en vivo, con dos solapas. Se actualiza sola cada 30 segundos y arranca en el evento que estás escaneando.

• Entradas: cuántos faltan entrar (y cuántos de esos se vendieron en boletería), cuántos entraron, y cuánto falta para llenar el lugar si el dueño cargó la capacidad. Abajo, cada tipo de entrada por separado: entraron, faltan, cuántas son invitaciones, y cuántas quedan a la venta. También el ritmo (cuántos entraron en los últimos 15 minutos y en la última hora) y quién escaneó.
• Consumiciones: cuántos pedidos faltan entregar, cuáles están a medias, y la lista de todos los productos con lo que falta entregar de cada uno (con buscador). Los vales de regalo que mandó el club van en un renglón aparte, «Vales: X de N retirados»: no son pedidos pendientes hasta que la persona los pide desde su teléfono.

Las entradas de una tanda que ya venció aparecen aparte («ya no pasan») y no cuentan en «faltan entrar». Si no carga la lista de eventos (poca señal), tocá Reintentar. Kicket cuenta los que entraron: no sabe quién se fue. El escaneador ve sólo cantidades, nunca plata.

2. Retiro de consumiciones (scanner y gastro_scanner)

Los dos roles leen el mismo QR, pero no ven la misma pantalla: la de la barra (gastro_scanner) se rehízo y la de la puerta (rol scanner, en Escanear → Consumiciones) sigue con su tarjeta, aunque arriba lleva el mismo resultado de colores que las entradas. Lo común:

1. Andá a Escanear y escaneá el QR del pedido.
2. Revisá producto por producto lo que estás entregando.
3. Confirmá. Soporta retiro parcial: si entregás 2 de 3, queda registrado y lo que falta se retira después con el mismo QR.

La cámara arranca apagada: tocá Escanear para prenderla. Queda prendida entre pedido y pedido y se apaga sola si pasan 40 segundos sin leer nada (vuelve el botón Escanear; también la prende el botón con el que salís del pedido: Siguiente pedido en la barra, Escanear otra consumición en la puerta). Si la imagen se traba mientras esperás el pedido siguiente, se reabre sola en un par de segundos, sin que toques nada; con un pedido en pantalla la reabre ese mismo botón. Si el QR del pedido que acabás de abrir sigue frente a la cámara, no se vuelve a abrir solo, ni aunque la cámara se haya apagado y la vuelvas a prender, ni aunque hayas ido a Validación manual y vuelvas (se libera 10 segundos de cámara prendida después de salir de cuadro, o cuando leés otro pedido). La pantalla no te lo dice: simplemente no lo abre, así no le entregás dos veces a la misma persona. Para abrirlo a propósito: en la barra, escribí su código en Validación manual; en la puerta, en Consumiciones, tocá Leer de nuevo esta orden, debajo de la cámara.

Con la hoja del pedido (o su confirmación) abierta, el botón atrás del teléfono la cierra como Siguiente pedido / Volver, sin entregar nada; recién el atrás siguiente sale de la pantalla.

Es importante que lo que confirmás sea todo lo que le diste a la persona — si dejás algo sin marcar, el pedido queda como entregado a medias y sigue apareciendo como pendiente (por ejemplo, en Pedidos Programados).

Si mientras tenías el pedido abierto alguien lo editó desde la caja (le sacó o le cambió un producto), al confirmar no se registra nada y la pantalla te avisa: «No se registró la entrega: el pedido cambió mientras lo marcabas. Volvé a mirar la lista.». Volvé a mirar el pedido —la lista se actualiza sola con lo que quedó— antes de darle nada a la persona. Vale en las cuatro pantallas desde las que se entrega: la cámara de la puerta, la cámara de la barra y las dos de Validación manual. Es lo que evita que lo que marcaste se descuente del producto que quedó en ese lugar de la lista.

En Validación manual el aviso sale verde cuando la entrega entró y rojo cuando no (y el rojo queda más tiempo en pantalla, para que te dé tiempo a leerlo con la barra llena). Y si justo se corta la conexión al confirmar, dice «No se pudo confirmar: puede que se haya entregado. Volvé a buscar el pedido antes de dar nada»: no lo entregues de nuevo sin mirar, porque puede haber quedado registrado.

En la puerta (rol scanner)

En Consumiciones, la orden abre en la misma hoja de entrega que la barra (la de más abajo): a pantalla completa, con el código y el nombre, lo que hay que entregar y el botón que dice cuánto («Entregar 2 · queda 1»); ese botón abre la confirmación («LE ENTREGÁS AHORA / LE QUEDA PENDIENTE») y recién «Sí, entregar 2» lo registra. La puerta no es ninguna barra, así que ahí nada sale «de otra barra». Después sale ENTREGADO a pantalla completa con Siguiente pedido y, si quedó algo, Entregar lo que falta. Un pedido que no se entrega (no está pago, anulado, ya se entregó) sale en rojo NO ENTREGAR con el motivo. Si la entrega no se pudo confirmar (se cortó la conexión), sale el gris «Puede que se haya entregado»: no entregues de nuevo, tocá Reintentar, que vuelve a leer el pedido y te muestra cómo quedó. Los créditos de consumo (los que vienen con la entrada) se abren como una mesa: el saldo grande y Cobrar un consumo (descontar un monto o canjear de la carta); después dice CANJE HECHO o DESCONTADO, y si el descuento es mayor que el saldo, NO ALCANZA sin descontar nada. ADELANTE es sólo para las entradas: una consumición o una mesa nunca lo dicen (la mesa cobrada dice COBRADO).

En la barra (rol gastro_scanner)

La cámara

La cámara ocupa toda la pantalla. Arriba a la izquierda, si tu local tiene barras cargadas, está tu barra; arriba a la derecha, el menú, para ir a las otras secciones. Abajo, Escanear y Validación manual: lo que se toca queda donde llega el pulgar.

Cuántas entregaste hoy

Al lado del menú vas viendo cuántas entregas hiciste hoy desde ese teléfono: el número grande y, abajo, «hoy» (con un lector de pantalla se escucha completo: «12 entregas hoy en este aparato»). Suma una por cada entrega que la pantalla te dio por hecha, aunque sea una parte del pedido: el verde ENTREGADO, o la hoja que vuelve diciendo «Se entregó lo que marcaste». También suman las que hacés desde la lista de Validación manual. Lo que la pantalla no te dio por entregado no suma, sin excepciones: si sale NO ENTREGAR, NO ES DE ACÁ o No se pudo validar, el número no cambia. Y si después de No se pudo validar tocás Reintentar y el pedido figura entregado, sale en rojo «Ya se entregó» y tampoco suma: el teléfono no puede saber si lo entregaste vos o alguien con la misma cuenta desde otro teléfono. Vuelve a cero a las 6 de la mañana, así una noche que pasa la medianoche es una sola jornada. Es la cuenta de ese teléfono, no la de toda la barra: si en la barra hay dos teléfonos, cada uno cuenta lo suyo. Queda guardada en el teléfono aunque recargues la página; si el navegador no deja guardar datos (una ventana privada, por ejemplo), cuenta igual pero vuelve a cero al recargar.

En qué barra estás

Tocá el aviso de arriba a la izquierda y elegí en qué barra estás. Queda guardado en ese teléfono (no en tu cuenta): lo elegís una vez y lo cambiás cuando quieras, en dos toques. Mientras el selector está abierto la cámara no abre ningún pedido, así que nada se te mete por atrás.

Con la barra elegida, un pedido que se retira en otra barra sale en ámbar («NO ES DE ACÁ · Se retira en Adentro») y lo que es de la otra barra aparece apagado en la hoja, sin poder marcarlo: así no le entregás algo que la persona ya pagó para retirar del otro lado.

Mientras no hayas elegido, el aviso está en amarillo con un punto que late y dice «Sin asignar». «Sin asignar» también es una opción —si en tu local hay una sola barra o vos atendés todas, elegila y el punto deja de latir—, pero no es neutra: sin barra elegida no te vamos a avisar cuando un pedido sea de otra barra, y podés entregar algo del otro puesto sin enterarte. Si tu local no tiene barras cargadas, no aparece ningún aviso: no hay a dónde mandar a nadie.

Si el aviso dice «Sin barra», es que el teléfono no pudo traer la lista de barras (se cortó internet, o falló algo de nuestro lado). En ese caso aparece además, arriba de la cámara, un cartel ámbar: «No pudimos cargar los puntos de retiro · No te vamos a avisar cuando un pedido sea de otra barra.», con el botón Reintentar (dice «Reintentando…» mientras carga). Tocá Reintentar (o el aviso de arriba a la izquierda) y, cuando la lista llegue, elegís la tuya. Hasta que vuelva, fijate vos que lo que entregás sea de tu barra.

Si tu local trabaja con puntos de retiro (la comida en un lado, la bebida en otro, con un solo QR), cómo se arman y qué ve el cliente está en Puntos de retiro.

Con las manos ocupadas: el cliente desliza

Si no podés agarrar el teléfono para escanear, el cliente puede deslizar en la pantalla de su pedido («¿No te pueden escanear?»). Le aparece ENTREGADO en verde con su número de pedido, lo que retira y la hora corriendo: si te la muestra así, ya está registrado y le das lo que dice. Una pantalla gris («Ya retirado») o quieta (una captura) no vale. Lo que desliza el cliente no suma a tu contador. El detalle está en Retirar sin escanear.

Sin QR: el código del pedido

Si el cliente no puede mostrarte el QR, tocá Validación manual: hay un solo campo, con el cursor ya puesto, y un solo botón. Escribí el número que él ve en su teléfono (#4801, con o sin #; en las consumiciones que vienen incluidas con la entrada son letras y números, como #JTF5JY) y tocá Buscar —o disparalo con un lector de códigos— y el pedido se abre como si lo hubieras escaneado. El número corto se busca entre los pedidos de hoy de tu local: si es de otra noche o de otro local, no lo va a encontrar.

Si no tiene el número, escribí en ese mismo campo su email, teléfono, nombre o DNI: no hay que elegir nada, la pantalla se da cuenta sola de qué escribiste y te muestra sus pedidos abajo, uno por renglón: el número y el nombre, lo que le falta («Fernet ×2 · Agua ×1») y cómo está («queda 1 de 3», «en cocina», «entregado»). Tocá Entregar, a la derecha del renglón, y se abre la misma hoja que cuando escaneás, con su confirmación; al pie de la hoja está también Entregar Todo, que te pregunta antes qué y cuánto vas a dar. ⚠️ Esa hoja, la que abrís desde la lista, no sabe en qué barra estás: te deja marcar también lo que se retira en otra barra, y Entregar Todo entrega el pedido entero, de todas las barras. Si tenés el número del pedido, escribilo arriba en vez de buscar por persona: así se abre con tu barra, como cuando escaneás. Un pedido anulado o sin pagar no tiene el botón. Uno ya entregado dice cuándo y quién lo dio. El crédito de consumo que vino con la entrada dice cuánto le queda («quedan $8.000») y tampoco tiene Entregar: se canjea escaneándolo. Esa entrega, la de la lista, se confirma con un cartelito arriba: no pinta la pantalla ni suena, como sí pasa cuando el pedido se abre escaneando.

Qué ves al abrir el pedido

• La hoja del pedido ocupa toda la pantalla: arriba el código (#4801) y para quién es, y abajo lo que hay que entregar. No muestra el total ni la fecha: para armar la bandeja no sirven.
• Si el pedido tiene una sola cosa y nada para leer, abre ya marcado y lo entregás de un toque. Si tiene varias líneas, o alguna trae una aclaración, una opción o un adicional, abre sin marcar: tocá cada línea a medida que la ponés. El − y el + sirven para entregar menos unidades de una línea.
• Lo que pidió el cliente («Sin hielo», «Sin cebolla») se destaca en una etiqueta oscura: es lo que más se olvida con la barra llena. El nombre del producto se ve siempre completo, nunca cortado con «…»: si es muy largo usa dos renglones, o tres.
• Lo que está en cocina no se marca tocándolo. Si cocina ya te lo dio en mano, tocá la línea una vez (te lo pregunta) y otra vez para confirmar: «Cocina ya me lo dio · entregar igual». Lo que nadie mandó a cocina lleva su propio aviso, «No se mandó a cocina».
• El botón dice qué va a pasar: «Entregar los 2» cuando el pedido va entero, «Entregar 2 · queda 1» cuando la persona se va con algo sin retirar. Ese «queda 1» cuenta todo lo que le falta al pedido, esté en tu barra, en cocina o en otra barra. Con nada marcado dice «Marcá lo que entregás». Al tocarlo te muestra la confirmación — hasta ahí no se registró nada. Dice a quién (#4807 · Cliente), qué le entregás ahora (con lo que pidió a la vista: sus notas, los adicionales y la aclaración del pedido) y, si no va todo, qué le queda pendiente. Sí, entregar 2 lo registra; con Volver vas a la hoja con lo que ya habías marcado.
• Si es un envío, la hoja muestra la dirección y, cuando el envío no se cobró antes, «Cobrar $X del envío al entregar»: es el único momento en que esa plata se cobra.
• Si el pedido entró por una app de delivery, lo que la app mandó y no está en tu carta sale aparte, en «Sin vincular · entregarlo igual»: ponelo en la bolsa igual.
• Lo que ya se entregó entero aparece al pie, apagado, en «Ya entregado», con la hora en que salió («✓ 1× Hamburguesa · 13:42»). Es para mirar: no se marca ni se vuelve a entregar. Sirve sobre todo cuando el pedido se retira por partes en dos barras: en la segunda ves lo que la persona ya se llevó de la primera. No dice en qué barra se entregó, porque eso no queda registrado. Lo que se dio a medias sigue arriba, con «Ya se entregaron 1 de 3». Este bloque sale igual en la puerta y en la hoja que abrís desde Validación manual.

El resultado

Después de confirmar, la pantalla se pinta entera de un color, con su forma, para que lo leas de lejos. Cuando se sabe de quién es el pedido, abajo dice a quién (#4801 · Cliente): si te distraés, sabés a cuál de los que esperan le corresponde.

El resultado también suena y vibra, para que no tengas que estar mirando el teléfono: ENTREGADO hace dos notas cortas que suben, con un golpecito; NO ENTREGAR y NO ES DE ACÁ suenan grave (el mismo sonido de error) y vibran distinto entre sí; el gris no suena —no hay nada resuelto— pero vibra largo. Abrir el pedido no hace ruido, y leer el QR ya no hace «bip» —ni en la barra ni en la puerta—: el único sonido es el del resultado. Si el teléfono está en silencio, o es un iPhone (que en el navegador no vibra), te quedan el color y la forma de siempre. Si un resultado sale sin sonido, tocá cualquier botón de la pantalla (por ejemplo, Siguiente pedido): desde ahí vuelve a sonar.

• Verde, círculo ✓ — ENTREGADO. Si quedó algo pendiente te lo dice, y si una parte se retira en otra barra lo suma al final: «Lo demás se retira en Barra B» (mandá a la persona para allá). Con Entregar lo que falta seguís en un toque, sin volver a escanear, pero ese botón aparece sólo si queda algo que puedas dar vos (algo de tu barra, o algo que está en cocina). Si todo lo que falta es de otra barra, no aparece: de tu lado ya no hay nada para dar.
• Rojo, octógono ✕ — NO ENTREGAR. Ya se entregó, está anulado, no está pago o no existe. Abajo, en chico, el motivo (y la hora y quién lo escaneó, si ya se había entregado). Si lo marcó el propio cliente deslizando en su teléfono, dice «Lo marcó el cliente desde su teléfono» (ver Retirar sin escanear).
• Ámbar, triángulo — NO ES DE ACÁ. O el pedido es de otro comercio (ahí no se muestra de quién es), o se retira entero en otra barra y te dice en cuál («Se retira en Adentro»): mandá a la persona para allá. Si el pedido tiene algo tuyo, no sale ámbar — abre la hoja con lo que sí podés entregar.
• Gris, cuadrado ? — No se pudo validar. Se cortó algo y puede que haya entrado: no lo entregues dos veces. Tiene dos salidas y ninguna es seguir de largo: Reintentar, que vuelve a leer el pedido y te muestra cómo quedó, o Validación manual, desde donde volvés a escanear con Volver a escanear. Esas dos pantallas andan aunque se haya cortado la señal: Validación manual abre (buscar ahí sí necesita señal) y Volver a escanear te deja en la cámara. Si la señal lleva varios minutos cortada, puede que el teléfono te muestre «Sin conexión»: cuando vuelva, tocá Reintentar ahí. Para retomar ese mismo pedido cuando vuelva la señal, lo más directo es escribir su número en Validación manual. El gris no dice a quién: si no se pudo validar, tampoco sabemos de quién es.

Del verde, el rojo y el ámbar salís con Siguiente pedido (el gris, con sus dos botones). Tocar fuera no cierra nada: el resultado se lee y se sale a propósito.

Si la búsqueda del pedido tarda, en «Buscando el pedido…» está Cancelar, abajo, que te vuelve a la cámara: aunque el cliente siga mostrando el QR, ese pedido no se vuelve a abrir solo; para abrirlo a propósito escribí su código en Validación manual. Revisando el pedido… —lo que ves después de Reintentar o de Entregar lo que falta— también tiene su Cancelar, y te deja en la cámara. Si el pedido no se encuentra, con el mismo QR adelante tampoco se vuelve a buscar solo (para no quedarse probando el mismo código): si querés reintentar, pedile al cliente el número del pedido que ve en su teléfono (no el QR) y escribilo en Validación manual. Con el gris (se cortó la conexión) depende de en qué momento: si se cortó al buscar el pedido, cuando vuelvas a la cámara el mismo QR se vuelve a leer solo; si se cortó al entregar, ese QR ya había abierto el pedido y no lo vuelve a abrir mientras el cliente lo siga mostrando (es lo que evita entregar dos veces): escribí su número en Validación manual, o, con la cámara prendida, pedile que lo saque de cuadro unos 10 segundos y lo vuelva a mostrar.

Quién valida qué

• El rol scanner valida entradas de puerta y también órdenes de consumo.
• El gastro_scanner solo valida órdenes de consumo, no entradas de puerta.

Tip: en el retiro parcial, marcá exactamente lo que entregaste. Lo que quede sin entregar sigue disponible con el mismo QR para retirarlo más tarde.