Importare e aggiornare i prodotti con un foglio di calcolo#

Scarica un modello di categoria, inserisci i prodotti e caricalo nel Catalogo. Questo flusso non richiede codice né credenziali API.

Prima di iniziare#

Seleziona il negozio corretto nel pannello di controllo. Devi avere il permesso di modificarne il catalogo. Se il pulsante Carica foglio prodotti non compare, verifica il negozio selezionato, il permesso di scrittura sul catalogo e se il tuo account dispone solo dell’accesso in lettura.

Scaricare il modello di categoria#

1. Apri Pannello di controllo → Catalogo.
2. Fai clic su Carica foglio prodotti per aprire la finestra Importa prodotti.
3. In Scegli la categoria, seleziona la categoria da importare. Le opzioni dipendono dalla configurazione del negozio.
4. Fai clic su Scarica modello Excel. Usa un modello e un caricamento separati per ogni categoria.

Scarica un nuovo modello quando prepari una nuova importazione, affinché le colonne corrispondano ai requisiti attuali della categoria. La cartella di lavoro scaricata è un modello, non un’esportazione del catalogo esistente.

Compilare la cartella di lavoro#

Usa i fogli della cartella di lavoro come segue:

Ogni riga di prodotto richiede sku, name, image_url e product_url, oltre alle dimensioni obbligatorie per la sua categoria. Segui le indicazioni dei campi obbligatori e le istruzioni del modello scaricato. Non tradurre i nomi dei campi e non aggiungere colonne sconosciute o duplicate.

• Mantieni le celle SKU in formato testo per evitare che il programma di fogli di calcolo elimini gli zeri iniziali o modifichi gli identificatori lunghi. Usa una riga per ogni SKU; i valori duplicati nello stesso file vengono rifiutati, inclusi quelli che differiscono solo per maiuscole e minuscole.
• Per image_url, usa un indirizzo diretto di un’immagine HTTP o HTTPS accessibile pubblicamente; deve funzionare senza accesso, cookie o intestazioni di richiesta personalizzate. Inserisci l’indirizzo della pagina di dettaglio del prodotto in product_url.
• Specifica dimensioni e unità seguendo le istruzioni del modello. Se non è indicata alcuna unità in una dimensione o in dimension_unit, il valore predefinito è in.
• Scegli status tra i valori accettati in Enums. Se lasci il campo vuoto, il valore predefinito è active; impostalo esplicitamente quando aggiorni i prodotti.

Salva in formato .xlsx (consigliato). È accettato anche .csv se contiene solo la riga di intestazione dei prodotti e i dati. I vecchi file .xls non sono supportati. Ogni file può contenere fino a 50,000 righe di prodotto non vuote e non deve superare 50 MB.

Caricare e controllare il risultato#

1. Torna alla finestra di importazione e seleziona la stessa categoria del modello.
2. In Compila e carica, scegli il file salvato, quindi fai clic su Avvia importazione.
3. Controlla Importazioni recenti per vedere il nome del file, lo stato dell’elaborazione e il numero di righe riuscite e non riuscite. L’invio conferma l’accettazione; l’elaborazione prosegue in background.
4. Attendi il termine dell’elaborazione e controlla le righe non riuscite anche se l’attività mostra Completata. Torna al Catalogo per verificare i dati importati e la disponibilità dei prodotti per la visualizzazione.

Se alcune righe non riescono, fai clic su File degli errori, esamina i messaggi di errore, correggi i dati dei prodotti e carica il file corretto con la stessa categoria. La cartella di lavoro degli errori scaricata contiene le righe non riuscite e colonne diagnostiche; queste colonne diagnostiche vengono ignorate al nuovo caricamento.

In caso di errore temporaneo di elaborazione, usa Riprova quando disponibile. Ripetere la stessa attività non corregge i dati dei prodotti non validi. Se l’interfaccia indica che alcune righe richiedono una verifica da parte dell’assistenza, usa Contact support; queste righe non vengono riprovate automaticamente.

Aggiornare i prodotti esistenti#

Per aggiornare i prodotti, usa lo stesso modello di categoria e mantieni lo SKU esistente di ogni prodotto. Compila tutti i campi obbligatori per ogni riga inclusa, modifica i valori desiderati e carica nuovamente il file.

• Lo stesso SKU nello stesso negozio aggiorna il prodotto esistente. Uno SKU che non esiste ancora crea un nuovo prodotto. Modificare uno SKU nel foglio di calcolo non rinomina il prodotto originale.
• Puoi caricare solo le righe dei prodotti che vuoi aggiornare. I prodotti assenti dal file non vengono eliminati, disattivati o rimossi dalla pubblicazione.
• Questo non è un aggiornamento parziale dei campi: i campi obbligatori devono comunque avere un valore. Non presumere che una cella facoltativa vuota mantenga il valore precedente. In particolare, uno status vuoto assume il valore predefinito active e le unità di dimensione mancanti assumono il valore predefinito in.
• Conserva la tua cartella di lavoro compilata per gli aggiornamenti futuri. Il modello scaricato non include i dati attuali dei prodotti.

Al termine dell’attività, verifica i prodotti interessati nel Catalogo. La sola riuscita dell’importazione non conferma la visibilità nel negozio; controlla la disponibilità dei prodotti e la lista di controllo per la pubblicazione di SDK.

Automatizzare le importazioni#

Per la sincronizzazione ricorrente lato server, usa Product Import API. I campi delle richieste, i limiti e il comportamento degli aggiornamenti parziali sono documentati separatamente da questo flusso con foglio di calcolo.