# DataFirefly Specific Price Cleaner: pulire i prezzi specifici scaduti, duplicati e orfani

> Installazione Installate il modulo da Moduli > Gestione moduli > Carica un modulo inviando il file ZIP. All'installazione il modulo crea le sue tabelle e aggiunge la scheda Catalogo >…

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

## Installazione

Installate il modulo da **Moduli > Gestione moduli > Carica un modulo** inviando il file ZIP. All'installazione il modulo crea le sue tabelle e aggiunge la scheda **Catalogo > Pulizia prezzi specifici**. Non modifica alcun prezzo durante l'installazione.

Per aggiornare dalla 1.0.x basta caricare il nuovo ZIP. Lo storico e i backup della 1.0.x vengono ripresi, così come le impostazioni dell'attività cron (attivazione, modalità, frequenza). Aprite la scheda **Pianificazione** dopo l'aggiornamento per verificare che vi vadano bene.

## La dashboard

La pagina **Stato** analizza la tabella dei prezzi specifici, su tutto il catalogo o su un ambito scelto (negozio, categoria, ID prodotto). Mostra:

- il numero di prezzi specifici, di cui quelli attivi in questo momento;
- il numero di righe pulibili senza rischi con la pulizia predefinita (scaduti, duplicati, orfani);
- ciò che non viene mai eliminato per impostazione predefinita: prezzi legati a un carrello attivo, regole prezzi del catalogo, prezzi futuri, prezzi senza data di fine, prezzi usati da un altro modulo;
- il dettaglio per categoria di problema, con le righe eliminabili e protette di ciascuna;
- i conflitti di priorità e le regole di catalogo scadute, da rivedere a mano;
- la dimensione attuale della tabella, misurata dal database.

