Una política es una campaña de promoción con nombre — tu acumulación de Black Friday, tu oferta de fidelización VIP, tu fin de semana de liquidación. Cada política contiene un árbol de condiciones (quién califica) y una o varias reglas de descuento (qué obtienen). Crea políticas ilimitadas, ordénalas arrastrando por prioridad, actívalas o pásalas individualmente sin tocar código.

Cada regla puede funcionar en modo Simple (% plano o importe fijo sobre carrito, productos o envío) o en modo Promoción con acceso a las 20 fórmulas. Los ajustes por regla incluyen código de descuento, prioridad, topes mínimo/máximo de descuento, rango de fechas (válido desde / válido hasta), condiciones opcionales a nivel de regla y etiqueta multilingüe de pago mostrada en la línea del carrito.

Detener en la primera coincidencia finaliza la evaluación tras la primera política que califica — útil cuando las campañas no deben superponerse. La estrategia de combinación por política controla cómo se combinan varias reglas dentro de una misma política: acumular todos los descuentos, que gane la primera, cascada por prioridad, solo el descuento más alto, o códigos únicos. Una estrategia de combinación global predeterminada y un tope de descuento global en Ajustes protegen tu margen en toda la tienda.

La vista de lista de políticas muestra el estado, la estrategia de combinación, el número de reglas y acciones rápidas. Duplica, exporta JSON, importa desde archivo o activa/desactiva — todo desde el panel de políticas, con cada cambio registrado en el registro de auditoría.

El constructor de condiciones es un editor de árbol AND/OR anidado — el mismo patrón que usan los motores de reglas profesionales, presentado como grupos fáciles de arrastrar en tu back office. Añade un grupo, elige un campo, selecciona un operador, define un valor. Anida grupos para lógicas como: (grupo VIP O 5+ pedidos anteriores) Y (total del carrito ≥ €100) Y (la categoría Rebajas de Verano tiene 3+ artículos).

Más de 30 campos de condición cubren todo el contexto del carrito: total del carrito, subtotal de producto, coste de envío, número de productos, número de SKUs únicos, peso, número de reglas de carrito existentes, número de pedidos del cliente, gasto histórico, día de la semana, hora, fecha, código postal, moneda, país, país de facturación, zona, grupo de cliente, transportista, módulo de pago, estado identificado/invitado, productos, categorías, fabricantes, proveedores, indicadores virtual/físico, personalización y detección de descuentos existentes.

Los campos compuestos combinan entidad + umbral en una sola condición — e.g. producto #123 cantidad ≥ 3, categoría #45 total de línea ≥ €50. Los operadores incluyen igual, distinto, mayor/menor que, entre, en lista, no en lista, contiene, empieza por, regex, vacío y no vacío.

Los selectores de producto, categoría, fabricante y grupo usan búsqueda con autocompletado integrada. Una frase de vista previa en vivo explica qué coincide con el árbol. Los usuarios avanzados pueden alternar el JSON en bruto para copiar y pegar entre entornos. Las condiciones se reevalúan en cada sincronización del carrito — añadir al carrito, cambiar cantidad, iniciar sesión, cambiar dirección — el motor reacciona de inmediato.

Cambia una regla al modo Promoción y los campos de valor plano se sustituyen por una cuadrícula de tarjetas con los 20 tipos de promoción, agrupados por familia: ajustes, ofertas por unidad enésima, tramos de cantidad, promociones por gasto, BOGO, descuentos por línea, regalos y parejas de productos. Haz clic en una tarjeta — solo aparecen los campos relevantes para esa fórmula.

El selector de alcance define qué líneas del carrito entran en el cálculo: todo el carrito, productos seleccionados a mano, categorías o fabricantes completos. Los tipos BOGO obtienen listas de productos compra/lleva con selectores visuales. Los tipos por gasto obtienen campos de umbral y tramo. Los tipos por tramos obtienen una tabla escalonada. Los tipos de pareja obtienen lista A + lista B. El artículo más barato gratis obtiene un campo de número de unidades gratis. Las promociones de línea te permiten elegir primero la más barata o primero la más cara.

