Questo articolo illustra come preparare un file di import per l'ambito prodotti ("products").
I record nell'ambito "products" rappresentano degli articoli che possono essere acquistati. I "products" sono poi correlati a "orders" (che rappresentano gli scontrini) tramite "ordersitems" (i singoli articoli all'interno di ogni scontrino).
Troverai un esempio di un file per questo ambito alla fine di questo articolo.
/!\ Nota che l'ambito "products" è un ambito aggiornabile, poiché i dati esistenti possono essere modificati da successivi import.
Prerequisiti
- Conoscenza di base del formato CSV e della codifica UTF-8
- Un editor di testo compatibile con la codifica UTF-8
- Un software di fogli di calcolo
- Generazione della sotto-sequenza nel file di configurazione nell'ambito dei "prodotti"
Preparazione del file prodotti
Controlla il file che stai preparando per vedere se contiene tutte le informazioni che desideri importare. Utilizza il software di fogli di calcolo per organizzare le colonne ed eliminare quelle che non puoi (o non vuoi) importare. Ricorda sempre di salvare (o esportare) il tuo lavoro come file CSV con codifica UTF-8 senza BOM, utilizzando i punti e virgola (";") per separare le colonne.
Utilizza il tuo editor di testo preferito per aprire e modificare il file di import CSV.
⚠️| Per favore, limita le dimensioni del file a 200K.
Intestazione e colonne
La prima linea del file è l'intestazione. Assicurati che contenga solo i nomi delle colonne, altrimenti l'import non andrà a buon fine.
Le seguenti colonne sono disponibili nei file "products":
- product_id -- l'ID esterno del prodotto; questa colonna è obbligatoria e deve essere unica per ogni prodotto.
- name -- il nome del prodotto che sarà visualizzato su Splio. Questa colonna è obbligatoria e deve essere unica per ogni prodotto.
- brand -- la marca del prodotto.
- description -- la descrizione del prodotto - informazioni aggiuntive che saranno visibili su Splio.
- price -- il prezzo nominale del prodotto. È sempre un numero con due cifre decimali (ad es. 2.50), espresso nella valuta predefinita dell'universo Splio.
- category -- il nome della categoria assegnata al prodotto.
- img_url -- l'URL di un'immagine utilizzata per mostrare il prodotto.
- sku -- "stock keeping unit" (SKU) del prodotto.
- colonna personalizzata, qualora definita per i prodotti nel tuo universo Splio.
Nota che tutte le colonne che indicano i campi di sistema sono sempre in minuscolo.
Ricorda che l'import non andrà a buon fine se non includi la colonna obbligatoria (product_id) o se ne utilizzi una che Splio non può identificare (ossia né una delle colonne predefinite né una colonna personalizzata adeguatamente definita).
Importante: nota che quando carichi i prezzi dei prodotti, devi inserire due cifre decimali dopo il punto (es. 10.99).
Esempio di un file
Un breve file contenente alcuni prodotti per animali potrebbe assomigliare a questo:
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, name, brand, e price. I valori corrispondenti a ogni colonna sono posizionati nelle seguenti righe.
Denominare il file
Salva il file con un nome composto dal nome dell'universo, l'ambito ("products"), la sotto-sequenza e la data corrente. Ad esempio:
myuniverse_products_zoo_20180416.csv
Questo nome file appartiene all'universo "myuniverse", sottosequenza "zoo" definita per i prodotti, ed è datato 16 aprile 2018.
Se vuoi saperne di più, consulta la guida per Guida per denominare e raggruppare i file.
Ora puoi caricare il file su SFTP/FTPS.
Informazioni avanzate
Questa parte del documento contiene informazioni aggiuntive che integrano la guida sopra citata, fornendo ulteriori dettagli.
Formato di file
Nome file | <universe>_products_<name>_<date>(_<id>).csv |
---|---|
Codifica | UTF-8 without BOM |
Formato | CSV (no multiline) |
Separatore di colonna | ; (semicolon) |
Qualificatore di testo |
" (double quote, optional) |
Carattere di escape |
\ (backslash) |
Fine linea |
\n or \r\n |
Separatore decimale |
. (dot) |
Colonne
La tabella qui di seguito contiene informazioni dettagliate su tutte le colonne (campi) nell'ambito "products".
/!\ Ricorda che tutti i nomi di colonna distinguono tra maiuscole e minuscole. Pertanto, i nomi predefiniti sono tutti in minuscolo.
Colonna | Necessaria |
Tipo di dati/ Lunghezza massima |
Descrizione |
ide prodotto (product_id) | Sì |
Testo (max. 50 caratteri) |
Questa colonna dovrebbe contenere l'ID esterno del prodotto importato. Essendo la chiave primaria dell'ambito "products", essa è obbligatoria. Quindi, se mancante, l'import sarà annullato. Inoltre Splio ignorerà tutte le linee che non forniscono un valore "product_id". |
nome (name) | Sì |
Testo (max. 120 caratteri) |
Il nome del prodotto. |
marchio (brand) | No |
Testo (max. 120 caratteri) |
Rappresenta la marca del prodotto. |
descrizione (description) | No |
Testo (max. 120 caratteri) |
Contiene una breve descrizione del prodotto (ricordati che questo campo ha dimensioni ridotte). |
prezzo (price) | No |
Decimale, "." (punto) come separatore decimale. Sempre espresso nella valuta predefinita del tuo universo. |
Il prezzo del prodotto. |
categoria (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 SKU del prodotto. |
campo personalizzato di prodotto (product custom field) | No |
Testo (max. 255 caratteri) |
Vedi a continuazione. |
Tramite la funzionalità di import di Splio, puoi utilizzare i campi personalizzati che sono stati configurati nel tuo universo. Per includere un campo personalizzato, utilizza il suo nome come intestazione di colonna oppure la lettera minuscola "c" seguita dal suo ID numerico.
Ad esempio, se hai un campo denominato "category" nel tuo ambito "products" e il suo ID è 2, puoi utilizzare come nome colonna o "category" o "c2".
Tieni presente che, se Splio non può identificare il nome di una colonna, non importerà il file.
Logs
Dopo l'import, Splio mette a disposizione le seguenti informazioni.
- Se l'import è stato eliminato o meno e, in caso di eliminazione, il perché (colonna sconosciuta, colonna external id mancante, campo personalizzato non dichiarato)
- Il numero di linee gestite (importate+ignorate)/importate/ignorate
- Il numero di record nuovi e aggiornati
- La motivazione per cui ogni linea è stata ignorata (product_id NULL, troppe colonne/troppo poche).
Normalmente un file log sarà disponibile nello stesso repository dove il file di import è stato caricato.