Utiliser des identifiants produit alternatifs dans les commandes

Apprenez comment le mapping d’identifiants alternatifs aide Channable à associer les articles commandés sur la marketplace aux bons produits de la boutique en ligne.

Utilisez le mapping d'ID alternatif lorsque les articles de commande ne correspondent pas aux produits. Cela se produit généralement lorsque les marketplaces utilisent un identifiant différent de celui de votre boutique en ligne.

Qu’est-ce qu’une connexion commande ?

Une connexion commande synchronise les commandes de la marketplace dans votre plateforme e-commerce. Pour créer une ligne de commande, Channable doit faire correspondre chaque article commandé à un produit.

Termes clés (pour que le reste de cette page soit clair)

• ID unique (identifiant produit de la boutique en ligne) : L’identifiant utilisé par votre plateforme e-commerce pour référencer un produit (souvent un SKU, mais pas toujours).

• ID alternatif : Un autre identifiant enregistré sur le même produit, comme EAN/GTIN ou MPN.

• Identifiant de l’article de marketplace : L’identifiant qui remonte dans les données de commande. Il s’agit souvent de Seller SKU.

Pourquoi les ID uniques sont importants

Les ID uniques relient l’article de commande au bon produit de la boutique en ligne. Si l’identifiant présent dans la commande n’existe pas dans votre boutique en ligne, la création de la commande échoue.

Configurer un ID unique dans Channable

• Lors de la configuration d’une API pour une marketplace dans Channable, vous devez sélectionner le champ correspondant à l’ID unique à l’étape Paramètres de la configuration de l’API. Cet identifiant est ensuite envoyé à la marketplace et utilisé pour associer les produits.

• Plus précisément, lorsqu’une commande est passée sur la marketplace, Channable utilise cet ID unique pour faire correspondre le produit de la commande avec le produit correspondant dans votre plateforme e-commerce.

Problèmes liés à des ID uniques incorrects ou manquants

• Des problèmes surviennent si vos produits n’ont pas été publiés à l’origine sur la marketplace via Channable, ou si l’ID unique diffère de celui utilisé dans votre plateforme e-commerce. Dans ces cas, Channable ne pourra pas faire correspondre les produits dans les commandes.

• Ce décalage entraînera une erreur indiquant que le produit est introuvable, empêchant ainsi la création de la commande.

C’est là que le mapping d’ID alternatif est utile.

Comment fonctionne le mapping d’ID alternatif

Lorsque vous importez vos produits dans Channable, nous suivons à la fois les identifiants principaux de votre source d’import principale (votre plateforme e-commerce) et les identifiants alternatifs couramment utilisés, comme les codes EAN et les codes SKU.

Lors du traitement d’une commande, Channable peut :

1. Lire l’identifiant reçu dans les données de commande de la marketplace.

2. Essayer de faire correspondre cette valeur avec les ID alternatifs suivis (comme EAN/GTIN).

3. S’il trouve une seule correspondance, créer la ligne de commande de la boutique en ligne pour ce produit correspondant.

Cela vous permet de traiter les commandes même lorsque les identifiants de la marketplace diffèrent de l’identifiant principal de votre boutique en ligne.

Channable prend actuellement en charge les plateformes e-commerce suivantes et leurs champs d’identifiant standard correspondants :

plateforme	Champs d’identifiant
BigCommerce	sku, GTIN
CCVShop	sku_number, ean, ean_number, mpn
Lightspeed Eseries	sku
Lightspeed	sku, article_code, ean
Magento	sku, ean
MijnWebWinkel	sku, uuid
Prestashop	ean13, GTIN, reference
Shopify	sku, GTIN
Shoptrader	sku, ean
Shopware	ean, article_number
Squarespace	sku
WooCommerce	sku

Si vous souhaitez utiliser des champs d’identifiant qui ne sont pas actuellement pris en charge, n’hésitez pas à contacter notre équipe d’assistance. Nous évaluerons votre demande et l’envisagerons pour de futures mises à jour si cela est possible.

