Modificare un ordine PrestaShop con DataFirefly Order Editor

Presentazione

DataFirefly Order Editor aggiunge un editor alla pagina di ogni ordine del back-office, subito sotto il blocco Prodotti. Permette di modificare un ordine convalidato come un carrello: aggiungere o rimuovere prodotti, cambiare una combinazione, correggere una quantità o un prezzo, cambiare indirizzo o corriere, rimuovere o aggiungere uno sconto. Ogni modifica viene ricalcolata dal motore del carrello di PrestaShop e la fattura viene annullata con una nota di credito e riemessa, oppure aggiornata, a tua scelta.

Il modulo funziona su PrestaShop da 8.0 a 9.x. È tradotto in italiano, inglese, francese, spagnolo, tedesco, olandese, polacco e portoghese.

Installazione

1. In Moduli > Gestione moduli, clicca su Carica un modulo e trascina il file dforderedit-1.0.0.zip.
2. All’installazione, il modulo assegna i suoi permessi ai profili che possono già modificare gli ordini (ad esempio SuperAdmin, Venditore, Logistico).
3. Apri un ordine: il blocco Editor ordini compare sotto il blocco Prodotti.

Configurazione

La pagina di configurazione del modulo offre cinque impostazioni:

• Stati dell’ordine modificabili: l’editor viene proposto solo per gli ordini in questi stati. Annullato, Rimborsato ed Errore di pagamento sono esclusi per impostazione predefinita.
• Gestione predefinita della fattura: nota di credito e nuova fattura (consigliato), oppure aggiornamento della fattura esistente con lo stesso numero. La scelta si può cambiare a ogni modifica.
• Rimettere in stock le quantità rimosse per impostazione predefinita.
• Avvisare il cliente via e-mail per impostazione predefinita.
• Aggiungere una nota privata all’ordine dopo ogni modifica.

Modificare un ordine

Aprire l’editor

Nella pagina dell’ordine, clicca su Modifica questo ordine. Finché non confermi nulla, l’ordine non viene toccato: il pulsante Reimposta annulla tutte le modifiche in corso e il browser ti avvisa se lasci la pagina con modifiche non applicate.

Prodotti

• Aggiungere un prodotto: digita un nome, un riferimento, un EAN o un ID nella ricerca (più parole, in qualsiasi ordine). Le frecce e il tasto Invio permettono di scegliere da tastiera. Per un prodotto con combinazioni, scegli la combinazione nell’elenco che compare.
• Cambiare la combinazione: l’elenco indica lo stock di ogni combinazione. Il prezzo della nuova combinazione viene ripreso automaticamente e resta modificabile.
• Correggere la quantità o il prezzo: il prezzo pagato dal cliente viene mantenuto per impostazione predefinita. Il link Applica il prezzo di catalogo riprende il prezzo attuale per quel cliente (gruppo, prezzi specifici, sconti quantità).
• Inserimento IVA esclusa o inclusa: il pulsante sopra la tabella sceglie la modalità. Per impostazione predefinita segue la visualizzazione dei prezzi del gruppo del cliente. Un prezzo inserito IVA inclusa viene convertito IVA esclusa, che resta il riferimento dell’ordine.
• Rimuovere una riga: l’icona del cestino barra la riga, l’icona della freccia la ripristina.

Indirizzi

Scegli un altro indirizzo del cliente nell’elenco o clicca su Modifica i campi di questo indirizzo per correggere una via o un CAP. Un indirizzo modificato viene salvato come nuovo indirizzo collegato solo a questo ordine: gli ordini passati e la rubrica del cliente non cambiano. Se il paese cambia, l’IVA dei prodotti e della spedizione viene ricalcolata.

Sconti

Deseleziona uno sconto per rimuoverlo dall’ordine. La ricerca aggiunge una regola carrello esistente per nome o codice. Il link Aggiungi uno sconto libero crea uno sconto in importo IVA inclusa o in percentuale con l’etichetta che preferisci, senza passare dal catalogo delle regole carrello. Questo sconto viene salvato come regola carrello disattivata, riservata al cliente e già consumata: non può essere riutilizzata nel carrello.

Spedizione

L’elenco dei corrieri propone solo quelli che possono consegnare il carrello modificato all’indirizzo scelto, con prezzo e tempi. Per le spese di spedizione ci sono tre modalità:

• Mantieni le spese di spedizione dell’ordine: l’importo IVA esclusa viene mantenuto, l’imposta segue l’indirizzo se cambia paese.
• Ricalcola con il corriere scelto: obbligatorio quando cambi corriere.
• Imposta le spese di spedizione (IVA incl.).

Opzioni

• Stato dell’ordine dopo la modifica: lo stato cambia tramite la cronologia nativa di PrestaShop, con le solite e-mail.
• Rimetti in stock le quantità rimosse.
• Invia al cliente il riepilogo dell’ordine modificato, nella sua lingua.
• Fattura: nota di credito e nuova fattura, oppure aggiornamento della fattura esistente.
• Nota interna, salvata nella cronologia delle modifiche.

