Descrizioni colonne file CSV degli ordini in Transporter
Descrizioni per le colonne del file CSV degli ordini.
Per importare ordini in Shopify utilizzando l'app Transporter, serve un file CSV che contenga solo questo tipo di record.
File CSV di esempio
Scarica un file di esempio per il CSV degli ordini: orders.csv
Puoi utilizzare lo strumento riga di comando di Transporter per generare questo file CSV oppure puoi attenerti al formato descritto di seguito per crearne uno tu stesso.
Descrizione colonne
La tabella seguente indica le intestazioni delle colonne del file CSV.
Colonna | Descrizione | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Name (Required) |
Identificatore dell'ordine che vedi nel pannello di controllo Shopify e che il cliente vede sulla fattura. Questo identificatore deve essere unico all'interno del tuo negozio. Ad esempio, n. 1001 , 1001-A e SH1001 . Questa colonna è obbligatoria. |
||||||||||
Indirizzo email del cliente. | |||||||||||
Financial Status | Stato dei pagamenti associati all'ordine. Valori validi:
|
||||||||||
Fulfillment Status | Stato dell'ordine in termini di voci evase. Valori validi:
|
||||||||||
Currency | Codice di tre lettere (formato ISO 4217) della valuta utilizzata per il pagamento. Ad esempio, USD o EUR . |
||||||||||
Buyer Accepts Marketing | Se un cliente ha scelto di ricevere il marketing. Valori validi:
|
||||||||||
Cancel Reason | Ragione per cui l'ordine è stato annullato. Valori validi:
|
||||||||||
Cancelled At | Data e ora (formato ISO 8601) in cui l’ordine è stato annullato. | ||||||||||
Closed At | Data e ora (formato ISO 8601) in cui l’ordine si è chiuso. | ||||||||||
Tags | Serie di tag separati da virgole, utilizzati come filtri e per la ricerca. Ciascuno dei tag separati da virgole può contenere fino a 255 caratteri. Ad esempio, "Verificato, imballato, consegnato" . |
||||||||||
Note | Nota facoltativa allegata all'ordine. Questa nota può essere visualizzata dal cliente. Ad esempio, "Il cliente ha cambiato idea" . |
||||||||||
Phone | Numero di telefono univoco (formato E.164) del cliente. Un numero di telefono può essere formattato utilizzando diversi formati, ma ogni formato deve rappresentare un numero che può essere composto in qualsiasi parte del mondo. I seguenti formati sono tutti validi: 6135551212 +16135551212 (613)555-1212 +1 613-555-1212
|
||||||||||
Referring Site | Sito web dove il cliente ha trovato il link che lo ha condotto al tuo negozio. Ad esempio, "http://www.unesempio.com"
|
||||||||||
Processed At |
Data e ora (formato ISO 8601) in cui l’ordine è stato originariamente creato sull'altra piattaforma. Questo valore appare sull'ordine nel pannello di controllo Shopify e corrisponde alla data usata nei report sulle vendite. Il valore predefinito è la data e l'ora di importazione dell'ordine. Per i valori che influiscono sulle analisi di contabilità e pagamenti, consulta |
||||||||||
Source name | Luogo di origine dell'ordine (ad esempio, il nome della piattaforma). Questo valore non può essere modificato dopo l'importazione. Ad esempio, Transporter . |
||||||||||
Total weight | Somma di tutti i pesi (formattati come numeri interi) delle voci dell'ordine in grammi. Ad esempio, 11 . |
||||||||||
Total Tax | Somma di tutte le imposte (Prezzo imposta 1, ..., Aliquota fiscale spedizione 1) applicate all'ordine (deve essere un numero positivo). Questa colonna è obbligatoria quando all'interno dell'ordine viene addebitata una qualsiasi imposta (ad esempio, quando c'è un valore nella colonna Prezzo imposta 1). Se non includi alcun valore in questa colonna, il valore totale del tuo ordine non includerà alcun addebito fiscale. | ||||||||||
Shipping Company | Nome dell'azienda, se ne esiste una associata all'indirizzo di spedizione. | ||||||||||
Shipping Name | Nome e cognome della persona associata all'indirizzo di spedizione. A un indirizzo deve essere associato un nome, che può corrispondere a Shipping Name o a Shipping First Name più Shipping Last Name . |
||||||||||
Shipping Phone | Numero di telefono (formato E.164) associato all'indirizzo di spedizione. Un numero di telefono può essere formattato utilizzando diversi formati, ma ogni formato deve rappresentare un numero che può essere composto in qualsiasi parte del mondo. I seguenti formati sono tutti validi: 6135551212 +16135551212 (613)555-1212 +1 613-555-1212
|
||||||||||
Shipping First Name | Nome della persona associata all'indirizzo di spedizione. A un indirizzo deve essere associato un nome, che può corrispondere a Shipping First Name più Shipping Last Name o a Shipping Name . |
||||||||||
Shipping Last Name | Cognome della persona associata all'indirizzo di spedizione. A un indirizzo deve essere associato un nome, che può corrispondere a Shipping First Name più Shipping Last Name o a Shipping Name . |
||||||||||
Shipping Address1 | Prima riga dell’indirizzo di spedizione. Questa colonna è obbligatoria per l'indirizzo. Ad esempio, Via delle Gardenie 10 . |
||||||||||
Shipping Address2 | Riga facoltativa dell'indirizzo di spedizione. Ad esempio, Scala B, int. 12 . |
||||||||||
Shipping City | Nome della città dell’indirizzo di spedizione. Questa colonna è obbligatoria per l'indirizzo di spedizione. Ad esempio, Milano o Roma . |
||||||||||
Shipping Province | Nome della suddivisione territoriale (provincia, stato, distretto o territorio), dove risiede il cliente. Se includi questa colonna, è obbligatoria la colonna Shipping Province Code . Ad esempio, Torino , Palermo , Nuovo Galles del Sud o New York . |
||||||||||
Shipping Province Code | Codice assegnato alla suddivisione territoriale del paese (ISO 3166-2), come lo stato, la provincia, il distretto o il territorio. Questa colonna è obbligatoria quando è presente la colonna Shipping Province . Il codice ISO3116-2 presenta le seguenti parti:
|
||||||||||
Shipping Zip | Codice postale o CAP dell'indirizzo del cliente. Ad esempio, K2P 1L4 , 90210 o 110 012 . |
||||||||||
Shipping Country | Nome del paese dell’indirizzo di spedizione. Questa colonna è obbligatoria per l'indirizzo. Ad esempio, Italia, Francia o Australia. | ||||||||||
Shipping Country Code | Codice di due lettere (codice ISO 3166-1 alpha-2) del paese dell'indirizzo del cliente, ad esempio, IT per l'Italia. Specificare il valore di Shipping Country code anche quando è specificato Shipping Country . |
||||||||||
Billing Company | Azienda della persona associata all'indirizzo di fatturazione. | ||||||||||
Billing Name | Nome e cognome del cliente associato al pagamento. A un indirizzo deve essere associato un nome, che può corrispondere a Billing Name o a Billing First Name più Billing Last Name . |
||||||||||
Billing Phone | Numero di telefono (formato E.164) associato all'indirizzo di fatturazione. Un numero di telefono può essere formattato utilizzando diversi formati, ma ogni formato deve rappresentare un numero che può essere composto in qualsiasi parte del mondo. I seguenti formati sono validi: 6135551212 +16135551212 (613)555-1212 +1 613-555-1212
|
||||||||||
Billing First Name | Nome della persona associata al metodo di pagamento. A un indirizzo deve essere associato un nome, che può corrispondere a Billing First Name più Billing Last Name o a Billing Name . |
||||||||||
Billing Last Name | Cognome della persona associata al metodo di pagamento. A un indirizzo deve essere associato un nome, che può corrispondere a Billing First Name più Billing Last Name o a Billing Name . |
||||||||||
Billing Address1 | Prima riga dell'indirizzo di fatturazione. Ad esempio, Via delle Gardenie 10 . Questa colonna è obbligatoria per l'indirizzo di fatturazione. |
||||||||||
Billing Address2 | Riga facoltativa dell'indirizzo di fatturazione. Ad esempio, Scala B, int. 12 . |
||||||||||
Billing City | Nome della città dell'indirizzo di fatturazione. Questa colonna è obbligatoria per l'indirizzo di fatturazione. Ad esempio, Milano , Parigi o Il Cairo . |
||||||||||
Billing Province | Nome della regione (provincia, stato, distretto o territorio) dell'indirizzo di fatturazione. Se includi questa colonna, è obbligatoria la colonna Shipping Province Code . Ad esempio, Città del Messico , New York , o Nunavut e New South Wales . |
||||||||||
Billing Province Code | Codice della suddivisione territoriale del paese (ISO 3166-2), come lo stato, la provincia, il distretto o il territorio. Questa colonna è obbligatoria quando è presente la colonna Billing Province . Il codice ISO3116-2 presenta le seguenti parti:
|
||||||||||
Billing Zip | Codice postale o CAP dell'indirizzo del cliente. Ad esempio, K2P 1L4 . |
||||||||||
Billing Country | Nome del paese dell’indirizzo di fatturazione. Questa colonna è obbligatoria per l'indirizzo di fatturazione. Ad esempio, Canada , India o Germania . |
||||||||||
Billing Country Code | Codice di due lettere (codice ISO 3166-1 alpha-2) del paese dell'indirizzo del cliente, ad esempio, IT per l'Italia. Specificare il valore di Country code anche quando è specificato Country . |
||||||||||
Lineitem name (Required) |
Nome della variante di prodotto ordinata. Ad esempio, maglietta blu . Questa colonna è obbligatoria. |
||||||||||
Lineitem variant ID | ID della variante di prodotto ordinata. Usa questa colonna per collegare l'articolo in questo ordine a una variante di prodotto esistente nel tuo negozio. Ad esempio, 7513594 . Devi assicurarti che l'ID in questa colonna corrisponda a un ID di variante di prodotto del tuo negozio, altrimenti lascia questa colonna vuota. Se l'app Transporter non trova nel tuo negozio una variante di prodotto che corrisponda all'ID in questa colonna, l'importazione non sarà alterata. Il prodotto verrà comunque aggiunto all'ordine, ma non sarà abbinato a un prodotto nel tuo negozio per scopi di analisi. |
||||||||||
Lineitem quantity | Il numero delle varianti di prodotto ordinate. Questa colonna accetta solo numeri interi positivi. Il valore predefinito è 1. Ad esempio, 3 . |
||||||||||
Lineitem price (Required) |
Il prezzo della variante di prodotto prima dell'applicazione di eventuali sconti. Ad esempio, 10,50 0,25 e 30 . Questa colonna è obbligatoria. |
||||||||||
Lineitem variant title | La variante di prodotto specifica. Ad esempio Small . |
||||||||||
Lineitem compare at price | Prezzo di confronto o prezzo suggerito per la variante di prodotto. Ad esempio, 15 . |
||||||||||
Lineitem sku | Numero SKU (stock keeping unit) dell'articolo (variante di prodotto). | ||||||||||
Lineitem requires shipping | Se per la variante di prodotto è richiesta la spedizione. Valori validi:
|
||||||||||
Lineitem taxable | Se la variante di prodotto è imponibile. Valori validi:
|
||||||||||
Lineitem fulfillment status | Lo stato di evasione delle singole voci di un ordine. Valori validi:
|
||||||||||
Taxes Included | Indica se le imposte erano incluse nell'ordine originale. Valori validi:
|
||||||||||
Tax 1 Title | Nome della prima imposta addebitata. Ad esempio, HST o VAT . |
||||||||||
Tax 1 Price | Importo (ISO 4217) dell'imposta da addebitare per le voci dell'ordine. Ad esempio, 1,50 . Quando è presente un valore per questa colonna, devi includere anche la colonna Total Tax . |
||||||||||
Tax 1 Rate | Aliquota (decimale) da addebitare per le voci dell'ordine. Ad esempio, .07 per un'aliquota fiscale del 7%. |
||||||||||
Tax 2 Title | Nome della seconda imposta addebitata. | ||||||||||
Tax 2 Price | L'importo (ISO 4217) dell'imposta da addebitare. Quando è presente un valore per questa colonna, devi includere anche la colonna Total Tax . |
||||||||||
Tax 2 Rate | Aliquota fiscale da addebitare per le voci dell'ordine. | ||||||||||
Tax 3 Title | Nome della terza imposta addebitata. | ||||||||||
Tax 3 Price | Importo (ISO 4217) dell'imposta da addebitare per le voci dell'ordine. Quando è presente un valore per questa colonna, devi includere anche la colonna Total Tax . |
||||||||||
Tax 3 Rate | Aliquota fiscale da addebitare per le voci dell'ordine. | ||||||||||
Transaction Amount | Importo (decimale) di denaro oggetto della transazione. Ad esempio, 50,00 . Questa colonna è obbligatoria quando stai effettuando un pagamento parziale o un rimborso parziale. |
||||||||||
Transaction Kind | Tipo di transazione. Questa colonna è obbligatoria quando è inclusa una qualsiasi delle colonne di transazione. Valori validi:
|
||||||||||
Transaction Status | Stato della transazione. Valori validi:
|
||||||||||
Transaction Processed At |
Data e ora (formato ISO 8601) in cui la transazione è stata originariamente eseguita sull'altra piattaforma. Questo valore appare sull'ordine nel pannello di controllo Shopify e corrisponde alla data usata nei report finanziari. Il valore predefinito è la data e l'ora di importazione dell'ordine. Se hai ricevuto il pagamento nel momento in cui è stato creato l'ordine, i valori |
||||||||||
Transaction Gateway | Nome del canale attraverso cui la transazione è stata eseguita. Un elenco dei gateway è disponibile sulla pagina dei canali di pagamento di Shopify. | ||||||||||
Transaction Location ID | Identificatore della sede dove è stata effettuata la transazione. Questo ID deve corrispondere a quello di una sede impostata sul negozio. I valori che non corrispondono agli ID delle sedi di transazione del negozio non vengono importati. | ||||||||||
Transaction Source Name | Origine della transazione. Esempi di valori: web , pos , iphone e android . |
||||||||||
Shipping Line Code | Riferimento al metodo di spedizione. Il valore predefinito è Shipping line title . |
||||||||||
Shipping Line Price | Valore del metodo di spedizione. Questa colonna è obbligatoria quando è inclusa la colonna Shipping line title . |
||||||||||
Shipping Line Source | Luogo di origine della spedizione. | ||||||||||
Shipping Line Title | Titolo del metodo di spedizione. Questa colonna è obbligatoria quando è inclusa la colonna Shipping line price . |
||||||||||
Shipping Line Carrier Identifier | Identificatore del servizio di trasporto che ha fornito la tariffa di spedizione. Di solito è necessario un valore quando si utilizza il servizio di un corriere di terze parti. | ||||||||||
Shipping Line Requested Fulfillment Service ID | Identificatore del servizio logistico che ha richiesto il metodo di spedizione. Di solito è necessario un valore quando il metodo di spedizione richiede l'elaborazione da parte di un gestore di terze parti.. | ||||||||||
Shipping Tax 1 Title | Nome dell'imposta addebitata sulla voce di spedizione. Ad esempio, HST . |
||||||||||
Shipping Tax 1 Rate | Aliquota fiscale (decimale) da addebitare per la voce di spedizione. Ad esempio, 0,15 per un'aliquota fiscale del 15% (percentuale) sulla spedizione. |
||||||||||
Shipping Tax 1 Price | Importo (formato ISO 4217) dell'imposta da addebitare sulla voce di spedizione. Quando è presente un valore per questa colonna, devi includere anche la colonna Total Tax . Ad esempio, 1,50 . |
||||||||||
Discount Code | Il codice sconto. Se includi la colonna Discount type , questa colonna è obbligatoria. |
||||||||||
Discount Amount |
Valore nella valuta del negozio dello sconto detratto dall'ordine. Se includi la colonna Verifica che il valore inserito corrisponda a |
||||||||||
Discount Type |
Tipo di sconto. Valori validi:
I valori tengono conto della differenza tra maiuscole e minuscole. Gli sconti non possono essere applicati ad articoli specifici di un ordine. Per maggiori informazioni, consulta Importazione sconti. |
||||||||||
Metafield Namespace | Contenitore per un serie di metafield. Per importare i metafield, devi includere dei valori in tutte e quattro le colonne dei metafield (Metafield Namespace , Metafield Key , Metafield Value e Metafield Value Type ). Definisci uno spazio dei nomi personalizzato per i tuoi metafield in modo da distinguerli da quelli usati dalle app e da Shopify (incluso lo spazio dei nomi predefinito global ). Lunghezza massima: 20 caratteri. |
||||||||||
Metafield Key | Nome del metafield. Lunghezza massima: 30 caratteri. Questa colonna è obbligatoria se sono incluse altre colonne di metafield. | ||||||||||
Metafield Value | Informazioni da memorizzare come metadati. Questa colonna è obbligatoria se sono incluse altre colonne di metafield. | ||||||||||
Metafield Value Type | Tipo di informazione del metafield. Valori validi:
|
Nome del file
Il nome del file CSV deve includere la parola order
(nome del tipo di oggetto che contiene). Ad esempio, file_order.csv. Il file deve essere nel formato UTF-8.
Indirizzi
L'indirizzo di spedizione dell'ordine diventa l'indirizzo predefinito del cliente. Quando importi un ordine a cui è associato un cliente, l'app Transporter controlla se il cliente è presente nel negozio Shopify:
- Se Transporter trova il cliente, l'ordine viene associato al cliente e l'indirizzo di spedizione dell'ordine è impostato come indirizzo predefinito del cliente.
- Se Transporter non trova il cliente, lo aggiunge associandogli l'ordine.
Transazioni multiple
Puoi aggiungere transazioni a un ordine creando righe separate per ogni transazione. In ogni riga deve essere incluso Order name
, in modo da collegare le transazioni all'ordine.
Stato di evasione
Lo stato di evasione di un ordine dev'essere determinato in base allo stato di evasione delle voci che costituiscono l'ordine:
- Se nessuna voce è stata evasa, lo stato di evasione dovrebbe essere lasciato vuoto per indicare che l'ordine non è stato evaso.
- Se le voci hanno una qualsiasi combinazione di stati (
fulfilled
ounfulfilled
), lo stato di evasione dovrebbe esserepartial
. - Se tutte le voci sono state evase, lo stato di evasione dovrebbe essere
fulfilled
.
Importazione sconti
Gli sconti possono essere applicati solo a livello di ordine e non possono essere applicati ad articoli specifici all'interno di un ordine. Se disponi di un ordine con sconti applicati ad articoli specifici, determina l'importo totale di sconto e applicalo all'intero ordine. Questo garantisce che il report delle vendite sia preciso.