Come caricare prodotti in blocco su WooCommerce

Opzione 1: l’importatore CSV integrato di WooCommerce

WooCommerce include un importatore e un esportatore CSV dei prodotti. Nell’area di amministrazione di WordPress vai su Prodotti → Tutti i prodotti e scegli Importa. Carica il CSV, associa le sue colonne ai campi di WooCommerce ed esegui l’importazione. Spuntando “Aggiorna i prodotti esistenti” puoi aggiornare i prodotti individuati tramite ID o SKU invece di creare duplicati.

• Esporta prima un prodotto esistente e usa quel file come modello: mostra i nomi esatti delle colonne attesi dal tuo negozio.
• Le colonne tipiche includono Type, SKU, Name, Published, Short description, Description, Regular price, Categories, Tags, Images e Attribute 1 name / Attribute 1 value(s).
• Le immagini vengono importate da URL, quindi devono essere raggiungibili pubblicamente al momento dell’importazione.
• I prodotti variabili richiedono una riga padre di tipo “variable” e una riga per ogni variazione che fa riferimento al padre.
• I file molto grandi possono andare in timeout su hosting condiviso: suddividili in lotti di qualche centinaio di righe.

Opzione 2: plugin di importazione

I plugin di importazione di terze parti aggiungono funzioni che l’importatore di base non ha: importazioni pianificate o ricorrenti da un feed del fornitore, supporto XML, regole di trasformazione dei campi e una migliore gestione dei file molto grandi. Hanno senso quando un fornitore invia regolarmente file aggiornati di prezzi e giacenze.

I plugin si aspettano comunque dati strutturati in ingresso. Se il tuo fornitore fornisce PDF anziché un feed, un plugin non elimina il lavoro di trasformare quei PDF in righe.

Opzione 3: la REST API di WooCommerce

Sviluppatori e strumenti di integrazione possono creare prodotti tramite la REST API di WooCommerce, che comprende un endpoint batch in grado di creare o aggiornare molti prodotti in una sola richiesta. È adatta a pipeline automatizzate e ad applicazioni che creano prodotti direttamente, senza passare dal CSV.

Doc2Shelf segue questa strada: dopo la revisione, invia i prodotti a WooCommerce come semplici prodotti in bozza con descrizioni lunghe e brevi, così puoi controllarli in WooCommerce prima di renderli attivi. Gli attributi globali per i filtri e i prodotti variabili si configurano separatamente in WooCommerce.

Preparare i dati di prodotto per un caricamento in blocco

Qualunque metodo di importazione usi, la qualità dei dati decide il risultato. Prima di importare:

• Assegna a ogni prodotto uno SKU univoco: è così che gli aggiornamenti successivi trovano il prodotto giusto.
• Crea prima in WooCommerce le categorie e gli attributi globali, poi richiamali in modo coerente.
• Normalizza le specifiche: stesse unità, stessi nomi di attributo, un solo valore per cella.
• Scrivi descrizioni vere invece di incollare il testo del fornitore; marketplace e motori di ricerca premiano i contenuti originali.
• Importa come bozze per una prima prova — imposta Published su -1 (con 0 i prodotti diventano privati) — poi controlla un campione prima di pubblicare tutto.

Quando il fornitore invia solo PDF

Molti fornitori forniscono schede tecniche e cataloghi in PDF, non feed CSV. In questo caso il collo di bottiglia è l’estrazione: qualcuno deve leggere ogni PDF, compilare le colonne e scrivere una descrizione.

Puoi farlo manualmente, oppure estrarre i dati con uno strumento e poi verificarli. Doc2Shelf legge i PDF dei fornitori, estrae le specifiche da sottoporre a revisione, prepara le descrizioni lunghe e brevi per WooCommerce e crea i prodotti come bozze tramite la REST API, sostituendo il passaggio del foglio di calcolo per i cataloghi che partono da PDF.

Errori di importazione comuni in WooCommerce

Se un’importazione fallisce o produce risultati inattesi, controlla prima questi punti:

• SKU duplicati o mancanti, che causano righe saltate o prodotti duplicati.
• Codifica del file errata: salva il CSV in UTF-8 in modo che i caratteri accentati vengano importati correttamente.
• URL delle immagini che reindirizzano, richiedono un login o puntano a file molto grandi.
• Percorsi di categoria scritti in modo incoerente (usa “Genitore > Figlio” per le categorie annidate).
• Variazioni i cui valori di attributo non corrispondono ai valori di attributo del prodotto padre.

