PS PrestaShop Intermedio

DataFirefly Shopify Migrator — Guida completa

Migri PrestaShop 1.7.8, 8 o 9 su Shopify passo passo: analisi, anteprima, lotti riprendibili e reindirizzamenti 301, con i modelli CSV ufficiali di Shopify o la GraphQL Admin API.

Aggiornato Versione del modulo 2.0.0

DataFirefly Shopify Migrator trasferisce un negozio PrestaShop 1.7.8, 8 o 9 su Shopify con un assistente passo passo: analisi del catalogo, corrispondenze, anteprima, migrazione in lotti riprendibili, report e reindirizzamenti 301. Funziona con i file dei modelli ufficiali di Shopify (nessuna connessione necessaria) oppure direttamente con la GraphQL Admin API di Shopify.

Versione 2.0.0. Modulo riscritto: PrestaShop da 1.7.8 a 9, PHP da 7.1 a 8.5, GraphQL Admin API (la REST Admin API è «legacy» per Shopify da ottobre 2024), modelli CSV attuali di Shopify, file generati protetti ed eliminati automaticamente, credenziali cifrate, back office in 8 lingue. L’aggiornamento dalla 1.x conserva i Suoi job, la Sua corrispondenza PrestaShop / Shopify e i Suoi file.
Cruscotto della migrazione a Shopify: passaggi, volumi del catalogo e ultime attività
Cruscotto della migrazione a Shopify: passaggi, volumi del catalogo e ultime attività

Requisiti

  • PrestaShop 1.7.8, 8.x o 9.x, PHP da 7.1 a 8.5 con cURL.
  • Immagini dei prodotti raggiungibili da Shopify su un indirizzo https pubblico: Shopify scarica ogni immagine dal suo URL. Un negozio che funziona su localhost o su un indirizzo privato deve inserire il proprio indirizzo pubblico nelle impostazioni, oppure essere migrato dal negozio in produzione.
  • Solo in modalità API: un negozio Shopify e un’app con gli scope delle parti da migrare (vedere il passaggio 1).

Installazione e aggiornamento

  1. In Moduli > Gestione moduli, clicchi su Carica un modulo e scelga dfshopifymigrator-2.0.0.zip.
  2. Il modulo crea 3 tabelle (ps_dfshopifymig_jobs, _mapping, _log) e il menu Parametri avanzati > Migrazione a Shopify. Non aggiunge nulla al front office del negozio.
  3. Aggiornamento dalla 1.x: il token Shopify e il client secret vengono cifrati, i file CSV della 1.x vengono spostati fuori dalla cartella pubblica modules/dfshopifymigrator/exports/ (chiunque ne conoscesse l’indirizzo poteva scaricarli), gli id REST della corrispondenza diventano id GraphQL e i job lasciati incompiuti dalla 1.x vengono chiusi: li riavvii, la corrispondenza evita i duplicati.

Passaggio 1: connessione

Scelga come inviare i dati a Shopify.

  • File CSV Shopify: il modulo prepara i file di prodotti, clienti e reindirizzamenti con le colonne dei modelli ufficiali di Shopify; Lei li importa nel pannello di amministrazione di Shopify. Nessuna connessione e nessuna chiave di accesso.
  • Direttamente sul mio negozio Shopify: il modulo crea e aggiorna prodotti, raccolte, pagine, clienti, metacampi, traduzioni e reindirizzamenti tramite la GraphQL Admin API. Una seconda esecuzione aggiorna invece di duplicare.
Connessione a Shopify: file CSV o API GraphQL Admin, client credentials, versione API e ambiti concessi
Connessione a Shopify: file CSV o API GraphQL Admin, client credentials, versione API e ambiti concessi

Per l’API sono disponibili due metodi di autenticazione:

  • App del Dev Dashboard (ID client + secret): concessione tramite credenziali client (client credentials grant), per un’app creata nel Dev Dashboard di Shopify e installata su un negozio della stessa organizzazione. Il modulo richiede il token di accesso (valido 24 ore) e lo rinnova da solo.
  • Token di accesso Admin API: per un’app personalizzata già creata nel pannello di amministrazione di Shopify. Dal 1° gennaio 2026 Shopify non consente più di crearne di nuove; quelle esistenti continuano a funzionare.

