Questo articolo spiega come preparare i file per l'importazione nella sezione “ordersitems”. Rappresentano i singoli articoli degli ordini o dei carrelli e sono utilizzati per completarli o riempirli.

I dati della sezione "orderitems" non possono essere aggiornati ed è necessario reimportare tutti gli articoli degli ordini per ogni "order_id" che viene modificato nelle sezioni "orders" o "abandonedcarts". Quando si aggiornano queste due sezioni, Splio elimina sempre tutti gli articoli dell'ordine associati (questo è uno dei primi passaggi dell'importazione).

Se importi un file di articoli degli ordini collegato a un ordine già esistente, questi articoli verranno aggiunti a quelli già presenti nell'ordine (se ce ne sono).

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 “orders” (ordini).

Preparazione di un file Ordersitems

Prepara e modifica il file con il foglio di calcolo o con l'editor di testo UTF-8 di tua preferenza. Il foglio di calcolo è lo strumento che si consiglia di usare ogni volta che è necessario tagliare o spostare le colonne.

🚧

Ricordarsi sempre di salvare utilizzando la codifica UTF-8 senza BOM.

Si prega di limitare la dimensione del file a 200K oggetti.

Intestazione e Colonne

La prima riga del file, chiamata intestazione, serve a determinare il contenuto delle righe successive. Per questo motivo, dovrebbe essere composta esclusivamente dai nomi delle colonne.

🚧
Ricorda che se Splio trova un nome di colonna che non riconosce, il file verrà saltato.

Colonna	Obbligatorio	Tipo di dati / Lunghezza massima	Descrizione
order_id	Sì	Testo (max. 50 caratteri)	Identificatore esterno di un ordine, questa colonna associa gli “ordersitems” a specifici “orders” (o “abandonedcarts”); è obbligatoria e deve riferirsi a un ordine esistente, altrimenti verrà creata una voce “orders” vuota.
product_id	Sì	Testo	ID esterno del prodotto nell'ordine o nel carrello. Questa colonna è obbligatoria. Se il prodotto non esiste ancora nel database, Splio creerà un dato (vuoto) di default. L'aggiornamento dei prodotti non cancella gli articoli degli ordini associati.
unit_price	No	Decimale	Il prezzo applicato per una singola unità di prodotto.Questo campo sarà quello preso in considerazione per qualsiasi regola Loyalty basata sul prezzo del prodotto
discount_amount	No	Decimale	L'importo totale dello sconto.
tax_amount	No	Decimale	L'importo totale delle tasse.
total_line_amount	No	Decimale	L'importo totale per questa riga d'ordine.
currency	Sì	Testo (max. 3 caratteri)	codice ISO di tre lettere della valuta in cui sono indicati tutti i prezzi e gli importi. Se manca, viene utilizzato il valore predefinito dell'universo.
quantity	No	Numero intero senza segno	La quantità del prodotto. Questo campo sarà quello preso in considerazione per qualsiasi regola Loyalty basata sulla quantità del prodotto.
card_code	No	Testo	Il codice di una carta fedeltà crea un collegamento tra l'articolo e la carta.
c0	No	Testo (max. 255 caratteri)	Una colonna personalizzata definita nell'universo per gli articoli degli ordini. È possibile includere fino a 32 colonne, denominate da "c0" a "c31".

📘

Nota che tutti i nomi delle colonne sono sempre scritti in lettere minuscole.

Ricorda che Splio controlla i file di importazione per le colonne obbligatorie. Ricorda che Splio controlla i file di importazione per le colonne necessarie. È fondamentale includere sia “order_id” sia “product_id” affinchè l'importazione vada a buon fine.

La colonna “card_code” viene utilizzata per associare un articolo dell'ordine a un codice di carta fedeltà. Puoi inserirla nei file “orders” o “ordersitems” per generare eventi Loyalty. Tuttavia, se desideri applicare regole Loyalty basate sui prodotti, devi importare i codici delle carte con i file “ordersitems”.

Per i numeri decimali, puoi usare anche "." come separatore.

🚧
Importante: quando si caricano i prezzi dei prodotti, si includono sempre due cifre decimali dopo il separatore (punto), come in "10.99".

Esempio di un file Ordersitems

Esaminiamo il seguente esempio di un file contente 3 articoli che appartenono allo stesso ordine.

order_id;product_id;unit_price;quantity;tax_amount;total_line_amount;currency;c3
"70x1bMhtt-1531745300";"00131300020004";"182.49";"1";"36.50";"218.99";"EUR";"Accessories"
"70x1bMhtt-1531745300";"0027011018374";"9.16";"5";"9.16";"54.96";"EUR";"Food"
"70x1bMhtt-1531745300";"0077890206324";"154.50";"2";"61.80";"370.80";"Accessories"

I campi rappresentano l'identificativo univoco dell'ordine, l'identificativo del prodotto, il prezzo netto, la quantità, l'imposta applicata, il totale di ogni riga e un campo categoria personalizzato.

Nominare il file

Quando si salva il file, utilizza un nome composto dal nome dell'universo, dalla sezione ("ordersitems"), dalla sottosequenza e dalla data attuale. Ad esempio:

myuniverse_ordersitems_pets_20180712.csv

Questo nome di file appartiene all'universo “myuniverse”, della sotto-sequenza “pets” definita in base agli ordini ed è datato 12 luglio 2018. Si noti che questa data che contraddistingue il file, non deve necessariamente corrispondere agli articoli. Se vuoi saperne di più, consulta la sezione “Linee guida per la denominazione dei file” nel documento Panoramica.

A questo punto è possibile caricare il file su SFTP/FTPS.