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.
Sur cette page
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. Vous pouvez télécharger l’exemple de modèle CSV pour étudier un exemple de contrat avec plusieurs rubriques.
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.
Colonne | Description |
---|---|
Handle | Les ancres sont les uniques identifiants pour chaque contrat. Par exemple, chemise rouge. 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 contenir une ancre unique. |
upcoming_billing_date | La prochaine date de facturation du contrat. L’heure est en UTC (temps universel coordonné) et doit être formatée comme ceci : AAAA-MM-JJTHH:MM:SSZ. Par exemple, le 7 septembre 2019 à 15 h 50 dans le fuseau horaire UTC (temps universel coordonné) devient 2019-09-07T15:50:00Z. La valeur de la date de facturation à venir doit être définie sur une date et une heure au moins 24 heures après la date et l’heure d’importation du fichier CSV. |
customer_id | L’ID du client. L’ID doit correspondre à l’ID d’un client existant dans votre interface administrateur Shopify, et être composé d'une chaîne de chiffres. Par exemple 6320530986896. |
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 :
|
cadence_interval | Fréquence de livraison de l’abonnement. Un contrat peut avoir l’un des intervalles de cadence suivants :
|
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. L’ID est un code alphanumérique unique. Par exemple, 24e8c839c47ef47d30ad28346d130e74. |
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 :
|
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 est requis uniquement pour les modes Expédition et Livraison locale. |
delivery_address_address1 | La première ligne de l’adresse de livraison. Ce champ est requis uniquement pour les modes Expédition et Livraison locale. |
delivery_address_address2 | La deuxième ligne de l’adresse de livraison. Ce champ est requis uniquement si l’adresse possède un deuxième champ et si le mode de livraison est Expédition ou Livraison locale. |
delivery_address_city | La ville de l’adresse de livraison. Ce champ est requis uniquement pour les modes Expédition et Livraison locale. |
delivery_address_province_code | La province ou l'état code ISO de l'adresse de livraison. Ce champ est requis uniquement pour les modes Expédition et Livraison locale. |
delivery_address_country_code | La pays code ISO de l'adresse de livraison. Ce champ est requis uniquement pour les modes Expédition et Livraison locale. |
delivery_address_company | Le nom de l'entreprise pour l’adresse de livraison. Ce champ est requis uniquement si la commande est pour une entreprise et si le mode de livraison est Expédition ou Livraison locale. |
delivery_address_zip | Le code postal de l’adresse de livraison. Ce champ est requis uniquement pour les modes Expédition et Livraison locale. |
delivery_address_phone | Le numéro de téléphone de l’adresse de livraison, par exemple +1 (613) 555-5555. Ce champ est requis uniquement pour les modes Expédition et Retrait en magasin. |
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 est requis uniquement pour les abonnements avec le mode Retrait en magasin. |
line_variant_id | L’ID de chaque rubrique incluse dans l’abonnement, par exemple 53154087005812. 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. Si l’abonnement comprend plusieurs rubriques, 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’ID du forfait d’abonnement, par exemple 3607724288. 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 admissible de Shopify App Store ou de l’application Shopify Subscriptions sur une autre boutique.
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.
Importation de contrats à partir d’une application d'abonnement tierce
Vous pourrez peut-être importer des contrats à partir d’une application d’abonnement tierce. Prenez en compte les comportements suivants lors de l’importation à partir d’une application tierce :
- Si votre application d’abonnement tierce n’est pas intégrée à Shopify Checkout, vous ne pouvez pas importer vos contrats.
- Vous ne pouvez pas importer les données directement depuis votre application tierce. Vous devez ajouter les données du contrat de votre application tierce à un fichier CSV compatible avec l'application Shopify Subscriptions dans le format correct pour l’importation.
- Si votre application d’abonnement tierce ne dispose pas d’une fonctionnalité d’exportation ou si les données exportées n’incluent pas toutes les données requises, dans ce cas contactez le développeur ou la développeuse de l’application pour obtenir de l’aide.
Étapes :
- Depuis votre interface administrateur Shopify, allez à Abonnements > Contrats.
- Cliquez sur Importer.
- Cliquez sur Ajouter un fichier, puis sélectionnez le fichier CSV que vous souhaitez importer.
- 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 :
- Depuis votre interface administrateur Shopify, allez à Abonnements > Contrats.
- Cliquez sur Exporter.