- moduł został kompletnie przepisany pod nowy PrestaShop 9.x
Fonti XML e adattamento del catalogo al negozio
- Più fonti di dati: ogni fonte ha un proprio nome, una configurazione di connessione, uno stato di attività e un adattatore assegnato, cioè il meccanismo che legge la sua struttura XML.
- Impostazioni generali e individuali: alcuni parametri di importazione possono essere sovrascritti per una fonte specifica, tra cui fascia di prezzo, regole di aggiornamento, download delle immagini e modalità di gestione dei prodotti mancanti.
- Aggiunta di prodotti e aggiornamento di quelli esistenti: il modulo salva i collegamenti tra i prodotti della fonte e le schede prodotto in PrestaShop e li utilizza durante le importazioni successive.
- Adattamento al proprio catalogo: i prodotti esistenti possono essere riconosciuti in base al campo selezionato: riferimento prodotto, EAN-13, UPC o MPN, purché il campo sia disponibile nella versione del negozio utilizzata. L’efficacia dell’abbinamento dipende dalla coerenza e dall’univocità degli identificatori.
- Mappatura delle categorie: le categorie della fonte possono essere collegate alle categorie del negozio oppure create durante l’importazione. La configurazione comprende la categoria predefinita e l’attività dei collegamenti.
- Mappatura di produttori, fornitori, caratteristiche e attributi: schermate separate aiutano ad assegnare i dati della fonte agli elementi appropriati del catalogo PrestaShop. Sono disponibili anche operazioni di abbinamento automatico in base ai nomi.
Importazione dei dati prodotto e controllo degli aggiornamenti
- Nomi e descrizioni: importazione del nome, della descrizione completa e breve, con interruttori separati per il loro aggiornamento. I dati devono essere forniti dalla fonte e supportati dal relativo adattatore.
- Identificatori e parametri fisici: supporto per riferimento, EAN-13, UPC, MPN, peso e dimensioni del prodotto, in base ai dati della fonte e alla disponibilità dei campi in PrestaShop.
- Prezzi e disponibilità: aggiornamento del prezzo di vendita, del prezzo di acquisto, della quantità e dello stato di attività del prodotto nell’ambito supportato dalla fonte. Il modulo consente anche di configurare i testi di disponibilità e i messaggi relativi ai tempi di consegna.
- Immagini dei prodotti: download delle immagini dagli indirizzi forniti nei dati, possibilità di disattivarne il download e di limitare il numero di immagini importate. L’aggiornamento delle immagini può essere controllato separatamente per i prodotti importati e per quelli abbinati al catalogo esistente.
- Caratteristiche tecniche: assegnazione delle caratteristiche ai prodotti e scelta tra la sostituzione del loro set o la fusione. La fusione aggiorna le caratteristiche presenti nell’importazione e lascia invariate le altre caratteristiche del prodotto.
- Combinazioni di prodotto: l’importazione completa può creare e aggiornare varianti sulla base della struttura delle combinazioni supportata, dei loro attributi, identificatori, quantità e impatto su prezzo e peso.
- Regole separate per i prodotti abbinati: è possibile applicare impostazioni di aggiornamento diverse alle schede create dall’importatore e ai prodotti riconosciuti nel catalogo esistente tramite identificatore.
Durante l’aggiornamento delle combinazioni, il modulo abbina le varianti in base ai set di attributi, aggiunge quelle nuove e può rimuovere le varianti esistenti non presenti nel set fornito. È disponibile anche un’opzione per eliminare le combinazioni esistenti durante il primo abbinamento del prodotto. La scelta di queste impostazioni è importante per i negozi che mantengono varianti proprie.
Regole di prezzo e selezione dell’assortimento importato
- Ricalcolo dei prezzi: le regole supportano l’aggiunta e la sottrazione di un importo, la moltiplicazione e l’aumento o la diminuzione del prezzo in percentuale. L’aumento percentuale indica un ricarico sul prezzo della fonte.
- Condizioni delle regole: il prezzo può dipendere dalla fascia di prezzo in ingresso, dalla categoria, dal produttore e dal fornitore. Le regole possono essere generali o assegnate a una fonte specifica.
- Priorità: l’importatore seleziona una sola regola di prezzo corrispondente in base alla priorità e, in caso di pari priorità, tiene conto della specificità delle sue condizioni.
- Maggiorazione e arrotondamento: dopo l’applicazione della regola è possibile aggiungere un importo configurato e infine arrotondare il prezzo netto o lordo all’unità intera.
- Collegamento delle aliquote con le imposte del negozio: la configurazione consente di assegnare le aliquote IVA supportate dai dati della fonte ai gruppi di regole fiscali esistenti in PrestaShop.
- Filtri di importazione: sono disponibili una soglia minima e massima del prezzo della fonte, nonché impostazioni per importare prodotti senza immagini e con quantità pari a zero.
- Prodotti che scompaiono dall’XML: al termine dell’importazione completa è possibile lasciarli invariati, disattivarli, impostare a zero la quantità del prodotto base oppure combinare la disattivazione con l’azzeramento di tale quantità.
Preparazione dei contenuti e dei campi SEO dei prodotti
- Dizionario delle modifiche testuali: sostituzione di frammenti specifici nei nomi, nelle descrizioni complete e brevi e nei campi meta title e meta description. Le regole possono utilizzare sostituzioni semplici o espressioni regolari.
- Modelli di nome: la configurazione consente di costruire i nomi a partire dai dati disponibili, come nome della fonte, riferimento, produttore, fornitore o EAN. Il dizionario offre un’anteprima della trasformazione su un testo di esempio.
- Frammenti personalizzati delle descrizioni: possibilità di aggiungere contenuti prima e dopo la descrizione completa o breve, con impostazioni linguistiche e individuali per la fonte.
- Campi SEO: supporto per il titolo e la meta description forniti dall’adattatore e creazione del frammento URL amichevole del prodotto in base al nome. Durante l’aggiornamento dei prodotti esistenti, i campi SEO sono collegati all’impostazione di aggiornamento del nome.
- Dati multilingua: l’importazione può utilizzare le versioni linguistiche fornite dalla fonte e dall’adattatore. Se mancano, il meccanismo può duplicare il contenuto disponibile in altre lingue; non esegue traduzioni automatiche.
Automazione dell’importazione e supervisione delle operazioni
- Importazione a fasi nel pannello: operazioni separate di download dell’XML, preparazione di categorie, produttori, fornitori, caratteristiche e attributi, nonché importazione dei prodotti.
- Elaborazione in batch: numero configurabile di prodotti per batch e lettura dei record tramite XMLReader. Ciò consente di adattare il processo di importazione alle risorse del server; il tempo di esecuzione dipende anche dalle immagini e dalla dimensione dei dati.
- Avanzamento, pausa e ripresa: il pannello mostra l’avanzamento e i contatori delle operazioni. La pausa consente di completare il batch in corso e poi blocca i successivi; l’avanzamento salvato permette di riprendere il lavoro.
- Salto dei record invariati: l’importatore confronta gli hash dei dati prodotto. Il forzamento dell’aggiornamento consente di rielaborare i record anche dopo una modifica delle impostazioni, nonostante l’XML non sia cambiato.
- Aggiornamento rapido: un’operazione separata scarica i dati tramite l’adattatore e aggiorna prezzi e quantità dei prodotti base già collegati a una determinata fonte. Non crea nuove schede prodotto né aggiorna descrizioni, immagini e stock delle singole combinazioni.
- CRON: gli URL di chiamata con chiave di accesso consentono di avviare le operazioni per la fonte indicata. La pianificazione deve essere configurata sul server o in un servizio esterno, tenendo conto del download dei dati e dell’elaborazione dei batch successivi.
- Cronologia ed esportazione dei log: registrazione delle sessioni, riepiloghi delle operazioni, avvisi ed errori, filtro delle voci ed esportazione del registro in CSV.
- Selezione dei negozi di destinazione: la configurazione consente di indicare i negozi nell’installazione multistore ai quali devono essere inviati i prodotti. Parte dei dati prodotto e delle impostazioni rimane condivisa in base al loro ambito in PrestaShop e nel modulo.
Vantaggi per la gestione del negozio
- Meno riscrittura manuale: dati di catalogo, immagini e disponibilità vengono trasferiti nelle schede prodotto nell’ambito dell’importazione configurata.
- Controllo sui propri contenuti: la disattivazione dell’aggiornamento di nomi o descrizioni consente di mantenere i materiali selezionati preparati nel negozio durante l’importazione completa.
- Regole di prezzo ripetibili: la stessa configurazione di calcolo dei prezzi può essere utilizzata negli aggiornamenti successivi della fonte.
- Individuazione più semplice delle cause dei problemi: avanzamento, riepiloghi e log aiutano a distinguere i record aggiunti, aggiornati e saltati e a verificare gli errori di importazione.
Come preparare l’importazione XML in PrestaShop?
- Prepara l’accesso all’XML e conferma che la sua struttura e i campi necessari siano supportati dall’adattatore della fonte.
- Crea la fonte, imposta la connessione e indica i negozi di destinazione.
- Scarica i dati e prepara i collegamenti di categorie, produttori, fornitori, caratteristiche e attributi necessari per il catalogo in questione.
- Definisci le regole di prezzo, i filtri e l’ambito di sovrascrittura dei dati, quindi avvia l’importazione dei prodotti.
- Verifica il risultato nelle schede prodotto e nei log, quindi configura le chiamate cicliche delle operazioni CRON appropriate.
Ambito di funzionamento e requisiti
La struttura della fonte richiede un adattamento. La sola estensione XML non significa che il file sia compatibile con l’importatore. Una diversa struttura dei dati può richiedere la preparazione o la modifica dell’adattatore; l’ambito dell’importazione dipende dai campi effettivamente forniti dalla fonte. Il modulo non è un importatore di fogli XLSX né di file CSV.
L’importazione completa e l’aggiornamento rapido hanno ambiti diversi. Gli interruttori di sovrascrittura dei campi riguardano il percorso completo di importazione. L’aggiornamento rapido tramite adattatore salva il prezzo e la quantità del prodotto base indipendentemente da questi interruttori. Il supporto di più fonti non significa la somma automatica delle loro giacenze né la selezione dell’offerta più economica.
Il modulo alimenta il catalogo prodotti; non trasmette gli ordini al grossista e non riserva la merce presso il fornitore. L’aggiornamento dei dati dipende dalla pubblicazione dell’XML e dalla frequenza di esecuzione dell’importazione. Le descrizioni e i campi meta vengono elaborati in base ai dati e alle regole, senza generazione di contenuti tramite AI.
Link alla demo del modulo:
Demo pannello amministrativo:
https://moduly-prestashop.eu/pdxmlimport/admin-dev
Demo front office:
https://moduly-prestashop.eu/pdxmlimport