# Ordine Rapido B2B (Quick Order) — Guida completa
> 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…
- Pagina:
- Lingua: it
- Aggiornato il: 2026-06-24
- Altre lingue: [fr](https://www.datafirefly.com/documentation/dfquickorder/index.md), [en](https://www.datafirefly.com/en/documentation/dfquickorder/index.md), [es](https://www.datafirefly.com/es/documentation/dfquickorder/index.md), [de](https://www.datafirefly.com/de/documentation/dfquickorder/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfquickorder/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfquickorder/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfquickorder/index.md)
- Indice:
## 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
1. Nel back office, apri **Moduli > Gestore dei moduli**.
2. Fai clic su **Carica un modulo** e seleziona il file `dfquickorder.zip`.
3. 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).