Operar el gestor¶
El gestor es el panel web donde el equipo de Caracol administra toda la campaña: la campaña en sí, los premios, los sorteos, los ganadores y sus entregas, el padrón de clientes y el rastreo de vouchers. Esta página lo recorre de punta a punta, sección por sección, con la captura de cada pantalla.
No hace falta memorizar nada
Cada sección de esta página corresponde a una pestaña o pantalla del gestor. Podés usarla como referencia: buscá la sección que necesitás en el momento en que la necesitás.
Acceso¶
Entrás al gestor con usuario y contraseña. Es un panel autenticado — no es la landing anónima que usa el cliente — así que solo entra personal de Caracol autorizado.
Panel¶
Al entrar, el panel te muestra un resumen del estado de la campaña de un vistazo:
| Métrica | Qué significa |
|---|---|
| Chances totales | Cuántas participaciones válidas se registraron en toda la campaña (cada voucher escaneado y confirmado suma una). |
| Clientes únicos | Cuántas personas distintas (por DNI) participaron, sin importar cuántas chances tenga cada una. |
| Topes (alcanzados) | Cuántas veces un cliente llegó al límite diario de chances (5 por DNI por día de emisión) y un voucher se rechazó sin consumirse. |
| Rechazos por motivo | Desglose de los vouchers que no sumaron chance: firma inválida, ya usado, fuera de vigencia, tope diario. Es tu primer lugar para investigar un reclamo de "el QR no me anda". |
| Tabla de sorteos | Los sorteos de la campaña con su estado (pendiente / ejecutado) y fecha. |
Para dar soporte, empezá acá
Si un cliente dice que tuvo un problema al escanear, el desglose de rechazos por motivo te dice de entrada si fue un caso puntual o algo más generalizado. El detalle de cómo investigar un voucher específico está en Dar soporte a clientes.
Campaña¶
La pantalla de campaña muestra los datos generales de "Sorteo 50 años": vigencia, los textos que se ven en la landing, la regla de chances (1 voucher = 1 chance), el tope diario y la versión de las bases vigentes.
Solo puede haber una campaña vigente
El sistema garantiza que exista una única campaña activa a la vez. Los textos que cargués acá (nombre, descripción) se reflejan directo en la landing sin necesidad de tocar código — así se puede lanzar una promo nueva sin depender de un despliegue.
Premios¶
Acá se cargan los tipos de premio, se controla el stock disponible y se asignan a cada sorteo.
Los pasos habituales son:
- Cargar un tipo de premio: nombre y cantidad (por ejemplo, "Bicicleta playera × 10"). El sistema genera automáticamente cada unidad individual del lote.
- Asignar unidades a un sorteo futuro, con su prelación — el orden en el que se van a repartir según el orden en que salga sorteada cada persona (primer sorteado se lleva el premio de prelación 1, y así sucesivamente).
- Repartir automáticamente: reparte el stock en partes iguales entre las semanas como punto de partida. Es un atajo, no una decisión final — la asignación y la prelación definitiva siempre las termina de ajustar el operador.
Cada unidad de premio recorre un ciclo de vida: Disponible → Asignado → Sorteado → Otorgado (entregado), con un estado terminal aparte, No otorgado, para cuando un premio no se puede entregar. El detalle completo de ese ciclo está en Premios y su ciclo de vida.
Sorteos¶
La lista de sorteos muestra cada sorteo semanal y el de cierre, con su estado y la acción de ejecutar.
Ejecutar un sorteo es irreversible
El sorteo se ejecuta manualmente desde acá — nunca hay un disparador automático por hora o fecha, para que siempre haya una persona a cargo del momento exacto. Por eso el botón Ejecutar pide doble confirmación antes de correr: una vez ejecutado, el resultado queda en un acta inmutable. No existe un "reejecutar" — un error de campaña ya sorteada se corrige por decisión humana documentada, no reiniciando el sorteo.
Para el paso a paso completo (qué revisar antes de ejecutar, cómo elegir el sorteo correcto), ver Ejecutar un sorteo.
Acta¶
Cada sorteo ejecutado genera un acta: el registro inmutable y reproducible de esa ejecución. Contiene la semilla (seed) usada, el algoritmo y versión, un hash de la lista de elegibles, y el resultado ordenado con ganadores y suplentes.
- Reproducible: la misma lista de elegibles + la misma semilla + el mismo algoritmo siempre dan el mismo resultado. Eso es lo que hace que el acta sea auditable — cualquiera puede reproducir el sorteo y llegar a los mismos ganadores.
- Descargar: podés bajar el acta en CSV, en JSON o mandarla directo a imprimir, según para qué la necesites (un reporte interno, un respaldo, o entregarla en papel).
El acta no cambia, aunque cambie la entrega
Lo que salió sorteado en el acta (el premio original de cada ganador) queda congelado para siempre, aunque después ese premio pase a un suplente o se devuelva al stock. El acta separa claramente "lo sorteado" (inmutable, tu registro legal del sorteo) de "el estado de entrega" (que sí evoluciona con el tiempo). Si exportás la misma acta dos veces en momentos distintos, la parte del sorteo es idéntica; la parte de entrega puede diferir.
Ganadores¶
Desde la pantalla de ganadores de un acta gestionás todo el circuito de contacto y entrega de cada premio.
Cada ganador tiene un estado:
| Estado | Qué significa |
|---|---|
| Pend. contacto | Todavía no se lo contactó. |
| Contactado | Ya se avisó al ganador, está pendiente de coordinar o concretar la entrega. |
| Entregado | El premio ya se le entregó. Estado terminal para ese ganador. |
Y las acciones disponibles sobre cada uno:
- Contacto: registra que se estableció contacto con el ganador (arranca a correr el plazo de retiro).
- Entrega: registra la entrega del premio. Siempre exige verificar el DNI de la persona contra el DNI que figura en el acta — nunca se entrega un premio sin confirmar que quien lo retira es efectivamente el ganador.
- Pasar a suplente: si el titular está incontactable o rechaza el premio, esta acción lo pasa al siguiente suplente de la misma acta, en el orden en que salieron sorteados.
- Devolver: devuelve la unidad de premio al stock disponible, para poder asignarla a un sorteo futuro (por ejemplo, si se agotaron los suplentes antes del cierre de la campaña).
- No otorgado: marca la unidad como definitivamente no entregada. Es un estado terminal, para usar cuando ya no tiene sentido seguir intentando (por ejemplo, después del cierre de la campaña).
Plazo de retiro vencido
Cada campaña define un plazo de retiro (10 días corridos desde el primer contacto). Si ese plazo venció, el gestor te lo va a advertir al intentar registrar una entrega y te va a pedir una confirmación explícita antes de dejarte continuar — nunca lo bloquea del todo, porque la decisión final es del operador, pero tampoco lo deja pasar por alto en silencio.
Para el flujo operativo completo de principio a fin, ver Gestionar ganadores y entregas.
Clientes¶
El buscador de clientes te deja encontrar a cualquier persona del padrón por DNI, apellido o celular.
Desde acá podés:
- Buscar un cliente puntual (hace falta escribir un término de búsqueda; la pantalla no carga todo el padrón de una — con decenas de miles de clientes eso sería lento e innecesario).
- Corregir datos de un cliente cuando detectás un error (por ejemplo, un celular mal cargado que impide contactar a un ganador). Ver el detalle de qué se puede corregir y qué no en Dar soporte a clientes.
- Exportar a CSV el padrón o el resultado de una búsqueda, para reportes o cruces por fuera del sistema.
Chances y vouchers¶
La pantalla de rastreo te deja seguir el rastro de cualquier chance o voucher: por sucursal, caja, fecha o estado.
Es la herramienta indicada cuando necesitás confirmar si un voucher puntual se validó, se rechazó (y por qué motivo) o directamente nunca llegó a procesarse — clave para responder consultas de soporte con precisión en vez de a ojo.
Claves¶
Las claves de firma son las que el sistema usa para validar que el QR de cada ticket sea genuino (HMAC). Cada clave tiene un identificador (keyId) y un estado de vigencia.
Rotación sin cortar el servicio
Se pueden tener varias claves registradas a la vez, cada una con su keyId. Esto permite rotar la clave de firma sin que los vouchers ya impresos con la clave anterior dejen de funcionar — el sistema valida cada voucher contra la clave que indica su propio keyId, no contra "la última".
Modo prueba¶
El generador de vouchers de prueba te permite crear QRs válidos sin necesidad de una impresora de ticket real, firmados con una clave de prueba separada de la clave de producción.
Es la herramienta para validar el circuito completo (caja → QR → landing → gestor) antes de una salida en vivo, o para reproducir un caso puntual sin usar un ticket de un cliente real. El paso a paso está en Generar vouchers de prueba (QR).