Promociones automáticas: reglas 3x2, 2x1 y N×M de punta a punta

Qué problema resuelve

Una promoción automática aplica una regla comercial sin que el cliente tenga que escribir un código. Structura evalúa la condición mientras el carrito contiene productos elegibles.

Los presets disponibles son 3x2, 2x1, 4x3 y Personalizado.

Paso 1 — Tipo

Nombre

Es el nombre operativo de la promoción. Debe permitir reconocer rápidamente qué regla está activa.

Presets

En personalizado:

• Comprá (buy_qty): mínimo 2.
• Pagás (pay_qty): mínimo 1 y menor que buy_qty.
• Estrategia: El más barato gratis (cualquier producto) o Mismo producto gratis (variantes OK).

No confundas el texto 3x2 con el comportamiento: la estrategia determina cómo se selecciona el beneficio dentro de los productos elegibles.

Paso 2 — Alcance

La promoción puede aplicar a:

• toda la tienda;
• productos específicos;
• categorías específicas.

El selector de productos/categorías se muestra solamente cuando corresponde al alcance elegido.

Paso 3 — Fechas, canal y listas

Las fechas Desde y Hasta son opcionales. Vacías significa que no existe una fecha límite explícita.

La audiencia puede ser:

• todos;
• tienda + POS;
• solo tienda online;
• solo POS;
• solo empresas B2B.

Para B2B podés limitar por IDs de canal. También podés restringir por listas de precios; sin listas seleccionadas aplica a cualquier lista.

Paso 4 — Presentación

La promoción puede publicarse visualmente mediante:

• badge, por ejemplo 3x2;
• imagen de banner;
• título del banner;
• descripción del banner;
• mostrar en home;
• mostrar en el filtro En promo.

Estos campos controlan cómo se comunica la promoción. No reemplazan la regla comercial.

Paso 5 — Pop-up

El pop-up es opcional. Puede tener imagen, título, cuerpo y CTA. El valor inicial del CTA es Ver promoción.

Activar el pop-up no activa la promoción: la promoción debe estar activa y sus condiciones deben cumplirse.

Guardar, activar y eliminar

La pantalla carga promociones desde /api/promotions. Al guardar se crea o actualiza el registro y después se vuelve a cargar la lista desde servidor.

Cada promoción puede:

• editarse;
• activarse/desactivarse;
• eliminarse con confirmación.

La interfaz puede quedar bloqueada si la API informa una restricción de plan.

Flujo funcional completo

Configuración → promoción activa → cliente agrega productos → motor evalúa alcance/canal/lista/fechas → evalúa N×M → aplica beneficio → carrito refleja el resultado → pedido conserva la operación comercial.

Por eso una promoción mal configurada no debe diagnosticarse solamente mirando la tarjeta de la lista.

Cómo probar una promoción

1. Activá la promoción.
2. Confirmá alcance y canal.
3. Confirmá lista de precios si está restringida.
4. Elegí productos suficientes para cumplir buy_qty.
5. Agregalos al carrito.
6. Verificá que el beneficio corresponda a la estrategia elegida.
7. Repetí con una cantidad menor para comprobar que la condición realmente es necesaria.

Diagnóstico

No se aplica: revisá estado activo, fechas, canal, lista, alcance y cantidad.

Se aplica al producto equivocado: revisá si la estrategia es cheapest_free o same_product.

3x2 no aparece en home: revisá Mostrar en home; la visibilidad comercial y la aplicación automática son controles distintos.

El filtro En promo no lo muestra: revisá Filtro "En promo".

El banner se ve pero no hay descuento: el contenido visual puede existir aunque la promoción no esté activa o no se cumplan las condiciones.

Qué no hacer

• No uses un banner como prueba de que el motor aplicó la promoción.
• No configures pay_qty igual o mayor que buy_qty.
• No dupliques promociones para corregir una regla de alcance.
• No supongas que una promoción B2B funciona en todos los canales si restringiste IDs.