Remarque : Si vous ajoutez un deuxième import (comme un CSV) et écrasez une valeur d’identifiant, les commandes peuvent échouer. Le mapping d’ID alternatif s’appuie sur les identifiants enregistrés depuis votre source d’import principale lors de la correspondance des articles de commande.

Quand utiliser le mapping d’ID alternatif

Le mapping d’ID alternatif est particulièrement utile dans différents cas afin de garantir un traitement précis des commandes. Situations courantes dans lesquelles cette fonctionnalité est utile :

• Utilisation de plusieurs identifiants

  • Scénario : vos fiches produits sur les marketplaces utilisent un mélange de codes EAN et de codes SKU comme identifiant principal.

  • Avantage : le mapping d’ID alternatif aide à garantir que les commandes sont correctement associées aux produits correspondants dans votre plateforme e-commerce, quel que soit l’identifiant utilisé par la marketplace.

• Systèmes anciens avec des structures d’ID différentes

  • Scénario : votre plateforme e-commerce ou votre système de gestion des commandes utilise une structure d’ID différente de celle exigée par la marketplace.

  • Avantage : avec le mapping d’ID alternatif, Channable peut faire le lien entre différents systèmes d’ID, en veillant à ce que les commandes soient associées aux bons produits sans intervention manuelle.

• Transition entre systèmes

  • Scénario : vous passez à une nouvelle plateforme e-commerce ou vous mettez à jour votre système d’ID, et pendant cette période, vos produits peuvent avoir à la fois d’anciens et de nouveaux identifiants.

  • Avantage : le mapping d’ID alternatif vous permet de poursuivre vos opérations de manière fluide en reconnaissant les deux ensembles d’identifiants, évitant ainsi les interruptions dans le traitement des commandes.

Avant d’activer la fonctionnalité, vérifiez le mapping d’ID enregistré de votre projet. Voir la section suivante pour savoir comment accéder à ces enregistrements.

Accéder aux enregistrements de mapping d’ID

Il existe deux façons de consulter les enregistrements de mapping d’ID.

1

Consulter le mapping d’ID pour tous les produits

Cette page vous permet de vérifier les mappings d’ID que Channable suit avant d’activer la fonctionnalité. En consultant ces enregistrements, vous pouvez vous assurer que tout est correctement mappé. Cette étape est essentielle pour éviter d’éventuels problèmes pouvant survenir si la fonctionnalité est activée sans vérification appropriée.

Pour obtenir une vue complète des enregistrements de mapping d’ID passés et actuels pour tous les produits (pas seulement les commandes) :

• Accédez à Installation > Commandes dans votre projet.

• Cliquez sur le bouton Mapping d’ID alternatif. Une fenêtre contextuelle s’affichera avec tous les enregistrements passés et actuels des ID mappés pour vos produits.

Vue d’ensemble du mapping d’ID alternatif (tous les produits).

• Utilisez le champ de recherche en haut à droite de la fenêtre contextuelle pour filtrer les enregistrements par ID, titre ou autre critère afin de faciliter la navigation.

Filtrer les enregistrements de mapping par ID, titre ou autres champs.

2

Consulter le mapping d’ID pour les produits utilisés dans les commandes

Pour afficher les enregistrements passés et actuels des produits utilisés dans les commandes :

• Accédez à la page Commandes dans votre projet et cliquez sur Mapping d’ID alternatif.

• Consultez les enregistrements de mapping d’ID passés et actuels pour tous les produits utilisés dans les commandes.

Enregistrements de mapping d’ID alternatif utilisés dans les commandes.

Explication des colonnes dans l’interface de mapping d’ID

• ID unique : l’identifiant utilisé par votre plateforme e-commerce pour référencer le produit.

• ID alternatif : le type d’identifiant que Channable suit, comme un SKU ou un EAN/GTIN.

• Valeur : la valeur réelle de l’ID alternatif (par exemple, le SKU ou le code EAN spécifique).

• Créé : la date et l’heure de création de l’enregistrement de mapping.

• Statut : indique si le mapping est actuellement actif ou inactif.

