Una policy è una campagna promozionale con nome — la tua combinazione per il Black Friday, la tua offerta fedeltà VIP, il tuo weekend di liquidazione. Ogni policy contiene un albero di condizioni (chi ha diritto) e una o più regole di sconto (cosa ottengono). Crea policy illimitate, ordinale per priorità con il drag&drop, attiva o metti in pausa singolarmente senza toccare il codice.

Ogni regola può funzionare in modalità Semplice (% fissa o importo fisso su carrello, prodotti o spedizione) oppure in modalità Promozione con accesso a tutte le 20 formule. Le impostazioni per singola regola includono codice sconto, priorità, limiti minimo/massimo di sconto, intervallo di date (valido da / valido a), condizioni opzionali a livello di regola ed etichetta di checkout multilingua mostrata sulla riga del carrello.

Interrompi alla prima corrispondenza termina la valutazione dopo la prima policy che ha diritto — utile quando le campagne non devono sovrapporsi. La strategia di unione per policy controlla come si combinano più regole all'interno di una policy: somma tutti gli sconti, la prima vince, cascata per priorità, solo lo sconto più alto, oppure codici univoci. Una strategia di unione predefinita globale e un limite di sconto globale nelle Impostazioni proteggono il margine su tutto il negozio.

La vista elenco delle policy mostra stato, strategia di unione, numero di regole e azioni rapide. Duplica, esporta in JSON, importa da file oppure attiva/disattiva — tutto dal pannello delle policy, con ogni modifica scritta nel log di audit.

Il generatore di condizioni è un editor ad albero AND/OR annidato — lo stesso schema usato nei motori di regole professionali, presentato come gruppi facili da trascinare nel tuo back office. Aggiungi un gruppo, scegli un campo, scegli un operatore, imposta un valore. Annida i gruppi per logiche come: (gruppo VIP OR 5+ ordini passati) AND (totale carrello ≥ €100) AND (la categoria Saldi Estivi ha 3+ articoli).

Oltre 30 campi di condizione coprono l'intero contesto del carrello: totale carrello, subtotale prodotto, costo di spedizione, numero di prodotti, numero di SKU univoci, peso, numero di regole carrello esistenti, numero di ordini del cliente, spesa complessiva, giorno della settimana, ora, data, codice postale, valuta, paese, paese di fatturazione, zona, gruppo cliente, vettore, modulo di pagamento, stato collegato/ospite, prodotti, categorie, produttori, fornitori, flag virtuale/fisico, personalizzazione e rilevamento di sconti esistenti.

I campi composti combinano entità + soglia in un'unica condizione — es. prodotto #123 qtà ≥ 3, categoria #45 totale riga ≥ €50. Gli operatori includono uguale, diverso, maggiore/minore di, tra, nella lista, non nella lista, contiene, inizia con, regex, vuoto e non vuoto.

I selettori di prodotto, categoria, produttore e gruppo utilizzano una ricerca con autocompletamento integrata. Una frase di anteprima live spiega a cosa corrisponde l'albero. Gli utenti avanzati possono attivare il JSON grezzo per copiare e incollare tra ambienti diversi. Le condizioni vengono rivalutate a ogni sincronizzazione del carrello — aggiunta al carrello, cambio quantità, login, cambio indirizzo — il motore reagisce immediatamente.

Passa una regola alla modalità Promozione e i campi a valore fisso vengono sostituiti da una griglia di riquadri con 20 tipi di promozione, raggruppati per famiglia: adeguamenti, offerte sull'N-esima unità, fasce di quantità, promo su spesa, BOGO, sconti di riga, regali e coppie di prodotti. Clicca su un riquadro — appariranno solo i campi rilevanti per quella formula.

Il selettore di ambito definisce quali righe del carrello entrano nel calcolo: intero carrello, prodotti selezionati a mano, intere categorie o produttori. I tipi BOGO ottengono liste prodotto compra/ricevi con selettori visuali. I tipi su spesa ottengono campi soglia e scaglione. I tipi a fasce ottengono una tabella a gradini. I tipi a coppia ottengono la lista A + la lista B. L'articolo più economico gratis ottiene un campo numero di unità gratuite. Le promo di riga permettono di scegliere prima il più economico o prima il più costoso.