Nuovi totali e conferma

Pochi istanti dopo ogni modifica, la barra fissata in fondo allo schermo mostra il totale IVA inclusa prima e dopo, la differenza e quanto il cliente deve ancora o l’importo pagato in eccesso da rimborsare. Il link Dettagli apre il confronto riga per riga (quantità, prezzi, aliquote), gli sconti, gli indirizzi e tutti i totali. Gli avvisi compaiono sopra: stock insufficiente, regola carrello il cui minimo non è più raggiunto, corriere che non consegna più.

Clicca su Applica le modifiche: la conferma elenca le righe interessate, gli sconti, il cambio di corriere, i documenti che verranno creati e il nuovo stato. Clicca su Conferma e applica e la pagina si ricarica con l’ordine aggiornato.

Fattura e nota di credito

Modalità nota di credito e nuova fattura (predefinita)

1. Il PDF della fattura viene archiviato così com’era, prima di qualsiasi scrittura.
2. Una nota di credito annulla la fattura per l’intero importo. Anche il suo PDF viene archiviato.
3. Viene emessa una nuova fattura con il numero successivo. Righe, sconti, corriere e pagamenti vengono collegati a essa.

Il link di download della fattura annullata, nel back-office come nell’account del cliente, restituisce sempre il PDF originale. La fattura annullata non viene più proposta nel modulo di aggiunta pagamento.

Modalità aggiornamento

Gli importi della fattura esistente vengono aggiornati e mantiene il suo numero, come fa PrestaShop in modo nativo. Il PDF precedente alla modifica viene comunque archiviato. Un ordine con più fatture passa sempre dalla modalità nota di credito e nuova fattura.

Pagamenti e rimborsi

Il pagamento già ricevuto resta sull’ordine. Quando il nuovo totale è più alto, PrestaShop mostra l’importo residuo come per qualsiasi pagamento parziale. Quando è più basso, l’importo pagato in eccesso compare nell’editor e il rimborso si fa con il tuo fornitore di pagamento.

Quando un ordine passa poi a uno stato pagato, PrestaShop aggiunge normalmente un pagamento per ogni fattura non saldata. Il modulo impedisce questo pagamento fittizio sulle fatture annullate da una nota di credito.

Stock

Lo stock viene adeguato per differenza. Una quantità portata da 2 a 3 consuma un’unità, una riga rimossa rimette la sua quantità in stock se l’opzione è selezionata, una combinazione sostituita restituisce la vecchia e consuma la nuova. Le quantità riservate vengono ricalcolate alla fine.

Righe bloccate

• Riga rimborsata o resa: non è né modificabile né rimovibile, per non falsare le note di credito esistenti. Le altre righe dell’ordine restano modificabili.
• Riga personalizzata (testo, file inviato dal cliente): può essere rimossa ma non modificata. Il testo della personalizzazione è mostrato sotto la riga e i file del cliente non vengono mai toccati.
• Prodotto eliminato dal catalogo: la riga può solo essere rimossa.

Cronologia e tracciabilità

La cronologia, sotto l’editor, elenca ogni modifica: data, dipendente, righe, sconti, indirizzi, corriere e stato modificati, totale prima e dopo, nota interna e link ai PDF archiviati. Una nota privata riassume inoltre la modifica nei messaggi dell’ordine.

Alla disinstallazione, la cronologia e i PDF archiviati vengono conservati, così le fatture annullate restano identificate se il modulo viene reinstallato.

Per gli sviluppatori

• actionOrderEdited: hook nativo di PrestaShop, chiamato con order dopo ogni modifica.
• actionDfOrderEditAfter: chiamato con order, id_dforderedit_log, changes (righe, sconti, indirizzi, corriere, totali) e id_order_slips.

Il ricalcolo usa un carrello temporaneo mai collegato a un ordine ed eliminato alla fine. L’anteprima viene calcolata in una transazione annullata.

Risoluzione dei problemi

L’editor non compare nell’ordine

Verifica che lo stato dell’ordine sia tra gli stati modificabili della configurazione e che il profilo del dipendente possa modificare gli ordini e vedere il modulo.

Il corriere non può consegnare il nuovo carrello

Peso, importo o zona sono fuori dalle fasce del corriere. Scegli un altro corriere dall’elenco o imposta le spese di spedizione a mano.

Il prezzo di una riga non è stato fissato esattamente

Una regola del catalogo (ad esempio uno sconto di gruppo) si applica sopra il prezzo inserito. Controlla il prezzo nei dettagli prima di confermare.

Ordine proveniente da un carrello multi-corriere

Quando un carrello è stato suddiviso in più ordini, le regole carrello vengono ricalcolate solo sull’ordine modificato. Un avviso lo ricorda nell’anteprima.