Avant d’activer le mapping d’ID alternatif

Vérifiez d’abord ces points. Cela vous fera gagner du temps par la suite.

• Confirmez quel identifiant la marketplace renvoie dans les données de commande (généralement Seller SKU).

• Confirmez que cette valeur d’identifiant existe quelque part sur le produit correspondant dans votre boutique en ligne.

  • Exemple : la marketplace envoie un EAN, mais votre produit de boutique en ligne a un EAN vide.

• Vérifiez les doublons sur les ID alternatifs.

  • Exemple : deux produits partagent le même EAN/GTIN.

• Vérifiez si un second import écrase les identifiants utilisés pour l’association.

Liste de contrôle détaillée de configuration (recommandée)

Utilisez cette liste de contrôle avant d’activer le paramètre. Elle permet d’éviter la plupart des problèmes de type « produit introuvable ».

1

1) Choisissez votre stratégie d’association

Choisissez un identifiant sur lequel vous souhaitez faire correspondre les commandes.

Choix courants :

• SKU: le meilleur choix si chaque article vendable dispose d’un SKU stable.

• EAN/GTIN: le meilleur choix si chaque article vendable dispose d’un code-barres valide.

Évitez de mélanger les identifiants entre les fiches produits, sauf nécessité absolue.

2

2) Vérifiez que l’ID choisi existe sur l’article vendable (souvent les variantes)

Vérifiez votre catalogue de produits pour l’ID choisi :

• Il doit exister au niveau de la variante si vous vendez des variantes.

• Il doit être renseigné pour les produits que vous vendez sur la marketplace.

Vérifiez au moins 10 produits :

• 3 produits simples

• 3 produits avec variantes (plusieurs tailles/couleurs)

• 2 meilleures ventes

• 2 produits « problématiques » ayant déjà échoué auparavant

3

3) Vérifiez la cohérence du format

La correspondance est exacte. De petites différences suffisent à la faire échouer.

Vérifiez :

• Les espaces en début ou en fin de valeur

• Les variations de casse (surtout pertinent pour les SKU)

• La disparition des zéros en début de valeur (fréquent avec les exports CSV)

• Les séparateurs différents (SKU-001 vs SKU001)

Corrigez d’abord le format dans votre système source.

4

4) Éliminez les doublons pour l’ID alternatif choisi

Les doublons provoquent le scénario « plusieurs correspondances trouvées ». Channable ne peut alors pas choisir un produit de manière fiable.

Effectuez une vérification des doublons dans votre catalogue pour l’ID choisi :

• Si deux produits partagent le même EAN/GTIN, corrigez ou supprimez une des valeurs.

• Si des SKU génériques existent (NA, 0, DEFAULT), remplacez-les.

Si vous ne pouvez pas supprimer les doublons, passez à une autre stratégie d’association.

5

5) Confirmez que votre import principal est la source de référence

Le mapping d’ID alternatif s’appuie sur les identifiants enregistrés depuis votre source d’import principale.

Avant d’activer :

• Assurez-vous que votre import principal contient les valeurs SKU/EAN correctes.

• Évitez d’écraser ces identifiants via un second import (comme un enrichissement CSV).

Si vous devez importer des identifiants via CSV, gardez une logique cohérente et prévoyez une période de transition.

6

6) Vérifiez les enregistrements de mapping d’ID alternatif

Ouvrez la vue d’ensemble du mapping et vérifiez ce que Channable a enregistré. Voir Accéder aux enregistrements de mapping d’ID.

Ce qu’il faut vérifier :

• Des ID alternatifs manquants pour les produits que vous vendez

• Des valeurs dupliquées sur différents produits

• Des valeurs anciennes ou obsolètes après une migration

7

7) Activez et validez sur un petit échantillon

Activez Utiliser des ID alternatifs pour les articles de commande sur la connexion commande.

Puis validez avec au moins un :

• Une commande ayant échoué auparavant (idéalement), ou

• Une nouvelle commande entrante

Vérifiez les deux points suivants :

• La commande est créée avec succès.

• L' la bonne variante est associée.

8

