Sviluppo alpha.3 — prove locali
Quote di unità delle campagne
Questa guida conserva gli esempi della versione 0.1.0-alpha.3. Per il pacchetto attuale e le verifiche successive, controlla il download e gli aggiornamenti del plugin prima di configurare la campagna.
Limita il numero totale di unità scontate
Apri HookSpark → Pricing & Discounts, crea o modifica una promozione e individua Unità scontate in questa campagna (0 = illimitate). Inserisci un numero intero e salva. Lascia zero per una campagna illimitata. Le promozioni esistenti hanno zero come valore predefinito.
È un totale degli ordini della promozione, non un massimo per carrello o un numero di clienti. Selezione dei prodotti, idoneità, date e calcolo dello sconto restano validi.
| Promozione | Ordine | Unità che consumano la quota della campagna |
|---|---|---|
| 10% su ogni articolo corrispondente | 12 articoli corrispondenti | 12 |
| Acquista 2, ricevi 1 gratis, ripetibile | 6 articoli, compresi 2 premi | 2 |
| Riduzione progressiva dal quinto articolo | 6 articoli, solo gli ultimi 2 scontati | 2 |
| Due promozioni cumulate | Ciascuna sconta gli stessi 3 articoli | 3 per ciascuna campagna separatamente |
I prodotti che attivano soltanto una promozione Acquista/Ricevi non consumano la quota premio. Gli omaggi automatici invece sì. Quote e scorte sono vincoli separati: una quota non crea disponibilità di magazzino. Min/Max continua a verificare le quantità fisiche dell’ordine.
Cosa vede il cliente
Aggiungere un prodotto al carrello non prenota disponibilità della campagna. Anteprima prodotto e simulatore non garantiscono che la quota resti disponibile.
Il checkout prenota l’intera assegnazione dell’ordine per 15 minuti. Se non restano unità sufficienti, si ferma con un messaggio che invita a tornare al carrello e controllare le quantità. Non applica silenziosamente una promozione parziale. Due checkout locali simultanei, con capacità per un solo ordine, hanno prodotto esattamente un successo, sia nel classico sia nella Store API.
Un checkout ripetuto sostituisce la prenotazione pendente di quell’ordine. Le campagne rimosse non ne trattengono le unità. Se manca capacità per una campagna necessaria, la sostituzione non riesce solo in parte.
Conferma, scadenza e annullamento
Le prenotazioni pendenti scadono dopo 15 minuti. Un ordine In sospeso non le estende né consuma la quota definitivamente. Dopo la scadenza, un altro ordine può usare le unità; una conferma successiva deve ricontrollare la disponibilità. Il passaggio dell’ordine ai callback WooCommerce processing/completed o payment-complete consuma l’assegnazione definitivamente. Ripetere i callback non moltiplica l’utilizzo.
Lo stato In lavorazione non prova che il denaro sia stato ricevuto. Il pagamento alla consegna può entrare in lavorazione prima dell’incasso: anche in quel caso l’assegnazione viene consumata alla conferma.
Ordini annullati o falliti liberano le prenotazioni pendenti. In questa implementazione, assegnazioni già consumate non vengono ripristinate automaticamente con annullamento o rimborso. Un rimborso monetario non va considerato un aumento della quota. La politica di rimborso o ripristino delle quote consumate resta incompleta.
Una conferma tardiva ricontrolla la capacità. Se restano unità sufficienti, conferma l’assegnazione senza avviso di revisione, anche dopo la scadenza della prenotazione iniziale. Se non riesce, l’ordine mantiene il proprio stato e viene contrassegnato per una verifica. Non viene eseguito alcun rimborso, annullamento o storno automatico del pagamento.
Risolvi “La quota della promozione richiede una verifica”
- Apri l’ordine e leggi avviso e nota interna prima di evaderlo.
- Controlla perché la disponibilità non è leggibile o se i dati richiedono attenzione. Una conferma della quota fallita non significa che il pagamento sia fallito.
- Dopo aver ripristinato la disponibilità, scegli Ricontrolla la quota della promozione nelle Azioni ordine di WooCommerce e applicala.
- L’avviso scompare solo dopo la conferma dell’assegnazione; altrimenti resta.
L’azione conserva l’assegnazione originale delle unità dell’ordine e verifica il limite attuale della campagna. Se due unità sono già consumate e un ordine ne richiede altre due, aumentare il limite da 2 a 4 permette di confermarlo al nuovo controllo. Non vengono riscritte quantità o prezzi storici. Se la campagna è stata eliminata, viene usata la capacità salvata. Ridurre il limite non revoca assegnazioni già confermate; se è inferiore all’utilizzo attuale, non se ne possono confermare altre. Impostare zero rende la campagna illimitata, ma ricontrollare un ordine segnalato ne registra comunque le unità esatte. Questa versione non offre un azzeramento manuale della quota. Solo chi è autorizzato a modificare l’ordine può eseguire il recupero.
Limiti delle verifiche originali
- Layout nel browser, uso da tastiera e invio dell’azione nativa richiedono ancora un collaudo visivo.
- Gli esempi di prezzo prodotto spiegano ora una disponibilità limitata o insufficiente senza mostrare nomi interni delle campagne o capacità residua esatta. Non prenotano unità e la disponibilità dell’intero carrello può differire. Il simulatore mostra la disponibilità delle campagne limitate selezionate, avvisa quando non basta e segnala esplicitamente un controllo fallito. Non prenota unità. L’editor della campagna salvata mostra anche utilizzo attuale e prenotazioni pendenti; il collaudo visivo resta aperto.
- Le prove HTTP locali usano il pagamento alla consegna; transizioni native In sospeso e scadenza/riassegnazione vengono provate con ordini temporanei e orario della prenotazione retrodatato. Gateway remoti e callback differiti non sono validati.
- Aggiornamento e migrazione, conservazione dei dati e politica di restituzione delle quote consumate richiedono completamento.
- Le istantanee storiche prive di assegnazioni unitarie esatte non vengono stimate o completate retroattivamente.
Guarda l’esempio nell’interfaccia
