Importation et exportation d’un CSV de contrat

Vous pouvez utiliser un fichier CSV (valeurs séparées par des virgules) pour importer des contrats d’une application d’abonnements tierce dans l’application Shopify Subscriptions ou pour exporter des contrats de l’application Shopify Subscriptions.

Pour en savoir plus sur l’utilisation des fichiers CSV, consultez la section sur l'ouverture et la modification d'un fichier CSV.

Télécharger un modèle de fichier CSV

Vous pouvez télécharger et afficher un exemple de contrat au format CSV pour l’utiliser comme modèle.

Considérations relatives au fichier CSV du contrat

Avant d’utiliser le fichier CSV du contrat pour importer des contrats, tenir compte de ce qui suit.

Formatage du fichier CSV

Pour que votre fichier CSV de contrat soit importé correctement, vérifiez qu’il répond aux critères suivants :

  • La première ligne de votre fichier CSV de contrat doit contenir les en-têtes de colonne comme spécifié dans le tableau de description du CSV de contrat.
  • Chaque colonne doit être séparée par une virgule.
  • La taille maximale d’un fichier CSV peut être de 10 Mo.

Comprendre la colonne Ancre

L’ancre est utilisée pour identifier que manière unique chaque contrat. Les ancres sont utilisées pour gérer les données des manières suivantes :

  • Regroupement de contrats avec plusieurs lignes : les contrats avec plusieurs lignes sont regroupés par une ancre partagée.
  • Empêcher les contrats en double : les contrats en double sont ignorés à l’importation. Si une ligne avec la même ancre a été importée avec succès, cette ligne est ignorée dans le nouveau processus d’importation. Ce mécanisme permet d’éviter la duplication des données.

Plusieurs contrats de rubriques

Les contrats qui incluent plusieurs rubriques nécessitent une ligne distincte pour chaque rubrique et sont regroupés avec la colonne de l’ancre.

Par exemple, si un contrat compte trois rubriques, chaque rubrique doit être ajoutée en tant que ligne distincte. La première ligne contient toutes les informations du contrat, et les deux lignes suivantes ne contiennent que des valeurs dans les colonnes suivantes :

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

L’ancre doit être identique pour les trois colonnes. Toutes les autres colonnes des rangées deux et trois doivent être vides.

Description du fichier CSV

Les informations utilisées dans le contrat CSV relèvent des catégories suivantes : * Le nom du contrat * Informations du client et de facturation * Mode de livraison et informations * Les articles inclus dans l’abonnement

Toutes les colonnes doivent être ajoutées au fichier CSV pour être importées correctement, et tous les champs sont obligatoires, sauf indication contraire.

Description des colonnes du fichier CSV du contrat.
Colonne Description
Handle Les acres sont les uniques identifiants pour chaque contrat. Les ancres peuvent contenir des lettres et des chiffres, et sont généralement une chaîne combinée de lettres, chiffres ou les deux. Chaque contrat doit avoir une ancre unique.
upcoming_billing_date La prochaine date de facturation du contrat. L’heure est indiquée en UTC (temps universel coordonné) et doit être formatée comme suit AAAA-MM-JJTHH:MM:SSZ. Par exemple, le 7 septembre 2019 à 15 h 50 dans le fuseau horaire UTC (temps universel coordonné) est représenté comme 2019-09-07T15:50:00Z.
customer_id L’ID du client. L’ID doit correspondre à l’ID d’un client existant dans votre interface administrateur Shopify.
currency_code Le code de devise du contrat. Le code de devise doit correspondre à une devise active dans votre boutique.
status Le statut du contrat. Les contrats peuvent avoir l’un des statuts suivants :
  • Actif
  • Suspendu
cadence_interval Fréquence de livraison de l’abonnement. Un contrat peut avoir l’un des intervalles de cadence suivants :
  • Semaine
  • Mois
  • Année
cadence_interval_count La fréquence de livraison de l’abonnement dans l’intervalle de temps global. Par exemple, le nombre d’intervalles de cadence par mois est de 1, et l’intervalle de cadence entre les deux semaines est de 2.
customer_payment_method_id L’ID du moyen de paiement utilisé par le client pour le contrat.
delivery_price Le prix de la livraison dans le bon format de devise.
delivery_method_type Le mode de livraison de l’abonnement. Le mode de livraison doit être l’un des types suivants :
  • Expédition
  • Livraison locale
  • Récupérer
  • Aucun
