Documentazione del modulo Preordine PrestaShop (dfpreorder)

<p>Il modulo <strong>DataFirefly Pre-Orders</strong> (dfpreorder) permette di vendere prodotti prima che arrivino in magazzino su PrestaShop 8 e 9. Questa pagina copre installazione, impostazioni, regole, arrivi di merce e risoluzione dei problemi.</p>

<h2>Installazione</h2>
<ol>
<li>Scarica lo ZIP dal tuo account cliente DataFirefly.</li>
<li>Nel back office vai su <em>Moduli > Gestore moduli > Carica un modulo</em> e invia lo ZIP.</li>
<li>All’installazione il modulo crea le sue tabelle, i due stati ordine e due voci di menu: <em>Catalogo > Preordini</em> per le regole e <em>Ordini > Preordini</em> per il monitoraggio.</li>
<li>Apri la configurazione del modulo per verificare le impostazioni generali e copiare l’URL del cron.</li>
</ol>
<p>Il modulo funziona da PrestaShop 8.0 a 9.x con lo stesso ZIP, in multinegozio e multilingua. Le stringhe sono fornite in italiano, inglese, francese, spagnolo, tedesco, olandese, polacco e portoghese.</p>

<h2>Impostazioni generali</h2>
<ul>
<li><strong>Testo del pulsante predefinito</strong> e <strong>testo del badge</strong>, per lingua. Ogni regola può sostituirli.</li>
<li><strong>Carrelli che mescolano preordini e articoli disponibili</strong>: consentire senza messaggio, consentire con un avviso che indica la spedizione in un’unica soluzione, o vietare la combinazione.</li>
<li><strong>Casella di consenso al checkout</strong>: aggiunge una casella obbligatoria quando il carrello contiene un preordine. Il testo accetta il segnaposto <code>%date%</code>, sostituito dalla data di spedizione prevista più lontana del carrello. La data del consenso resta salvata su ogni riga di preordine.</li>
<li><strong>E-mail</strong> di conferma e di disponibilità, attivabili separatamente.</li>
<li><strong>Assegnazione automatica</strong> dello stock ricevuto e <strong>stato ordine</strong> da applicare quando tutte le righe sono assegnate.</li>
<li><strong>Modulo Avvisami</strong> sui prodotti non ordinabili.</li>
<li><strong>Dati strutturati PreOrder</strong>, disattivati di default: attivali solo se il tema o il modulo SEO non genera già il JSON-LD del prodotto.</li>
</ul>

<h2>Creare una regola di preordine</h2>
<p>Vai su <em>Catalogo > Preordini</em> quindi su <em>Aggiungi una regola</em>. Una regola riguarda un prodotto o una combinazione specifica.</p>

<h3>Le tre modalità</h3>
<ul>
<li><strong>Quando esaurito</strong>: il preordine parte quando lo stock arriva a zero e si ferma al riassortimento. È la modalità per le rotture di stock del fornitore.</li>
<li><strong>Forzata</strong>: il prodotto resta in preordine finché la regola è attiva, anche con stock. È la modalità di un lancio.</li>
<li><strong>Finestra di date</strong>: il preordine si apre e si chiude alle date indicate. La chiusura viene applicata dall’attività cron e, come riserva, a ogni visita della scheda prodotto.</li>
</ul>

<h3>Gli altri campi</h3>
<ul>
<li><strong>Data di spedizione prevista</strong>: mostrata nella scheda, nel carrello, nell’account cliente, sulla fattura e nelle e-mail.</li>
<li><strong>Quantità massima</strong> e <strong>massimo per cliente</strong>: 0 significa illimitato. I limiti sono verificati lato server a ogni salvataggio del carrello.</li>
<li><strong>Sconto preordine</strong> in percentuale o importo: disponibile nelle modalità forzata e finestra di date, dove il periodo è noto in anticipo. Crea un prezzo specifico rimosso alla fine della regola.</li>
<li><strong>Testo del pulsante</strong> e <strong>messaggio</strong> per lingua, propri della regola.</li>
<li><strong>Conto alla rovescia</strong> (fino alla chiusura o all’uscita) e <strong>barra delle unità prenotate</strong>, che richiede una quantità massima.</li>
</ul>

<h3>Creare molte regole in una volta</h3>
<p>Il pulsante <em>Assegnazione massiva e importazione CSV</em> apre due moduli. Il primo crea una regola per ogni prodotto che corrisponde a una categoria, una marca o un fornitore, sommando i criteri. Il secondo importa un CSV con le colonne <code>product</code> (ID o riferimento), <code>combination</code> (facoltativa), <code>mode</code>, <code>release_date</code>, <code>max_qty</code>, <code>max_per_customer</code>, <code>date_start</code>, <code>date_end</code>. Le regole esistenti vengono aggiornate.</p>

