Ordine Rapido B2B (Quick Order) — Guida completa
Installare, configurare e utilizzare l'ordine rapido B2B: griglia SKU con completamento automatico, importazione CSV, incolla da Excel, liste di riacquisto e riordino con un clic per PrestaShop 8 e 9.
Panoramica
Il modulo Ordine Rapido B2B (dfquickorder) aggiunge una pagina di inserimento rapido in cui i tuoi clienti professionali compongono un ordine direttamente dai loro riferimenti (SKU), senza sfogliare il catalogo. Possono digitare i riferimenti uno a uno con completamento automatico, incollare due colonne da Excel, importare un file CSV, ricaricare una lista di riacquisto salvata o riordinare un ordine passato, quindi aggiungere tutto al carrello con un clic.
Pensato per il riassortimento B2B e gli acquirenti di fretta: un grossista che conosce i suoi riferimenti risparmia molto tempo rispetto alla navigazione prodotto per prodotto. La griglia risolve ogni SKU in tempo reale (nome, prezzo in base al gruppo, stock, quantità minima, combinazione).
Compatibilità
- PrestaShop da 8.0 a 9.x
- PHP da 7.4 a 8.3
- Negozio singolo e multinegozio
- 5 lingue: FR, EN, ES, DE, IT
- Tema Classic e temi personalizzati (griglia in JavaScript nativo, senza dipendenza da jQuery)
- Nessuna dipendenza (né Composer né framework)
Installazione
- Nel back office, apri Moduli > Gestore dei moduli.
- Fai clic su Carica un modulo e seleziona il file
dfquickorder.zip. - Una volta installato, fai clic su Configura.
All’installazione, il modulo crea la sua tabella delle liste di riacquisto, registra i suoi hook (displayCustomerAccount, displayNav2 e l’hook personalizzato displayQuickOrderBlock) e inizializza le impostazioni predefinite. Un collegamento Ordine rapido appare quindi nell’area cliente.
Configurazione
Accesso e restrizione
- Gruppi di clienti autorizzati: lascia vuoto per aprire l’ordine rapido a tutti, oppure seleziona uno o più gruppi per riservarlo ai tuoi clienti B2B. I visitatori non autorizzati vengono reindirizzati al loro account.
Inserimento e importazione
- Separatore CSV: punto e virgola, virgola, tabulazione o barra verticale, in base al formato esportato dai tuoi clienti.
- Numero di righe predefinito: numero di righe vuote mostrate all’apertura della griglia.
- Righe massime per CSV / incolla: protezione contro importazioni troppo grandi; le righe oltre il limite vengono ignorate con un avviso.
Visualizzazione e funzionalità
- Mostra prezzo e subtotale: mostra il prezzo unitario, il totale per riga e il totale stimato, calcolati secondo il metodo fiscale del gruppo (IVA esclusa o inclusa).
- Incolla da Excel: attiva la scheda per incollare due colonne (riferimento e quantità).
- Liste di riacquisto: attiva il salvataggio e il ricaricamento di liste con nome per cliente.
- Riordino con un clic: attiva il ricaricamento di un ordine passato nella griglia.
- Pulsante «Converti in preventivo»: mostrato solo se il modulo
dfb2bquoteè installato e attivo (ponte con la gamma di preventivi B2B).
Utilizzo
La griglia di inserimento SKU
Il cliente digita un riferimento: un menu di completamento automatico suggerisce i prodotti e le combinazioni corrispondenti (per riferimento o per nome). Alla conferma, la riga viene risolta in tempo reale e mostra il nome del prodotto, l’etichetta della combinazione, il prezzo unitario per il suo gruppo, il totale della riga e un distintivo di stato. Una nuova riga vuota viene aggiunta automaticamente man mano.
Gli stati di riga
- Verde: riferimento valido, stock sufficiente.
- Arancione: quantità adattata (stock parziale disponibile, o quantità minima di vendita raggiunta).
- Rosso: riferimento sconosciuto, prodotto non disponibile o esaurito.
La risoluzione gestisce le combinazioni: un riferimento di combinazione restituisce il corretto id_product_attribute e la sua etichetta di attributi. La ricerca avviene sul riferimento e, come ripiego, sul codice a barre EAN13, rispettando il negozio corrente e i prodotti attivi.
Incolla da Excel
Nella scheda Incolla da Excel, il cliente incolla due colonne (riferimento e quantità) direttamente dal suo foglio di calcolo. Ogni riga viene analizzata e risolta, quindi inserita nella griglia con il suo stato. Un’eventuale riga di intestazione («sku», «riferimento»…) viene rilevata e ignorata.
Importazione CSV
Nella scheda Importazione CSV, il cliente carica un file a due colonne. Il file viene letto nel browser e poi inviato per la risoluzione. Viene fornito un modello CSV scaricabile per guidare il formato atteso. Si applica il separatore configurato nel back office, con ripiego automatico sui separatori comuni.
Liste di riacquisto
Un cliente connesso può salvare la griglia corrente come lista con nome (ad esempio «Riassortimento mensile») e ricaricarla in qualsiasi momento dalla scheda Le mie liste. Ogni lista appartiene al cliente e al negozio; può essere caricata nella griglia o eliminata.
Riordinare un ordine passato
La scheda Riordina elenca gli ultimi ordini validi del cliente. Un clic ricarica tutti i riferimenti e le quantità dell’ordine nella griglia, pronti per essere adattati e aggiunti al carrello.
Aggiungere al carrello e convertire in preventivo
Il pulsante Aggiungi tutto al carrello aggiunge in una volta tutte le righe valide al carrello, rispettando le quantità. Se il modulo dfb2bquote è attivo, il pulsante Converti in preventivo aggiunge le righe al carrello e poi passa al percorso preventivo.
Accesso all’ordine rapido
Il collegamento Ordine rapido è disponibile nell’area cliente. Puoi anche mostrarlo nella navigazione superiore e, tramite l’hook personalizzato displayQuickOrderBlock, inserire un blocco di invito all’azione dove preferisci nel tuo negozio.
FAQ e risoluzione dei problemi
La griglia mostra un errore «JSON non valido» o non risolve i riferimenti
Svuota la cache di PrestaShop (Parametri avanzati > Prestazioni) e, durante i test, disattiva la combinazione/compressione dei file (CCC). Le risposte della griglia sono JSON rigoroso: il modulo scarta qualsiasi output parassita prima di rispondere, evitando che un messaggio PHP corrompa la risposta.
Come riservo l’ordine rapido ai miei clienti professionali?
Nella configurazione, seleziona il gruppo o i gruppi autorizzati in Gruppi di clienti autorizzati. Tutti gli altri visitatori non potranno accedere alla pagina.
Le combinazioni sono gestite?
Sì. Un riferimento di combinazione viene risolto nella combinazione corretta, con la propria etichetta di attributi, prezzo e stock. Anche il codice a barre EAN13 è accettato come riferimento.
Cosa succede se una quantità supera lo stock?
A seconda dell’impostazione di gestione dell’esaurimento del prodotto, la quantità viene adattata allo stock disponibile (stato arancione) oppure la riga viene contrassegnata come esaurita (stato rosso). I riferimenti non trovati vengono segnalati senza bloccare il resto della griglia.
Le liste e il riordino richiedono un account?
Sì: salvare le liste e riordinare gli ordini passati richiede che il cliente sia connesso. L’inserimento SKU, l’incolla e l’importazione CSV funzionano anche per i visitatori autorizzati.
È compatibile con PrestaShop 9?
Sì. Il modulo è compatibile con PrestaShop 8 e 9, in multinegozio e multilingue (FR, EN, ES, DE, IT).