delivery_address_first_name Le prénom du destinataire sur l’adresse de livraison. Ce champ est requis uniquement pour les modes Expédition et Livraison locale.
delivery_address_last_name Le nom de famille du destinataire sur l’adresse de livraison. Ce champ n’est requis que pour les modes Expédition et Livraison locale.
delivery_address_address1 La première ligne de l’adresse de livraison. Ce champ n’est requis que pour les modes Expédition et Livraison locale.
delivery_address_address2 La deuxième ligne de l’adresse de livraison. Ce champ n’est requis que si l’adresse possède un deuxième champ et que le moyen de livraison est Expédition ou Livraison locale.
delivery_address_city La ville de l’adresse de livraison. Ce champ n’est requis que pour les modes Expédition et Livraison locale.
delivery_address_province_code La province ou l’État de l’adresse de livraison. Ce champ n’est requis que pour les modes Expédition et Livraison locale.
delivery_address_country_code Le code de pays de l’adresse de livraison. Ce champ n’est requis que pour les modes Expédition et Livraison locale.
delivery_address_company Le nom de la société pour l’adresse de livraison. Ce champ n’est requis que si la commande est pour une entreprise et que le mode de livraison est Expédition ou Livraison locale.
delivery_address_zip Le code postal de l’adresse de livraison. Ce champ n’est requis que pour les modes Expédition et Livraison locale.
delivery_address_phone Le numéro de téléphone de l’adresse de livraison. Ce champ n’est requis que pour les modes Expédition et Livraison locale.
delivery_local_delivery_phone Le numéro de téléphone de l’adresse de livraison. Ce champ est obligatoire pour les abonnements avec le mode Livraison locale.
delivery_local_delivery_instructions Instructions de livraison locale. Ce champ n’est pas nécessairement inclus lorsque des instructions sont fournies pour les abonnements avec le mode Livraison locale.
delivery_pickup_method_location_id L’ID d’emplacement pour la méthode de récupération. Ce champ n’est requis que pour les abonnements avec le mode Retrait en magasin.
line_variant_id L’ID de chaque rubrique incluse dans l’abonnement. Si l’abonnement inclut plusieurs rubriques, chaque rubrique doit être ajoutée en tant que nouvelle ligne avec l’ID de variante unique.
line_quantity La quantité pour chaque rubrique incluse dans l’abonnement. S’il y a plusieurs rubriques incluses dans l’abonnement, la quantité ajoutée doit être celle de cet article spécifique, et non la quantité totale de tous les articles inclus.
line_current_price Le prix de la rubrique d’abonnement dans le bon format de devise.
line_selling_plan_id L’identifiant du forfait. Ce champ est facultatif.
line_selling_plan_name Le nom du forfait d’abonnement. Ce champ est facultatif.

Importer des contrats à l’aide d’un fichier CSV

Vous pouvez utiliser un fichier CSV pour importer des contrats existants à partir d’une application d’abonnement tierce de Shopify App Store ou d’une autre boutique Shopify vers votre application Shopify Subscriptions. Il n’est pas possible d’utiliser un fichier CSV pour modifier ou écraser les contrats existants. Les doublons de contrats existants sont ignorés à l’importation.

Étapes :

  1. Depuis votre interface administrateur Shopify, allez à Abonnements > Contrats.
  2. Cliquez sur Importer.
  3. Cliquez sur Ajouter un fichier, puis sélectionnez le fichier CSV que vous souhaitez importer.
  4. Cliquez sur Mettre en ligne le fichier.

Une fois votre fichier CSV téléchargé, vous recevrez un e-mail de confirmation de la part de Shopify sur le compte e-mail utilisé pour configurer votre boutique Shopify. Lisez les solutions aux erreurs d’importation courantes pour résoudre tous les problèmes d’importation.

Exporter des contrats à l’aide d’un fichier CSV

Vous pouvez exporter vos contrats pour vos dossiers ou importer dans une autre boutique Shopify où vous avez installé l’application Shopify Subscriptions.

Étapes :

  1. Depuis votre interface administrateur Shopify, allez à Abonnements > Contrats.
  2. Cliquez sur Exporter.

Prêt(e) à commencer à vendre avec Shopify ?

Essayez gratuitement