- moduł został kompletnie przepisany + dodano masę nowych opcji
Caratteristiche e vantaggi principali
- Aggiornamento massivo dei prezzi: un solo file CSV può indicare molti prodotti, riducendo la necessità di aprire e modificare le loro schede separatamente.
- Adattamento al listino del fornitore: la scelta del separatore, il supporto dell’intestazione e la mappatura delle colonne consentono di utilizzare diversi layout di dati senza dover riposizionare manualmente ogni colonna.
- Calcolo ripetibile dei prezzi: le impostazioni salvate di ricarico, riduzione e arrotondamento vengono utilizzate nelle successive importazioni dei prodotti base.
- Controllo prima dell’aggiornamento: la simulazione mostra le decisioni pianificate senza salvare i prezzi nel catalogo.
- Chiarezza del risultato: il riepilogo e il report permettono di distinguere modifiche, elementi saltati, identificatori sconosciuti e righe bloccate dai limiti.
- Possibilità di ripristinare i valori salvati: la cronologia consente di annullare le esecuzioni per le quali sono stati conservati i dati necessari al ripristino.
- Supporto per la ricezione regolare dei listini: il download del file e l’importazione possono essere avviati da una pianificazione CRON esterna.
Importazione CSV e abbinamento dei prodotti
Il formato predefinito comprende due colonne: identificatore e prezzo. Nella pagina di mappatura è possibile assegnare altre posizioni di colonna all’identificatore, al prezzo di vendita e al costo di acquisto, ignorando gli altri campi. Il modulo mostra un’anteprima del file caricato e può proporre l’assegnazione in base alle intestazioni riconosciute; la proposta richiede verifica e salvataggio.
- Identificatori: riferimento prodotto, cioè codice SKU, EAN13, UPC, ID prodotto e ID combinazione in modalità combinazioni. MPN è disponibile se il relativo campo esiste nel database di quella installazione.
- Codici ripetuti nel catalogo: l’impostazione consente di aggiornare la prima corrispondenza oppure tutti i record con lo stesso identificatore.
- Formato dei numeri: sono supportati la virgola o il punto decimale, gli spazi negli importi e i simboli di valuta accanto al numero. La rimozione del simbolo di valuta non implica la conversione del tasso di cambio.
- Formato del file: separatore configurabile, incluso il tabulatore, riga di intestazione facoltativa, campi tra virgolette e rimozione del marcatore BOM dal file UTF-8.
- Controllo della reimportazione manuale: è possibile bloccare l’uso di un nome file già registrato nella cronologia delle importazioni manuali applicate di quel negozio. Le simulazioni e le esecuzioni CRON non vengono considerate in questo controllo.
Esempio di listino CSV di base
reference;price
PROD-001;99.90
PROD-002;149,50
PROD-003;219.00
Per questo esempio occorre selezionare il riferimento come identificatore, il punto e virgola come separatore e attivare l’opzione per ignorare la prima riga come intestazione. La prima colonna è l’identificatore e la seconda è il prezzo. Il modo in cui gli importi vengono interpretati come netti o lordi si imposta separatamente.
Calcolo dei prezzi di vendita e regole di prezzo
Per i prodotti base, il punto di partenza può essere il prezzo dal CSV, il costo di acquisto dalla colonna CSV assegnata oppure il prezzo di acquisto già salvato nel catalogo. Il costo letto dal file serve per i calcoli; il modulo non lo salva come nuovo prezzo di acquisto del prodotto.
- Ricarico sul costo: il prezzo viene calcolato secondo la formula: costo × (1 + percentuale / 100). Ad esempio, un costo di 100 zł e un ricarico del 30% danno un prezzo di 130 zł prima di un eventuale arrotondamento.
- Riduzione percentuale: il modulo sottrae la percentuale selezionata dal valore indicato come punto di partenza.
- Arrotondamento: sono disponibili due cifre decimali, finale ,99, unità intere per eccesso, unità intera più vicina e mantenimento del risultato senza arrotondamenti aggiuntivi.
- Ricarico minimo sul costo: dopo l’arrotondamento il prezzo può essere aumentato fino al livello risultante dal ricarico minimo impostato, purché sia disponibile un costo di acquisto positivo.
- Regole condizionali: è possibile definire un comportamento separato per produttore, fornitore indicato nel prodotto, categoria predefinita, intervallo di valori in ingresso oppure tutti i prodotti inclusi nell’importazione. La regola può anche escludere elementi dall’aggiornamento.
- Ordine delle regole: prevale la prima regola attiva corrispondente. Se nessuna corrisponde, vengono applicate le impostazioni predefinite. L’elenco delle regole è assegnato al negozio di destinazione.
Qui ricarico e margine indicano calcoli diversi. Un ricarico del 30% su un costo di 100 zł dà 130 zł, cioè un margine di circa il 23,08% del prezzo di vendita. Nel riepilogo il modulo calcola il margine secondo la formula: (prezzo di vendita netto − costo netto) / prezzo di vendita netto. Il prospetto riguarda gli elementi per i quali è disponibile il costo necessario al calcolo.
Prezzi netti, lordi e combinazioni di prodotto
L’importazione dei prezzi netti salva i valori senza ricalcolare l’imposta. Per i prezzi lordi è possibile scegliere un’aliquota IVA fissa oppure il ricalcolo secondo la regola fiscale del prodotto per il paese predefinito del negozio di destinazione. Con un file lordo, le regole di prezzo e l’arrotondamento operano sugli importi lordi, e solo il risultato viene poi convertito in netto. L’assenza dell’aliquota necessaria per il ricalcolo viene indicata nel riepilogo.
In modalità combinazioni il file definisce l’impatto della variante sul prezzo base del prodotto. Con un prezzo base di 100 zł e un impatto della combinazione di 20 zł, il totale è 120 zł netti prima dell’imposta e di altri meccanismi di prezzo del negozio. È anche possibile attivare l’azzeramento del prezzo base dei prodotti le cui combinazioni sono state aggiornate; tale modifica influisce sulle altre varianti dello stesso prodotto. Le regole di ricarico, riduzione percentuale e arrotondamento, nonché la creazione di riduzioni come prezzi specifici, riguardano l’importazione dei prodotti base.
Simulazione, limiti di modifica e riduzioni come sconti
La simulazione consente di verificare come il modulo leggerà il listino e quali decisioni prenderà, senza salvare i prezzi dei prodotti. Nelle impostazioni dei limiti è possibile controllare la percentuale massima di aumento e diminuzione, il prezzo zero e, per i prodotti base con prezzo di acquisto salvato, anche la vendita sotto costo e il ricarico minimo rispetto al costo di catalogo.
- Salto della riga: un elemento che viola un limite viene inserito nel report, mentre gli altri elementi possono essere aggiornati.
- Interruzione dell’intera esecuzione: l’analisi che precede il salvataggio verifica i limiti attivi; la loro violazione comporta il rifiuto dell’importazione prima della modifica dei prezzi.
- Limite degli elementi non abbinati: il raggiungimento della soglia impostata di righe non abbinate interrompe l’esecuzione prima del salvataggio.
- Gestione dei dati errati: l’assenza delle colonne richieste, un identificatore vuoto o un prezzo richiesto non valido vengono segnalati come elementi saltati.
L’opzione delle riduzioni come sconti mantiene il prezzo di catalogo del prodotto base e salva la differenza tra esso e il prezzo finale inferiore come prezzo specifico PrestaShop di tipo importo. Le importazioni successive gestiscono gli sconti salvati dal modulo. Nelle installazioni aggiornate dalla linea 1.1.x, il meccanismo di pulizia degli sconti più vecchi può includere anche un precedente sconto fisso in importo, senza condizioni, aggiunto manualmente per questo negozio.
Report, cronologia e annullamento degli aggiornamenti
Il riepilogo mostra il numero di righe lette, prodotti e combinazioni modificati, prezzi invariati, salti, mancati abbinamenti e blocchi. Contiene anche informazioni su aumenti e diminuzioni di prezzo, le variazioni maggiori e i risultati dell’applicazione delle regole di prezzo.
- Report CSV: contiene la decisione per l’elemento, il motivo, il numero di riga, l’identificatore, l’ID prodotto o combinazione e i valori disponibili prima e dopo la modifica.
- Anteprima delle differenze nel pannello: consente di filtrare per risultato, direzione della modifica e variazione percentuale minima. Il report completo può essere scaricato in un file.
- Cronologia delle esecuzioni: mette a disposizione i risultati salvati di importazioni e simulazioni, i report e le azioni di ripristino e rimozione delle voci.
- Memorizzazione dei prezzi precedenti: attivando questa opzione è possibile ripristinare i valori salvati prima di una determinata esecuzione. Per impostazione predefinita vengono conservati i dati di annullamento delle ultime 10 esecuzioni, separatamente per negozio.
- Riepilogo e-mail: dopo un aggiornamento applicato è possibile inviare un messaggio all’indirizzo indicato. Un report inferiore a 2 MiB viene allegato al messaggio; uno più grande resta disponibile per il download nel pannello.
L’annullamento può anche rimuovere gli sconti creati dall’esecuzione e ripristinare gli sconti eliminati, se ne è stata conservata la registrazione. Il ripristino di un prezzo precedente può sovrascrivere una modifica successiva dello stesso campo. La disponibilità di questa operazione dipende dai dati di cronologia conservati e non sostituisce un backup del database del negozio.
Download dei listini, profili fornitore e CRON
La fonte del listino può essere un file caricato dal computer oppure un indirizzo del fornitore. Il download remoto supporta HTTP/HTTPS, FTP con opzione FTPS e SFTP, se la libreria cURL sul server rende disponibile questo protocollo. I dati di connessione comprendono rispettivamente indirizzo, host, porta, percorso, login e password.
Il profilo fornitore salva sotto un nome le impostazioni di importazione ed esportazione, la mappatura delle colonne, le impostazioni predefinite di calcolo dei prezzi, i limiti e la fonte del file. I profili appartengono al negozio di destinazione, ma non memorizzano la sua selezione, il file caricato, il segreto CRON né la password del fornitore. L’elenco delle regole condizionali resta assegnato al negozio. Dopo il cambio del fornitore occorre verificare i dati di autenticazione.
Il modulo mette a disposizione un indirizzo CRON protetto da segreto e le operazioni di download del file, importazione, download combinato con importazione e lettura dello stato. La pianificazione si imposta sul server o in un servizio che richiama periodicamente l’indirizzo. La chiamata può indicare un profilo e le chiamate successive continuano l’importazione avviata. I profili non costituiscono un archivio di password separate per più fornitori; la corrispondenza della password attuale con il profilo viene verificata durante la chiamata automatica che richiede autenticazione.
Esportazione dei prezzi, file più grandi e multistore
L’esportazione genera un CSV con gli identificatori e i prezzi netti attuali del negozio selezionato. È possibile scegliere i prodotti base oppure le combinazioni, il tipo di identificatore e il separatore. Per le combinazioni viene esportato l’impatto sul prezzo base. La reimportazione richiede la verifica della mappatura, la selezione dei prezzi netti e delle impostazioni delle regole, per non ricalcolare nuovamente importi già preparati.
I file di dimensione pari o superiore a 512 KiB avviati nel pannello vengono elaborati per fasi con indicazione dello stato di avanzamento. Dopo la chiusura della scheda, le fasi successive non vengono eseguite dal browser; tornando alla pagina di importazione è possibile continuare dal punto salvato. Il limite del file nel modulo è di 32 MiB e le impostazioni PHP possono limitare ulteriormente la dimensione del file caricato.
In un’installazione multistore si selezionano il negozio di destinazione dell’importazione e il negozio dell’esportazione. I prezzi vengono aggiornati nel negozio selezionato, mentre le impostazioni di base del modulo sono condivise per l’installazione. Profili, regole condizionali e dati di cronologia sono associati al negozio.
Come preparare l’aggiornamento dei prezzi?
- Seleziona il negozio di destinazione, l’ambito dell’aggiornamento e l’identificatore coerente con i dati del catalogo.
- Carica o scarica il file, controlla l’anteprima, il separatore, l’intestazione e la mappatura delle colonne.
- Imposta netto o lordo, le regole di prezzo necessarie, i limiti di modifica e la memorizzazione dei prezzi precedenti.
- Avvia la simulazione e controlla il riepilogo e il report delle differenze.
- Avvia l’aggiornamento con la simulazione disattivata, quindi controllane il risultato nella cronologia.
Ambito di funzionamento e requisiti
Importazione prezzi da CSV Pro aggiorna i dati di prezzo di prodotti e combinazioni esistenti. Non crea nuovi prodotti né importa scorte, descrizioni, immagini, pesi o codici identificativi nelle schede prodotto. Excel e altri fogli di calcolo possono essere usati per preparare il listino, ma il file deve essere salvato in formato CSV; il modulo non importa direttamente XLSX né XML.
Per la versione 1.4.0 il modulo dichiara il supporto per PrestaShop dalla 1.7.6 alla 9.x. La documentazione indica l’intervallo PHP 7.0–8.5, fermo restando che la versione PHP deve contemporaneamente soddisfare i requisiti della versione di PrestaShop utilizzata. Il download remoto richiede cURL e gli aggiornamenti pianificati richiedono la configurazione di un CRON esterno.
Link alla demo del modulo:
Demo pannello amministrativo:
https://moduly-prestashop.eu/masowa-aktualizacja-csv-cen/admin-dev
Demo front office:
https://moduly-prestashop.eu/masowa-aktualizacja-csv-cen