Importare i prodotti in piattaforma
Questa guida spiega come importare o aggiornare il catalogo prodotti tramite file Excel XLSX in quattro step: caricamento e validazione, configurazione import, abbinamento attributi e avvio import. Il sistema gestisce categorie e varianti, offre report dettagliati e richiede permessi specifici. Sono indicati limiti tecnici e best practice per un import efficace.
Per importare i prodotti in piattaforma devi essere Amministratore o avere il permesso "Può creare e modificare prodotti”
Preparazione del File di Import
Il sistema accetta esclusivamente file XLSX. Hai due modalità per preparare il documento:
- Export e Modifica: Esporta i prodotti esistenti, modifica i valori e reimporta il file.
- Creazione da zero: Crea un nuovo file Excel specificando un attributo per ogni colonna.
Best Practice
- Usa nomi colonna identici ai Codici Attributo di THRON; il sistema eseguirà il mapping automatico riducendo l'intervento manuale.
- In Excel, imposta le colonne con valori multipli (es. taglie, colori) come Testo. Questo evita che valori come "2024,2023" siano interpretati come numeri decimali.
- Prima di caricare migliaia di righe, esegui un test con un file ridotto da 10-20 righe.
Importa i Prodotti
Dalla lista prodotti, clicca Import in alto a destra per accedere al flusso guidato.
Step 1 - Caricamento e Validazione
- Accedi all’area Prodotti.
- Clicca sul pulsante Importa in alto a destra.
- Trascina il tuo file XLSX nell'area di upload. Il sistema effettuerà una scansione immediata per verificare che il file non sia corrotto e che il formato sia supportato.
Step 2 - Setup importazione
Modalità di importazione:
- Aggiorna esistenti: Modifica solo i prodotti già presenti (identificati tramite codice univoco).
- Aggiungi nuovi & aggiorna esistenti: Crea nuove schede se il codice non esiste e aggiorna quelle esistenti.
- Gestione Varianti: Se gestisci prodotti con varianti, attiva l'opzione e mappa le colonne: Variazione (es. colore/taglia), Livello di gerarchia, Master (prodotto padre) e l'eventuale Gruppo di variazioni.
Associazione Categorie
Per collegare i prodotti alle categorie attiva la relativa opzione e specifica la colonna del file che contiene i percorsi.
- Attiva l’opzione Sì, importa le associazioni.
- Seleziona la colonna del file con i percorsi.
Formato richiesto: Usa > per separare i livelli e , per percorsi multipli.
- Esempio:
master-catalog > accessories > bags - Esempio:
master-catalog > accessories > bags, master-catalog > accessories > summer bags
Puoi scegliere di creare automaticamente le categorie non ancora presenti nel Data Model. Tieni presente che:
- il catalogo di riferimento deve già esistere in piattaforma;
- se l'import dei prodotti associati fallisce, la categoria viene comunque creata;
- le categorie create sono verificabili nel report di esecuzione e gestibili da Impostazioni → Cataloghi e Categorie.
Una volta compilati tutti i campi obbligatori, clicca Associazione attributi per procedere.
Step 3 - Abbinamento degli Attributi (Matching) e avvio dell’import
Il sistema propone un abbinamento tra le Colonne del File e gli Attributi di Piattaforma.
Per ogni riga proposta è disponibile il pulsante Ignora per escludere la colonna dall'import senza eliminarla dal file.
Errori bloccanti che impediscono di procedere
- Colonna senza attributo abbinato: ogni colonna deve avere un attributo selezionato, altrimenti il pulsante Importa prodotti rimane disabilitato.
- Attributo duplicato: due colonne non possono essere abbinate allo stesso attributo con la stessa locale. Modifica uno dei match o clicca Ignora su una delle righe.
Quando tutti i match sono validi e l'attributo identificativo è presente, il pulsante Importa prodotti si attiva puoi avviare il processo. L'import viene eseguito in background,
Best Practice
- Verifica che ogni colonna sia mappata correttamente.
- Se una colonna non viene riconosciuta, seleziona manualmente l'attributo di destinazione dal menu a tendina.
- Ignora Colonna: Se una colonna non deve essere importata, seleziona l'opzione per saltarla.
- Ogni colonna deve avere un attributo selezionato, altrimenti il pulsante Importa prodotti rimane disabilitato.
- Due colonne non possono essere abbinate allo stesso attributo con la stessa locale. Modifica uno dei match o clicca Ignora su una delle righe.
Monitorare Import ed Export in Background
Quando sono in esecuzione operazioni in background, nella barra superiore compare un'icona che indica lo stato delle attività.
Clicca sull'icona per visualizzare la lista delle ultime 5 operazioni. Per ogni task vengono mostrate tre informazioni:
Leggere il Report di un Import
Al termine di un import, clicca sul task completato nella lista delle operazioni in background per aprire il report di esecuzione.
Visualizzare le righe in errore
Clicca sul contatore delle righe in errore (rosso) per accedere alla pagina di dettaglio.
Visualizzare le nuove categorie create
Clicca sul contatore delle categorie create per accedere alla pagina di dettaglio. Da qui, clicca Gestisci per essere reindirizzato a Impostazioni → Cataloghi e Categorie, dove puoi verificare e modificare le categorie generate.
Limiti e Vincoli Tecnici
| Parametro | Limite / Vincolo |
|---|---|
| File Name |
|
| Dimensione File |
|
| Nome Colonna |
|
| Separatore Valori Multipli |
|