Importazione ed esportazione di un file CSV di un contratto

Puoi utilizzare un file CSV (valori separati da virgola) per importare i contratti da un'app per abbonamenti di terze parti all'app Shopify Subscriptions o per esportare i contratti dall'app Shopify Subscriptions.

Per maggiori informazioni su come utilizzare i file CSV, consulta open and edit a CSV file (apri e modifica un file CSV).

Download di un file CSV di esempio

Puoi scaricare e visualizzare un file CSV di contratti di esempio da utilizzare come modello.

Considerazioni sui file CSV dei contratti

Prima di utilizzare il file CSV del contratto per importare i contratti, verifica le seguenti considerazioni.

Formattazione del file CSV

Per la corretta importazione del file CSV del contratto, verifica che vengano soddisfatti i seguenti criteri:

  • La prima riga del file CSV dei contratti deve essere l'header delle colonne, come specificato nella tabella di descrizione CSV dei contratti.
  • Ogni colonna deve essere separata da una virgola.
  • Un file CSV può avere una dimensione massima di 10 MB.

Comprensione della colonna handle

L'handle si usa per identificare in modo univoco ogni contratto. Gli handle vengono utilizzati per gestire i dati nei seguenti modi:

  • Raggruppare i contratti con più voci: i contratti con più voci sono raggruppati per handle condiviso.
  • Evitare i contratti duplicati: i contratti duplicati vengono ignorati durante l'importazione. Se una riga con lo stesso handle è stata precedentemente importata in modo corretto, tale riga verrà saltata nel nuovo processo di importazione. Questo meccanismo aiuta a evitare la duplicazione dei dati.

Contratti di più voci

I contratti che includono più voci richiedono una riga separata per ogni voce e sono raggruppati con la colonna handle.

Ad esempio, se un contratto ha tre voci, ciascuna voce deve essere aggiunta come una riga separata. La prima riga contiene tutte le informazioni del contratto, mentre le due righe seguenti contengono solo i valori nelle seguenti colonne:

  • handle
  • line_variant_id
  • line_quantity
  • line_current_price
  • Facoltativo: line_selling_plan_id
  • Facoltativo: line_selling_plan_name

L'handle deve essere identico per tutte e tre le colonne. Tutte le altre colonne nelle righe due e tre devono essere vuote. Puoi scaricare il template CSV di esempio per esaminare un esempio di contratto con più voci.

Descrizione del file CSV

Le informazioni utilizzate nel file CSV del contratto rientrano nelle seguenti categorie: * Nome del contratto * Informazioni del cliente e di fatturazione * Informazioni e metodo di consegna * Articoli inclusi nell'abbonamento

Tutte le colonne devono essere aggiunte al file CSV per poter essere importate correttamente e tutti i campi sono obbligatori, salvo diversamente specificato.

Descrizione delle colonne nel file CSV dei contratti.
ColonnaDescrizione
HandleGli handle sono gli identificatori univoci per ogni contratto. Per esempio, maglietta-rossa. Possono contenere lettere e numeri e sono solitamente una stringa combinata di lettere, numeri o entrambi. Ogni contratto deve avere un handle univoco.
upcoming_billing_dateData di fatturazione imminente per il contratto.
L'ora è in UTC (Tempo coordinato universale) e deve essere formattata come YYYY-MM-DDTHH:MM:SSZ.
Ad esempio, le 15:50 del 7 settembre 2019 nel fuso orario UTC (Tempo coordinato universale) sono rappresentate come 2019-09-07T15:50:00Z.
Il valore della data di fatturazione in arrivo deve essere impostato su una data e un'ora successiva di almeno 24 ore alla data e all'ora di importazione del file CSV.
customer_idL'ID cliente. L'ID deve corrispondere all'ID di un cliente esistente nel tuo pannello di controllo Shopify e deve essere una stringa di numeri. Ad esempio, 6320530986896.
currency_codeIl codice valuta del contratto. Il codice valuta deve corrispondere a una valuta attiva nel negozio.
statusLo stato del contratto. I contratti possono avere uno degli stati seguenti:
  • Attivo
  • In pausa
cadence_intervalLa frequenza di consegna dell'abbonamento. Un contratto può avere uno dei seguenti intervalli di cadenza:
  • Settimana
  • Mese
  • Anno
cadence_interval_countLa frequenza di consegna dell'abbonamento nell'intervallo di tempo complessivo. Ad esempio, il conteggio dell'intervallo di cadenza per ogni mese è 1 e l'intervallo di cadenza ogni due settimane è 2.
customer_payment_method_idL'ID del metodo di pagamento utilizzato dal cliente per il contratto. L'ID è un codice alfanumerico univoco. Ad esempio, 24e8c839c47ef47d30ad28346d130e74.
delivery_priceIl prezzo della consegna nel corretto formato della valuta.
delivery_method_type Il metodo di consegna dell'abbonamento. Il metodo di consegna deve essere uno dei seguenti tipi:
  • Spedizione
  • Consegna locale
  • Ritiro
  • Nessuno
