Saltar a contenido

Preparar una campaña

Esta guía te lleva por la carga operativa de una campaña desde el gestor: revisar los datos generales, cargar los tipos de premio, generar las unidades y asignarlas a los sorteos. Al terminar, la campaña queda lista para que el equipo de sucursal empiece a validar tickets.

A quién apunta esta guía

Al equipo de Caracol que administra la campaña desde el gestor (/gestor/), con las credenciales SP_GESTOR_USER / SP_GESTOR_PASSWORD. Si todavía no tenés el sistema instalado y publicado, empezá por Instalar en el servidor y Publicar con HTTPS.

1. Revisar los datos de la campaña

Entrá a la sección Campaña del gestor y confirmá que los datos generales estén bien cargados: vigencia, textos que se muestran en la landing, la regla de chances (cuántas chances vale cada voucher) y el tope diario por DNI.

Datos de la campaña

Solo puede haber una campaña vigente a la vez

El sistema garantiza una única campaña activa. Los textos que cargués acá (nombre, descripción) se reflejan directo en la landing sin tocar código — así se puede ajustar la comunicación de la promo sin depender de un nuevo despliegue.

La vigencia se compara contra la fecha de emisión del ticket, no contra "hoy"

Un ticket con fecha de emisión dentro de la ventana de la campaña participa aunque se escanee después de cerrada la vigencia. Si necesitás el detalle completo de esta regla, ver Los casos de participación.

2. Cargar los tipos de premio

Andá a la sección Premios. Ahí se cargan los tipos de premio (por ejemplo, "Bicicleta playera × 10"), se controla el stock disponible y se asignan a los sorteos.

Tipos de premio, stock y asignación

  1. Cargar un tipo de premio: completá nombre y cantidad. El sistema genera automáticamente cada unidad individual del lote — no hace falta crear las unidades una por una.
  2. Repetí para cada tipo de premio de la campaña, siguiendo la lista real que definió el cliente.

Es un lote único para toda la campaña

No hay "recargar stock" a mitad de campaña como flujo estándar — la cantidad que cargás por tipo de premio es la que genera todas las unidades disponibles. Confirmá la lista completa de premios con el cliente antes de cargar, para no tener que hacer altas parciales sobre la marcha.

3. Asignar unidades a los sorteos

Con las unidades generadas, el siguiente paso es asignarlas a sorteos futuros, con su prelación — el orden en el que se reparten según el orden en que sale sorteada cada persona (el primer ganador sorteado se lleva el premio de prelación 1, y así sucesivamente).

Tenés dos caminos, no excluyentes:

  • Asignación manual: elegís vos qué unidades van a qué sorteo y en qué prelación. Es el camino para cuando la distribución de premios entre semanas no es pareja (por ejemplo, un premio grande reservado para el sorteo de cierre).
  • Repartir automáticamente: un atajo que distribuye el stock en partes iguales entre las semanas, como punto de partida. No es una decisión final — siempre podés ajustar la asignación y la prelación después de usarlo.

El reparto automático es un punto de partida, no el resultado final

Usalo para no arrancar de cero, pero revisá siempre la asignación resultante antes de dar la campaña por lista — sobre todo si hay premios de valor muy distinto que conviene repartir a criterio y no en partes iguales.

Cada unidad de premio recorre un ciclo de vida propio: Disponible → Asignado → Sorteado → Otorgado, con un estado terminal aparte (No otorgado) para cuando un premio no se puede entregar. El detalle completo de ese ciclo, incluyendo devoluciones al stock y reasignaciones, está en Premios y su ciclo de vida.

4. Revisar la campaña antes de lanzar

Antes de dar por lista la campaña para que arranque la validación de tickets en sucursal, repasá:

  • [ ] La vigencia de la campaña cubre todo el período real de la promo.
  • [ ] Todos los tipos de premio del acuerdo comercial están cargados, con la cantidad correcta.
  • [ ] Cada sorteo tiene unidades asignadas — ningún sorteo debería quedar sin premios el día que le toca ejecutarse.
  • [ ] La prelación de cada sorteo tiene sentido (el premio más valioso, primero).
  • [ ] El modo prueba generó al menos un QR de prueba y el circuito completo (caja → QR → landing → gestor) funcionó de punta a punta.

Campaña lista

Con la campaña vigente, los premios cargados y asignados, y el smoke test de QR en verde, el sistema está listo para que las cajas empiecen a emitir tickets reales.

Con la campaña corriendo, el siguiente paso operativo llega cuando se cumple la fecha de un sorteo — ver Ejecutar un sorteo.