Vai al contenuto

Importare i prodotti da un file CSV o Excel

Con i profili di import carichi in Kliveer centinaia di prodotti da un file CSV, Excel o XML, abbini le colonne ai campi, aggiorni prezzi e quantità dei prodotti già presenti e colleghi le varianti con un secondo file.

Indice del manuale28 guide

Se il catalogo sta già in un foglio di calcolo, o il fornitore ti manda il listino in CSV, non serve inserire i prodotti a mano. In Kliveer l'importazione passa da un profilo di import: lo prepari una volta, dicendo come è fatto il file e quale colonna va in quale campo, e poi lo riusi ogni volta che arriva un file con la stessa struttura. L'esempio è una ferramenta che porta in Kliveer 1.200 articoli dal vecchio gestionale e poi, ogni mese, aggiorna prezzi e quantità.

Le due fasi: profilo e importazione

Nel menu laterale del gestionale apri Importa. Le voci che userai sono:

  • Crea Nuovo Profilo di Import: opzioni e abbinamento delle colonne.
  • Importa File con Profilo: carichi il file, guardi l'anteprima e avvii.
  • Gestione Profili di Import: i profili salvati, da modificare o eliminare.
  • Visualizza Log delle Importazioni: lo storico, con righe lette, righe elaborate e messaggi.
  • CSV varianti prodotti: la procedura per collegare le varianti.

Preparare il file

Kliveer legge file CSV o di testo, XML e fogli di calcolo XLS/ODF. Un foglio Excel conviene salvarlo come CSV con il punto e virgola come separatore. Controlla che il file abbia:

  • Una riga per prodotto e, nella prima riga, i nomi delle colonne.
  • Un codice univoco per ogni prodotto: SKU, EAN o codice del fornitore. Serve a riconoscere i prodotti già presenti quando reimporti il file.
  • Prezzo senza IVA nella colonna del prezzo di vendita. I prodotti importati ricevono l'aliquota IVA predefinita del tuo account.
  • Categorie con un separatore tra categoria e sottocategoria, per esempio Utensili>Trapani. Se un prodotto sta in più categorie, separale con un secondo carattere, per esempio Utensili>Trapani|Offerte. Le categorie che non esistono vengono create.
  • Foto come indirizzi web (URL) che finiscono con il nome del file. Più foto nella stessa cella vanno separate con ####.

Un estratto del file della ferramenta:

codicedescrizioneprezzocostoeangiacenzacategoriafoto
TR-450Trapano a percussione 750 W65.5738.00800123456789512Utensili>Trapanihttps://.../tr450.jpg
VI-M6Viti metriche M6 conf. 1004.921.808001234567901240Minuteria>Vitihttps://.../vim6.jpg

Creare il profilo di import

Apri Importa > Crea Nuovo Profilo di Import. Queste sono le opzioni che contano per i prodotti.

Impostazioni del file

  • Nome profilo: per esempio «Catalogo vecchio gestionale».
  • Entità da Importare: scegli Prodotto.
  • Divisore di campo: il separatore delle colonne, di solito ;.
  • Intestazione in prima riga?: Sì, se la prima riga contiene i nomi delle colonne.
  • Divisore campi interni "splitter": il separatore dei valori multipli nella stessa cella, come le foto. Il valore proposto è ####.

Cosa fare con i prodotti

  • Modalità di importazione: per il primo caricamento scegli Inserisci nuovi e Aggiorna esistenti. Su un profilo nuovo la scelta proposta è Inserisci nuovi e duplica esistenti, che crea un doppione per ogni prodotto già presente: cambiala.
  • Analisi del file: Totale (più tempo) rielabora tutto; Differenziale (meno tempo) lavora solo le righe cambiate dall'ultima volta.
  • Divisore Categorie e Sottocategorie e Separatore categorie multiple: nell'esempio > e |. In alternativa Unica Categoria in cui importare TUTTI i prodotti mette tutto in una categoria.
  • Vuoi pubblicare i prodotti nell'ecommerce?: Sì se devono comparire subito nel negozio.
  • Modo import immagini: Aggiungi alle esistenti oppure Cancella e importa nuovamente. Se le celle contengono solo il nome del file, scrivi la parte iniziale dell'indirizzo in Prefisso URL immagini.
  • Importa prodotto come Bozza: per controllarli prima di metterli in vendita.

Le quantità: listino del fornitore o merce tua

Qui c'è la scelta più importante. Se il file è il listino di un fornitore, scegli il Fornitore (con Nuovo Fornitore lo crei al volo) e, se usi più magazzini, il suo magazzino in Assegna al Magazzino:. In questo caso ogni riga deve avere il codice articolo del fornitore: quelle senza non vengono importate.

Se il file contiene la merce che hai tu, come nel caso della ferramenta, spunta Inventario Iniziale, scegli il Magazzino Fisico (se non usi più magazzini, Kliveer ti avvisa che le quantità vanno direttamente nei prodotti) e poi una delle due opzioni:

  • Aggiorna quantità senza azzerare: aggiorna i prodotti presenti nel file e lascia com'erano gli altri.
  • Azzera quantità prima di importare: prima mette a zero le quantità di tutti i prodotti dei magazzini fisici, poi applica il file. Usala solo se il file contiene davvero tutto il catalogo: i prodotti che mancano restano a 0 e nel negozio risultano esauriti. Fai attenzione perché, quando spunti Inventario Iniziale, è l'opzione già selezionata.

Da dove arriva il file