Inserisca l’indirizzo .myshopify.com permanente del negozio e scelga la versione dell’API (la più recente è selezionata per impostazione predefinita; Shopify supporta ogni versione per almeno 12 mesi). Le credenziali sono cifrate nel database e non vengono mai più visualizzate: lasci un campo vuoto per mantenere il valore salvato. Salva e verifica la connessione mostra il negozio, la sua valuta, le sue località di magazzino, le sue lingue e gli scope concessi all’app.

Scope Necessario per
write_products prodotti, varianti, immagini, raccolte, metacampi
read_locations, write_inventory quantità in magazzino
write_customers clienti, indirizzi, consenso al marketing via email
write_content pagine CMS
write_online_store_navigation reindirizzamenti URL
write_translations, read_locales traduzioni
write_publications pubblicazione facoltativa su un canale di vendita

Creare l’app nel Dev Dashboard di Shopify

  1. Nel Dev Dashboard di Shopify, crei un’app (per esempio «Migrator»).
  2. Configuri gli ambiti di accesso (scope) Admin API delle parti da migrare (tabella qui sopra) e salvi.
  3. Installi l’app sul negozio di destinazione (distribuzione personalizzata) e approvi gli accessi richiesti.
  4. Copi l’ID client e il client secret dell’app nel passaggio 1 del modulo, poi clicchi su Salva e verifica la connessione.
Stessa organizzazione. La concessione client credentials funziona solo se l’app e il negozio appartengono alla stessa organizzazione Shopify; altrimenti Shopify risponde shop_not_permitted. Se modifica gli scope dopo aver installato l’app, li approvi di nuovo sul negozio (reinstalli l’app se necessario).

Prima di qualsiasi invio, l’analisi elenca ciò che Shopify rifiuterebbe o modificherebbe, con esempi cliccabili: punti bloccanti (immagini non raggiungibili da Shopify, immagini non in https, prodotti senza nome, più di 2048 combinazioni, indirizzi email non validi), punti da verificare (più di 3 gruppi di attributi, combinazioni identiche, prodotti attivi con prezzo 0, file immagine mancanti, riferimenti usati più volte, pack, campi di personalizzazione, prodotti scaricabili, più account con la stessa email) e buono a sapersi (password, storico degli ordini, lingue, valute, multinegozio, dimensione del file dei prodotti).

Analisi del catalogo prima della migrazione: punti bloccanti, punti da verificare ed esempi da correggere
Analisi del catalogo prima della migrazione: punti bloccanti, punti da verificare ed esempi da correggere

Passaggio 3: impostazioni e corrispondenze

Impostazioni della migrazione: negozio di origine, lingua, prodotti disattivati, fornitore, tag, prezzi e imposte
Impostazioni della migrazione: negozio di origine, lingua, prodotti disattivati, fornitore, tag, prezzi e imposte
  • Origine: negozio da migrare (multinegozio: un negozio alla volta), lingua principale (usi la lingua principale del negozio Shopify), elementi per lotto.
  • Catalogo: prodotti disattivati come bozza, archiviati o non migrati; esclusione per categoria o per prefisso di riferimento; fornitore (marca o fornitore predefinito); tipo di prodotto (categoria predefinita); nomi delle categorie e tag PrestaShop come tag Shopify (necessari per le raccolte automatizzate in modalità CSV); caratteristiche come metacampi custom.<name>. La «Categoria prodotto» di Shopify (tassonomia standard) viene lasciata vuota: le categorie PrestaShop non vi corrispondono.
  • Prezzi e imposte: prezzi con imposte escluse o incluse (scelga ciò che corrisponde a «Includi le imposte nei prezzi» nelle impostazioni delle imposte di Shopify) con l’aliquota del paese scelto, riduzioni pubbliche in corso come prezzi di confronto, prezzo d’acquisto come costo per articolo. I prezzi sono esportati nella valuta predefinita del negozio.
  • Magazzino e spedizione: comportamento in caso di esaurimento (come in PrestaShop, interrompi sempre, continua sempre), unità dei pesi di PrestaShop (rilevata automaticamente). I prodotti virtuali non richiedono spedizione.