![Cruscotto dello stato dei prezzi specifici: righe pulibili, categorie di problemi e protezioni](https://www.datafirefly.com/wp-content/uploads/2026/11/cruscotto-stato-prezzi-specifici-dfspecificpricecleaner-it.webp)

La dashboard indica quante righe in meno avrà la tabella dopo la pulizia. L'effetto sulla velocità delle pagine dipende dal vostro negozio: il modulo non lo misura.

## La procedura di pulizia in 6 passi

Fate clic su **Avvia la procedura di pulizia**. I passi sono: Scegli, Simula, Verifica, Backup, Pulisci, Report. Nulla viene eliminato prima del passo Pulisci.

### 1. Scegli

Spuntate le categorie da pulire. Ogni contatore indica le righe che verrebbero eliminate con le protezioni attive. Regolate il ritardo dei prezzi scaduti (per esempio scaduti da almeno 7 giorni) e quello dei carrelli conclusi. Le **protezioni** restano spuntate per impostazione predefinita; togliete una spunta solo se sapete esattamente perché una riga deve sparire. I **filtri avanzati** limitano la pulizia a un negozio, una categoria, degli ID prodotto, un cliente, un gruppo, un paese, una valuta, un tipo di valore o una data di scadenza.

![Procedura di pulizia, fase 1: scelta delle categorie, protezioni e filtri avanzati](https://www.datafirefly.com/wp-content/uploads/2026/11/procedura-pulizia-scelta-categorie-dfspecificpricecleaner-it.webp)

### 2. Simula

**Avvia la simulazione** calcola il piano senza eliminare nulla: righe previste e protette per categoria. Il piano è congelato: solo queste righe potranno essere eliminate. Una riga che corrisponde a più categorie viene pianificata una sola volta, nella prima. Potete esportare il piano in CSV.

![Risultato della simulazione: righe previste e protette per categoria, nulla eliminato](https://www.datafirefly.com/wp-content/uploads/2026/11/simulazione-pulizia-prezzi-specifici-dfspecificpricecleaner-it.webp)

### 3. Verifica

L'elenco delle righe previste mostra per ciascuna il prodotto, il destinatario, il valore, il periodo e i segnali utili. Togliete la spunta a una riga per tenerla: una riga esclusa non viene mai eliminata.

![Verifica riga per riga del piano bloccato, ogni riga può essere esclusa](https://www.datafirefly.com/wp-content/uploads/2026/11/verifica-righe-prima-eliminazione-dfspecificpricecleaner-it.webp)

### 4. Backup

**Crea il backup** copia ogni riga prevista, colonna per colonna, nello storico del modulo. Potete scaricare questo backup in CSV prima di proseguire. Se il backup è disattivato nelle impostazioni, il modulo lo dice chiaramente: l'eliminazione sarà definitiva.

![Backup completo delle righe previste prima di ogni eliminazione, scaricabile in CSV](https://www.datafirefly.com/wp-content/uploads/2026/11/backup-prima-della-pulizia-dfspecificpricecleaner-it.webp)

### 5. Pulisci

Spuntate **Ho verificato la simulazione e voglio eliminare queste N righe.** e fate clic su **Elimina N righe**. Senza backup bisogna anche digitare il numero di righe. L'eliminazione procede a blocchi, ciascuno nella propria transazione, e ogni riga viene ricontrollata subito prima dell'eliminazione: una riga legata nel frattempo a un carrello, rigenerata da una regola o usata da un modulo viene saltata. Potete mettere in pausa e riprendere.

![Conferma esplicita prima della pulizia a blocchi transazionali con ripresa](https://www.datafirefly.com/wp-content/uploads/2026/11/conferma-esplicita-pulizia-dfspecificpricecleaner-it.webp)

### 6. Report

Il report indica, per categoria, le righe previste, eliminate, saltate, escluse e protette, e la durata. Mostra anche cosa è stato fatto dopo la pulizia: cache dei prezzi di PrestaShop svuotate e indice prezzi della ricerca a faccette aggiornato per i prodotti interessati. Dal report potete ripristinare, scaricare il backup o il report dettagliato in CSV, o inviarvi il report via e-mail.

![Report di pulizia per categoria, cache dei prezzi svuotate e ripristino in 1 clic](https://www.datafirefly.com/wp-content/uploads/2026/11/report-pulizia-prezzi-specifici-dfspecificpricecleaner-it.webp)

Se la scheda viene chiusa o il server si interrompe durante la pulizia, nulla resta a metà. La dashboard mostra la pulizia incompleta con **Apri e riprendi**, oppure potete abbandonare il resto.

## Categorie di pulizia

- **Prezzi scaduti**: la data di fine è passata, questi prezzi non si applicano più a nessuno.
- **Duplicati esatti**: stesso prodotto, destinatario, date, quantità e valore di una riga più vecchia; si tiene la più vecchia. L'indice univoco di PrestaShop normalmente li impedisce: il controllo resta utile per i dati importati.
- **Orfani**: prodotto eliminato (o assente dal negozio del prezzo), combinazione, cliente, gruppo, paese, valuta, negozio o gruppo di negozi eliminato.
- **Prezzi senza effetto**: «mantieni il prezzo di base» senza sconto. Quelli che possono annullare un altro sconto sono protetti.
- **Prezzi di carrelli conclusi**: prezzi creati per un carrello (preventivo, trattativa, regalo...) ordinato o non toccato dal ritardo scelto, oppure eliminato.
- **Priorità di prodotti eliminati** e **priorità identiche a quella globale**.
- **Selezione manuale**: righe scelte nell'elenco dei prezzi.

## Protezioni

- **Generato da una regola prezzi catalogo**: PrestaShop lo rigenera dalla regola. Sempre protetto: modificate o eliminate la regola.
- **Legato a un carrello**: creato per il carrello di un cliente da un modulo di preventivi, B2B, configuratore o regalo. Solo la categoria Carrelli conclusi può rimuoverlo.
- **Inizia in futuro**: promozioni pianificate.
- **Senza data di fine (illimitato)**: conservati per impostazione predefinita, anche se sembrano inutili.
- **Usato da un altro modulo**: un modulo lo referenzia ancora nelle proprie tabelle. La dashboard elenca i moduli rilevati.
- **Può annullare un altro sconto**: un prezzo senza effetto può prevalere su uno sconto di gruppo o globale e annullarlo per il suo destinatario.

## L'elenco dei prezzi

La scheda **Prezzi specifici** elenca tutti i prezzi specifici con gli stessi filtri della procedura, e segnali per i prezzi legati a un carrello, generati da una regola o usati da un modulo di terze parti. Spuntate delle righe per avviare una simulazione solo su questa selezione.

![Elenco dei prezzi specifici con filtri avanzati e segnali carrello, regola e modulo](https://www.datafirefly.com/wp-content/uploads/2026/11/elenco-prezzi-specifici-filtri-dfspecificpricecleaner-it.webp)

## Storico e ripristino

La scheda **Storico e ripristino** elenca ogni pulizia e ogni simulazione pianificata, con autore, report e backup. Le pulizie vengono conservate con il loro backup per la durata scelta nelle impostazioni (90 giorni di default), poi eliminate automaticamente.

![Storico delle pulizie e delle simulazioni pianificate, con backup e ripristino](https://www.datafirefly.com/wp-content/uploads/2026/11/storico-pulizie-backup-dfspecificpricecleaner-it.webp)

**Ripristina** rimette le righe con il loro ID originale, poi confronta ciascuna con il backup. Il report mostra quindi il numero di righe ripristinate e la data.

![Ripristino in 1 clic: conferma prima di rimettere le righe con il loro ID originale](https://www.datafirefly.com/wp-content/uploads/2026/11/ripristino-un-clic-conferma-dfspecificpricecleaner-it.webp)

![Ripristino completato: righe rimesse con il loro ID e verificate identiche al backup](https://www.datafirefly.com/wp-content/uploads/2026/11/ripristino-verificato-riga-per-riga-dfspecificpricecleaner-it.webp)

## Pianificazione

La scheda **Pianificazione** configura una pulizia automatica richiamata dall'attività cron del vostro hosting. Le protezioni della procedura sono sempre attive.

- **Modalità**: _Solo simulazione_ (report, nulla eliminato), consigliata per iniziare, oppure _Pulizia_ con backup automatico.
- **Frequenza**: ogni ora, giorno, settimana o mese. Le chiamate fatte prima della scadenza successiva vengono ignorate.
- **Categorie**, ritardo dei prezzi scaduti e dei carrelli conclusi, limitazione ai prezzi riservati a un cliente o a un negozio.
- **Al massimo N righe per esecuzione**: il resto viene elaborato all'esecuzione successiva.
- **Report via e-mail** dopo ogni esecuzione, all'indirizzo scelto o a quello del negozio.

Copiate l'**URL cron** mostrato e richiamatelo dal vostro hosting, per esempio ogni ora: il modulo applica la frequenza scelta. Aggiungete `&dry=1` per forzare una simulazione. Tenete privato questo URL: il token lo protegge e potete generarne uno nuovo. Una chiamata con un token errato riceve un errore 403; se un'esecuzione è già in corso, la chiamata riceve un errore 423.

![Pianificazione: simulazione o pulizia via cron, frequenza, categorie e report via e-mail](https://www.datafirefly.com/wp-content/uploads/2026/11/pianificazione-pulizia-cron-dfspecificpricecleaner-it.webp)

![Report di pulizia ricevuto via e-mail, dettagliato per categoria](https://www.datafirefly.com/wp-content/uploads/2026/11/report-pulizia-via-email-dfspecificpricecleaner-it.webp)

## Impostazioni

- **Backup prima di ogni eliminazione**: fortemente consigliato, permette il ripristino in un clic.
- **Conservazione dei backup** in giorni (0 = per sempre).
- **Profili autorizzati a pulire e ripristinare**, oltre al permesso «Elimina» della scheda.
- **Conserva lo storico e i backup alla disinstallazione**.
- **Elimina tramite gli oggetti PrestaShop**: sì di default, perché gli hook di eliminazione vengano eseguiti (ERP, feed e moduli di sincronizzazione restano informati). No: SQL diretto, più veloce su volumi molto grandi.
- **Righe per blocco** (500 di default): ogni blocco è una transazione. Abbassatelo se il server interrompe le richieste lunghe.
- **Aggiorna l'indice prezzi della ricerca a faccette** per i prodotti interessati (fino a 300).
- **Elimina ora il vecchio storico**: rimuove le pulizie più vecchie della durata di conservazione e le simulazioni mai eseguite.

![Impostazioni: backup, conservazione, profili autorizzati ed elaborazione a blocchi](https://www.datafirefly.com/wp-content/uploads/2026/11/impostazioni-sicurezza-backup-dfspecificpricecleaner-it.webp)

## Blocchi sulla scheda prodotto e cliente

Sulla scheda prodotto, il blocco **Stato dei prezzi specifici** indica il numero di prezzi del prodotto, quelli pulibili e lo stato di ciascuno (attivo, scaduto, futuro, carrello, regola, modulo). Il pulsante **Simula una pulizia di questo prodotto** apre la procedura già filtrata.

![Blocco della scheda prodotto: stato dei prezzi specifici del prodotto e simulazione diretta](https://www.datafirefly.com/wp-content/uploads/2026/11/blocco-scheda-prodotto-prezzi-dfspecificpricecleaner-it.webp)

Sulla scheda cliente, il blocco elenca i prezzi riservati al cliente e i carrelli collegati, con una pulizia mirata su questo cliente.

![Blocco della scheda cliente: prezzi riservati, carrelli collegati e pulizia mirata](https://www.datafirefly.com/wp-content/uploads/2026/11/blocco-scheda-cliente-prezzi-dfspecificpricecleaner-it.webp)

## Permessi dei dipendenti

Consultare il modulo richiede il permesso «Visualizza» della scheda. Pulire e ripristinare richiedono il permesso «Elimina» della scheda in **Parametri avanzati > Team > Permessi**, e che il profilo sia spuntato nelle impostazioni del modulo. Il profilo SuperAdmin è sempre autorizzato. Un profilo senza questi diritti vede le pagine in sola lettura.

## Per gli sviluppatori di moduli

Subito prima di eliminare un blocco, il modulo esegue l'hook `actionDfSpecificPriceCleanerBeforeDelete` con l'ID della pulizia e l'elenco degli ID dei prezzi. Un modulo può aggiungere all'array `veto` gli ID dei prezzi che vuole tenere: queste righe vengono saltate e restano al loro posto.

## Risoluzione dei problemi

### Alcune righe vengono «saltate» durante la pulizia

Sono cambiate dopo la simulazione: legate a un carrello, rigenerate da una regola o usate da un modulo. È voluto. Avviate una nuova simulazione per riesaminarle.

### La simulazione non prevede alcuna riga

Tutte le righe corrispondenti sono protette, oppure nessuna corrisponde ai filtri. Il contatore «protette» di ogni categoria indica cosa viene tenuto e perché.

### La pulizia si ferma su un grande volume

Abbassate **Righe per blocco** nelle impostazioni, poi riprendete la pulizia dalla dashboard. I blocchi già elaborati non vengono rifatti.

### L'URL cron risponde 403, 423 o SKIPPED

403: token errato, ricopiate l'URL dalla scheda Pianificazione. 423: un'esecuzione è ancora in corso. SKIPPED: pianificazione disattivata, scadenza non ancora raggiunta o nessuna categoria spuntata.

### Il report consiglia di ricostruire l'indice

Oltre 300 prodotti interessati, il modulo non aggiorna da solo l'indice prezzi della ricerca a faccette. Ricostruite l'indice dalla configurazione del modulo di ricerca a faccette.

## Limiti

- I conflitti di priorità e le regole di catalogo scadute vengono segnalati, mai eliminati automaticamente.
- Il report via e-mail viene inviato nella lingua del dipendente (pulsante del report) o nella lingua predefinita del negozio (cron).
- Senza backup, un'eliminazione non può essere annullata.

## Compatibilità

- PrestaShop da 1.7.8 a 9.x con lo stesso ZIP. Testato su 1.7.8.11, 8.2.1 e 9.1.5, con PHP 7.4, 8.1 e 8.5.
- Multinegozio: analisi e pulizia limitabili a un negozio.
- Architettura ModuleAdminController, senza dipendenze Composer.
- Interfaccia tradotta in francese, inglese, spagnolo, tedesco, italiano, olandese, polacco e portoghese.