Detrás de la interfaz, ConorderdisPromotionCalculator delega en matemáticas dedicadas: expansión del grupo de unidades para ciclos BOGO, ordenación de líneas por valor total para la línea más barata gratis, aritmética de tramos repetidos para escaleras de gasto. El resultado es un importe de descuento preciso — no una estimación redondeada de una regla de carrito genérica.

La configuración de promoción se sincroniza bidireccionalmente con JSON. Importa una política desde el entorno de pruebas, abre el constructor visual, ajusta un umbral, guarda — los datos estructurados permanecen consistentes. Las etiquetas de resumen de regla en el panel muestran la fórmula activa de un vistazo sin abrir el editor.

La pestaña Simulador es un flujo de trabajo de tres pasos contra datos reales de tu base de datos — no un carrito ficticio. Paso 1: busca carritos por ID, nombre de cliente o correo electrónico. Paso 2: elige un carrito de la lista en vivo (muestra cliente, correo, total del carrito, última actualización). Paso 3: ejecuta la evaluación y lee el desglose completo del resultado.

Los resultados muestran qué políticas coincidieron, cuáles se omitieron (y por qué), los importes calculados por regla, las líneas de regalo que se añadirían, los indicadores de envío gratis y el descuento total final. Un filtro de cliente opcional reduce la lista de carritos a una sola cuenta — ideal para reproducir un ticket de soporte.

Cada simulación ejecutada se registra en el registro de auditoría con el tipo de evento simulation_run, el ID del carrito, el actor (empleado) y una instantánea del resultado. Marketing puede verificar una campaña antes de activarla. Soporte puede explicar por qué el carrito de un cliente concreto recibió o no un descuento — sin hacer un pedido de prueba en la tienda en producción.

Usa el simulador tras cada edición de política, antes de publicar el Black Friday y al importar políticas desde el entorno de pruebas. Es la red de seguridad que separa la gestión de promociones de nivel empresarial de "cambiar y confiar en la suerte".

La pestaña Panel es tu sala de control de promociones. Las tarjetas de KPI, sobre un periodo seleccionable (30 / 90 / 180 / 365 días), muestran: total de aplicaciones de descuento, pedidos afectados, total de descuento redondeado en la moneda de la tienda y número de políticas activas. Los datos provienen del registro de auditoría — eventos reales, no estimaciones.

Los gráficos de tendencia de Chart.js visualizan la actividad de descuentos en tres granularidades: diaria (ventana configurable), semanal y mensual. Cambia el tipo de gráfico predeterminado en Ajustes. Un gráfico circular desglosa las aplicaciones por código de descuento para que veas qué reglas COD-* se activan realmente en producción.

El panel también muestra las entradas de auditoría recientes — últimos cambios de política, últimas simulaciones, últimas aplicaciones de descuento en la tienda online — para una resolución de problemas rápida sin abrir el registro completo. El periodo de analítica, las ventanas de día/semana/mes del gráfico y el tipo de gráfico predeterminado son configurables en Ajustes → Analítica.

Para agencias y operadores multitienda: el panel responde a la pregunta que marketing siempre hace — "¿Se está ejecutando realmente nuestra promoción?" — con datos, no con intuición.

La pestaña dedicada de Registro de auditoría es un diario de eventos completo — no un archivo de depuración enterrado en los registros del servidor. Cada fila almacena marca de tiempo, tipo de evento, actor (nombre de empleado, nombre de cliente o SYSTEM), resumen legible, referencia de pedido vinculada, código de descuento, importe, ID de carrito e ID de política.

Se rastrean 11 tipos de evento: discount_applied (sincronización de carrito en vivo), order_discount (pedido realizado), policy_created, policy_updated, policy_deleted, policy_toggled, policy_duplicated, policy_imported, policy_exported, settings_updated y simulation_run. Cada evento registra su origen: tienda online, back office o sistema.

