Descriptions de colonnes CSV d'une commande

Descriptions des colonnes du fichier CSV des commandes.

Pour importer des commandes dans Shopify à l'aide de l'application Transporter, il vous faut un fichier CSV contenant uniquement ce type d'enregistrement.

Exemple de fichier CSV

Téléchargez l'exemple de fichier CSV des commandes : orders.csv

Vous pouvez utiliser l'outil de ligne de commande Transporter pour générer ce fichier CSV ou suivre le format décrit ci-dessous pour le créer vous-même.

Descriptions des colonnes

Le tableau suivant décrit les en-têtes de colonne du fichier CSV.

Les valeurs sont sensibles à la casse Les valeurs sont sensibles à la casse
Commander les en-têtes de colonnes CSV
Colonne Description
Name
(Obligatoire)
L'identifiant de la commande que vous voyez dans votre interface administrateur Shopify et que votre client voit sur sa facture. Cet identifiant doit être unique dans votre boutique. Par exemple, n ° 1001, 1001-A et SH1001. Cette colonne est obligatoire.
Email L'adresse e-mail du client.
Financial Status Le statut des paiements associés à la commande. Valeurs valides :
  • pending - Les paiements sont en attente. Le paiement peut échouer en raison de son statut. Vérifiez à nouveau pour confirmer si les paiements ont été payés avec succès.
  • authorized - Les paiements ont été autorisés.
  • partially_paid - La commande a été partiellement payée.
  • paid - Les paiements ont été payés.
  • partially_refunded - Les paiements ont été partiellement remboursés.
  • refunded - Les paiements ont été remboursés.
  • voided - Les paiements ont été annulés.
Fulfillment Status Statut de la commande en termes de rubriques traitées. Valeurs valides :
  • fulfilled - Chaque rubrique de la commande a été traitée.
  • partial - Au moins une rubrique de la commande a été traitée.
  • restocked - Chaque rubrique de la commande a été réapprovisionnée et la commande annulée.
Currency Le code à trois lettres (format ISO 4217) de la devise utilisée pour le paiement. Par exemple, USD ou EUR.
Cancel Reason Le motif pour lequel la commande a été annulée. Valeurs valides :
  • customer - Le client a annulé la commande.
  • fraud - La commande était frauduleuse.
  • inventory - Les articles de la commande n'étaient pas en stock.
  • declined - Le paiement a été refusé.
  • other - Une raison ne figurant pas dans cette liste.