Impostazioni di immagini, clienti (consenso marketing, password), traduzioni e reindirizzamenti 301
Impostazioni di immagini, clienti (consenso marketing, password), traduzioni e reindirizzamenti 301
  • Immagini: indirizzo https pubblico usato per costruire gli URL delle immagini, file originale o dimensione generata più grande (Shopify accetta immagini sotto i 20 MB e fino a 5000 × 5000 px).
  • Clienti: account ospite e disattivati, gruppi di clienti come tag, un tag su ogni cliente migrato.
  • Lingue (modalità API): i testi delle lingue selezionate vengono inviati come traduzioni Shopify (titolo, descrizione, handle, SEO). La lingua deve essere aggiunta e pubblicata nel negozio Shopify.
  • Reindirizzamenti 301: lingue, cartella di lingua per le altre lingue (/en/products/handle), URL delle combinazioni, pagine delle marche.
  • Pubblicazione (modalità API): per impostazione predefinita, i prodotti e le raccolte creati tramite l’API non sono pubblicati su alcun canale di vendita; ne scelga uno o li pubblichi più tardi in Shopify.

Passaggio 4: anteprima

L’anteprima legge 8 prodotti con le Sue impostazioni, esattamente come verranno inviati: handle, stato, fornitore, tipo, tag, opzioni e varianti (SKU, prezzo, prezzo di confronto, magazzino, peso), immagini, metacampi e problemi rilevati. CSV Shopify di questi prodotti scarica il file dei prodotti mostrati. Nulla viene inviato a Shopify.

Anteprima dei prodotti come li riceverà Shopify: handle, opzioni, varianti, prezzi di confronto, inventario e metacampi
Anteprima dei prodotti come li riceverà Shopify: handle, opzioni, varianti, prezzi di confronto, inventario e metacampi

In modalità API viene mostrato anche l’input GraphQL inviato per il primo prodotto (productSet).

Dati GraphQL productSet inviati per un prodotto: opzioni, varianti, inventario per località, immagini e SEO
Dati GraphQL productSet inviati per un prodotto: opzioni, varianti, inventario per località, immagini e SEO

Passaggio 5: migrazione

Una scheda per parte, nell’ordine consigliato: raccolte, prodotti, caratteristiche → metacampi, pagine CMS, traduzioni, clienti, storico degli ordini, reindirizzamenti 301. Avvia la migrazione crea tutti i job; i clienti e gli ordini (dati personali) possono essere esclusi.

Migrazione per passaggi: raccolte, prodotti, metacampi, pagine, traduzioni, clienti e reindirizzamenti, con contatori
Migrazione per passaggi: raccolte, prodotti, metacampi, pagine, traduzioni, clienti e reindirizzamenti, con contatori
  • I job vengono eseguiti in questa pagina, lotto dopo lotto (circa 8 secondi per chiamata) con avanzamento in tempo reale. Tenga la pagina aperta, oppure aggiunga il task cron facoltativo (pagina Avanzate) per proseguire in background.
  • Pausa, Riprendi e Annulla in qualsiasi momento; un job interrotto da un errore riprende dal punto in cui si trovava. Riprova gli errori invia di nuovo solo gli elementi in errore.
  • Ogni elemento è elaborato per id crescente: un job ripreso non salta né ripete elementi. Un job non viene mai elaborato contemporaneamente dal browser e dal cron.
  • Modalità API: il modulo legge il costo della query restituito da Shopify e attende quando il bucket è basso; i limiti di frequenza (THROTTLED, HTTP 429) e gli errori del server vengono ritentati un numero limitato di volte; un token non valido interrompe subito il job.
Migrazione in corso: avanzamento in tempo reale per lotti, pausa, ripresa e annullamento
Migrazione in corso: avanzamento in tempo reale per lotti, pausa, ripresa e annullamento

Cosa invia ciascuna parte