<h2>Cosa vede il cliente</h2>
<p>Su un prodotto in preordine il pulsante di aggiunta al carrello assume il testo scelto, un badge compare sulle immagini negli elenchi e nella scheda, e un riquadro mostra la data prevista, il tuo messaggio, il conto alla rovescia e la barra delle unità prenotate. Il blocco si aggiorna al cambio di combinazione.</p>
<p>Nel carrello ogni riga interessata è segnalata con la data prevista. Al checkout la casella di consenso ricorda la data. Dopo l’ordine il cliente segue i suoi preordini in <em>Il mio account > I miei preordini</em> e può chiedere l’annullamento delle righe ancora in attesa.</p>

<h2>Monitoraggio e assegnazione dello stock</h2>
<p><em>Ordini > Preordini</em> raccoglie il monitoraggio.</p>
<h3>Dashboard</h3>
<p>Gli indicatori mostrano le unità in attesa, il numero di ordini coinvolti, il fatturato prenotato IVA inclusa, le unità già assegnate e le richieste di annullamento. La tabella per prodotto indica, per ogni prodotto o combinazione, le unità in attesa, lo stock PrestaShop, le unità assegnabili subito e la quantità da ordinare al fornitore. Il pulsante di esportazione CSV usa le stesse colonne.</p>
<h3>Assegnare un arrivo</h3>
<p>Un preordine scala lo stock al momento dell’ordine, portandolo sotto zero. Le unità fisicamente disponibili per i preordini sono quindi: unità in attesa + stock attuale. Dopo un riassortimento, il pulsante <em>Assegna (dai più vecchi)</em> serve gli ordini per data, oppure <em>Scegli gli ordini</em> apre la schermata di assegnazione con le righe proposte già selezionate e modificabili.</p>
<p>Quando tutte le righe in preordine di un ordine sono assegnate, l’ordine passa allo stato configurato (per impostazione predefinita <em>Preordine: pronto per la spedizione</em>) e il cliente riceve un’e-mail. Poi prepari l’ordine come di consueto.</p>
<div class=”df-callout note”><p>L’assegnazione automatica serve i preordini senza convalida manuale, ma mai prima della data annunciata per una regola forzata o con finestra di date.</p></div>

<h2>Gestire un ritardo</h2>
<p>Apri la regola, cambia la data di spedizione prevista e lascia attiva l’opzione <em>Avvisa i clienti se la data cambia</em>. I preordini in attesa vengono aggiornati e ogni cliente interessato riceve un’e-mail con la nuova data e un link per chiedere l’annullamento. Il numero di clienti avvisati compare dopo il salvataggio e la cronologia delle date annunciate appare sotto il modulo.</p>
<p>Le richieste di annullamento arrivano nella dashboard. <em>Conferma l’annullamento</em> libera le unità prenotate; il rimborso resta da effettuare dalla pagina dell’ordine con il tuo metodo di pagamento. <em>Mantieni il preordine</em> riporta le righe in attesa.</p>

<h2>Attività cron</h2>
<p>La configurazione del modulo mostra un URL con token. Programmalo ogni 15 minuti presso il tuo hosting. Apre e chiude le finestre di date all’ora prevista e, se l’assegnazione automatica è attiva, serve i preordini il cui stock è arrivato.</p>

<h2>Domande frequenti</h2>
<h3>Il cliente paga l’intero importo?</h3>
<p>Sì, nella versione 1.0. L’acconto con saldo alla disponibilità è previsto per la versione 1.1.</p>
<h3>Perché un ordine passa a Preordine: in attesa di disponibilità?</h3>
<p>Il modulo porta l’ordine in quello stato appena è pagato e contiene almeno una riga in preordine. Lo stato è pagato e non spedibile, così un ordine incompleto non entra in preparazione.</p>
<h3>Una regola su una combinazione influisce sulle altre?</h3>
<p>PrestaShop gestisce l’impostazione che consente gli ordini senza stock solo a livello di prodotto. Il modulo la applica quindi sul prodotto e poi blocca, in front e nel carrello, le combinazioni esaurite senza regola, per conservare il comportamento originale del negozio.</p>
<h3>Il conto alla rovescia non compare</h3>
<p>Compare solo se la data di chiusura (modalità finestra) o la data di spedizione prevista è nel futuro e se l’opzione è attiva sulla regola.</p>
<h3>Il pulsante mantiene il testo originale</h3>
<p>Il modulo sostituisce il testo del pulsante di aggiunta al carrello nei temi standard. Su un tema molto personalizzato, contatta l’assistenza indicando l’URL della scheda: il selettore del pulsante può essere adattato.</p>