---
title: Importa prodotti
description: Usa il modello CSV di Runner per avviare un'importazione di catalogo e segui la sua cronologia di elaborazione.
---

Importa prodotti da un CSV preparato quando l'inserimento delle stesse informazioni di catalogo strutturate uno per uno sarebbe inefficiente.

## Perché e quando usare l'importazione

Usa Importa quando hai già dati di prodotto in un foglio di calcolo o in un altro sistema e puoi mapparli al modello CSV di Runner. Usa il modulo [Prodotti](./products) manuale per un catalogo piccolo o quando hai bisogno di imparare prima i campi.

## Disponibilità e prerequisiti

- Apri **Store Operations → Prodotti** in un negozio pronto.
- Completa la configurazione di pubblicazione/preparazione del negozio che crea il suo canale di catalogo della vetrina live; l'attività di importazione non può continuare senza quel canale.
- L'elenco di prodotti desktop popolato mostra **Importa**. In un catalogo vuoto, usa prima **Aggiungi primo prodotto**; la vista mobile enfatizza la creazione manuale.
- L'importazione accetta solo file CSV.
- Usa il modello corrente di Runner. Le colonne richieste sono `handle` e `title`; le righe di variante devono includere il `sku` richiesto e i valori delle opzioni mostrati dal modello.
- L'avvio di un'importazione modifica il catalogo del negozio. Rivedi il file prima di inviarlo.

## Apri Importa prodotti

**Percorso di accesso:** **Workspace → scegli un negozio → Store Operations → Prodotti → Importa**

![Finestra di dialogo Importa prodotti](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgObeFKMJCcW62zHrU8smjSnqvixd1twlAf4uK)

## Controlli principali

| Controllo | Perché lo usi | Cosa succede quando selezionato |
| --- | --- | --- |
| **Importa** | Apri il flusso di lavoro di importazione in blocco | Apre la finestra di dialogo Importa prodotti senza avviare un'attività. |
| **Modello** | Inizia dalle colonne previste di Runner | Scarica il file `product-import-template.csv` corrente. |
| **Cronologia** | Controlla le attività di importazione precedenti | Passa a un elenco di file di importazione e i loro ultimi stati. |
| Area di caricamento | Scegli il CSV preparato | Legge il file localmente e lo mostra come pronto quando il contenuto è disponibile. |
| Controllo di rimozione file | Correggi una selezione errata | Cancella il file selezionato in modo da poterne scegliere un altro. |
| **Avvia importazione** | Invia il CSV selezionato | Avvia un'attività di importazione, quindi passa a Cronologia quando Runner l'accetta. |
| **Annulla** | Esci senza inviare | Chiude la finestra di dialogo e cancella il file selezionato. |
| **Aggiorna** in Cronologia | Richiedi lo stato dell'attività più recente | Ricarica la cronologia di importazione visibile. |
| **Torna a Importa** | Prepara un altro file | Ritorna da Cronologia alla vista di caricamento. |
| **Chiudi** | Esci da Cronologia | Chiude la finestra di dialogo senza modificare l'attività già inviata. |

## Prepara e invia un CSV

1. Seleziona **Importa**, quindi **Modello**.
2. Apri il CSV scaricato in un editor di fogli di calcolo che preserva la formattazione CSV.
3. Mantieni le intestazioni del modello. Completa `handle` e `title` per i prodotti, più il `sku` mostrato e i valori delle opzioni per le varianti.
4. Rivedi i handle dei prodotti, i titoli, i prezzi, le varianti e le righe ripetute prima di esportare come CSV.
5. Torna alla finestra di dialogo e scegli o trascina il CSV nell'area di caricamento.
6. Attendi che il file mostri **Pronto per l'importazione**.
7. Seleziona **Avvia importazione** una sola volta.
8. In **Cronologia**, segui il file inviato fino a quando non raggiunge uno stato terminale, quindi aggiorna l'elenco Prodotti e ispeziona le righe risultanti.

## Comprendi gli stati della cronologia

| Stato | Significato | Cosa fare |
| --- | --- | --- |
| **In sospeso** | L'attività è in attesa di avvio | Lasciala in posizione e controlla di nuovo più tardi; non inviare immediatamente un duplicato. |
| **Elaborazione** | Runner sta elaborando il file | Mantieni la finestra di dialogo aperta o torna a Cronologia più tardi. |
| **Completato** | Runner ha finito di consegnare il file all'importatore di catalogo | L'elaborazione del prodotto può continuare dopo questo stato. Aggiorna Prodotti e ispeziona nomi, varianti, prezzi, stato e inventario. |
| **Non riuscito** | Runner non ha potuto completare l'attività di importazione | La scheda Cronologia corrente registra lo stato non riuscito ma non una causa dettagliata. Controlla i prerequisiti e il CSV di origine prima di inviare un nuovo file. |
| **Annullato** | L'attività non ha continuato | Conferma se sono stati creati prodotti prima di decidere cosa inviare dopo. |

La cronologia può anche mostrare la dimensione del file, il numero totale di righe e un ID transazione quando Runner ha questi valori. Questi dettagli identificano l'attività; non sostituiscono il controllo dei record del prodotto.

## Limiti e risoluzione dei problemi

- **Avvia importazione è disabilitato:** Seleziona un file `.csv` e attendi che Runner finisca di leggere il contenuto non vuoto.
- **Tipo di file non valido:** Esporta il foglio di calcolo come CSV; rinominare un altro formato di file non lo converte.
- **Errore di lettura file:** Riesporta il CSV, conferma che si apre normalmente sul tuo dispositivo e sceglilo di nuovo.
- **Importazione non riuscita:** Conferma che la configurazione di pubblicazione/preparazione del negozio ha creato il canale di catalogo della vetrina live, quindi usa il modello fornito, ripristina le colonne richieste e controlla i valori `sku` e delle opzioni della variante.
- **L'attività sembra bloccata:** Apri Cronologia e seleziona **Aggiorna**. In sospeso e Elaborazione non sono prova di completamento.
- **Righe di prodotto inaspettate appaiono:** Non ripetere ciecamente la stessa importazione. Confronta i handle CSV con l'elenco Prodotti e correggi i record deliberatamente.

## Guide correlate

- [Prodotti](./products)
- [Inventario e varianti](./inventory-and-variants)
- [Onboarding e Impostazioni generali](./onboarding-and-general-settings)
- [Panoramica di Store Operations](./)