PrestaShop Modalità CSV Modalità API
Categorie file di riferimento: regola di raccolta automatizzata per tag di prodotto (Shopify non prevede l’importazione delle raccolte) raccolte manuali, prodotti collegati dal job dei prodotti; una raccolta esistente con lo stesso handle viene riutilizzata
Prodotti, combinazioni, immagini file di importazione prodotti di Shopify (colonne ufficiali) productSet, upsert per id o handle; i prodotti invariati vengono saltati
Caratteristiche colonne di metacampi Name (product.metafields.custom.key): crei prima le definizioni in Shopify definizioni create, valori scritti con metafieldsSet
Pagine CMS copia delle pagine da incollare (Shopify non prevede l’importazione delle pagine) pagine Shopify
Altre lingue — traduzioni Shopify
Clienti file di importazione clienti di Shopify upsert per email, indirizzo principale, consenso al marketing via email
Ordini file di archivio (Shopify non importa ordini da un file) —
URL file di importazione reindirizzamenti di Shopify reindirizzamenti URL creati in Shopify

Combinazioni: Shopify accetta 3 opzioni e 2048 varianti per prodotto. Con più di 3 gruppi di attributi, il 3° gruppo e i successivi vengono uniti nell’opzione 3 (ad esempio «Materiale / Finitura» = «Legno / Opaco»): nessun valore va perso. Due combinazioni con gli stessi attributi non possono coesistere in Shopify: viene esportata solo la prima e l’altra viene segnalata.

Importare i file CSV in Shopify

  1. Prodotti > Importa: scelga il file dei prodotti. Spunti «Sovrascrivi i prodotti con lo stesso handle» solo per aggiornare prodotti già importati: con questa opzione, le colonne vuote sovrascrivono i valori in Shopify. I file oltre i 15 MB (limite di Shopify) vengono proposti in più parti, senza dividere alcun prodotto.
  2. Clienti > Importa con il file dei clienti.
  3. Negozio online > Navigazione > Reindirizzamenti URL > Importa con il file dei reindirizzamenti, una volta che gli handle sono definitivi.

Clienti: password e consenso

  • Le password non possono essere migrate: sono cifrate e Shopify non può importarle. I Suoi clienti creano una nuova password, oppure accedono con un codice grazie ai nuovi account cliente. Pianifichi un’email per informarli.
  • Marketing via email: solo i clienti che hanno spuntato la casella newsletter di PrestaShop vengono migrati come iscritti (single opt-in, con la data di iscrizione). La casella «offerte dei partner» non costituisce un consenso alle Sue email e non viene utilizzata. Il marketing via SMS e WhatsApp è impostato su «no».
  • Il numero di telefono dell’indirizzo viene ricostruito in formato internazionale con il prefisso del paese; un numero che non può essere ricostruito in modo sicuro viene escluso e segnalato. Il telefono a livello di cliente resta vuoto (Shopify richiede che sia univoco).

Passaggio 6: report

Per ogni job: elementi elaborati, OK, con avvisi, in errore e saltati (invariati), i problemi più frequenti e un log filtrabile (errori, avvisi, informazioni), nella lingua del dipendente, con un link al prodotto PrestaShop. Report errori (CSV) esporta i problemi per un foglio di calcolo.

Report di un’attività: contatori, problemi più frequenti e avvisi per prodotto
Report di un’attività: contatori, problemi più frequenti e avvisi per prodotto

Passaggio 7: reindirizzamenti 301

L’anteprima mostra il vecchio percorso PrestaShop e il nuovo percorso Shopify per alcuni elementi. I reindirizzamenti coprono i prodotti attivi e l’URL di ogni combinazione (verso il prodotto, con la variante selezionata in modalità API), le categorie, le pagine CMS e, facoltativamente, le marche, in ogni lingua selezionata, con gli handle tradotti quando le traduzioni sono state inviate.

