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.

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.
Colonna Descrizione
Handle Gli handle sono gli identificatori univoci per ogni contratto. 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_date La data di fatturazione in arrivo per il contratto. L'ora è in UTC (Tempo coordinato universale) e deve essere formattata come AAAA-MM-GGTOO: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.
customer_id L'ID cliente. L'ID deve corrispondere all'ID di un cliente esistente nel pannello di controllo Shopify.
currency_code Il codice valuta del contratto. Il codice valuta deve corrispondere a una valuta attiva nel negozio.
status Lo stato del contratto. I contratti possono avere uno degli stati seguenti:
  • Attivo
  • In pausa
cadence_interval La frequenza di consegna dell'abbonamento. Un contratto può avere uno dei seguenti intervalli di cadenza:
  • Settimana
  • Mese
  • Anno
cadence_interval_count La 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_id L'ID del metodo di pagamento utilizzato dal cliente per il contratto.
delivery_price Il 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_name Il nome del destinatario sull'indirizzo di consegna. Questo campo è obbligatorio solo per i metodi di Spedizione e di Consegna locale.
delivery_address_last_name Il cognome del destinatario sull'indirizzo di consegna. Questo campo è obbligatorio solo per i metodi di Spedizione e di Consegna locale.
delivery_address_address1 La prima riga dell'indirizzo di consegna. Questo campo è obbligatorio solo per i metodi di Spedizione e di Consegna locale.
delivery_address_address2 La 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_city La città dell'indirizzo di consegna. Questo campo è obbligatorio solo per i metodi di Spedizione e di Consegna locale.
delivery_address_province_code La provincia o lo stato dell'indirizzo di consegna. Questo campo è obbligatorio solo per i metodi di Spedizione e di Consegna locale.
delivery_address_country_code Il codice del paese dell'indirizzo di consegna. Questo campo è obbligatorio solo per i metodi di Spedizione e di Consegna locale.
delivery_address_company Il 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_zip Il codice postale dell'indirizzo di consegna. Questo campo è obbligatorio solo per i metodi di Spedizione e di Consegna locale.
delivery_address_phone Il numero di telefono dell'indirizzo di consegna. Questo campo è obbligatorio solo per i metodi di Spedizione e di Consegna locale.
delivery_local_delivery_phone Il numero di telefono dell'indirizzo di consegna. Questo campo è obbligatorio per gli abbonamenti con il metodo di Consegna locale.
delivery_local_delivery_instructions Le 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_id L'ID della sede per il metodo di ritiro. Questo campo è obbligatorio solo per gli abbonamenti con il metodo di Ritiro locale.
line_variant_id L'ID di ogni voce inclusa nell'abbonamento. Se nell'abbonamento sono incluse più voci, ciascuna voce deve essere aggiunta come nuova riga con l'ID variante univoco.
line_quantity La 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_price Il prezzo della voce dell'abbonamento nel corretto formato della valuta.
line_selling_plan_id L'ID del piano di abbonamento. Questo campo è facoltativo.
line_selling_plan_name Il 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 dallo Shopify App Store o da un altro negozio Shopify all'app Shopify Subscriptions. 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.

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.

Sei pronto per iniziare a vendere con Shopify?

Provalo, è gratis