# Inserire un ordine dal back office con DataFirefly Order Creator

> Presentazione DataFirefly Order Creator aggiunge al back office una pagina di inserimento ordini, pensata per gli ordini ricevuti per telefono o via email. Segue l’ordine di una presa d’ordine in…

- Pagina: <https://www.datafirefly.com/it/documentation/dfordercreator/>
- Lingua: it
- Aggiornato il: 2026-10-13
- Altre lingue: [fr](https://www.datafirefly.com/documentation/dfordercreator/index.md), [en](https://www.datafirefly.com/en/documentation/dfordercreator/index.md), [es](https://www.datafirefly.com/es/documentation/dfordercreator/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfordercreator/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfordercreator/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfordercreator/index.md), [de](https://www.datafirefly.com/de/documentation/dfordercreator/index.md)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

## Presentazione

DataFirefly Order Creator aggiunge al back office una pagina di inserimento ordini, pensata per gli ordini ricevuti per telefono o via email. Segue l’ordine di una presa d’ordine in quattro passaggi (cliente, prodotti, indirizzi e consegna, pagamento e stato) e mostra a destra un riepilogo che si ricalcola a ogni azione.

L’ordine viene creato con la stessa funzione della schermata nativa di PrestaShop (`PaymentModule::validateOrder`), a partire dal carrello del cliente. Il modulo funziona su PrestaShop da 8.0 a 9.x e la sua interfaccia è tradotta in francese, inglese, spagnolo, tedesco, italiano, olandese, polacco e portoghese.

## Installazione

1. In **Moduli > Gestione moduli**, clicca su **Carica un modulo** e trascina il file `dfordercreator-1.0.0.zip`.
2. La pagina viene aggiunta in **Ordini > Inserimento ordini**.
3. Per impostazione predefinita, anche i pulsanti **Aggiungi nuovo ordine** del back office aprono questa pagina.

Per aprire la pagina a un profilo diverso da SuperAdmin, assegnagli i permessi sulla scheda **Inserimento ordini** in **Parametri avanzati > Team > Permessi**. Il permesso **Aggiungi** è necessario per creare clienti e ordini. Senza di esso, il dipendente può preparare un carrello e inviare il link di pagamento.

In multinegozio, seleziona un solo negozio nel selettore in alto nel back office prima di inserire un ordine.

## Configurazione

La pagina di configurazione del modulo offre queste impostazioni:

- **Sostituisci i pulsanti nativi "Aggiungi nuovo ordine"**: il pulsante dell’elenco ordini apre la pagina del modulo, e il pulsante di creazione ordine di un carrello cliente la apre con quel carrello già caricato.
- **Stato dell’ordine predefinito**: uno stato fisso, oppure l’ultimo stato usato dal dipendente.
- **Metodo di pagamento predefinito**: un modulo di pagamento fisso, oppure l’ultimo usato dal dipendente.
- **I prezzi inseriti dai dipendenti sono**: IVA inclusa o IVA esclusa. Ogni dipendente può cambiare modalità nella pagina, e la sua scelta viene memorizzata nel browser.
- **Consenti modifiche di prezzo e sconti di riga**.
- **Mostra il margine**, calcolato IVA esclusa a partire dal prezzo di costo di prodotti e combinazioni.
- **Consenti l’aggiunta di prodotti esauriti**: mostra una casella che permette al dipendente di superare lo stock per un determinato ordine.
- **Invia email al cliente per impostazione predefinita**: stato iniziale dell’opzione al momento di creare l’ordine.
- **Risultati della ricerca**: numero massimo di clienti o prodotti mostrati (da 5 a 50).

## Inserire un ordine

### 1. Il cliente

Digita almeno due caratteri nella ricerca (oppure un numero cliente). La ricerca riguarda nome, cognome, email, azienda, telefono degli indirizzi, partita IVA e CAP. Si possono combinare più parole, ad esempio «rossi milano». Scegli il cliente con le frecce e il tasto Invio, oppure con il mouse.

La scheda mostra i gruppi del cliente (il gruppo predefinito in scuro, con la sua riduzione), i suoi ordini validi, il fatturato, l’ultimo ordine e la nota privata. Il link **Cronologia** espande:

- gli ultimi sei ordini, con il pulsante **Ordina di nuovo** che aggiunge i loro prodotti al carrello;
- i carrelli aperti del cliente, con il pulsante **Riprendi questo carrello**.

Il pulsante **Nuovo cliente** (oppure Alt + N) apre la creazione di un cliente: nome, cognome, email, azienda, gruppo, lingua, account ospite se il negozio lo consente, newsletter e primo indirizzo. Se l’email esiste già, la finestra propone di usare il cliente esistente. Per un account normale, la casella **Invia al cliente un link per scegliere la password** gli invia l’email nativa di reimpostazione della password.

**Cambia cliente** mantiene nel carrello i prodotti già inseriti.

### 2. I prodotti

Il tasto / porta il cursore nella ricerca prodotti. La ricerca riguarda nome, riferimento, EAN, UPC, MPN, riferimento fornitore e ID, compresi quelli delle combinazioni. Ogni risultato mostra immagine, riferimento, stock e prezzo per questo cliente. Le combinazioni sono espanse sotto il loro prodotto.

- ↑ ↓ per spostarsi, Invio per aggiungere, Maiusc + Invio per aggiungere mantenendo aperti i risultati.
- Il campo **Qtà** accanto alla ricerca stabilisce la quantità aggiunta.
- Con un lettore di codici a barre, scansiona il codice nella ricerca: il prodotto o la combinazione con EAN, UPC o riferimento corrispondente viene aggiunto direttamente.

Nella tabella delle righe:

- **Quantità**: pulsanti **+** e **-** o inserimento diretto. Impostare 0 o cliccare sul cestino rimuove la riga.
- **Prezzo unitario**: inserito IVA inclusa o IVA esclusa secondo il pulsante sopra la tabella. Un prezzo inserito IVA inclusa viene convertito IVA esclusa con l’aliquota della riga.
- **Sconto**: una percentuale applicata al prezzo della riga.
- Quando il prezzo o lo sconto viene modificato, il prezzo di catalogo compare barrato con il link **Reimposta**, e il prezzo netto compare sotto la riga.
- Il margine IVA esclusa della riga compare sotto il suo totale se l’opzione è attiva.

Il prezzo e lo sconto di una riga vengono salvati come prezzo specifico limitato al carrello, come nella schermata nativa. Il prezzo del prodotto nel catalogo non cambia. Uno sconto di gruppo può ancora applicarsi in aggiunta: il prezzo mostrato sulla riga è sempre quello che PrestaShop fatturerà.

### 3. Indirizzi e consegna

L’indirizzo di consegna è il primo indirizzo del cliente. Cambialo con l’elenco a discesa, correggilo con **Modifica** o creane uno con **Nuovo indirizzo**. Deseleziona **Fattura all’indirizzo di consegna** per scegliere un altro indirizzo di fatturazione.

Un indirizzo già usato da un ordine passato non viene mai modificato: PrestaShop mantiene la vecchia versione su quegli ordini e il modulo salva un nuovo indirizzo, che sostituisce il vecchio nella rubrica del cliente.

I corrieri che consegnano questo carrello a questo indirizzo compaiono con logo, tempi di consegna e prezzo. Il primo corriere proposto da PrestaShop viene selezionato automaticamente. Se il negozio offre la confezione regalo o l’imballaggio riciclato, le opzioni compaiono sotto i corrieri. Un carrello che contiene solo prodotti virtuali non ha bisogno di un corriere.

### 4. Pagamento e stato

- **Metodo di pagamento**: i moduli di pagamento installati e attivi sul negozio.
- **Stato dell’ordine**: la nota sotto il campo indica se questo stato considera l’ordine come pagato.
- **Messaggio al cliente**: visibile nel suo account e sull’ordine, come un messaggio lasciato al momento dell’ordine.
- **Nota interna**: salvata nella nota dell’ordine, visibile solo nel back office.
- **Invia email al cliente**: se deselezionata, la conferma dell’ordine e l’email dello stato scelto non vengono inviate al cliente. Le email destinate al negozio vengono inviate normalmente.

## Il riepilogo

Il riepilogo mostra il numero di articoli, il totale dei prodotti, gli sconti, la spedizione, la confezione regalo, il totale IVA esclusa, le tasse e il totale IVA inclusa, poi il margine IVA esclusa e la sua percentuale. Un’icona di avviso segnala che un prodotto del carrello non ha un prezzo di costo.

- **Valuta e lingua**: i due elenchi in alto nel riepilogo. La lingua determina quella dei nomi dei prodotti e delle email del cliente.
- **Codice buono sconto**: digita un codice o clicca su uno dei suggerimenti, che sono i buoni utilizzabili da questo cliente. La crocetta rimuove un buono.
- **Sconto sull’ordine**: un importo IVA inclusa o una percentuale, poi **Applica**. Viene salvato come regola carrello monouso riservata al cliente.
- **Spedizione gratuita**: crea una regola carrello di spedizione gratuita per questo carrello, come l’opzione nativa.

La lista di controllo indica i passaggi rimanenti. **Crea l’ordine** (oppure Ctrl + Invio) segnala cosa manca se l’ordine non è completo. Una volta creato l’ordine, una finestra mostra il riferimento e il totale con tre scelte: aprire l’ordine, inserire un nuovo ordine per questo cliente o inserire un nuovo ordine.

## Link di pagamento

Quando il cliente preferisce pagare online, non creare l’ordine:

- **Invia per email** invia l’email nativa di PrestaShop che invita il cliente a procedere al pagamento del suo ordine, con il link del suo carrello.
- **Copia il link** mette lo stesso link negli appunti, per un SMS o un’app di messaggistica.

Il cliente arriva alla fase di pagamento del negozio, collegato al suo account, con il carrello preparato (prezzi modificati, sconti e corriere compresi). L’ordine viene creato dal suo pagamento.

## Bozza e più schede

Il carrello in corso viene conservato: tornando sulla pagina, il modulo riprende l’ultimo carrello del dipendente e lo segnala con un messaggio. Il numero del carrello compare nell’indirizzo della pagina, il che permette di inserire due ordini in due schede. **Ricomincia** avvia un nuovo inserimento, e il carrello precedente resta tra i carrelli del cliente.

Il pulsante **I miei ordini recenti** elenca gli ordini creati dal dipendente con il modulo.

## Scorciatoie da tastiera

- / o F2: cercare un prodotto
- Alt + C: cercare un cliente
- Alt + N: nuovo cliente
- ↑ ↓ poi Invio: scegliere nei risultati
- Esc: chiudere i risultati
- Ctrl + Invio: creare l’ordine
- ?: mostrare l’aiuto delle scorciatoie

## Nella pagina dell’ordine

Ogni ordine creato con il modulo mostra un riquadro **Inserimento ordini**: il dipendente che lo ha inserito, la data, se il cliente non è stato avvisato via email e il numero di righe il cui prezzo è stato modificato.

## Risoluzione dei problemi

### Non compare nessun corriere

Nessun corriere copre la zona del paese di consegna, oppure il peso o l’importo del carrello sono fuori dalle sue fasce. Verifica la configurazione dei corrieri o scegli un altro indirizzo.

### Il prodotto non viene aggiunto: «Solo X in magazzino»

Il prodotto non accetta ordini quando è esaurito. Attiva l’opzione **Consenti l’aggiunta di prodotti esauriti** nella configurazione, poi seleziona la casella **Consenti prodotti esauriti per questo ordine** sotto la ricerca prodotti.

### L’email del link di pagamento o della password non è partita

Il modulo usa le email di PrestaShop. Verifica la configurazione in **Parametri avanzati > E-mail** e invia un’email di prova.

### I pulsanti «Aggiungi nuovo ordine» aprono ancora la schermata nativa

Verifica che l’opzione di sostituzione sia attiva, poi svuota la cache del browser. Se il modulo è stato disattivato e poi riattivato, verifica che sia ancora agganciato all’hook `displayBackOfficeHeader`.