Reindirizzamenti 301 dagli URL PrestaShop a Shopify: prodotti, combinazioni, categorie e pagine, in ogni lingua
Reindirizzamenti 301 dagli URL PrestaShop a Shopify: prodotti, combinazioni, categorie e pagine, in ogni lingua
  • Shopify applica un reindirizzamento solo quando non esiste nulla al vecchio indirizzo sul negozio Shopify.
  • Fino a 100.000 reindirizzamenti per negozio (20 milioni su Shopify Plus).
  • I vecchi indirizzi con parametri (?id_product=…) potrebbero non essere reindirizzati da Shopify: se possibile, attivi gli URL semplificati in PrestaShop prima della migrazione.
  • I percorsi riservati da Shopify (/cart, /orders, /apps…) vengono esclusi e segnalati.
  • I reindirizzamenti mantengono funzionanti i Suoi vecchi link; non garantiscono le Sue posizioni nei motori di ricerca.

Sicurezza e dati personali

Pagina avanzata: attività cron protetta da token, file protetti eliminati automaticamente e corrispondenza PrestaShop ↔ Shopify
Pagina avanzata: attività cron protetta da token, file protetti eliminati automaticamente e corrispondenza PrestaShop ↔ Shopify
  • I file generati sono archiviati fuori dal modulo, in var/dfshopifymigrator/, in una cartella con nome casuale, rifiutata dal server web, con nomi di file casuali. Possono essere scaricati solo dal back office e vengono eliminati automaticamente dopo il periodo di conservazione (7 giorni per impostazione predefinita, pagina Avanzate).
  • Il token Shopify e il client secret sono cifrati con la chiave del negozio, non vengono mai più visualizzati e sono mascherati in tutti i log.
  • Permessi (Parametri avanzati > Team > Permessi): «visualizza» per aprire il modulo, «modifica» per cambiare le impostazioni e avviare i job, «elimina» per eliminare job e file. L’esportazione di clienti o ordini richiede anche il permesso «visualizza» su Clienti o Ordini.
  • L’URL del cron contiene un token casuale confrontato in tempo costante; lo rigeneri se è stato condiviso.
  • La corrispondenza PrestaShop ↔ Shopify (handle e id Shopify di ogni elemento) è ciò che evita i duplicati quando un job viene rieseguito: la reimposti solo se ha svuotato il negozio Shopify.

Risoluzione dei problemi

«Shopify refused the access token (HTTP 401)»

Il token è errato o l’app è stata disinstallata. In modalità client credentials, salvi di nuovo il client secret: il modulo richiede un nuovo token. Il job si ferma subito e può essere ripreso dopo la correzione.

«Shopify refused the client credentials»

Verifichi l’ID client e il client secret, e che l’app sia installata su un negozio della stessa organizzazione (shop_not_permitted).

Uno scope appare in rosso dopo il test di connessione

Aggiunga lo scope all’app, lo approvi sul negozio, poi verifichi di nuovo la connessione. Uno scope mancante blocca solo la parte che ne ha bisogno.

I prodotti arrivano in Shopify senza immagini

Shopify scarica le immagini dal loro URL: verifichi nell’analisi che l’indirizzo pubblico delle immagini sia raggiungibile in https da internet e che i file delle immagini esistano sul server.

Limitazioni

  • Non migrati: password dei clienti (impossibile), ordini in Shopify (solo file di archivio), regole carrello, prezzi per gruppo, per cliente e per quantità, contenuto dei pack, campi di personalizzazione, file dei prodotti scaricabili, recensioni dei prodotti.
  • Un negozio di origine e la valuta predefinita per job; i tag non possono essere tradotti in Shopify.
  • Verifichi il risultato su un negozio di sviluppo Shopify prima di migrare il negozio di produzione.

Domande frequenti

Posso eseguire di nuovo una parte?

Sì. In modalità API, gli elementi invariati vengono saltati e quelli modificati vengono aggiornati; nulla viene creato due volte. In modalità CSV viene generato un nuovo file.

Posso migrare senza una chiave di accesso?

Sì, con la modalità CSV. Raccolte, pagine e traduzioni richiedono allora la modalità API o un passaggio manuale in Shopify.

PrestaShop 1.7.8 è supportato?

Sì. La versione 2.0.0 è stata testata su PrestaShop 1.7.8.11 (PHP 7.4), 8.2.1 (PHP 8.1) e 9.1.5 (PHP 8.5).

Questa pagina ti è stata utile?

Ancora bloccato? Contatta l'assistenza