Riferimento delle colonne CSV dei prodotti WooCommerce

L’importatore di base legge un insieme fisso di nomi di colonna. Esportando un prodotto dal tuo negozio ottieni le intestazioni esatte attese dalla tua versione di WooCommerce; la tabella qui sotto spiega le colonne più importanti per un caricamento in blocco. Solo Name è obbligatoria — tutte le altre colonne sono facoltative, ma un catalogo importato senza Type, SKU, prezzi e categorie lascia molto lavoro manuale per dopo.

Le colonne con un’unità nell’intestazione, come Weight e le tre dimensioni, mostrano l’unità configurata nelle impostazioni del negozio, quindi copia queste intestazioni da un’esportazione invece di digitarle. I dati personalizzati che non hanno una colonna propria vanno in una colonna la cui intestazione inizia con meta: seguito dalla chiave del campo.

Prodotti variabili in un CSV: righe padre e righe di variazione

Un prodotto variabile si estende su più righe: una riga padre che definisce il prodotto e i valori di attributo che offre, e una riga per ogni variazione che riporta prezzo, SKU e giacenza di una singola combinazione. La riga padre ha Type “variable”; ogni riga di variazione ha Type “variation” e rimanda al padre nella colonna Parent, usando lo SKU del padre o id: seguito dal suo ID.

Le colonne degli attributi collegano le righe tra loro. Nel padre, Attribute 1 value(s) elenca tutti i valori offerti dal prodotto, separati da virgole. In ogni variazione compare lo stesso Attribute 1 name con uno solo di quei valori. Ortografia e maiuscole devono coincidere: una variazione che riporta “rosso” sotto un padre che offre “Rosso” può finire senza un valore di attributo utilizzabile.

Imposta Attribute 1 global su 1 sul padre e sulle sue variazioni quando usi un attributo valido per tutto il negozio creato in Prodotti → Attributi — è quello con cui funzionano la navigazione a faccette e i widget dei filtri. Da WooCommerce 11.1, un’importazione di aggiornamento può anche aggiungere nuove variazioni a un prodotto variabile già esistente, così puoi ampliare una gamma senza ricostruire il padre.

• Tieni ogni riga padre sopra le sue variazioni, così il file è facile da controllare e il padre esiste quando le variazioni vi fanno riferimento.
• Assegna a ogni variazione il proprio SKU e prezzo; una variazione senza prezzo non può essere acquistata.
• Usa Attribute 1 default sul padre per controllare quale opzione è preselezionata.

Aggiungere le immagini dei prodotti tramite il CSV

La colonna Images accetta uno o più URL di immagini separati da virgole. Il primo URL diventa l’immagine in evidenza e gli altri formano la galleria del prodotto nell’ordine indicato. Durante l’importazione WordPress scarica ogni file nella libreria multimediale, quindi ogni URL deve essere raggiungibile pubblicamente in quel momento — senza login, senza link di condivisione che scadono e senza reindirizzamenti a una pagina web invece che al file.

Le immagini sono di solito la parte più lenta di un’importazione: poche centinaia di prodotti con cinque immagini ciascuno significano oltre mille download. Ridimensiona le immagini prima di ospitarle, usa nomi di file descrittivi (kettle-red-front.jpg, non IMG_0042.jpg) e dividi i cataloghi grandi in file più piccoli.

L’importatore di base non può impostare il testo alternativo delle immagini. Aggiungilo in seguito nella libreria multimediale, tramite la REST API o con un’estensione di importazione che lo supporti. Una variazione contiene una sola immagine, quindi assegna a ogni riga di variazione al massimo un URL.

Creare prodotti in blocco con la REST API di WooCommerce

La REST API è la strada migliore quando le importazioni si ripetono, quando i dati di prodotto risiedono già in un altro sistema o quando nessuno dovrebbe doversi occupare di un CSV. Il suo endpoint batch dei prodotti (POST /wp-json/wc/v3/products/batch) accetta operazioni di creazione, aggiornamento ed eliminazione in un’unica richiesta.

Per impostazione predefinita, una richiesta batch è limitata a 100 oggetti tra creazioni, aggiornamenti ed eliminazioni. Lo stesso limite vale per gli endpoint batch di variazioni, categorie, attributi e termini di attributo. Un catalogo di 1.000 prodotti richiede quindi almeno dieci richieste, e di più una volta aggiunte le variazioni.

