# Prodotti Ricondizionati PrestaShop: installazione e configurazione > Panoramica Il modulo aggiunge a PrestaShop 8 e 9 la gestione dei prodotti ricondizionati e dei pezzi unici. Ogni grado di condizione (A, B, C e quelli che aggiungi) è… - Pagina: - Lingua: it - Aggiornato il: 2026-10-07 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dfrefurbished/index.md), [en](https://www.datafirefly.com/en/documentation/dfrefurbished/index.md), [es](https://www.datafirefly.com/es/documentation/dfrefurbished/index.md), [de](https://www.datafirefly.com/de/documentation/dfrefurbished/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfrefurbished/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfrefurbished/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfrefurbished/index.md) - Indice: ## Panoramica Il modulo aggiunge a PrestaShop 8 e 9 la gestione dei prodotti ricondizionati e dei pezzi unici. Ogni grado di condizione (A, B, C e quelli che aggiungi) è un valore di attributo nativo: un prodotto ricondizionato ha quindi combinazioni come «128 GB Nero, grado A». Ogni dispositivo è un'unità con il suo numero di serie, le sue foto e i suoi test, e lo stock di ogni combinazione di grado è pari al numero di unità disponibili. ## Installazione 1. In **Moduli > Gestione moduli**, clicca su **Carica un modulo** e invia il file `dfrefurbished-1.2.1.zip`. 2. L'installazione crea il gruppo di attributi **Grade (DataFirefly)**, mostrato come «Condizione» nel negozio, con i gradi A, B e C. 3. Compare il menu **Catalogo > Unità ricondizionate**. Il pulsante Configura del modulo porta ai gradi e alle impostazioni. Per aggiornare una versione precedente basta caricare il nuovo ZIP: lo script di aggiornamento aggiunge le colonne e le tabelle necessarie. ## Configurare i gradi Nella configurazione del modulo, il blocco **Gradi di condizione** elenca i gradi con: - **Codice** (A, B, C…) e **colore**, usati su schede, badge ed etichette; - **Nome e descrizione** in ogni lingua (link «Mostra tutte le lingue»); - **Impatto sul prezzo predefinito** in percentuale (0, -10 e -20% all'installazione); - **Posizione**: il primo grado è il migliore, il suo indicatore è pieno; - **Attivo**. L'ultima riga permette di aggiungere un grado (spunta **Aggiungi**). Un grado non si può eliminare perché è usato da combinazioni e ordini: disattivalo. ## Impostazioni del modulo - **Mostra le schede dei gradi** nella pagina prodotto, con indicatore, prezzo, risparmio e stock. - **Nascondi il selettore di grado nativo** quando le schede sono visibili. - **Modalità unità: nascondi il pulsante nativo di aggiunta al carrello**; il cliente aggiunge allora un pezzo con il suo pulsante. - **Maschera i numeri di serie** nelle pagine pubbliche (visibili gli ultimi 4 caratteri). - **Confronto nuovo/ricondizionato** e sua posizione: sotto il prodotto o accanto al pulsante carrello. - **Offerta ricondizionata nella pagina del prodotto nuovo**. - **Garanzie predefinite** del ricondizionato e del nuovo, in mesi. - **Prenotazione di un pezzo nel carrello**, 30 minuti per impostazione predefinita. - **Numeri di serie nella riga d'ordine**, quindi in fattura e nella nota di credito. - **Stati d'ordine che rimettono le unità in stock** (annullato ed errore di pagamento per impostazione predefinita) e stato delle unità liberate: disponibili o restituite (da controllare). - **Checklist dei test**: un punto per riga, in ogni lingua. Mantieni lo stesso ordine in tutte le lingue: i punti sono associati per numero di riga. Il blocco **Strumenti** dà accesso alle unità e alla risincronizzazione di tutto lo stock. ## Preparare un prodotto ricondizionato Apri il prodotto, scheda **Moduli**, poi **DataFirefly Refurbished & Unique Items**. 1. Spunta **Questo prodotto è venduto ricondizionato**. La condizione nativa del prodotto passa a «Ricondizionato». 2. Scegli la **modalità di vendita**: per grado (il pezzo viene assegnato all'ordine) o per pezzo (il cliente sceglie il dispositivo esatto). 3. Indica il **prodotto nuovo equivalente** per il confronto e il risparmio mostrato. Le combinazioni sono associate sugli stessi attributi (capacità, colore). 4. Se necessario, regola le garanzie e l'**impatto sul prezzo** di ogni grado per questo prodotto, in percentuale o importo IVA esclusa. Se vuoto, si applica la percentuale del grado. 5. Clicca su **Salva le impostazioni ricondizionato**. 6. Clicca su **Crea le combinazioni di grado**: una combinazione per ogni opzione di base (capacità, colore…) e grado attivo. L'opzione di eliminazione rimuove poi le combinazioni senza grado; gli ordini passati mantengono le loro righe. 7. Clicca su **Applica i prezzi dei gradi**. La tabella dei gradi mostra per ogni grado il numero di unità disponibili, vendute, restituite e nascoste. ## Aggiungere unità In **Catalogo > Unità ricondizionate**, clicca su **Aggiungi un'unità**. - **Prodotto** (ricerca per nome, riferimento o ID), **combinazione di base** e **grado**. La combinazione di grado viene creata automaticamente se non esiste. - **Numero di serie**: univoco per negozio. Il campo accetta un lettore di codici a barre. - **Stato**: disponibile, venduta, restituita, nascosta. - **Stato della batteria**, **garanzia** (vuoto = valore del prodotto o del modulo) e **data di ricondizionamento**. - **Prezzo di vendita proprio (IVA escl.)**: usato solo in modalità per pezzo. Vuoto = prezzo della combinazione di grado. - **Note pubbliche** in ogni lingua e **checklist dei test** (OK, difetto, N/D, non testato). - **Foto**: JPG, PNG, WebP o GIF, massimo 10 MB ciascuna, ridimensionate automaticamente. - Pannello **Interno**: SKU, prezzo di costo, provenienza e note interne, mai mostrati ai clienti. **Salva e aggiungi un'altra** mantiene prodotto, combinazione e grado per inserimenti in sequenza. La scheda dell'unità mostra la sua cronologia, un link alla scheda pubblica e un pulsante per stampare l'etichetta. ## Importare unità da CSV Pulsante **Importa CSV** nell'elenco delle unità. File UTF-8, separatore `;` o `,` rilevato dalla riga di intestazione. È disponibile un file di esempio. - Obbligatorie: `serial`, `grade` (codice del grado) e `product_id` o `product_reference`. - `base_reference`: riferimento della combinazione senza grado, vuoto per un prodotto senza altri attributi. - Facoltative: `status` (available, hidden, returned), `battery`, `warranty_months`, `date_refurbished` (AAAA-MM-GG), `price`, `cost_price`, `origin`, `sku`, `notes`, `internal_notes`. Spunta **Aggiorna le unità già note** per modificare i numeri esistenti, altrimenti vengono ignorati. Un'unità venduta non viene mai modificata da un'importazione. ## Nel negozio ### Pagina prodotto Le schede dei gradi mostrano l'indicatore di condizione, il prezzo («Da» quando i pezzi hanno prezzi diversi), il risparmio rispetto al nuovo e lo stock. Il link **Come sono definiti i gradi?** apre una finestra con la descrizione di ogni grado, la checklist e la garanzia. ### Modalità per pezzo Sotto le schede, l'elenco **Scegli il tuo pezzo** presenta ogni unità disponibile del grado scelto: foto (visualizzatore a schermo intero al clic), numero mascherato, batteria, test, garanzia e prezzo. Il pulsante **Aggiungi questo pezzo** lo prenota nel carrello per la durata impostata; un pezzo già prenotato da un altro cliente mostra «Prenotato». ### Confronto e prodotto nuovo La tabella confronta il nuovo e ogni grado: prezzo, risparmio, condizione estetica, garanzia, disponibilità. Nella pagina del prodotto nuovo, un riquadro propone l'offerta ricondizionata a partire dal grado meno caro. ### Scheda dell'unità e certificato Un'unità disponibile ha una scheda pubblica (non indicizzata) con foto, batteria, checklist e note del tecnico. Dopo la vendita, l'acquirente trova nel dettaglio dell'ordine un link al **certificato di condizione**, con il numero completo, la data di fine garanzia e un pulsante di stampa. ## Ordini - Alla conferma vengono assegnate prima le unità prenotate dal carrello, poi le unità libere più vecchie. Le unità con prezzo proprio restano riservate alla vendita per pezzo. - Il numero di serie viene aggiunto al nome della riga d'ordine se l'impostazione è attiva. - L'ordine nel back-office mostra un blocco **Unità ricondizionate** con un link a ogni unità. - Sugli stati scelti, le unità tornano disponibili o restituite e l'evento viene registrato nella loro cronologia. ## Cruscotto ed etichette Sopra l'elenco delle unità: unità in vendita, da controllare e nascoste, valore dello stock al prezzo di costo, età media dello stock e numero di unità in vendita da oltre 60 giorni, unità vendute, fatturato IVA esclusa e margine lordo a 30 giorni. L'azione di gruppo **Stampa etichette** apre un foglio A4 da 24 etichette 63,5 x 33,9 mm (tipo L7159): prodotto, grado, batteria, numero di serie e codice QR verso la scheda dell'unità. Il campo **Inizia dall'etichetta n.** permette di riutilizzare un foglio già iniziato. Stampa al 100%, senza margini né intestazioni. ## Limiti noti - Il prezzo proprio di un pezzo si applica solo in modalità per pezzo, e le regole di prezzo del catalogo non si applicano ai pezzi con prezzo proprio. - Su un prodotto ricondizionato, lo stock inserito a mano su una combinazione di grado viene sostituito dal numero di unità disponibili. - Se un dipendente senza permessi sul modulo modifica un prodotto, PrestaShop non esegue gli hook del modulo: usa la risincronizzazione dello stock. - Il nascondimento del selettore di grado nativo si basa sull'HTML della pagina prodotto nativa. Con un tema molto personalizzato, il selettore nativo può restare visibile accanto alle schede. - Se la prenotazione di un pezzo scade mentre è ancora nel carrello, un altro cliente può prenotarlo; l'ordine del primo cliente riceve allora un'altra unità dello stesso grado, se esiste.