In fondo scegli la sorgente: Importa da File (lo carichi dal computer), Importa da URL (API) (indirizzo del file, con utente e password se richiesti) o Importa da FTP. Carica un file d'esempio e premi Analizza File.

Abbinare le colonne ai campi

Nella pagina successiva vedi il Charset Rilevato del file e una riga per ogni sua colonna: in Campo File il nome della colonna, nelle colonne Anteprima Riga i primi valori letti, e in Campo Entità un menu dove scegli il campo di Kliveer. Le colonne che non ti servono restano su Non Mappare.

Per il file della ferramenta l'abbinamento è questo:

Colonna del fileCampo Entità
codiceSku
descrizioneNome (diventa il nome del prodotto)
prezzoPrezzo vendita
costoPrezzo acquisto
eanCodice EAN
giacenzaQuantita (nell'elenco è scritto senza accento)
categoriaCategoria
fotoURL Immagine

Nel menu ci sono anche Descrizione breve, Descrizione estesa, Meta Title, Meta Description, Marca e il prezzo di ogni listino di vendita attivo. Per un listino del fornitore abbina il suo codice a Codice articolo e la sua disponibilità a Qta disponibile fornitore, che il negozio non mostra.

La colonna Post-elaborazione corregge i valori mentre vengono importati, per esempio Sostituzione testo, Scarta se contiene... o Aggiungi prima..., con cui metti il prefisso «FB-» davanti a tutti i codici. Quando hai finito premi Salva.

Avviare l'importazione

  1. Apri Importa > Importa File con Profilo.
  2. Scegli il Profilo di import, indica quante righe vedere in N° Record in anteprima (da 1 a 10) e carica il file.
  3. Premi Anteprima Importazione e controlla che i valori stiano nei campi giusti. Se qualcosa non torna, con Modifica la Selezione torni indietro.
  4. Premi Avvia Import. Con file grandi può durare qualche minuto.
  5. Alla fine leggi l'esito, per esempio «Importazione Terminata! Sono stati importati 1200 elementi.». I dettagli riga per riga sono in Visualizza Log delle Importazioni.

Le foto indicate con un URL vengono messe in coda e scaricate in un secondo momento: è normale vederle comparire con un po' di ritardo.

Aggiornare i prodotti che hai già

Il mese dopo la ferramenta riceve un file con i nuovi prezzi. Non serve un profilo nuovo: basta riusare quello di prima, oppure crearne uno dedicato con Modalità di importazione su Aggiorna solo Esistenti non inserire Nuovi, così le righe di prodotti che non hai in catalogo vengono ignorate.

Un prodotto viene considerato già presente se trova corrispondenza su SKU, EAN o codice del fornitore. Nelle opzioni del profilo puoi aggiungere al confronto Codice Costruttore e PN (Part Number), oppure scegliere Crea Clone se prodotto esistente per avere una copia con un altro SKU.

Le varianti: il file «CSV varianti prodotti»

Se vendi lo stesso articolo in più taglie o colori, prima importa tutti i prodotti (quello di partenza e ogni variante, ciascuno con il suo SKU), poi collegali con Importa > CSV varianti prodotti. Il file ha questa struttura, con la prima riga di intestazione che viene saltata:

SKU padreSKU varianteCaratteristica 1Valore 1Caratteristica 2Valore 2
GU-100GU-100-MTagliaMColoreNero
GU-100GU-100-LTagliaLColoreNero

Nella pagina indica il Separatore campi, carica il file con Carica CSV, scegli la Lingua dei nomi delle caratteristiche e premi Procedi. Kliveer collega ogni variante al suo prodotto padre e crea le caratteristiche e i valori che mancano; gli SKU che non trova sono elencati in Impossibile trovare i seguenti prodotti:. Per creare le varianti dalla scheda prodotto leggi creare un prodotto completo.

Errori tipici

  • «Nessun prodotto importato!»: di solito i prodotti non sono cambiati dall'ultima importazione. Se serve, rilancia con Analisi del file su Totale (più tempo).
  • «Importazione NON effettuata completamente!» con SKU già esistenti: il profilo non aggiorna i prodotti presenti. Modifica la Modalità di importazione.
  • «Importazione NON effettuata!» perché nel profilo non è indicato un magazzino: con i magazzini attivi devi scegliere il Magazzino Fisico (merce tua) o il magazzino del fornitore. Se non hai ancora un magazzino fisico, crealo dal menu Magazzini.
  • Limiti del piano: se il file contiene più prodotti di quelli consentiti dal tuo piano, Kliveer blocca l'importazione oppure, con Import parziale? su Sì, importa fino al limite e ti dice quanti elementi sono rimasti fuori. Anche i profili salvabili sono limitati dal piano.
  • «Impossibile avviare l'import!»: c'è un'altra importazione in corso.
  • «ERRORE DETECT TIPO FILE»: Kliveer non ha riconosciuto il formato. Torna indietro e scegli il Tipo File a mano.

Se nel menu Importa vedi le voci Reset Categorie/Prodotti [ATTENZIONE OP. IRREVERSIBILE] o Reset Clienti/Indirizzi [ATTENZIONE OP. IRREVERSIBILE], non usarle per rimediare a un'importazione sbagliata: cancellano tutti i prodotti, le categorie o i clienti e non si possono annullare.

Dopo l'import le quantità finiscono nei magazzini: per tenerle allineate nel tempo leggi magazzini, carico e scarico, ordini ai fornitori.

Altre guide