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).
Su questa pagina
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.
| Colonna | Descrizione |
|---|---|
| Handle | Gli 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_date | Data 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_id | L'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_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:
|
| cadence_interval | La frequenza di consegna dell'abbonamento. Un contratto può avere uno dei seguenti intervalli di cadenza:
|
| 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. L'ID è un codice alfanumerico univoco. Ad esempio, 24e8c839c47ef47d30ad28346d130e74. |
| 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:
|
| 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 | Il 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_code | Il codice ISO 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, ad esempio +1 (613) 555-5555. Questo campo è obbligatorio solo per i metodi di spedizione e 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. -- per esempio 53154087005812. 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, ad esempio 3607724288. 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 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:
- Se la tua app per abbonamenti di terze parti non è integrata nel check-out di Shopify, non puoi importare i contratti.
- Non puoi importare i dati direttamente dall'app di terze parti. Devi aggiungere i dati del contratto dall'app di terze parti a un FILE CSV compatibile con l'app Shopify Subscriptions nel formato corretto per l'importazione.
- Se la tua app per abbonamenti di terze parti non dispone di una funzionalità di esportazione o se i dati esportati non includono tutti i dati richiesti, contatta lo sviluppatore dell'app per assistenza.
Passaggi:
- Dal pannello di controllo Shopify vai su Subscriptions > Contratti.
- Clicca su Import (Importa).
- Clicca su Aggiungi file, quindi seleziona il file CSV che desideri importare.
- 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:
- Dal pannello di controllo Shopify vai su Subscriptions > Contratti.
- Fai clic su Esporta.