Dietro l'interfaccia, ConorderdisPromotionCalculator delega a calcoli dedicati: espansione del pool di unità per i cicli BOGO, ordinamento delle righe per valore totale per la riga più economica gratis, aritmetica a scaglioni ripetuti per le scale di spesa. Il risultato è un importo di sconto preciso — non una stima approssimativa di una regola carrello generica.

La configurazione della promozione si sincronizza in modo bidirezionale con il JSON. Importa una policy da staging, apri il generatore visuale, modifica una soglia, salva — i dati strutturati restano coerenti. I chip di riepilogo regola nell'admin mostrano la formula attiva a colpo d'occhio senza aprire l'editor.

La scheda Simulatore è un flusso di lavoro in tre passaggi su dati reali del tuo database — non un carrello fittizio. Passo 1: cerca i carrelli per ID, nome cliente o email. Passo 2: scegli un carrello dall'elenco live (mostra cliente, email, totale carrello, ultimo aggiornamento). Passo 3: esegui la valutazione e leggi il riepilogo completo del risultato.

I risultati mostrano quali policy hanno corrisposto, quali sono state saltate (e perché), gli importi calcolati per ogni regola, le righe regalo che verrebbero aggiunte, i flag di spedizione gratuita e lo sconto totale finale. Un filtro cliente opzionale restringe l'elenco carrelli a un solo account — ideale per riprodurre un ticket di supporto.

Ogni simulazione eseguita viene registrata nel log di audit con tipo di evento simulation_run, ID carrello, attore (dipendente) e snapshot del risultato. Il marketing può verificare una campagna prima di attivarla. Il supporto può spiegare perché il carrello di un cliente specifico ha ricevuto o non ha ricevuto uno sconto — senza effettuare un ordine di prova sul negozio live.

Usa il simulatore dopo ogni modifica a una policy, prima della pubblicazione del Black Friday e quando importi policy da staging. È la rete di sicurezza che distingue la gestione delle promozioni di livello enterprise dal "modifica e spera".

La scheda Dashboard è la tua sala di controllo delle promozioni. Le schede KPI su un periodo selezionabile (30 / 90 / 180 / 365 giorni) mostrano: applicazioni totali di sconto, ordini coinvolti, totale sconto arrotondato nella valuta del negozio e numero di policy attive. I numeri provengono dal log di audit — eventi reali, non stime.

I grafici di andamento Chart.js visualizzano l'attività degli sconti su tre livelli di granularità: giornaliero (finestra configurabile), settimanale e mensile. Cambia il tipo di grafico predefinito nelle Impostazioni. Un grafico a torta suddivide le applicazioni per codice sconto, così puoi vedere quali regole COD-* si attivano realmente in produzione.

La dashboard mostra anche le voci di audit recenti — le ultime modifiche alle policy, le ultime simulazioni, le ultime applicazioni di sconto lato front-office — per una risoluzione dei problemi a colpo d'occhio senza aprire il log completo. Il periodo di analisi, le finestre giorno/settimana/mese dei grafici e il tipo di grafico predefinito sono tutti configurabili in Impostazioni → Analisi.

Per agenzie e operatori multistore: la dashboard risponde alla domanda che il marketing si pone sempre — "La nostra promozione è davvero attiva?" — con i dati, non con l'istinto.

La scheda dedicata Log di audit è un giornale eventi completo — non un file di debug sepolto nei log del server. Ogni riga memorizza data/ora, tipo di evento, attore (nome dipendente, nome cliente o SYSTEM), riepilogo leggibile, riferimento ordine collegato, codice sconto, importo, ID carrello e ID policy.

Vengono tracciati 11 tipi di evento: discount_applied (sincronizzazione carrello live), order_discount (ordine effettuato), policy_created, policy_updated, policy_deleted, policy_toggled, policy_duplicated, policy_imported, policy_exported, settings_updated e simulation_run. Ogni evento registra la propria origine: front office, back office o sistema.

