Règles et limites

Tout ce qui figure sur cette page a été vérifié de bout en bout sur de vrais canaux. Quand une règle n'est pas respectée, l'API répond 422 validation_failed (ou le code indiqué) avec un message qui nomme le champ. Rien n'est modifié en silence.

Produits et variantes

• Un SKU par variante. Le stock, les commandes et POST /inventory/batch associent les variantes par SKU : deux variantes d'un produit ne peuvent donc pas en partager un (422, Two variants share the SKU …).
• Toutes les combinaisons d'options. Un produit avec les tailles S/M et les couleurs Rouge/Bleu a exactement 4 variantes. Pour ajouter une couleur, ajoutez-la dans chaque taille ; pour retirer une taille, retirez-la pour chaque couleur. Les canaux construisent la grille complète : une combinaison manquante y apparaîtrait comme une variante fantôme.
• 3 options et 100 variantes au maximum par produit.
• Les prix ont au maximum 2 décimales ; les quantités sont des nombres entiers ≥ 0.
• Images : un produit a besoin d'au moins une image pour être publié (photo_required_for_channel). Jusqu'à 20 par produit.
• La suppression d'un produit encore présent sur un canal est refusée (422 product_still_listed), y compris quand son annonce est en error mais toujours en ligne sur le canal. Retirez-le d'abord (DELETE /listings/{id}).

Textes par canal

• PATCH /listings/{id} avec overrides.title / overrides.description définit le texte pour ce canal uniquement ; null revient à celui du produit.
• Les titres plus longs que ce que le canal autorise sont refusés immédiatement : Shopify 255, Etsy 140, eBay 80 caractères.
• Un produit sur un seul canal : modifier le titre ou la description du produit modifie aussi ceux de ce canal, mais uniquement le champ modifié (une modification de la description conserve un titre défini pour le canal).
• Un canal défini comme leader (ses modifications remontent dans Nembol) écrase les textes du produit et ceux de chaque canal.
• Les descriptions sont en HTML et arrivent sur les canaux en HTML.

Commandes

• Une commande par commande du canal : une commande avec plusieurs lignes revient comme une seule commande avec chaque ligne dans lines et le total complet ; order.created se déclenche une fois par commande.
• Les nouvelles commandes arrivent en quelques secondes par webhook quand le canal les envoie, sinon au prochain polling. Les changements de statut faits sur le canal (annulée, remboursée, expédiée ailleurs) arrivent en moins de 10 minutes.
• source_status est la chaîne de statut propre au canal, telle que lue la dernière fois.

Expédition (POST /orders/{id}/fulfillment)

• mark_shipped sans suivi ne met à jour que Nembol : la marketplace n'est pas informée.
• Avec un numéro de suivi, la marketplace est informée une fois par commande. Un suivi envoyé plus tard (après mark_shipped) est notifié à ce moment-là. Une fois que la marketplace a un suivi, un numéro différent est enregistré dans Nembol uniquement et la réponse indique channel_notification.error: channel_already_notified. Corrigez-le sur la marketplace elle-même.
• tracking.number ≤ 64, carrier ≤ 64, url ≤ 512 caractères : au-delà, c'est refusé, jamais tronqué.
• Une commande annulée ou remboursée ne peut pas être marquée comme expédiée (order_not_fulfillable).

Connexions de canaux

• Un lien de connexion fonctionne une seule fois et pendant une heure.

• Amazon : params.country choisit la région ; params.marketplace doit être une marketplace de cette région.

• Les canaux OAuth (eBay, Etsy, Shopify, WooCommerce, TikTok Shop, Temu, Amazon, Google Merchant Center, Facebook Catalog, Square, Squarespace, Faire, Wix, Facebook, Pinterest, Tumblr) se connectent via un lien.

• Kaufland, OnBuy, PrestaShop et Subito se connectent avec des identifiants dans params (sans lien).

• La publication sur eBay nécessite les Business Policies : si le compte n'y a pas adhéré, POST /channel_accounts/{id}/enable_business_policies (avec confirmation).

• Un nouveau compte de canal reçoit les paramètres par défaut du canal à la connexion, de la même façon via l'API que dans le tableau de bord.

Délais et limites

• Les limites de débit et les Idempotency-Key sont par boutique (par entreprise pour les partenaires). Voir Limites de débit.
• Une annonce passe généralement en listed en quelques secondes ; les marketplaces qui examinent les produits (Amazon, TikTok Shop) peuvent prendre plus de temps.

Dernière mise à jour le 20 octobre 2026