Traduite de l'anglais. En cas de différence, la page en anglais fait foi. Lire en anglais
Exports
Exports CSV des produits et des commandes : chaque format, son délimiteur et ses colonnes, et la correspondance de ses id avec l'API.
Tous les exports sont au format CSV, UTF-8 avec BOM (EF BB BF, pour qu'Excel affiche correctement les accents), avec une ligne d'en-tête en premier et des fins de ligne \n. Ils sont renvoyés en flux en text/csv; charset=utf-8 avec Content-Disposition: attachment.
Ce que l'API écrit différemment du téléchargement depuis le tableau de bord (colonnes identiques par ailleurs) :
- les id de produit sont
prod_<hex>, exactement comme dansGET /products(le fichier du tableau de bord contient l'id hexadécimal brut) ; - les prix ont exactement 2 décimales, en texte (
"15.90"), comme dans l'API ; - les exports de commandes se terminent par l'id de commande de l'API et les références du canal (colonnes ci-dessous).
Un fichier de produits exporté via l'API peut être réimporté avec POST /imports (csv) : les id prod_… sont reconnus, les produits existants sont donc mis à jour, pas dupliqués.
Valeurs : les champs texte susceptibles de contenir le délimiteur sont entourés de "…" ; un " à l'intérieur devient ' ; # est supprimé de chaque ligne (compatibilité historique). Cellule vide = aucune valeur.
Produits : format=standard (par défaut)
Délimiteur ,. Une ligne par variante ; les colonnes au niveau du produit (titre, description, noms d'option, images, marque, tags, catégorie, poids, dimensions) ne sont remplies que sur la première ligne du produit, les lignes de variante suivantes ne reprennent que id et les colonnes de variante.
| Colonne | Signification | Exemple |
|---|---|---|
id | Id du produit (prod_…), sur chaque ligne | prod_6ad22d0ee891b034a5693aa0 |
title | Titre du produit (première ligne) | Ceramic mug |
description | Description du produit (HTML autorisé, première ligne) | "<p>Hand made</p>" |
option_1_name | Nom de la première option (première ligne) | Size |
option_1_value | Valeur de cette variante | M |
option_2_name / option_2_value | Deuxième option | Color / Blue |
option_3_name / option_3_value | Troisième option | |
sku | SKU de la variante | TSHIRT-M-BLUE |
gtin | Code-barres de la variante (EAN/UPC) | 0080694175826 |
asin | ASIN Amazon | B009DEA0SQ |
quantity | Stock (0 si vide) | 25 |
price | Prix dans la devise de la boutique, 2 décimales | 15.90 |
image_link | URL de l'image principale du produit (première ligne) | https://…/a.jpg |
additional_image_link | URL des autres images du produit, séparées par des virgules entre guillemets (première ligne) | |
variant_image_link | Image propre à cette variante | |
variant_additional_image_link | Autres images de cette variante | |
brand | Marque (première ligne) | Acme |
tags | Tags, séparés par des virgules entre guillemets (première ligne) | "mug,kitchen" |
category | Libellé de catégorie propre au vendeur (première ligne) | Kitchen |
weight / weight_unit | Poids et unité (première ligne) | 0.4 / kg |
height / width / length / dimensions_units | Dimensions et unité (première ligne) | 10 / 8 / 8 / cm |
Produits : format=inventory
Délimiteur ,. Une ligne par variante. Centré sur le stock et le prix.
| Colonne | Signification | Exemple |
|---|---|---|
id | Id du produit (prod_…) | prod_6ad22d0ee891b034a5693aa0 |
name | Titre du produit (uniquement sur la première ligne du produit) | Cotton T-shirt |
option_1_name … option_3_value | Comme dans standard | |
sku, gtin, asin | Comme dans standard | |
quantity | Stock | 3 |
price | Prix, 2 décimales | 19.90 |
variant_image_link, variant_additional_image_link | Comme dans standard |
Produits : format=google
Délimiteur | (barre verticale ; | et # sont supprimés des titres et des descriptions). Une ligne par produit, construite à partir de sa première variante (flux Google Merchant Center). Les produits à vérifier sont exclus.
| Colonne | Signification | Exemple |
|---|---|---|
id | Id de l'offre : le SKU de la première variante, sinon l'id du produit (prod_…) | MUG-1 |
title | Titre (sauts de ligne supprimés) | Ceramic mug |
description | Description en texte brut (HTML retiré, sauts de ligne supprimés) | Hand made |
link | L'URL du produit sur la première marketplace où il est en ligne, sinon sa page sur le storefront Nembol | https://nembolitalia.myshopify.com/products/ceramic-mug |
image_link | Image principale | https://…/a.jpg |
additional_image_link | Autres images, séparées par des virgules | |
availability | Toujours in stock | in stock |
price | Prix de la première variante, 2 décimales, sans devise (ajoutez-la dans Merchant Center ; c'est la devise de la boutique) | 15.90 |
brand | Marque | Acme |
gtin | Code-barres de la première variante | 0080694175826 |
condition | Toujours new | new |
google_product_category | Toujours vide (définissez-la dans Merchant Center) |
Commandes : format=standard (par défaut)
Délimiteur ; (point-virgule). Une ligne par ligne de commande ; les colonnes au niveau de la commande ne figurent que sur la première ligne de la commande.
| Colonne | Signification | Exemple |
|---|---|---|
Order | Le numéro de commande que le canal affiche au vendeur (Shopify « #1011 » → 1011), sur chaque ligne | 1011 |
Channel | Canal (première ligne) | shopify |
Date | Date de la commande YYYY-MM-DD HH:mm:ss (première ligne) | 2026-10-16 21:00:00 |
Title | Titre de la ligne | Cotton T-shirt |
SKU | SKU de la ligne | TSHIRT-S-RED |
Variant | Nom de la variante | S / Red |
Quantity | Quantité | 1 |
Item price | Prix unitaire, 2 décimales | 9.90 |
Total price | Somme des lignes (première ligne) | 19.80 |
Address1, Address2, City, Zip, Province, Country | Adresse de livraison (première ligne) | |
Email, Name, Phone | Acheteur (première ligne) | |
Currency | Devise de la commande (première ligne) | USD |
Subtotal, Shipping, Discount, Tax | Détail des montants quand le canal le fournit (première ligne ; vide pour les commandes importées avant la collecte des taxes) | 19.80 / 5.00 / 0.00 / 1.60 |
Tax remitted by | seller, ou la marketplace qui a collecté la taxe (par exemple etsy) | seller |
Order total | Ce que l'acheteur a payé (première ligne) | 26.40 |
Order ID | API uniquement : l'id de la commande dans l'API (ord_…, comme dans GET /orders), sur chaque ligne | ord_057ca3ae7912e009d01612d7 |
Order ID on channel | API uniquement : l'id de commande propre au canal, = order_id_on_channel dans l'API, sur chaque ligne | 18968716083351 |
Status | API uniquement : le statut de la commande, comme status dans GET /orders (awaiting_shipment, shipped, canceled, refunded…), sur chaque ligne. Les commandes annulées et remboursées figurent dans ce fichier : filtrez sur cette colonne pour les totaux de ventes | shipped |
Commandes : format=quickbooks
Délimiteur ,. Format d'import de factures de QuickBooks Online (Settings → Import data → Invoices) : une ligne par ligne de commande, les colonnes de la facture répétées sur chaque ligne. Les colonnes obligatoires de QuickBooks sont inchangées ; l'API ajoute deux colonnes à la fin, que l'écran de mappage de QuickBooks permet d'ignorer. Les commandes annulées et remboursées sont exclues, elles ne deviennent donc jamais des factures ; les commandes partiellement remboursées restent, à leur montant d'origine (enregistrez le remboursement dans QuickBooks).
| Colonne | Signification | Exemple |
|---|---|---|
InvoiceNo | <channel>-<channel order id> (unique par commande du canal) | shopify-18968716083351 |
Customer | Nom de l'acheteur, sinon e-mail, sinon <channel> buyer | Test Buyer |
InvoiceDate / DueDate | Date de la commande YYYY-MM-DD (les commandes des marketplaces sont déjà payées : échéance à la date de facture) | 2026-10-16 |
Item(Product/Service) | SKU, sinon titre (≤ 100 caractères) | TSHIRT-S-RED |
ItemDescription | Titre et variante | Cotton T-shirt — S / Red |
ItemQuantity | Quantité | 1 |
ItemRate | Prix unitaire, 2 décimales | 9.90 |
ItemAmount | Prix × quantité, 2 décimales | 9.90 |
Currency | Devise de la ligne | USD |
ItemTaxAmount | Taxe de la commande, uniquement sur la première ligne de la commande | 1.60 |
OrderId | API uniquement : id de commande de l'API (ord_…), sur chaque ligne | ord_057ca3ae7912e009d01612d7 |
OrderNumber | API uniquement : le numéro affiché par le canal (1011) | 1011 |
Une commande, trois références
| Où | Valeur pour la commande Shopify #1011 |
|---|---|
Id de commande de l'API (GET /orders, exports Order ID / OrderId) | ord_057ca3ae7912e009d01612d7 |
Id propre au canal (order_id_on_channel, Order ID on channel en standard, dans InvoiceNo de QuickBooks) | 18968716083351 |
Numéro que le vendeur voit sur le canal (number dans l'API, Order en standard, OrderNumber dans QuickBooks) | 1011 |
Faites correspondre les exports à l'API avec Order ID / OrderId (commandes) et id (produits).
Dernière mise à jour le 20 octobre 2026
Besoin d'aide ?
Écrivez-nous et une personne vous répond, généralement sous un jour ouvré.
Expédier les commandes
Récupérez les commandes avec l'adresse de livraison complète, marquez-les comme expédiées, ajoutez le suivi et informez la marketplace.
Importer des produits
Importez dans Nembol le catalogue d'un canal connecté, ou un CSV, depuis votre application ou votre agent : uniquement les nouveaux articles, liaison par SKU, filtres ponctuels, progression en direct et annulation.