Con i file CSV puoi caricare e aggiornare molti prodotti in una volta sola, per esempio partendo dal listino di un fornitore, ed esportare prodotti e ordini verso un gestionale. In questa guida trovi come preparare il file dei prodotti; i passaggi per caricarlo sono in Importazione manuale dei CSV.

Le altre guide sui CSV: CSV Pro per salvare un modello e creare in automatico categorie, brand e attributi; Esportazione CSV Prodotti; Modifica informazioni di spedizione con CSV per aggiornare tracking e stato degli ordini; Modifica campi descrittivi lingue con csv per le traduzioni.

Com'è fatto un file CSV

Un CSV è un file di testo che contiene una tabella: ogni riga è un prodotto e le colonne sono separate da un carattere, di solito il punto e virgola. Lo puoi creare con Excel, LibreOffice o Google Fogli scegliendo il formato CSV. Per Maxpho Commerce conta questo: la codifica deve essere UTF-8, altrimenti le lettere accentate arrivano sbagliate (in Excel scegli CSV UTF-8); la prima riga contiene i nomi delle colonne; il separatore consigliato è il punto e virgola. Se un testo contiene il separatore o va a capo, racchiudilo tra virgolette doppie, come fanno da soli i fogli di calcolo.

Il nome delle colonne lo scegli tu, perché durante l'importazione associ ogni colonna a un campo del prodotto. Il nome conta solo in tre casi, che trovi più sotto: i testi in più lingue, i prezzi dei listini e gli attributi.

Le colonne principali

La colonna più importante è lo SKU: è il codice con cui il sistema capisce se un prodotto esiste già (e lo aggiorna) o se va creato. Per un prodotto nuovo servono anche il titolo (campo Titolo) e la categoria (campo Nome categoria): senza titolo il prodotto non viene creato, senza categoria viene creato spento. Di solito si aggiungono Descrizione, Prezzo lordo, Quantità a magazzino, Nome Brand, le immagini e i codici come Codice EAN e Codice produttore (MPN).

Nel menu di associazione trovi anche gli altri campi: Campo Personalizzato 1…5, Prezzo netto, Prezzo netto scontato e Prezzo lordo scontato, il prezzo di stock con la Minima quantità acquistabile:, Prezzo di costo netto, Peso del pacco con Lunghezza, Altezza e Profondità, Giorni per l'imballaggio, Data disponibile (YYYY-MM-DD), i codici UPC, ISBN, GTIN, JAN, Part Number e ASIN Amazon, e i campi per eBay, come ID inserzione eBay®, ID categoria eBay® e KType.

Qualche regola sui valori. I prezzi si scrivono senza simbolo di valuta e senza separatore delle migliaia, per esempio 1249.90; se usi la virgola per i decimali sceglilo nel formato del file. Se importi prezzi lordi, aggiungi la colonna Valore dell'imposta con l'aliquota, per esempio 22: il sistema la usa per calcolare il prezzo netto e deve corrispondere a un'aliquota che hai già in Classi di tassazione. La quantità è un numero intero. Per Stato (valori [0,1]) usa 1 per acceso e 0 per spento. Le date si scrivono come 2026-11-30 oppure 30/11/2026.

Categorie e brand

Nella colonna della categoria scrivi il percorso completo, dalla categoria principale alla sottocategoria, separando i livelli con #. Per esempio Sport#Basket#Accessori indica la categoria Accessori dentro Basket, dentro Sport. Il sistema accetta anche > oppure | come separatore. Se un prodotto sta in più categorie, usa più colonne e associale tutte a Nome categoria.

Categorie e brand devono già esistere nel negozio, scritti nello stesso modo: quelli che il sistema non trova vengono ignorati, senza avviso. Puoi crearli prima, anche loro con un CSV, oppure usare CSV Pro, che li crea da solo.

Le immagini

Metti nella colonna l'indirizzo web completo dell'immagine, che inizia con https://. Nel menu di associazione puoi scegliere Scarica immagine da URL HTTP, che salva una copia dell'immagine nel tuo negozio, oppure Usa immagine da URL HTTP, senza scaricarla, che mostra l'immagine direttamente dal sito che la ospita: è più veloce, ma se il fornitore la toglie sparisce anche dal tuo sito. Per più immagini usa più colonne associate allo stesso campo: la prima diventa l'immagine principale. Sono accettati i formati jpg, png, gif, webp, tif e bmp.

Testi in più lingue