Clicca su Visualizza su qualsiasi riga per aprire una finestra di dettaglio con lo snapshot JSON completo — righe di sconto applicate, diff della policy, output della simulazione o payload della modifica alle impostazioni. Le applicazioni di sconto memorizzano uno discount_snapshot così puoi ricostruire esattamente ciò che il cliente ha visto al momento del checkout.

L'elenco supporta l'esportazione CSV nativa di PrestaShop per revisioni finanziarie e di conformità. Le colonne collegate mostrano riferimento ordine, nome cliente e nome dipendente senza incroci manuali. Quando un cliente chiede "perché ho ricevuto questo sconto?", la risposta è a una sola ricerca di distanza.

Nella pagina ordine del back office (hook displayAdminOrder), un pannello mostra quali policy di Sconti condizionali sull'ordine hanno contribuito a quell'ordine — nome policy, codice sconto, importo e snapshot. La verità storica sopravvive anche se la policy viene successivamente modificata o eliminata.

Le policy sono documenti JSON portabili. Esporta scarica la policy completa — albero delle condizioni, tutte le regole, configurazioni delle promozioni, strategia di unione, posizioni — pronta per il controllo di versione o il passaggio a un altro negozio. Importa carica un file JSON e crea una nuova policy (oppure la aggiorna, in base al flusso di lavoro) con voce di log di audit policy_imported.

Duplica clona una policy con un clic dal menu azioni dell'elenco — copia ogni regola, la rinomina con un suffisso, registra policy_duplicated. Perfetto per creare "Black Friday v2" da "Black Friday v1" senza ricostruire 15 regole a mano.

Flusso di lavoro tipico di un'agenzia: costruisci e simula in staging → esporta il JSON → importa in produzione → esegui di nuovo il simulatore → attiva. Le configurazioni del Black Friday si spostano tra i negozi dei clienti in pochi minuti. Ogni trasferimento è rintracciabile nel log di audit.

La scheda Impostazioni centralizza il comportamento a livello di negozio. Interruttore principale di attivazione/disattivazione. Strategia di unione globale predefinita per le nuove policy. Limite di sconto globale — sconto totale massimo per carrello su tutte le policy (0 = illimitato). Interruttore Prodotti gratuiti come regalo — materializza i prodotti gratuiti come righe regalo native di PrestaShop oppure come sconto in linea.

Disattiva l'aggiunta automatica impedisce l'inserimento automatico di regole carrello quando vuoi il controllo manuale. Il log di debug scrive tracce dettagliate del motore per il supporto. La sezione Analisi configura il periodo predefinito dei grafici, le finestre giornaliera/settimanale/mensile e il tipo di grafico predefinito.

Ogni salvataggio delle impostazioni registra settings_updated nel log di audit con snapshot prima/dopo. Nessuna deriva silenziosa della configurazione.

Gli sconti si materializzano come regole carrello native di PrestaShop con prefisso COD-*. Appaiono nel riepilogo carrello, nel checkout, nella conferma d'ordine, nelle fatture e nelle note di credito — esattamente come le regole carrello create manualmente. Nessun trucco sul tema. Nessuna riga prodotto negativa finta.

Il motore si aggancia a actionCartSave, aggiunta/rimozione prodotto, inizializzazione del controller front, validazione ordine e validazione regola carrello — ricalcolando ogni volta che il contesto del carrello cambia. Lo stato del carrello viene salvato in conorderdis_cart con snapshot applicato, snapshot regalo e ID della regola carrello collegata per una sincronizzazione idempotente.

Le policy sono legate al negozio (id_shop) per le configurazioni multistore. Ogni negozio del tuo gruppo può eseguire combinazioni di promozioni indipendenti. PrestaShop 9.x, 8.x e 1.7.x condividono un unico codice grazie al livello di compatibilità integrato.

Le etichette di checkout multilingua per regola (conorderdis_rule_lang) garantiscono che la riga di sconto sia leggibile correttamente in ogni lingua attiva del negozio.