Descriptions de colonnes CSV d'une commande

Descriptions des colonnes du fichier CSV des commandes.

Shopify Plus

l'application Transporter est disponible dans l'App Store de Shopify uniquement pour les marchands Shopify Plus.

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.

Commander les en-têtes de colonnes CSV

Colonne	Description
Name (Required)	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. Les valeurs sont sensibles à la casse.
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. Si cette colonne reste vide, le statut de la commande est non traitée. Les valeurs sont sensibles à la casse. Le statut de traitement d’une commande doit être basé sur le statut de chaque rubrique. Pour en savoir plus, consultez la section Statut de traitement des commandes ci-dessous.
Currency	Le code à trois lettres (format ISO 4217) de la devise utilisée pour le paiement. Par exemple, USD ou EUR.
Buyer Accepts Marketing	Si un client a accepté de recevoir des communications marketing. Valeurs valides : TRUE - Le client a accepté de recevoir des communications marketing. FALSE - Le client a refusé de recevoir des communications marketing.
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.
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é ».
Note	Une remarque facultative jointe à la commande. Cette remarque peut être visualisée par le client. Par exemple, « Le client a changé d'avis ».
Phone	Le numéro de téléphone unique (au format E.164) du client. Un numéro de téléphone peut être saisi sous 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 sur lequel le client a cliqué sur un lien menant à votre boutique. Par exemple, « http://www.unexemple.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	La somme de toutes les taxes (Montant de la taxe 1, ..., Taux de la taxe d'expédition 1) appliquées à la commande (doit être un chiffre positif). 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 Montant de la taxe 1). Si vous n'incluez pas de valeur pour cette colonne, la valeur totale de votre commande n'inclura aucune 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. Un numéro de téléphone peut être saisi sous 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
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	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. Cette colonne est obligatoire lorsque vous incluez la colonne Shipping Province. Un code ISO3116-2 comprend les parties suivantes : Indicatif de pays à deux 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 Zip	Le code postal de l'adresse du client. Par exemple, K2P 1L4, 90210 ou 110 012.
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.
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. Un numéro de téléphone peut être saisi sous 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 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	Le code de subdivision (ISO 3166-2) de la région, par exemple l'État, la province, la préfecture ou le territoire du pays. Cette colonne est obligatoire lorsque vous spécifiez la colonne Billing Province. Un code ISO3116-2 comprend les parties suivantes : Indicatif de pays à deux 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 (Required)	Nom de la variante de produit ayant été commandée. Par exemple, Chemise bleue. Cette colonne est obligatoire.
Lineitem variant ID	Identifiant de la variante de produit ayant été commandé. Utilisez cette colonne pour relier l'article de cette commande à une variante de produit existant dans votre boutique. Par exemple, 7513594. Vous devez vous assurer que l'identifiant de cette colonne correspond à un identifiant de variante de produit de votre boutique, ou bien 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'en est pas affectée. Le produit sera tout de même ajouté à la commande, mais ne correspondra pas à un produit de votre boutique dans vos analyses de données.
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 (Required)	Le prix de la variante du produit avant l'application de réductions. Par exemple, 10,50, 0,5 et 30. Cette colonne est obligatoire.
Lineitem variant title	La variante de produit spécifique. Par exemple Petit .
Lineitem compare at price	Une comparaison ou un prix suggéré pour la 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 la variante de 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 variante de 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	Statut de traitement de chaque rubrique d’une commande. Valeurs valides : fulfilled - Tous les produits de la rubrique ont été traités. Si cette colonne reste vide, le statut de la rubrique est non traitée. Les valeurs sont sensibles à la casse. Le statut de traitement de chaque rubrique détermine le statut de la commande entière. Pour en savoir plus, consultez la section Statut de traitement des commandes ci-dessous.
Taxes Included	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 de rubrique et les taxes 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 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.
Transaction Status	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 Processed At	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 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 Source	L’origine de l’envoi.
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 : fixed_amount - Le code de réduction correspond à un montant spécifique. Ceci est la valeur par défaut. percentage - Le code de réduction correspond à un pourcentage. 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. 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). Définissez 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.

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.

Statut de traitement des commandes

Le statut de traitement d’une commande doit dépendre du statut de traitement des rubriques qui composent cette commande :

• Si toutes les rubriques sont non traitées, le statut de traitement de la commande reste vide pour indiquer que la commande n’est pas traitée.
• Si les rubriques ont différents statuts (fulfilled ou unfulfilled), le statut de traitement de la commande doit être partial.
• Si tous les éléments sont traités, le statut de traitement de la commande doit être fulfilled.

En savoir plus

• Description des colonnes CSV du produit
• Descriptions des colonnes CSV client
• Importation de données à l'aide de l'application Transporter
• Résolution de problèmes liés à l'application Transporter
• À propos de l'application Transporter
• Outil de ligne de commande Transporter