Come preparare il catalogo
Il catalogo raccoglie informazioni e fotografie dei prodotti. Le azioni descritte in questa guida si eseguono nell’area clienti: apri Progetti, scegli il progetto SHOP e poi Catalogo. Questa pagina di documentazione non carica né modifica prodotti.
Se il catalogo è aperto per la preparazione e il tuo ruolo consente modifiche, puoi aggiungere prodotti a mano oppure importare una tabella. Se vedi un avviso di sola lettura, consulta la sezione sui permessi alla fine della guida.
Tre passaggi con una tabella
Nel Catalogo del progetto, il blocco Importa da un foglio di calcolo accetta Excel .xlsx e CSV. Il vecchio formato .xls non è supportato.
- Scegli Modello Excel. Il foglio Catalog contiene solo le intestazioni: aggiungi una riga per prodotto e salva il file .xlsx.
- Nel Catalogo del progetto apri Foto del catalogo e scegli Carica foto. Poi riporta i nomi esatti dei file nella colonna images della tabella.
- In Importa da un foglio di calcolo scegli il tuo Excel o CSV. Controlla l’anteprima, correggi gli eventuali errori e premi Importa catalogo.
Identificativi e SKU
In external_id inserisci un codice stabile, per esempio TSHIRT-001; in title inserisci il nome del prodotto. Conserva sempre lo stesso external_id, incluse le maiuscole, per aggiornare quel prodotto.
Lo SKU è il codice articolo per la tua gestione interna; external_id identifica stabilmente la riga durante gli aggiornamenti; il codice a barre ha un campo dedicato. Se hai già uno SKU, scrivilo in sku. Altrimenti lascia sku vuoto e scrivi yes in sku_generate: autorizzi il team ad assegnarlo in seguito, non lo generi al momento dell’importazione.
Come collegare le foto ai prodotti
Nell’area clienti, in Progetto → Catalogo → Foto del catalogo, usa Carica foto quando il caricamento è consentito. I file salvati appartengono al progetto: puoi collegarli tramite il loro nome nella tabella oppure selezionarli nella scheda prodotto.
Il simbolo | è una barra verticale e separa un nome di file dal successivo.
Copia il nome esatto, incluse estensione e maiuscole. Il nome deve corrispondere a una sola foto del progetto.
Prima di importare la tabella, attendi che accanto a ogni foto caricata compaia Salvata.
- Una foto: scrivi photo-front.jpg nella cella images del prodotto.
- Più foto: scrivi photo-front.jpg|photo-back.jpg nella stessa cella images.
- Se usi Aggiungi prodotto, puoi scegliere Usa questa foto nella raccolta: non devi scrivere il nome del file.
Immagini tramite link esterni
I collegamenti HTTPS delle foto restano riferimenti: non scarichiamo automaticamente le immagini. Mantieni disponibili le foto nel negozio di origine fino al trasferimento concordato con il team.
Hai pochi prodotti?
Scegli Aggiungi prodotto, compila la scheda, seleziona le foto già caricate e premi Salva prodotto. Non serve un file Excel.
Nella scheda di modifica manuale, una casella selezionata corrisponde a yes e una non selezionata a no. Non serve digitare questi valori nella scheda.
La scheda prodotto consente di modificare il riepilogo di lavoro. Queste modifiche non riscrivono l’originale Shopify: per aggiornare varianti o altri dati originali, carica un nuovo export.
Stati e varianti del modello siti.gratis
draft indica un prodotto ancora da completare. active richiede un prezzo, una descrizione in facts e almeno una foto. Nessuno dei due stati pubblica il prodotto o lo sincronizza con un negozio.
Puoi indicare fino a 3 gruppi di opzioni, per esempio taglia e colore. Le singole varianti non hanno prezzi o giacenze separati in questa tabella.
Guida alle colonne
Non rinominare le intestazioni del modello. Puoi lasciare vuote le colonne facoltative che non ti servono.
| Colonna | Come compilarla | Esempio |
|---|---|---|
| external_id | Identificativo obbligatorio e univoco del prodotto: serve a ritrovarlo e aggiornarlo nelle importazioni successive. Mantienilo invariato quando modifichi lo stesso prodotto. | TSHIRT-001 |
| title | Nome obbligatorio del prodotto, chiaro e riconoscibile per il cliente. Indica che cosa vendi e le caratteristiche principali. | Maglietta blu in cotone |
| status | Usa draft per completare i dettagli in seguito; active richiede descrizione dei fatti, prezzo e almeno un'immagine. Questo stato non pubblica il prodotto nel negozio. | draft |
| vendor | Marca o produttore del prodotto. Campo facoltativo: lascialo vuoto se non è pertinente. | North Coast |
| product_type | Tipo generale del prodotto, per esempio maglietta, sedia o crema. È facoltativo e descrive l'articolo, mentre categories lo raggruppa nel catalogo. | Maglietta |
| categories | Categorie o collezioni facoltative in cui raggruppare il prodotto. Separa fino a 50 nomi con |, senza usare |, ; o un ritorno a capo all'interno di un singolo nome. | Abbigliamento|Collezione estiva |
| facts | Informazioni verificabili: materiali, misure, utilizzo e manutenzione, fino a 5.000 caratteri. Obbligatorio per active; in draft puoi completarlo in seguito. | 100% cotone. Vestibilità regolare. Lavabile in lavatrice a 30 °C. |
| sku | Codice articolo interno usato per riconoscere il prodotto a magazzino: ha una funzione diversa da external_id e dal codice a barre. Inseriscilo oppure autorizza il team con sku_generate=yes. | TSHIRT-BLUE |
| sku_generate | Scrivi yes per autorizzare il team ad assegnare un codice articolo, oppure no se fornisci tu lo SKU. È un'autorizzazione, non una generazione immediata; senza SKU, yes è obbligatorio. | yes |
| barcode | Codice a barre EAN, UPC o GTIN, se disponibile. Trattalo come testo anche in Excel, così gli zeri iniziali non vengono eliminati. | 0012345678905 |
| variant1_name | Nome della prima opzione del prodotto, per esempio colore. Puoi descrivere fino a tre opzioni; questi campi non assegnano prezzi o quantità a ogni variante. | Colore |
| variant1_values | Valori della prima opzione, separati da |, fino a 50. Compila anche variant1_name; lascia entrambi vuoti se questa opzione non serve. | Blu|Bianco|Nero |
| variant2_name | Nome facoltativo della seconda opzione, per esempio taglia. Usalo insieme a variant2_values, senza aggiungere prezzi o quantità nei valori. | Taglia |
| variant2_values | Valori della seconda opzione, separati da |, fino a 50. Compila anche variant2_name oppure lascia vuoti entrambi i campi. | S|M|L|XL |
| variant3_name | Nome facoltativo della terza e ultima opzione, per esempio confezione. Usalo insieme a variant3_values. | Confezione |
| variant3_values | Valori della terza opzione, separati da |, fino a 50. Compila anche variant3_name oppure lascia vuoti entrambi i campi. | Singola|Set da 2 |
| price | Prezzo di vendita del prodotto, obbligatorio per active e mai negativo. Scrivi solo il numero, preferibilmente con il punto decimale, senza simboli di valuta. | 29.90 |
| compare_price | Prezzo di confronto o di listino, facoltativo, se hai un importo di riferimento confermato. Scrivi solo il numero con il punto decimale, senza simboli di valuta. | 39.90 |
| cost | Costo interno di acquisto o produzione del prodotto, se vuoi comunicarlo al team. È facoltativo: usa un numero con il punto decimale, senza simboli di valuta. | 12.50 |
| vat_rate | Aliquota IVA applicabile confermata dalla tua azienda, espressa in percentuale senza il simbolo %. Lasciala vuota se non è ancora definita; il campo non indica se il prezzo include l'IVA. | 22 |
| weight | Peso del prodotto, facoltativo, espresso come numero con il punto decimale. Indica separatamente l'unità in weight_unit. | 0.25 |
| weight_unit | Unità usata per il peso, per esempio kg o g. Mantienila coerente con il numero inserito in weight; lascia vuoto se non indichi il peso. | kg |
| track_inventory | Indica se vuoi gestire le quantità disponibili: yes per tenerne traccia, no per non farlo. È un'indicazione per la preparazione del negozio. | yes |
| quantity | Numero di pezzi disponibili, facoltativo, da indicare con un numero intero senza decimali. Usalo insieme alle indicazioni sul magazzino in track_inventory. | 50 |
| oversell_policy | Comportamento desiderato quando le scorte finiscono: deny blocca gli ordini, allow li consente, preorder indica il preordine. Puoi lasciare vuoto se la scelta non è ancora definita. | deny |
| images | Carica le foto in questo progetto e inserisci i nomi esatti e non ambigui dei file, separati da |, fino a 50. Per active serve almeno un'immagine; i link HTTPS sono solo riferimenti e non vengono scaricati. | photo-front.jpg|photo-back.jpg |
| alt_facts | Descrizione facoltativa di ciò che si vede nelle immagini, utile per preparare testi alternativi accessibili. Riporta dettagli visivi concreti, fino a 5.000 caratteri. | Maglietta blu a maniche corte, vista frontale, sfondo bianco. |
| seo_notes | Note facoltative per i contenuti destinati ai motori di ricerca: termini importanti e aspetti da evidenziare. Fino a 5.000 caratteri; non è una promessa di posizionamento. | Mettere in evidenza il tessuto di cotone, la vestibilità regolare e l'abbigliamento estivo. |
Hai già un negozio Shopify?
Puoi caricare direttamente il file dei prodotti esportato da Shopify, senza ricopiarlo nel modello siti.gratis.
Shopify esporta in CSV. Accettiamo anche .xlsx con le stesse intestazioni, un solo foglio dati e nessuna formula. Non rinominare le colonne.
- In Shopify apri Prodotti → Esporta e salva il CSV dei prodotti che vuoi trasferire.
- Nell’area clienti apri Progetto → Catalogo e usa il caricamento Excel / CSV. Seleziona l’export Shopify: il formato viene riconosciuto automaticamente.
- Controlla l’anteprima e il numero di prodotti, varianti e foto. Il catalogo cambia solo dopo la conferma di importazione; non occorre collegare il tuo account Shopify.
Come vengono conservati i dati Shopify
Lo stesso Handle identifica un solo prodotto. Le righe delle varianti e delle foto vengono riunite: non diventano prodotti aggiuntivi.
I prodotti vengono aggiunti come bozze per la preparazione. Lo stato Shopify originale (active, draft o archived) resta conservato; non pubblichiamo e non modifichiamo il negozio.
Product Category viene conservata com’è, separata dalle collezioni del negozio. Non trasformiamo automaticamente la categoria Shopify o i tag in pagine o collezioni.
Conserviamo anche i dati delle righe originali, inclusi HTML della descrizione, metadati e campi aggiuntivi. L’importazione riguarda il catalogo, non clienti, ordini o pagamenti.
Lo SKU è il codice articolo interno di una variante. I codici mancanti restano vuoti: importarli non autorizza la generazione automatica di nuovi SKU.
Controlli prima di confermare
La scelta del file apre l’anteprima. Il catalogo cambia solo quando confermi con Importa catalogo; prima correggi gli errori segnalati.
Se l’anteprima segnala un errore nel file Shopify, l’importazione non viene applicata. Controlla Handle e titoli mancanti, dati discordanti dello stesso prodotto, varianti duplicate e dimensione massima per prodotto. Correggi il file e ricaricalo nel Catalogo del progetto senza rinominare le intestazioni Shopify.
Limiti tecnici: 20.000 righe originali, 5.000 prodotti raggruppati, 10 MiB per il file e per il catalogo finale, 128 KiB per prodotto con i dati originali. La tabella Shopify può contenere al massimo 500.000 celle, comprese quelle vuote. I limiti commerciali del progetto restano separati.
Importare di nuovo ed esportare
Nel modello siti.gratis lo stesso external_id aggiorna l’intera scheda: conserva anche i campi che vuoi mantenere. Un nuovo codice crea un altro prodotto; i prodotti assenti dal file non vengono eliminati. Prima di un’importazione importante conserva il tuo file e chiedi al team un export aggiornato. Non contare su un comando di annullamento dell’importazione.
Un nuovo file con lo stesso Handle sostituisce quel prodotto importato, comprese le varianti e le modifiche al riepilogo. I prodotti assenti dal file rimangono nel catalogo.
L’amministratore può esportare il riepilogo di lavoro oppure scegliere l’export dei dati originali Shopify. Quest’ultimo include i dati originali importati, comprese le varianti, ma non i prodotti aggiunti a mano o con il modello siti.gratis né le modifiche al riepilogo. Per queste informazioni serve l’esportazione normale. Nel CSV i valori che potrebbero diventare formule ricevono un apostrofo di sicurezza; Excel li conserva come testo letterale.
Se il catalogo è di sola lettura
Se vedi il messaggio di sola lettura o non trovi i controlli di caricamento, la fase di preparazione o il tuo ruolo potrebbero non consentire modifiche. Puoi consultare i dati e scaricare le foto disponibili. Per modificare prodotti o aggiungere foto, chiedi al team la verifica dei permessi o la riapertura della preparazione.
Nell’accesso staff il catalogo è destinato a consultazione ed esportazione: lo staff può anche scaricare le fotografie. Il caricamento di prodotti e foto viene eseguito da un cliente autorizzato quando la preparazione è modificabile.