Questa guida tecnica permette di creare o aggiornare il catalogo prodotti caricando un file Excel. Il sistema gestisce l'abbinamento degli attributi e la creazione delle categorie mancanti.

Il processo si articola in quattro step guidati: caricamento e validazione del file, configurazione dell'import, abbinamento degli attributi e avvio del processo.

Al termine dell'elaborazione, un report di esecuzione mostra l'esito dell'operazione con il dettaglio di prodotti creati, aggiornati, righe in errore e categorie generate.

Preparazione del File di Import

Il sistema accetta esclusivamente file XLSX. Hai due modalità per preparare il documento:

1. Export e Modifica: Esporta i prodotti esistenti, modifica i valori e reimporta il file.

2. 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 Importa in alto a destra per accedere al flusso guidato.

Step 1 - Caricamento e Validazione

1. Accedi all'area Prodotti.

2. Clicca sul pulsante Importa in alto a destra.

3. 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.

## Articoli di approfondimento
- 
Guida alla Configurazione delle Famiglie di Prodotto e delle Variazioni

Associazione Categorie

Per collegare i prodotti alle categorie attiva la relativa opzione e specifica la colonna del file che contiene i percorsi.

1. Attiva l'opzione Sì, importa le associazioni.

2. 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 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.

Quando tutti i match sono validi e l'attributo identificativo è presente, il pulsante Importa prodotti si attiva e 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:

• Stato: in corso (icona di caricamento), completato (spunta verde) o fallito (punto esclamativo rosso).

• Tipo di operazione: import o export di prodotti.

• Avvio: quanto tempo fa è stata avviata l'operazione.

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

Serve aiuto?

Per problemi tecnici, scrivi a support@thron.com