Descrizioni colonne file CSV degli ordini in Transporter

Descrizioni per le colonne del file CSV degli ordini.

Shopify Plus

l'app Transporter è disponibile nell'app store di Shopify solo per i merchant Shopify Plus.

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.

Header delle colonne CSV degli ordini

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.
Email	Indirizzo email del cliente.
Financial Status	Stato dei pagamenti associati all'ordine. Valori validi: pending - I pagamenti sono in sospeso. Un pagamento in questo stato potrebbe fallire. Controlla di nuovo per accertarti che i pagamenti siano stati effettuati correttamente. authorized - I pagamenti sono stati autorizzati. partially_paid - L'ordine è stato pagato parzialmente. paid - I pagamenti sono stati effettuati. partially_refunded - I pagamenti sono stati parzialmente rimborsati. refunded - I pagamenti sono stati rimborsati. voided - I pagamenti sono stati annullati. I valori tengono conto della differenza tra maiuscole e minuscole.
Fulfillment Status	Stato dell'ordine in termini di voci evase. Valori validi: fulfilled - Ogni voce dell'ordine è stata evasa. partial - Almeno una voce dell'ordine è stata evasa. restocked - Ogni voce dell'ordine è stata restituita all'inventario e l'ordine è stato annullato. Se lasci vuota questa colonna, lo stato di un ordine risulta inevaso. I valori tengono conto della differenza tra maiuscole e minuscole. Lo stato di evasione dovrebbe essere basato sullo stato delle singole voci. Consulta Stato di evasione sotto per maggiori informazioni.
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: TRUE - Il cliente ha scelto di ricevere il marketing. FALSE - Il cliente ha scelto di non ricevere il marketing.
Cancel Reason	Ragione per cui l'ordine è stato annullato. Valori validi: customer - Il cliente ha annullato l'ordine. fraud - L’ordine era fraudolento. inventory - I prodotti nell'ordine non erano nell'inventario. declined - Il pagamento è stato rifiutato. other - Motivo non presente in questo elenco. I valori tengono conto della differenza tra maiuscole e minuscole.
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 Transaction Processed At.
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: codice paese a 2 caratteri: non includere questa parte. trattino (-) che separa le due parti del codice: non includere il trattino. codice suddivisione 1-3 caratteri: includi solo questa parte. Codici di suddivisione codice suddivisione ISO 3166-2 Codice provincia IT-BO (Bologna, Italia) BO US-NY (New York, Stati Uniti) NY Ar-B (Buenos Aires, Argentina) B FR-21 (Côte-d'Or, Francia) 21
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: codice paese a 2 caratteri: non includere questa parte. trattino (-) che separa le due parti del codice: non includere il trattino. codice suddivisione 1-3 caratteri: includi solo questa parte. Codici di suddivisione codice suddivisione ISO 3166-2 Codice provincia IT-BO (Bologna, Italia) BO US-NY (New York, Stati Uniti) NY Ar-B (Buenos Aires, Argentina) B FR-21 (Côte-d'Or, Francia) 21
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: true - L'articolo richiede la spedizione. false - L'articolo non richiede la spedizione. I valori tengono conto della differenza tra maiuscole e minuscole.
Lineitem taxable	Se la variante di prodotto è imponibile. Valori validi: true - L'articolo è soggetto a imposta. false - L'articolo non è soggetto a imposta. I valori tengono conto della differenza tra maiuscole e minuscole.
Lineitem fulfillment status	Lo stato di evasione delle singole voci di un ordine. Valori validi: fulfilled - Tutti i prodotti della voce sono stati evasi. Se si lascia vuota questa colonna lo stato della voce risulta come inevaso. I valori tengono conto della differenza tra maiuscole e minuscole. Lo stato di evasione delle singole voci deve essere utilizzato per determinare lo stato dell'ordine nel suo insieme. Consulta Stato di evasione sotto per maggiori informazioni.
Taxes Included	Indica se le imposte erano incluse nell'ordine originale. Valori validi: true - Le imposte sono incluse nel subtotale. Quando questo valore è impostato su true, tutte le imposte sono incluse nel prezzo, comprese quelle sulle singole voci dell'ordine e sulle tariffe di spedizione. false - Le imposte non sono incluse nel subtotale. Questo è il valore predefinito. I valori tengono conto della differenza tra maiuscole e minuscole.
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: authorization - L'importo che il cliente ha accettato di pagare è stato autorizzato, ma non acquisito. Il periodo di autorizzazione, in cui il negozio attende l'acquisizione del pagamento, è di 7-30 giorni (a seconda del servizio di pagamento utilizzato). capture - Trasferimento del denaro messo a disposizione con l'autorizzazione. sale - Autorizzazione e acquisizione di un pagamento in un unico passaggio. void - Annullamento di un'autorizzazione o acquisizione in sospeso. refund - Restituzione parziale o totale del denaro acquisito al cliente. I valori tengono conto della differenza tra maiuscole e minuscole.
Transaction Status	Stato della transazione. Valori validi: success - Transazione completata correttamente dal canale di pagamento. Questo è il valore predefinito. pending - Il canale ha ricevuto le informazioni sulla transazione, ma ha risposto indicando che ha bisogno di più tempo per completarla. failure - Il canale ha risposto che la transazione è fallita (ad esempio, perché la carta è stata rifiutata o perché il negozio non ha configurato correttamente il canale di pagamento). error - Si è verificato un errore di comunicazione (ad esempio, la risposta del canale non è stata ricevuta o il canale non ha ricevuto la richiesta). I valori tengono conto della differenza tra maiuscole e minuscole.
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 Processed At e Processed At dovrebbero essere identici.
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 fornitore 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 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 Discount type, questa colonna è obbligatoria. Verifica che il valore inserito corrisponda a Discount type. Se il tipo è percentage, inserisci il valore percentuale dello sconto. Se il tipo è fixed_amount, inserisci il valore totale in dollari dello sconto.
Discount Type	Tipo di sconto. Valori validi: fixed_amount - Il codice sconto era pari a un importo specifico. Questo è il valore predefinito. percentage - Il codice di sconto era per un importo percentuale. shipping - Lo sconto consisteva nell'offerta della spedizione gratuita, purché il costo di spedizione fosse inferiore al valore impostato come amount. Ad esempio, se Discount amount è 30 e il costo di spedizione è di 30 dollari, lo sconto è di 30 dollari. Se Discount amount è 30 e il costo di spedizione è di 100 dollari, allora non c'è sconto. 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, occorre che siano inseriti valori in tutte e 4 le colonne dei metafield (Metafield Namespace, Metafield Key, Metafield Value e Metafield Value Type). Definisci un namespace personalizzato per i tuoi metafield in modo da distinguerli dai namespace usati dalle app e da Shopify (incluso il namespace 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: string integer json_string I valori tengono conto della differenza tra maiuscole e minuscole. Questa colonna è obbligatoria se sono incluse altre colonne di metafield.

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 o unfulfilled), lo stato di evasione dovrebbe essere partial.
• 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.

Maggiori informazioni

• Descrizioni colonne file CSV dei prodotti
• Descrizioni colonne file CSV dei clienti
• Importazione di dati tramite l'app Transporter
• Risolvere i problemi dell'app Transporter
• Informazioni sull'app Transporter
• Strumento riga di comando di Transporter