Questo articolo spiega come preparare i file d'importazione per la categoria "ordini". I dati di questa categoria corrispondono agli ordini effettuati negli stores, che vengono poi completati con i dati “ordersitems”.

I dati nella categoria “ordini” possono essere aggiornati con un caricamento successivo. Se si importa un ordine che ha lo stesso ID di un ordine già esistente, quello nuovo sostituirà quello esistente e tutti gli articoli d'ordine legati a esso saranno cancellati. Splio scarterà qualsiasi dato “orderitem” se l'ordine associato non è ancora stato creato.

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 "ordini".

Preparare un file di ordini

Modifica il file di importazione con l'editor di testo UTF-8 preferito. Se necessario, controllare il numero e la posizione delle colonne con un foglio elettronico di vostro piacimento. È lo strumento migliore per rimuovere le colonne che non si desidera importare.

🚧

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

Limita la dimensione del file a 200K oggetti.

Header e Colonne

La prima riga del file è chiamata header. Deve contenere solo i nomi delle colonne presenti nella tabella sottostante.

📘
Ricorda che se Splio trova un nome di colona che non è in grado di riconoscere, salterà il file.

Le seguenti colonne sono disponibili nella sezione “ordini”:

Colonna	Obbligatorio	Tipo di dati / Lunghezza massima	Descrizioni
order_id	Sì	Testo (max. 50 caratteri)	L'identificatore esterno dell'ordine importato (il numero unico di un ordine). Questo numero deve essere unico per ogni ordine.
customer_key	Sì	Testo	Colonna specifica utilizzata da Splio per identificare i contatti nel database. Se si tratta dell'indirizzo email, deve essere in minuscolo.
card_code	No	Testo	Codice di una carta Loyalty. Il codice crea un collegamento tra l'ordine e la carta fedeltà. Per maggiori dettagli, consulta la sezione “Ordini Loyalty”.
store_id	Sì	Testo (max. 50 caratteri)	ID esterno dello store in cui è stato effettuato l'ordine. Questo ID crea una relazione tra "orders" e "stores". I valori di questa colonna devono riferirsi agli stores già importati.
order_date	No	Data	Data in cui è stato effettuato l'ordine. Per ulteriori dettagli sulla formattazione, vedi “Date” di seguito. Per evitare errori, inserire sempre ore, minuti e secondi.
shipping_amount	No	Decimale	Rappresenta l'importo dovuto come pagamento per la spedizione dell'ordine.
discount_amount	No	Decimale	L'importo totale dello sconto applicato all'ordine.
tax_amount	No	Decimale	L'importo totale delle imposte (IVA, imposta sulle vendite) applicate all'ordine.
total_amount	No	Decimale	L'importo totale pagato per gli articoli dell'ordine (e la spedizione), meno lo sconto.
currency	No	Testo (max. 3 caratteri)	Codice di 3 lettere per la valuta dell'ordine; si applica a tutti gli importi. Se non viene indicata nessuna valuta, Splio adotterà quella predefinita nell'universo.
salesperson	No	Testo (max. 120 caratteri)	Il venditore responsabile dell'ordine.
c02	No		Una colonna personalizzata relativa agli ordini e definita nel tuo universo. È possibile aggiungere fino a 32 colonne denominate da “c0” a “c31”.

📘

Si noti che tutti i nomi delle colonne sono sempre scritti in minuscolo.

La colonna customer_key identifica i contatti nel database dell'universo Splio.

Si precisa che Splio esamina i file di importazione per verificare la presenza di colonne obbligatorie. È necessario includere “order_id”, “customer_key” e “store_id” affinché l'importazione vada a buon fine.

Esempio 1: Default Customer Key