Titolo, descrizione e campi personalizzati possono avere un testo per ogni lingua. Basta aggiungere in fondo al nome della colonna il codice della lingua, per esempio titolo_en_GB o descrizione_de_DE, e associare tutte le colonne del titolo a Titolo e tutte quelle della descrizione a Descrizione. I codici delle tue lingue sono nella colonna Codice della pagina Lingue: it_IT per l'italiano, en_GB per l'inglese, de_DE per il tedesco, fr_FR per il francese, es_ES per lo spagnolo. Le colonne senza codice vanno nella lingua che scegli durante l'importazione. Trovi un esempio completo in Modifica campi descrittivi lingue con csv.

Prezzi dei listini

Se usi i Listini di prezzo, puoi importare il prezzo di ogni listino in una colonna a parte: scrivi in fondo al nome della colonna il nome del listino, esattamente come l'hai chiamato, per esempio prezzo_Rivenditori, e associala a Prezzo lordo o Prezzo netto. Lo stesso vale per il prezzo scontato del listino con Prezzo lordo scontato o Prezzo netto scontato. La colonna del prezzo senza nome del listino aggiorna il prezzo base. Attenzione ai prodotti nuovi: sui listini che non sono nel file ricevono prezzo 0, che sul sito diventa «Trattativa Privata».

Varianti e specifiche

Gli attributi si importano con colonne che si chiamano attribute_ seguito dal nome dell'attributo, per esempio attribute_Taglia o attribute_Anno, associate al campo Attributo prodotto. L'attributo e i suoi valori devono già esistere in Attributi Prodotti: un valore che il sistema non trova viene ignorato.

Le specifiche, come l'anno o il materiale, si scrivono sulla stessa riga del prodotto. Le varianti, come le taglie, hanno invece una riga ciascuna: la prima riga contiene i dati del prodotto e le righe successive ripetono lo stesso SKU con i dati della singola variante. Le righe dello stesso prodotto devono stare una sotto l'altra.

Per ogni variante puoi aggiungere altre colonne con il nome dell'attributo, i due punti e il dato: attribute_Taglia:quantity per la quantità, :sku per lo SKU della variante, :ean per l'EAN, :price per la differenza di prezzo rispetto al prodotto, e ancora :weight, :asin, :mpn e :image per un'immagine della variante. Queste colonne vanno messe dopo la colonna attribute_Taglia. Puoi partire da questi esempi: variante_singola.csv per le varianti e specifiche.csv per le specifiche.

Le varianti con due attributi combinati, come taglia e colore, richiedono un'impostazione: nel Pannello Di Controllo, sezione Moduli, apri Moduli CSV › Configurazione importazione prodotti e imposta Abilita attributi correlati su Vero; se al posto di Vero e Falso trovi un campo di testo, scrivi 1. Poi metti sulla stessa riga le due colonne, per esempio attribute_Taglia e attribute_Colore, seguite da attribute_Colore:quantity e dagli altri dati della combinazione.

Quando aggiorni un prodotto con un file che contiene colonne di attributi, le sue varianti e specifiche vengono sostituite da quelle del file: metti sempre tutte le varianti, non solo quelle che cambiano.

Esportare gli ordini

Puoi scaricare gli ordini in un file CSV da passare al tuo gestionale. Nel menu a sinistra clicca su Ordini, spunta gli ordini che ti servono e clicca sull'icona Esporta che compare in alto, poi su Esporta. Per esportare tutti gli ordini che vedi con i filtri applicati, per esempio quelli di un mese o di uno stato, spunta la casella in testa all'elenco e accetta di selezionarli tutti.

Nel file orders.csv c'è una riga per ogni prodotto ordinato, con il numero dell'ordine ripetuto. Le colonne le scegli nel Pannello Di Controllo, sezione Moduli, in Moduli CSV › Esportazione ordini csv (se accanto c'è il +, cliccalo per installarlo): trovi i dati del cliente, dell'indirizzo di spedizione e di fatturazione con partita IVA e codice fiscale, il pagamento, il metodo di spedizione, lo stato, i prodotti con prezzi netti e lordi e aliquota, i totali, la valuta, le date e i commenti, e in più, da attivare, codici EAN e MPN, coupon, sconti, contrassegno, corriere e tracking.

In Moduli CSV › Configurazione file CSV imposta la codifica dell'esportazione su UTF-8, altrimenti le lettere accentate vengono tolte, e il separatore dei decimali che vuole il tuo gestionale.