Haz clic en Ver en cualquier fila para abrir una ventana de detalle con la instantánea JSON completa — líneas de descuento aplicadas, diferencia de política, salida de simulación o carga de cambios de ajustes. Las aplicaciones de descuento almacenan una discount_snapshot para que puedas reconstruir exactamente lo que vio el cliente en el momento del pago.

La lista admite la exportación a CSV nativa de PrestaShop para revisiones de finanzas y cumplimiento. Las columnas combinadas muestran la referencia del pedido, el nombre del cliente y el nombre del empleado sin necesidad de cruzar datos manualmente. Cuando un cliente pregunta "¿por qué recibí este descuento?", la respuesta está a una búsqueda de distancia.

En la página de pedido del back office (hook displayAdminOrder), un panel muestra qué políticas de Descuentos condicionales de pedido contribuyeron a ese pedido — nombre de la política, código de descuento, importe e instantánea. La verdad histórica se conserva incluso si la política se edita o elimina más adelante.

Las políticas son documentos JSON portables. Exportar descarga la política completa — árbol de condiciones, todas las reglas, configuraciones de promoción, estrategia de combinación, posiciones — lista para control de versiones o para entregarla a otra tienda. Importar sube un archivo JSON y crea una nueva política (o la actualiza, según el flujo de trabajo) con la entrada de auditoría policy_imported.

Duplicar clona una política con un clic desde el menú de acciones de la lista — copia todas las reglas, renombra con un sufijo y registra policy_duplicated. Perfecto para crear "Black Friday v2" a partir de "Black Friday v1" sin reconstruir 15 reglas a mano.

Flujo de trabajo típico de una agencia: crear y simular en el entorno de pruebas → exportar JSON → importar en producción → ejecutar el simulador de nuevo → activar. Las configuraciones de Black Friday se trasladan entre tiendas de clientes en minutos. Cada transferencia se puede rastrear en el registro de auditoría.

La pestaña Ajustes centraliza el comportamiento de toda la tienda. Interruptor maestro de activación/desactivación. Estrategia de combinación global predeterminada para nuevas políticas. Tope de descuento global — descuento total máximo por carrito en todas las políticas (0 = ilimitado). Interruptor de artículos gratuitos como regalo — materializa los productos gratuitos como líneas de regalo nativas de PrestaShop frente a descuento en línea.

Desactivar autoañadido evita la inyección automática de reglas de carrito cuando quieres control manual. El registro de depuración escribe trazas detalladas del motor para soporte. La sección de analítica configura el periodo de gráfico predeterminado, las ventanas diaria/semanal/mensual y el tipo de gráfico predeterminado.

Cada guardado de ajustes registra settings_updated en el registro de auditoría con una instantánea antes/después. Sin desviaciones de configuración silenciosas.

Los descuentos se materializan como reglas de carrito nativas de PrestaShop con el prefijo COD-*. Aparecen en el resumen del carrito, el proceso de pago, la confirmación del pedido, las facturas y los abonos — exactamente igual que las reglas de carrito creadas manualmente. Sin trucos de plantilla. Sin líneas de producto negativas falsas.

El motor se enlaza a actionCartSave, añadir/quitar productos, inicialización del controlador frontal, validación de pedido y validación de reglas de carrito — recalculando cada vez que cambia el contexto del carrito. El estado del carrito se persiste en conorderdis_cart con instantánea aplicada, instantánea de regalo e ID de regla de carrito vinculada para una sincronización idempotente.

Las políticas tienen alcance por tienda (id_shop) para configuraciones multitienda. Cada tienda de tu grupo puede ejecutar acumulaciones de promociones independientes. PrestaShop 9.x, 8.x y 1.7.x comparten una sola base de código gracias a la capa de compatibilidad integrada.

Las etiquetas multilingües de pago por regla (conorderdis_rule_lang) garantizan que la línea de descuento se lea correctamente en todos los idiomas activos de la tienda.