Le prime righe di un file di importazione "ordini" che utilizza la chiave cliente predefinita (l'email del contatto) potrebbero essere così:

order_id;customer_key;store_id;order_date;total_amount;currency
"70x1bMhtt-1531745300";"[email protected]";"Internet";"2018-06-22 11:30:00;173.00";"EUR"
"70x1byTRJ-1531778200";"[email protected]";"Internet";"2018-06-21 12:10:00";"244.99";"EUR"
"70xb1KLio-1531723300";"[email protected]";"Internet";"2018-06-20 17:33:00;25.50";"EUR"

Ogni riga è composta esattamente da 6 colonne. L'“order_id” serve a distinguere gli ordini, il “customer_key” collega l'ordine al contatto che lo ha acquistato.

Esempio 2: Personalizzare colonne come Customer Key

Vediamo un file di importazione che utilizza una colonna personalizzata come chiave cliente:

order_id;customer_key;store_id;order_date;total_amount;currency
"70x1bKkUt-1531738300";"PPL000000045732";"MGZOO;2018-06-27 12:17:27;225.00";"EUR"
"70x1bKooY-1531738300";"PPL000000007633";"MGZOO;2018-06-27 12:19:23;17.00";"EUR"
"70x1bu9Gt-1531756600";"PPL000000045661";"MGZOO;2018-06-27 12:22:07;112.50";"EUR"

Questa importazione è molto simile a quella dell'esempio 1, la differenza principale è il tipo di valori della colonna “customer_key”. È necessario utilizzare sempre lo stesso tipo di chiave cliente definita nell'universo Splio.

Nominare file

Per salvare il file, utilizza un nome costituito dal nome dell'universo, dalla sezione (“orders”), dalla sottosequenza e dalla data corrente. Ad esempio:

myuniverse_orders_zoo_20210225.csv

Questo file appartiene all'universo “myuniverse”, alla sottosequenza “zoo” definita per gli ordini ed è datato 25 febbraio 2021.

Date

Tutte le date utilizzate nei file di importazione degli abbonamenti devono essere formattate nel modo seguente: 4 cifre per l'anno, 2 per il mese e 2 per il giorno, seguite da ore, minuti e secondi, ciascuno di 2 cifre. Una data corretta per il 9 agosto 2018, 10:00:05 ha il seguente formato:

2018-08-09 10:00:05

La data e l'ora sono separate da uno spazio. Se decidi di utilizzare solo la data, senza l'ora, Splio considererà automaticamente mezzanotte come orario per quel giorno. Quindi,

2018-09-09 equivale a 2018-09-09 00:00:00

🚧

L'uso di date senza orario non dovrebbe mai essere un'alternativa per le date e gli orari: 00:00:00 corrisponde alla mezzanotte e Splio elaborerà la data come tale. Questo potrebbe provocare errori e malfunzionamenti nei trigger associati alle date. Inoltre, i dati relativi a Loyalty sono trattati come informazioni di tipo economico, quindi tu e la tua azienda siete responsabili della loro accuratezza, così come di ogni altro dettaglio. Un ulteriore vantaggio dell’uso delle date complete è che sarai in grado di cercare e filtrare per data con maggiore precisione.

Quando importi date e orari, ricorda di usare sempre il fuso orario CEST.

Dettagli aggiuntivi: NULL e cancellazione dei dati

NULL è un valore specifico che indica al database che un campo è vuoto.

Nel tuo universo Splio, puoi configurare il sistema per interpretare i valori NULL come istruzioni per svuotare i campi. Questa configurazione ti permette di cancellare i dati memorizzati nel database. Per fare ciò, assicurati che il valore importato sia esattamente NULL, senza spazi aggiuntivi: "NULL" o "NULL" verranno trattati come valori di testo.

Se questa opzione non è attiva, Splio manterrà i valori nei campi per cui il valore importato è NULL.

Differenza tra NULL e stringa vuota

""è una stringa vuota. Nella maggior parte dei casi, sia NULL che "" saranno importati come valori vuoti.

Soprattutto, la stringa vuota “” non viene mai considerata un valore NULL, quindi non causa la cancellazione di un valore esistente.