Les valeurs sont sensibles à la casse
Cancelled At La date et l'heure (format ISO 8601) auxquelles la commande a été annulée.
Closed At La date et l'heure (format ISO 8601) auxquelles la commande a été fermée.
Note Une remarque facultative jointe à la commande. Cette remarque peut être visualisée par le client. Par exemple, « Le client a changé d'avis ».
Tags Une chaîne de balises séparées par des virgules, utilisées pour le filtrage et la recherche. Chaque balise séparée par une virgule peut comporter jusqu'à 255 caractères. Par exemple, « vérifié, emballé, livré ».
Phone Le numéro de téléphone unique (au format [E.164](https://en.wikipedia.org/wiki/E.164)) du client. Un numéro de téléphone peut être formaté en utilisant différents formats, mais chaque format doit représenter un numéro pouvant être composé n'importe où dans le monde. Les formats suivants sont tous valides :
6135551212
+16135551212
(613)555-1212
+1 613-555-1212
Referring site Le site web où le client a cliqué sur un lien menant à votre boutique. Par exemple, « http://www.anexample.com »
Processed At La date et l'heure (format ISO 8601) auxquelles la commande a été initialement créée sur l'autre plateforme. Cette valeur apparaît sur la commande dans l'interface administrateur Shopify et correspond à la date utilisée dans les rapports d'analyse. La valeur par défaut correspond à la date et à l'heure d'importation de la commande.
Source Name D'où provient la commande (par exemple, le nom de la plateforme). Cette valeur ne peut pas être modifiée après l'importation. Par exemple, Transporter.
Total Weight La somme de tous les poids des rubriques (sous forme d'entier) en grammes. Par exemple, 11.
Total Tax Cette colonne est obligatoire lorsqu'une taxe est facturée dans le cadre de la commande (par exemple, lorsqu'il existe une valeur dans la colonne Prix de la taxe 1). La somme de toutes les taxes (prix de la taxe 1, ..., taxe d'expédition 1) appliquées à la commande (doit être un chiffre positif). Si vous n'incluez pas de valeur pour cette colonne, la valeur totale de votre commande n'inclura aucun frais de taxe.
Shipping Company Le nom de l'entreprise, le cas échéant, associé à l'adresse d'expédition.
Shipping Name Le nom complet de la personne associée à l'adresse d'expédition. Une adresse doit être associée à un nom. Vous pouvez le faire en utilisant Shipping Name ou en utilisant Shipping First Name et Shipping Last Name.
Shipping Phone Le numéro de téléphone (format E.164) associé à l'adresse d'expédition. Il existe plusieurs options de format pour le numéro de téléphone, mais toutes doivent permettre de composer le numéro partout dans le monde. Les formats suivants sont tous valides :
6135551212
+16135551212
(613)555-1212
+1 613-555-1212
Shipping First Name Le prénom de la personne associée à l'adresse d'expédition. Une adresse doit être associée à un nom. Vous pouvez le faire en utilisant Shipping First Name et Shipping Last Name ou en utilisant Shipping Name.
Shipping Last Name Le nom de famille de la personne associée à l'adresse d'expédition. Une adresse doit être associée à un nom. Vous pouvez le faire en utilisant Shipping First Name et Shipping Last Name ou en utilisant Shipping Name.
Shipping Address1 La première ligne d'adresse de l'adresse d'expédition. Cette colonne est obligatoire pour une adresse. Par exemple, 150 rue Elgin.
Shipping Address2 Une ligne d'adresse facultative de l'adresse d'expédition. Par exemple, Unité 202.
Shipping City Le nom de la ville de l'adresse d'expédition. Cette colonne est obligatoire pour une adresse d'expédition. Par exemple, Ottawa ou Sydney.
Shipping Province Le nom de la région (province, État, préfecture ou territoire, par exemple) où se trouve le client. Si vous incluez cette colonne, la colonne Shipping Province Code est obligatoire. Par exemple, Mexico, Tasmanie, Nouvelle-Galles du Sud ou New York.
Shipping Province Code Cette colonne est obligatoire lorsque vous incluez la colonne Shipping Province. Le code attribué par la subdivision (ISO 3166-2) pour la région, par exemple l'État, la province, la préfecture ou le territoire du pays. Un code ISO3116-2 comprend les parties suivantes :
  • Code de pays à 2 caractères - n'incluez pas cette partie.
  • trait d'union (-) qui sépare les deux parties du code - n'incluez pas le trait d'union.
  • Code de subdivision de 1 à 3 caractères - n'incluez que cette partie.
Codes de subdivision
Code de subdivision ISO 3166-2 Code de province
MX-MEX (Mexico, Mexique) MEX
NY-US (New York, États-Unis) New York
Ar-B (Buenos Aires, Argentine) B
FR-21 (Côte-d'Or, France) 21
Shipping Country Le nom du pays de l'adresse d'expédition. Cette colonne est obligatoire pour une adresse. Par exemple, le Canada, l'Inde ou l'Australie.
Shipping Country Code Le code à deux lettres (ISO 3166-1 alpha-2) correspondant au pays de l'adresse du client. Par exemple, CA pour le Canada. Précisez le Shipping Country code même lorsque vous spécifiez le Shipping Country.
Shipping Zip Le code postal de l'adresse du client. Par exemple, K2P 1L4, 90210 ou 110 012.
Billing Company La société de la personne associée à l'adresse de facturation.
Billing Name Le nom complet du client associé au paiement. Une adresse doit être associée à un nom. Vous pouvez le faire en utilisant Billing Name ou en utilisant Billing First Name et Billing Last Name.
Billing Phone Le numéro de téléphone (format E.164) associé à l'adresse de facturation. Il existe plusieurs options de format pour le numéro de téléphone, mais toutes doivent permettre de composer le numéro partout dans le monde. Les formats suivants sont tous valides :
6135551212
+16135551212
(613)555-1212
+1 613-555-1212
Billing First Name Le prénom de la personne associée au moyen de paiement. Une adresse doit être associée à un nom. Vous pouvez le faire en utilisant Billing First Name et Billing Last Name ou en utilisant Billing Name.
Billing Last Name Le nom de famille de la personne associée au moyen de paiement. Une adresse doit être associée à un nom. Vous pouvez le faire en utilisant Billing First Name et Billing Last Name ou en utilisant Billing Name.
Billing Address1 La première ligne d'adresse de l'adresse de facturation. Par exemple, 150 rue Elgin. Cette colonne est obligatoire pour une adresse de facturation.
Billing Address2 Une ligne d'adresse facultative de l'adresse de facturation. Par exemple, Unité 202.
Billing City Le nom de la ville de l'adresse de facturation. Cette colonne est obligatoire pour une adresse de facturation. Par exemple, Ottawa, Delhi et Auckland.
Billing Province Le nom de la région (comme la province, l'État, la préfecture ou le territoire) où se trouve l'adresse de facturation. Si vous incluez cette colonne, la colonne Shipping Province Code est obligatoire. Par exemple, Mexico, New York, Nunavut et Nouvelle-Galles du Sud.
Billing Province Code Cette colonne est obligatoire lorsque vous spécifiez la colonne Billing Province. Le code attribué par la subdivision (ISO 3166-2) pour la région, par exemple l'État, la province, la préfecture ou le territoire du pays. Un code ISO3116-2 comprend les parties suivantes :
  • Code de pays à 2 caractères - n'incluez pas cette partie.
  • trait d'union (-) qui sépare les deux parties du code - n'incluez pas le trait d'union.
  • Code de subdivision de 1 à 3 caractères - n'incluez que cette partie.
Codes de subdivision
Code de subdivision ISO 3166-2 Code de province
MX-MEX (Mexico, Mexique) MEX
US-NY (New York, États-Unis) New York
Ar-B (Buenos Aires, Argentine) B
FR-21 (Côte-d'Or, France) 21
Billing Zip Le code postal de l'adresse de facturation. Par exemple, K2P 1L4.
Billing Country Le nom du pays de l'adresse de facturation. Cette colonne est obligatoire pour une adresse de facturation. Par exemple, le Canada, l'Inde et l'Allemagne.
Billing Country Code Le code à deux lettres (ISO 3166-1 alpha-2) correspondant au pays de l'adresse de facturation. Par exemple, CA pour le Canada. Précisez le Country code même lorsque vous spécifiez le Country.
Lineitem Name
(Obligatoire)
Nom de l'article (variante du produit) ayant été commandé. Par exemple, chemise bleue. Cette colonne est obligatoire.
Lineitem Variant ID L'identifiant de l'article (variante du produit) ayant été commandé. Utilisez cette colonne pour relier l'article de cette commande à une variante de produit existant dans votre boutique. Vous devez vous assurer que l'identifiant de cette colonne correspond à un identifiant de variante de produit de votre boutique ou laisser cette colonne vide. Si l'application Transporter ne parvient pas à trouver dans votre boutique une variante de produit correspondant à l'identifiant de cette colonne, l'importation n'est pas affectée. L'identifiant est ignoré, mais vous n'êtes pas averti(e) qu'il y avait un problème. Par exemple, 7513594.
Lineitem Quantity Le nombre d'articles (variantes de produit) ayant été commandés. Cette colonne accepte un entier positif. La valeur par défaut est 1. Par exemple, 3.
Lineitem Price
(Obligatoire)
Le prix (décimal) de l'article (variante du produit) avant l'application de réductions. Par exemple, 10,50, 0,5 et 30.
Lineitem Compare At Price Une comparaison ou un prix suggéré pour l'article (variante du produit). Par exemple, 15.
Lineitem SKU Le SKU (unité de gestion des stocks) de l'article (variante de produit).
Lineitem Requires Shipping Si l'article (variante du produit) nécessite une expédition. Valeurs valides :
  • true - l'article nécessite une expédition.
  • false - l'article ne nécessite pas d'expédition
Les valeurs sont sensibles à la casse
Lineitem Taxable Si la rubrique (variante du produit) est taxable. Valeurs valides :
  • true - l'article est taxable.
  • false - l'article n'est pas taxable.
Les valeurs sont sensibles à la casse
Lineitem Fulfillment Status Où en est le traitement de la commande. Valeurs valides :
  • fulfilled
  • partial
Les valeurs sont sensibles à la casse
Taxes incluses Si les taxes ont été incluses à la commande originale. Valeurs valides :
  • true - les taxes sont incluses dans le sous-total. Lorsque cette valeur est définie sur « true » (vrai), toutes les taxes sont incluses dans le prix, y compris les taxes des rubriques et les taxes sur les frais d’expédition.
  • false - les taxes ne sont pas incluses dans le sous-total. Ceci est la valeur par défaut.
Les valeurs sont sensibles à la casse
Tax 1 Title Le nom de la première taxe facturée. Par exemple, HST ou VAT.
Tax 1 Price Le montant (ISO 4217) de taxe à facturer pour les rubriques. Par exemple, 1,50. Lorsqu'il existe une valeur pour cette colonne, vous devez également inclure la colonne Total Tax.
Tax 1 Rate Le taux (décimal) de taxe à facturer pour les rubriques. Par exemple, 0,07 pour un taux d’imposition de 7 %.
Tax 2 Title Le nom de la deuxième taxe facturée.
Tax 2 Price Le montant (ISO 4217) de la taxe à facturer. Lorsqu'il existe une valeur pour cette colonne, vous devez également inclure la colonne Total Tax.
Tax 2 Rate Le taux de taxe à facturer pour les rubriques.
Tax 3 Title Le nom de la troisième taxe facturée.
Tax 3 Price Le montant (ISO 4217) de taxe à facturer pour les rubriques. Lorsqu'il existe une valeur pour cette colonne, vous devez également inclure la colonne Total Tax.
Tax 3 Rate Le taux de taxe à facturer pour les rubriques.
Transaction traitée à La date et l'heure (format ISO 8601) auxquelles la transaction a été effectuée à l'origine sur l'autre plate-forme. Cette valeur apparaît dans la commande de l'interface administrateur Shopify et correspond à la date utilisée dans vos analyses de données Shopify. La valeur par défaut correspond à la date et à l'heure d'importation de la commande.
Transaction amount Le montant (décimal) de l'argent pour lequel la transaction a été effectuée. Par exemple, 50,00. Cette colonne est obligatoire lorsque vous effectuez un paiement partiel ou un remboursement partiel.
Transaction kind Le type de transaction. Cette colonne est obligatoire lorsque l'une des colonnes de transaction est incluse. Valeurs valides :
    • authorization - L'argent que le client a accepté de payer a été autorisé, mais il n'a pas été saisi. La période d'autorisation peut être comprise entre 7 et 30 jours (en fonction de votre service de paiement) pendant que la boutique attend qu'un paiement soit saisi.
    • capture - Un transfert d'argent qui a été réservé lors de l'autorisation.
    • sale - L'autorisation et la saisie d'un paiement effectué en une seule étape.
    • void - L'annulation d'une autorisation ou d'une saisie en attente.
    • refund - Le retour partiel ou total de l'argent saisi au client.
    Les valeurs sont sensibles à la casse
Statut de la transaction Le statut de la transaction. Valeurs valides :
  • success - La transaction a été effectuée avec succès par la passerelle de paiement. Ceci est la valeur par défaut.
  • pending - La passerelle a reçu les informations sur la transaction, mais elle a renvoyé une réponse indiquant qu'elle a besoin de plus de temps pour la terminer.
  • failure - La passerelle a répondu que la transaction avait échoué (par exemple, parce que la carte avait été refusée ou que la boutique n'avait pas configuré la passerelle de paiement correctement).
  • error - Une erreur de communication s'est produite (par exemple, la réponse de la passerelle n'a pas été reçue ou la passerelle n'a pas reçu la demande).
Les valeurs sont sensibles à la casse
Transaction gateway Nom de la passerelle par laquelle la transaction a été émise. Une liste des passerelles se trouve sur la page des passerelles de paiement de Shopify.
Transaction location ID L'identifiant de l'emplacement où la transaction a été effectuée. Cet identifiant doit correspondre à un identifiant d'emplacement défini dans votre boutique (les valeurs qui ne correspondent pas aux identifiants d'emplacement de transaction de la boutique ne sont pas importées).
Transaction Source Name L'origine de la transaction. Exemples de valeurs : web, pdv, iphone et android.
Shipping line code Une référence au mode d'expédition. La valeur par défaut est le Shipping line title.
Shipping line price La valeur du mode d'expédition. Cette colonne est requise lorsque la colonne Shipping line title est incluse.
Shipping line title Le titre du mode d'expédition. Cette colonne est requise lorsque la colonne Shipping line price est incluse.
Shipping line carrier identifier Identifiant du service de transporteur ayant fourni le tarif d'expédition. Une valeur est généralement nécessaire lorsqu'un service de transporteur tiers est utilisé.
Shipping line requested fulfillment service ID L'identifiant du service de traitement ayant demandé le mode d'expédition. Une valeur est généralement nécessaire lorsque le mode d'expédition nécessite un traitement par un service de traitement tiers.
Shipping Tax 1 Title Le nom de la taxe facturée à la rubrique d’expédition. Par exemple, HST.
Shipping Tax 1 Rate Le taux de taxation (décimal) à facturer pour la rubrique d’expédition. Par exemple, 0,15 pour un taux de taxe d'expédition de 15 % (pourcentage).
Shipping Tax Price Le montant (format ISO 4217) de taxe à facturer pour la rubrique d'expédition. Lorsqu'il existe une valeur pour cette colonne, vous devez également inclure la colonne Total Tax. Par exemple, 1,50.
Discount code Le code de réduction. Si vous incluez la colonne Discount type, cette colonne est obligatoire.
Discount amount La valeur (dans la devise de la boutique) de la réduction déduite de la commande. Si vous incluez la colonne Discount type, cette colonne est obligatoire.
Discount type

Le type de réduction. Valeurs valides :

  1. fixed_amount - le code de réduction correspond à un montant spécifique. Ceci est la valeur par défaut.
  2. percentage - le code de réduction correspond à un pourcentage.
  3. shipping - la réduction offerte correspondait à l'expédition gratuite tant que les frais d'expédition étaient inférieurs à la valeur indiquée dans le montant. Par exemple, si Discount amount est de 30 et le coût d'expédition est de 30 $, alors la réduction est de 30 $. Si le Discount amount est de 30 et le coût d'expédition est de 100 $, alors il n'y a pas de réduction.
  4. Les valeurs sont sensibles à la casse
Metafield Namespace Un conteneur pour un ensemble de champs méta. Pour importer des champs méta, vous devez inclure des valeurs dans les 4 colonnes de champs méta (Metafield Namespace, Metafield Key, Metafield Value et Metafield Value Type). Vous devez définir un espace de nom personnalisé pour vos champs méta afin de les distinguer des espaces de noms utilisés par les applications et Shopify (y compris la valeur par défaut global). Longueur maximale : 20 caractères.
Metafield Key Le nom du champ méta. Longueur maximale : 30 caractères. Cette colonne est obligatoire si d'autres colonnes de champ méta sont incluses.
Metafield Value Les informations à stocker en tant que métadonnées. Cette colonne est obligatoire si d'autres colonnes de champ méta sont incluses.
Metafield Value Type Le type d'information de champ méta. Valeurs valides :
  • string
  • integer
  • json_string
Les valeurs sont sensibles à la casse. Cette colonne est obligatoire si d'autres colonnes de champ méta sont incluses.

Remarques

Nom de fichier

Le nom de votre fichier CSV doit inclure le mot order (nom du type d'objet qu'il contient). Par exemple, myorders.csv. Le fichier doit être au format UTF-8.

Adresses

L'adresse d'expédition dans une commande devient l'adresse par défaut du client. Lorsque vous importez une commande à laquelle un client est associé, l'application Transporter recherche le client dans votre boutique Shopify :

  • Si Transporter trouve le client, la commande est associée au client et l'adresse d'expédition de la commande est définie comme adresse par défaut du client.
  • Si Transporter ne trouve pas le client, celui-ci est ajouté et la commande lui est associée.

Transactions multiples

Des transactions supplémentaires peuvent être ajoutées à une commande en créant des rangées distinctes pour chaque transaction. le Order name doit être inclus à chaque ligne pour lier les transactions à la commande.

En savoir plus

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

Essayez gratuitement