Questo articolo spiega come preparare un file di importazione per la categoria "prodotti".

I dati in questa categoria rappresentano gli articoli disponibili per l'acquisto. I "prodotti" sono quindi collegati agli "orders" (ovvero gli ordini) tramite "order lines" (i singoli articoli in ogni ordine).

🚧
Tieni presente che "prodotti" è una delle categorie che possono essere aggiornate: i dati già esistenti possono essere modificati per mezzo di future importazioni.

Prerequisiti

Conoscenza di base del formato CSV e della codifica UTF-8.
Un editor di testo compatibile con UTF-8.
Un software per fogli di calcolo
La sottosequenza deve essere definita nel file di configurazione nella sezione "prodotti".

Preparare un file di prodotti

Controlla il file che stai preparando e verifica che contenga tutte le informazioni che vuoi importare.

Utilizza il tuo software per fogli di calcolo per organizzare le colonne e rimuovere quelle che non puoi (o non vuoi) importare. Ricorda sempre di salvare (o esportare) il file in formato CSV con codifica UTF-8 senza BOM e di usare i punti e virgola (";") per separare le colonne.

Usa il un editor di testo di tua preferenza per aprire e modificare il file CSV da importare.

🚧
Si prega di limitare le dimensioni del file a 200K righe.

Header e Colonne

La prima riga del file è l'header. Assicurati che contenga solo i nomi delle colonne, altrimenti l'importazione non andrà a buon fine.

Le seguenti colonne sono disponibili nei file "prodotti":

product_id -- l'identificatore esterno del prodotto; questa colonna è obbligatoria e deve essere univoca per ogni prodotto.
name -- il nome del prodotto che verrà visualizzato in Splio.
brand -- la marca del prodotto.
description -- la descrizione del prodotto - informazioni aggiuntive che saranno visibili in Splio.
price -- il prezzo nominale del prodotto, sempre espresso come numero con due decimali (es. 2,50), nella valuta predefinita dell'universo Splio.
category -- il nome della categoria associata al prodotto.
img_url -- l'URL di un'immagine che rappresenta il prodotto.
sku -- (Stock Keeping Unit); il codice univoco utilizzato per tenere traccia delle scorte dei prodotti.
Un'eventuale colonna personalizzata, se definita per i prodotti nel tuo universo Splio.

Nota che tutte le colonne relative ai campi di sistema devono essere in minuscolo.

L'importazione fallirà se non includi la colonna obbligatoria (product_id) o se utilizzi una colonna non riconosciuta da Splio (ossia, né una delle colonne predefinite né una colonna personalizzata correttamente).

📘
Nota Bene: Quando carichi i prezzi dei prodotti, assicurati di inserire due cifre decimali dopo il punto (per esempio 10,99).

Esempio di un file

Un file breve che elenca alcuni prodotti per animali potrebbe apparire così:

product_id;name;brand;price
"0013130002004";"Dog Treats";"Milk Bone";"182.49"
"8003299918256";"Tigrito Cat Bowl";"Alessi";"38.50"
"0871864006190";"Hot Diggity Dog Dog Toy Size Medium";"Petstages";"85.25"
"0721343632993";"Maximum Absorbency Dog Puppy Pads Size 100 Package;Zanies";"119.91" 
"0045663188931";"Dog Diaper Garment Size Medium";"Topdawg Pet Supply";"115.61"

L'esempio utilizza quattro colonne standard: product_id, nome, marca e prezzo. I dati relativi a ciascuna colonna sono elencati nelle righe successive.

Nominare un file

Salva il tuo file con un nome composto dal nome dell'universo, ambito ("prodotti"), sotto-sequenza e data corrente. Ad esempio:

myuniverse_products_zoo_20180416.csv

Questo file fa parte dell'universo "myuniverse", nella sottosequenza "zoo" definita per i prodotti, ed è datato 16 aprile 2018.

Ora puoi caricare il file su SFTP/FTPS.

Informazioni Avanzate

Questa parte dell'articolo contiene informazioni aggiuntive relative alla guida qui sopra e forniscono maggiori dettagli.

Formato dei file

Nome del file	products().csv
Codificación	UTF-8 senza BOM
Formato	CSV (senza multilinea)
Separatore di colonne	; (semicolonna)
Qualificatore di testo	" (doppie virgolette, facoltative)
Caretteri di escape	\ (backslash)
Fine della linea	\n or \r\n
Separatore decimale	. (punto)

Colonne

La tabella qui sotto contiene informazioni dettagliate relative a tutte le colonne (campi) dell'ambito "prodotti".

🚧
Tieni presente che i nomi delle colonne devono essere scritti facendo attenzione alle maiuscole e minuscole. Per questo motivo, i nomi predefiniti sono tutti in minuscolo.

Colonna	Obbligatorio	Tipo di dati / Lunghezza massima	Descrizione
product_id	Sì	Testo (max. 50 caratteri)	Questa colonna deve includere l'identificatore esterno del prodotto importato. Poiché è la chiave primaria della tabella "prodotti", questa colonna è obbligatoria. Di conseguenza, se manca, l'importazione verrà interrotta. Inoltre, Splio ignorerà salterà tutte le righe che non forniscono un valore "product_id".
name	Sì	Testo (max. 120 caratteri)	Nome del prodotto
brand	No	Testo (max. 120 caratteri)	Indica il nome della marca del prodotto.
description	No	Testo (max. 120 caratteri)	Include una breve descrizione del prodotto (assicurati di rispettare le dimensioni limitate del campo).
price	No	I numeri decimali utilizzano il "." (punto) come separatore decimale e sono sempre espressi nella valuta principale del tuo universo.	Il prezzo del prodotto.
category	No	Testo (max. 120 caratteri)	La categoria del prodotto.
img_url	No	Testo (max. 2048 caratteri)	L'URL di un'immagine del prodotto
sku	No	Testo (max. 120 caratteri)	Il codice identificativo del prodotto
Product custom field	No	Testo (max. 255 caratteri)	Vedi sotto

Nel sistema di Splio, è possibile importare dati utilizzando campi personalizzati configurati nel tuo universo. Puoi identificare questi campi usando il loro nome originale come header della colonna o la sigla "c" seguita dal suo ID numerico.

Ad esempio, se hai un campo chiamato "categoria" nella tabella "prodotti" e il suo ID è 2, puoi utilizzare sia "categoria" che "c2" come nome della colonna.

È essenziale che Splio riconosca il nome della colonna per importare correttamente il file.

Logs

Ecco le informazioni fornite da Splio dopo aver importato i dati.

Indica se ci sono stati problemi durante l'importazione e, se sì, specifica la causa (colonna sconosciuta, mancanza dell'ID esterno, campo personalizzato non specificato).

Numero totale di righe processate (importate + saltate) / importate / saltate
Numero di nuovi dati aggiunti e di dati aggiornati
Motivo per cui ogni riga è stata saltata (product_id NULL, troppe/non abbastanza colonne)

Normalmente, troverai un file di log nella stessa cartella in cui hai caricato il file di importazione.