delivery_address_first_nameIl nome del destinatario sull'indirizzo di consegna. Questo campo è obbligatorio solo per i metodi di Spedizione e di Consegna locale.
delivery_address_last_nameIl cognome del destinatario sull'indirizzo di consegna.
Questo campo è obbligatorio solo per i metodi di Spedizione e di Consegna locale.
delivery_address_address1La prima riga dell'indirizzo di consegna.
Questo campo è obbligatorio solo per i metodi di Spedizione e di Consegna locale.
delivery_address_address2La seconda riga dell'indirizzo di consegna.
Questo campo è obbligatorio solo se l'indirizzo ha un secondo campo e il metodo di consegna è Spedizione o Consegna locale.
delivery_address_cityLa città dell'indirizzo di consegna.
Questo campo è obbligatorio solo per i metodi di Spedizione e di Consegna locale.
delivery_address_province_codeIl codice ISO della provincia o dello stato dell'indirizzo di consegna.
Questo campo è obbligatorio solo per i metodi di Spedizione e di Consegna locale.
delivery_address_country_codeIl codice ISO del paese dell'indirizzo di consegna.
Questo campo è obbligatorio solo per i metodi di Spedizione e di Consegna locale.
delivery_address_companyIl nome dell'azienda dell'indirizzo di consegna.
Questo campo è obbligatorio solo se l'ordine è per un'azienda e il metodo di consegna è Spedizione o Consegna locale.
delivery_address_zipIl codice postale dell'indirizzo di consegna.
Questo campo è obbligatorio solo per i metodi di Spedizione e di Consegna locale.
delivery_address_phoneIl numero di telefono dell'indirizzo di consegna, ad esempio +1 (613) 555-5555.
Questo campo è obbligatorio solo per i metodi di spedizione e consegna locale.
delivery_local_delivery_phoneIl numero di telefono dell'indirizzo di consegna.
Questo campo è obbligatorio per gli abbonamenti con il metodo di Consegna locale.
delivery_local_delivery_instructionsLe istruzioni per la consegna locale.
Questo campo deve essere incluso solo quando vengono fornite le istruzioni per gli abbonamenti con il metodo di Consegna locale.
delivery_pickup_method_location_idL'ID della sede per il metodo di ritiro.
Questo campo è obbligatorio solo per gli abbonamenti con il metodo di Ritiro locale.
line_variant_idL'ID di ogni voce inclusa nell'abbonamento. -- per esempio 53154087005812.
Se nell'abbonamento sono incluse più voci, ciascuna voce deve essere aggiunta come nuova riga con l'ID variante univoco.
line_quantityLa quantità per ogni voce inclusa nell'abbonamento.
Se nell'abbonamento sono incluse più voci, la quantità aggiunta deve essere per quell'articolo specifico, non per la quantità totale di tutti gli articoli inclusi.
line_current_priceIl prezzo della voce dell'abbonamento nel corretto formato della valuta.
line_selling_plan_idL'ID del piano di abbonamento, ad esempio 3607724288.
Questo campo è facoltativo.
line_selling_plan_nameIl nome del piano di abbonamento.
Questo campo è facoltativo.

Importazione dei contratti con un file CSV

Puoi utilizzare un file CSV per importare contratti esistenti da un'app per abbonamenti di terze parti idonea dall'App Store di Shopify o dall'app Shopify Subscription di un altro negozio.

Un file CSV non può essere utilizzato per modificare o sovrascrivere i contratti esistenti. I duplicati dei contratti esistenti vengono ignorati al momento dell'importazione.

Importare contratti da un'app di abbonamento di terze parti

Potresti essere in grado di importare contratti da un'app di abbonamento di terze parti. Quando importi da un'app di terze parti, valuta i seguenti comportamenti:

Passaggi:

  1. Dal pannello di controllo Shopify vai su Subscriptions > Contratti.
  2. Clicca su Import (Importa).
  3. Clicca su Aggiungi file, quindi seleziona il file CSV che desideri importare.
  4. Fai clic su Carica file.

Quando il tuo file CSV verrà caricato, riceverai un'email di conferma da Shopify sull'account email che hai utilizzato per configurare il tuo negozio Shopify. Leggi le soluzioni agli errori di importazione comuni per risolvere eventuali problemi di importazione.

Esportazione dei contratti con un file CSV

Puoi esportare i contratti per i record o importarli in un altro negozio Shopify in cui hai installato l'app Shopify Subscriptions.

Passaggi:

  1. Dal pannello di controllo Shopify vai su Subscriptions > Contratti.
  2. Fai clic su Esporta.
Non trovi le risposte che stai cercando? Siamo qui per aiutarti.