Questo articolo illustra come preparare i file per importare l'ambito "righe scontrino" (ordersitems). Identificando i singoli articoli contenuti negli scontrini oppure nei carrelli abbandonati, "ordersitems" è utilizzato per integrare i contenuti al loro interno.
I record nell'ambito "ordersitems" non vengono aggiornati. Pertanto, dovrai prepararti ad importare nuovamente tutte le righe scontrino per ogni "order_id" che aggiorni nell'ambito "orders" oppure "abandonedcarts". Gli aggiornamenti di questi due ambiti implicano sempre l'eliminazione di tutte le righe scontrino ad essi associate (è una delle fasi iniziali dell'import).
Se importi un nuovo file di testata scontrini connesso ad un ordine esistente, aggiungerà le ordine alle testata scontrini (qualora presente).
Troverai un esempio di un file per questo ambito alla fine di questo articolo.
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 degli "ordini"
Preparazione di un file "righe scontrino" (ordersitems)
Utilizza il tuo software di fogli di calcolo preferito oppure un editor di testo compatibile con la codifica UTF-8 per preparare e modificare il file. Uno strumento di fogli di calcolo è consigliabile quando devi eliminare oppure spostare delle colonne.
💡 | Ricordati sempre di salvare il tuo lavoro utilizzando la codifica UTF-8 senza BOM.
⚠️| Per favore, limita le dimensioni del file a 200K.
Intestazione e colonne
La prima linea del file, chiamata intestazione, viene utilizzata per determinare il contenuto delle linee successive. Di conseguenza, deve contenere solamente i nomi delle colonne.
⚠️ | Se Splio trova un nome di una colonna che non identifica, in questo caso non importerà il file.
Le seguenti colonne sono disponibili nell'ambito "ordersitems":
|
Colonna |
Necessaria |
Tipo di dati/ Lunghezza massima |
Descrizione |
|
id dell'ordine (order_id) |
Sì |
Testo (max. 50 caratteri) |
ID esterno di uno scontrino, questa colonna associa "ordersitems" a "orders" (o "abandonedcarts") specifici; questa colonna è obbligatoria e collegata ad uno scontrino esistente; in caso contrario, verrà creata una voce vuota "orders". |
|
id del prodotto (product_id) |
Sì |
Testo |
ID esterno del prodotto sullo scontrino o sul carrello. Questa colonna è obbligatoria. Se il prodotto non esiste ancora nel database, Splio creerà un record predefinito (vuoto). L'aggiornamento dei prodotti non cancella le righe scontrino (ordersitems) associate. |
|
prezzo per unità (unit_price) |
No |
Decimale |
Il prezzo caricato per una singola unità di prodotto. Questo campo sarà quello preso in considerazione per qualsiasi regola loyalty basata sul prezzo del prodotto. |
|
valore dello sconto (discount_amount) |
No |
Decimale |
Il valore totale dello sconto. |
|
valore imposte (tax_amount) |
No |
Decimale |
Il valore totale delle imposte. |
|
valore totale linea scontrino (total_line_amount) |
No |
Decimale |
Il valore totale per questa linea dello scontrino. |
|
valuta |
Sì |
Testo (max. 3 caratteri) |
Codice ISO di tre lettere della valuta tramite il quale vengono definiti tutti i prezzi e gli importi. Se assente, viene utilizzata la valuta predefinita dell'universo. |
|
quantità |
No |
Intero senza segno |
La quantità del prodotto. Questo campo sarà quello preso in considerazione per qualsiasi regola loyalty basata sulla quantità di prodotto. |
|
codice carta |
No |
Testo |
il codice di una carta loyalty, che collega l'articolo e la carta loyalty. |
|
c0 |
No |
Testo (max. 255 caratteri) |
Una colonna personalizzata definita nel tuo universo per le righe scontrino. Puoi includere fino a 32 colonne da "c0" a "c31". |
📗 | Nota che tutti i nomi delle colonne sono sempre in minuscolo.
💡 | Ricordati che Splio verifica i file di import per le colonne obbligatorie. Devi includere sia "order_id" che "product_id" affinché l'import venga effettuato correttamente.
💡 | La colonna "card_code" è utilizzata per associare una riga scontrino ad un codice carta loyalty. Puoi inserirla nei file "orders" o "ordersitems" per creare eventi loyalty. Tuttavia, devi importare i codici carta con "ordersitems" se vuoi utilizzare le regole loyalty basate sui prodotti. Vedi il paragrafo "Scontrini Loyalty" in Import - Scontrini (orders) per maggiori dettagli.
📗 | Per i numeri decimali, puoi utilizzare "." come separatore.
⚠️ | Importante: quando carichi i prezzi prodotto, includi sempre due cifre decimali dopo il separatore (punto), come in "10.99".
Esempio di un file "righe scontrino" (ordersitems)
Osserva l'esempio seguente di un file che contiene 3 articoli appartenenti allo stesso scontrino:
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'ID unico dello scontrino, l'ID del prodotto, il suo prezzo netto, la quantità, l'imposta applicata, la somma totale di ogni linea e un campo personalizzato per categoria.
Denominare il file
Quando salvi il file, utilizza un nome composto dal nome dell'universo, l'ambito ("ordersitems"), la sotto-sequenza e la data corrente. Ad esempio:
myuniverse_ordersitems_pets_20180712.csv
Questo nome file appartiene all'universo "myuniverse", sottosequenza "pets" definita per gli scontrini, ed è datato 12 luglio 2018. Nota che questa data si riferisce al file, non agli articoli al suo interno.
Per maggiori informazioni, consulta il paragrafo "Linee guida per la denominazione dei file" nel documento Panoramica.
Ora puoi caricare il file su SFTP/FTPS.