Automatizza l'import dei tuoi Prodotti
Ogni volta che il tuo catalogo cambia — nuovi prodotti, aggiornamenti stagionali — qualcuno deve aggiornare THRON. Con l'automazione Product Import, quel lavoro sparisce: THRON si connette al tuo server, recupera il file aggiornato e sincronizza il catalogo in modo ricorrente e senza intervento manuale.
Questa guida ti accompagna nella configurazione completa del flusso, dall'accesso al server alla lettura dei risultati.
Quando usare questa automazione
| Scenario | Usa Product Import se… |
|---|---|
| Onboarding iniziale | Hai un catalogo esistente su un sistema esterno e vuoi importarlo in THRON senza copia-incolla |
| Sync periodico | Il tuo sistema gestionale aggiorna i dati prodotto regolarmente e vuoi mantenerli allineati in THRON |
| Aggiornamento massivo | Hai variazioni frequenti su molti prodotti (disponibilità, attributi stagionali) che non vuoi gestire manualmente |
Prima di iniziare
Verifica di avere pronti questi elementi:
- Famiglie e attributi configurati in THRON — l'automazione popola attributi esistenti, non li crea.
- Accesso al server FTP/SFTP/FTPS — host, porta, username, password e path della cartella sorgente.
- File di mappatura — un CSV o XLSX che associa le colonne del tuo file agli attributi di prodotto THRON.
- Permessi in THRON — devi poter creare e modificare prodotti.
Non hai ancora configurato Famiglie e attributi? Parti da Configura le Famiglie di Prodotto e Variazioni.
Configura il flusso in 5 passi
Passo 1 — Crea l'automazione
- Vai in Impostazioni di Piattaforma → Flussi & Automazioni → Automazioni.
- Clicca su Nuova e seleziona Product Import.
- Assegna un Nome chiaro e riconoscibile (es.
Product Import – ERP Stagione SS26).
Passo 2 — Connetti il server sorgente
Inserisci i parametri di connessione al server da cui THRON leggerà i file:
| Parametro | Descrizione |
|---|---|
| Tipo connessione |
FTP, FTPS o SFTP
|
| Host | Indirizzo del server (es. ftp.azienda.com) |
| Porta |
21 per FTP · 22 per SFTP · 990 per FTPS |
| Username / Password | Credenziali di accesso al server |
| Path di lettura | Percorso della cartella remota (es. /export/prodotti/) |
Non sai quale protocollo usare? Scegli SFTP (porta 22): è il più sicuro e il più supportato dai server moderni.
Passo 3 — Carica il file di mappatura
Il file di mappatura dice a THRON come leggere il tuo file: quale colonna corrisponde a quale attributo di prodotto.
Struttura del file (CSV o XLSX, due colonne):
| Colonna sorgente | Attributo THRON |
|---|---|
product_code |
sku |
nome_prodotto |
product_name |
prezzo |
price |
| (la tua colonna) | (il codice attributo THRON) |
Come caricarlo:
- Clicca su Carica file di mappatura e seleziona il tuo file.
- Il sistema riconosce le colonne automaticamente e mostra un riepilogo di mappatura.
- Controlla ogni abbinamento e correggi eventuali colonne non mappate.
- Per gli attributi localizzati, aggiungi il Locale (es.
it-IT). - Clicca Salva mappatura.
Attenzione: Tutti i file che il job processerà devono avere sempre la stessa struttura di colonne. Se la struttura cambia, aggiorna prima il file di mappatura.
Passo 4 — Imposta la cartella errori e la schedulazione
Cartella errori: seleziona una cartella dedicata in THRON. Ogni volta che un prodotto non viene importato correttamente, il sistema deposita qui un file Excel con il dettaglio degli errori per riga e attributo.
Schedulazione — scegli la frequenza più adatta al tuo flusso:
| Frequenza | Adatta a… |
|---|---|
| Ogni ora | Catalogo ad alto tasso di variazione |
| Ogni 6 ore | Aggiornamenti frequenti durante la giornata lavorativa |
| Ogni 12 ore | Sync mattina/sera |
| Ogni giorno alle 01:00 | Aggiornamento notturno — la scelta più comune |
| Ogni giorno alle 02:00 | Alternativa notturna se hai altri job attivi alle 01:00 |
Passo 5 — Monitora i risultati
Vai nella scheda Executions dell'automazione. Per ogni esecuzione trovi:
- Data e ora di avvio e completamento
-
Stato:
SuccessooErrore - Report scaricabile con l'elenco dei prodotti importati e il dettaglio degli errori per attributo e colonna
Configurazione Consigliata
Se è la prima volta che configuri questa automazione, parti da qui. Puoi sempre modificare la configurazione in seguito.
| Parametro | Valore consigliato | Perché |
|---|---|---|
| Tipo connessione | SFTP (porta 22) | Protocollo sicuro, ampiamente supportato |
| Schedulazione | Ogni giorno alle 01:00 | Esegue di notte, senza impatto sulle performance |
| File di mappatura | Mappa solo gli attributi obbligatori | Valida il flusso end-to-end, poi aggiungi i campi opzionali |
| Cartella errori | Cartella dedicata, monitorata dal team | Isola gli errori e semplifica il troubleshooting |
Cosa succede ad ogni esecuzione
L'automazione esegue questi passaggi in sequenza, in modo completamente automatico:
- Connessione al server con le credenziali configurate
- Lettura del file CSV/XLSX dal path di lettura
- Conversione automatica del file nel formato compatibile con il job di import
- Applicazione della mappatura colonne → attributi
- Avvio del job di importazione nella sezione Prodotti di THRON
- Scrittura dei risultati: in caso di successo il file viene spostato nella cartella "contenuti completati"; in caso di errori viene generato un file Excel di dettaglio depositato nella cartella errori
Gestione degli errori
| Errore | Causa probabile | Come risolverlo |
|---|---|---|
| Errore di connessione | Credenziali errate, server non raggiungibile o porta sbagliata | Verifica host, porta e credenziali nella configurazione |
| File non valido | Colonne mancanti, formato non supportato o file corrotto | Controlla che il file sia CSV o XLSX e rispetti la struttura attesa |
| Errore di mappatura | Attributo inesistente o valore non compatibile con il tipo campo | Aggiorna il file di mappatura e verifica i valori nel file sorgente |
| Errore di importazione | Dati non conformi alla struttura degli attributi configurati | Apri il report di esecuzione e leggi il dettaglio per riga |
| Esecuzione non completata | Errore di sistema | Contatta support@thron.com allegando il log di esecuzione |