1. Crea una chiave REST API con permessi di lettura/scrittura in WooCommerce → Impostazioni → Avanzate → REST API, oppure lascia che un’app ne richieda una tramite la schermata di autorizzazione di WooCommerce.
2. Crea prima le categorie, gli attributi globali e i termini di attributo, e annota i relativi ID.
3. Invia i prodotti semplici e i prodotti padre in batch fino a 100, con stato impostato su bozza.
4. Crea le variazioni di ogni prodotto variabile tramite l’endpoint batch delle variazioni di quel prodotto.
5. Controlla l’esito di ogni elemento nella risposta e ripeti solo gli elementi che non sono riusciti.
6. Controlla a campione alcune bozze nell’area di amministrazione, poi pubblicale.

Scegliere un plugin o una via per il caricamento in blocco di prodotti su WooCommerce

Se l’importatore di base non basta, valuta un plugin o un’estensione di importazione da come gestisce i tuoi dati, non dalla lunghezza dell’elenco di funzionalità, e provalo su una copia di staging del negozio con un vero file del fornitore prima di adottarlo. La tabella confronta le quattro vie, seguita dalle domande da porre a qualsiasi plugin.

• Formati di origine: solo CSV, oppure anche XML, fogli di calcolo e feed remoti recuperati tramite URL.
• Pianificazione: se può rieseguire un’importazione a intervalli programmati per recepire nuovi prezzi e giacenze.
• Mappatura e trasformazioni: rinominare colonne, dividere valori, convertire unità e applicare regole di prezzo durante l’importazione.
• Prodotti variabili: se crea in modo affidabile padri, variazioni e attributi globali.
• Immagini: come le scarica, se rileva i duplicati e se imposta il testo alternativo.
• File di grandi dimensioni: elaborazione in background o a blocchi, perché le importazioni lunghe non vadano in timeout.
• Regole di aggiornamento: su quale chiave cerca la corrispondenza (ID, SKU o GTIN) e quali campi può sovrascrivere.

Checklist pre-importazione e correzione degli errori

La maggior parte delle importazioni fallite risale a un passaggio di preparazione saltato. Segui la checklist prima di ogni importazione di grandi dimensioni e usa la tabella per diagnosticare i problemi che si presentano comunque.

1. Esegui il backup del database, oppure esegui l’importazione su una copia di staging del negozio.
2. Esporta un prodotto esistente e copia la sua riga di intestazione nel tuo file.
3. Crea le categorie, gli attributi globali e i termini di attributo a cui il file fa riferimento.
4. Verifica che ogni SKU sia univoco e che il valore Parent di ogni variazione corrisponda allo SKU di un padre esistente.
5. Usa numeri semplici nelle colonne di prezzo, giacenza, peso e dimensioni.
6. Apri un campione di URL di immagini in una finestra del browser privata per confermare che si caricano senza login.
7. Imposta Published su -1 in modo che i prodotti arrivino come bozze.
8. Salva il file come CSV UTF-8.
9. Importa un file di prova di dieci righe, controlla i risultati, poi importa il resto a blocchi.

Provare con prodotti fittizi prima dell’importazione vera

Un piccolo file fittizio individua gli errori di mappatura prima che tocchino centinaia di prodotti. Crealo dal tuo vero modello in modo che le intestazioni siano identiche e assegna a ogni prodotto di prova un contrassegno evidente — un prefisso “TEST-” nello SKU e un tag “test” — così potrai trovare ed eliminare i prodotti in seguito.

Copri ogni caso presente nel tuo file reale, non solo quello più semplice. In genere bastano circa dieci righe:

• Un prodotto semplice con tutte le colonne che intendi usare compilate.
• Un prodotto variabile con due attributi e almeno tre variazioni.
• Un prodotto con una galleria di più immagini e uno senza immagini.
• Un prodotto in una categoria annidata che non esiste ancora.
• Un prodotto con caratteri accentati, virgolette e una virgola nella descrizione.
• Una riga che aggiorna un prodotto esistente tramite SKU.
• Controlla i risultati nell’area di amministrazione e nel negozio — prezzi, menu a tendina delle variazioni, ordine delle immagini e pagine delle categorie — poi elimina i prodotti di prova prima dell’importazione vera.