8) Déployez et surveillez

Une fois la correspondance correcte :

• Activez-la sur les autres connexions commande (si vous en avez).

• Surveillez les erreurs « produit introuvable » et « plusieurs correspondances trouvées ».

Si les erreurs augmentent, corrigez d’abord les données du catalogue. Évitez les contournements qui introduisent davantage d’incohérences d’identifiants.

Activer le mapping d’ID alternatif

1

Cochez la case Utiliser des ID alternatifs pour les articles de commande sur la connexion commande que vous souhaitez activer.

Activer les ID alternatifs pour les articles de commande.

2

Cliquez Sauvegarder. Vous pouvez ensuite ouvrir le mapping d’ID alternatif (Installation > Commandes) pour vérifier les mappings suivis.

Ce que ce paramètre ne fait pas

Le mapping d’ID alternatif aide à faire correspondre les articles de commande avec les produits existants de la boutique en ligne. Il ne permet pas de :

• Modifier l’identifiant que vous envoyez à une marketplace lors de la mise en ligne des produits.

• Corriger les valeurs EAN/SKU en double dans le catalogue de votre boutique en ligne.

• Garantir la création de la commande lorsque la marketplace envoie des identifiants produit inconnus.

Scénarios de correspondance avec identifiant alternatif

Les identifiants alternatifs comme les codes EAN et SKU ne sont pas toujours uniques. Dans votre catalogue de produits, vous pouvez avoir plusieurs produits avec le même EAN ou des produits sans EAN du tout. Channable associe le bon ID de base de données de la plateforme e-commerce en fonction de l’identifiant alternatif reçu de la marketplace.

Nous vérifions si des ID de base de données de la plateforme e-commerce correspondent à l’ID du produit issu des données de commande pour tous les identifiants alternatifs suivis. Trois scénarios peuvent se produire :

1

Aucune correspondance trouvée

Channable ne peut pas associer l’identifiant de la marketplace à un produit de la boutique en ligne. Channable essaiera de créer la commande en utilisant l’identifiant de la marketplace. Cela peut échouer si votre boutique en ligne ne reconnaît pas cet identifiant.

Correction : ajoutez l’ID alternatif manquant au produit de la boutique en ligne, ou modifiez ce que la marketplace envoie.

2

Une seule correspondance exacte trouvée

Channable trouve un produit de boutique en ligne correspondant à l’identifiant de la marketplace. Channable crée la ligne de commande pour ce produit correspondant.

3

Plusieurs correspondances trouvées

• Valeurs identiques entre identifiants : Channable peut suivre plusieurs valeurs d’identifiants alternatifs pour votre plateforme e-commerce (par exemple à la fois SKU et EAN), et les deux ont des valeurs identiques pour un produit. Dans ce cas, il existe un seul ID de base de données de la plateforme e-commerce, et la commande sera créée à l’aide de cet unique ID. Channable vérifie que l’ID de base de données de la plateforme e-commerce lié à l’enregistrement SKU et EAN correspondant est le même.

• Plusieurs produits avec le même identifiant : plusieurs produits distincts dans votre plateforme e-commerce partagent la même valeur pour un ID alternatif. Channable ne peut pas choisir le bon. Channable reviendra à l’identifiant de la marketplace lors de la création de la commande. Cela peut provoquer une erreur de création de commande dans votre boutique en ligne.

Correction : supprimez les doublons des valeurs d’identifiant dans votre boutique en ligne, ou modifiez l’identifiant utilisé par la marketplace.

Vérifications rapides de dépannage

Si vous voyez toujours « produit introuvable » après avoir activé le paramètre, c’est généralement l’un des cas suivants.

• La valeur de l’ID alternatif est vide sur le produit de la boutique en ligne.

• La marketplace envoie un identifiant différent de celui attendu.

  • Exemple : vous attendiez un EAN, mais elle envoie Seller SKU.

• La valeur de l’ID alternatif existe, mais elle est dupliquée sur plusieurs produits.

• Un import secondaire a écrasé les valeurs d’identifiant après leur enregistrement.