Rue Du Commerce

Rue du Commerce migre actuellement vers une nouvelle plateforme Mirakl.

C'est pourquoi vous trouverez en plus de votre/vos flux Rue Du Commerce Mirakl (avec univers), un flux "Rue Du Commerce CSV 4". Ce flux permet de récupérer les commandes sur leur ancien système en attendant que Rue Du Commerce migre la gestion des commandes sur Mirakl. Il est important de ne pas désactiver ce flux et de laisser renseigner vos identifiants Mirakl au niveau de la "Gestion du flux" > "Identifiants API".

Si vous utilisez encore le flux "Rue Du Commerce CSV 4" pour la création et la mise de vos produits, contactez en urgence votre chargé de compte Rue Du Commerce pour connaître les modalités permettant de migrer vers leur nouvelle plateforme ou suivez notre guide dédié à la migration.

1. Préambule - Gérer votre flux Rue du Commerce sur Lengow

Ce guide indique comment configurer et gérer au quotidien votre flux Rue du Commerce. Avant de vous lancer dans le paramétrage de votre flux Rue du Commerce, prenez connaissance de ces recommandations.

Voici les étapes pour publier vos produits et pour récupérer vos commandes Rue du Commerce :

  • Contacter la marketplace Rue du Commerce service.marchands@rueducommerce.com pour savoir si vous êtes éligible et autorisé à publier vos produits sur leur site
  • Créer votre boutique vendeur sur Mirakl (cette étape est indispensable pour la diffusion de vos produits)
  • Demander la création du flux Rue du Commerce côté Lengow
  • Réaliser une segmentation des produits que vous ne souhaitez pas diffuser sur Rue du Commerce
  • Réaliser le "Matching Champs" pour faire correspondre les données de votre flux source à la structure de Rue du Commerce
  • Modifier les valeurs de votre flux source à l'aide de "Règles Automatiques" ou/et "Rechercher-Remplacer" pour les adapter aux attentes du diffuseur
  • Renseigner les attributs produits
  • Compléter le "Mapping des Catégories" pour faire correspondre vos catégories à celles de Rue du Commerce
  • Paramétrer les options de votre flux (Fréquence d'indexation, alerte…)
  • Prévenir votre chargé(e) de compte Rue du Commerce que vous êtes prêt
  • Renseigner vos identifiants API pour lancer la diffusion de vos produits
  • Gérer vos commandes (à venir)

Toutes ces actions sont détaillées ci-dessous.

2. Les univers Rue du Commerce

Si vous utilisiez l'ancienne version du flux Rue du Commerce dans Lengow et que vous avez répondu au questionnaire concernant la migration de votre flux vers la nouvelle version Rue du Commerce, la création de votre/vos flux va être prise en charge par notre Support. Vous n'avez pas à effectuer la demande de création de flux. Passez au point 3.

2.1 Dans quelle catégorie diffuser vos produits ?

Rue du Commerce fonctionne par univers. Chaque univers possède sa propre structure et correspond à une typologie de produits. Par exemple, il n'est pas possible de vendre des canapés dans l'univers "jardin".

Pour savoir quel univers correspond à vos produits, contactez votre chargé de compte Rue du Commerce (ce point est généralement défini lors de la signature de votre contrat avec Rue du Commerce).

Une fois ce/ces univers connus, demandez les flux correspondants dans Lengow.

2.2 Ouvrir votre flux Rue du Commerce dans Lengow

Pour ouvrir votre flux Rue Du Commerce dans Lengow, contactez notre Support Client par ticket.

3. Configurer votre flux Rue du Commerce

Rue du Commerce demande aux vendeurs d’indiquer des valeurs spécifiques pour référencer les produits sur leur place de marché. Vous devez donc adapter les valeurs de votre flux source sur Lengow.

3.1 Réaliser une segmentation

Avant de commencer l'adaptation de vos valeurs, commencez par réaliser une segmentation pour ne pas envoyer à Rue du Commerce :

  • Les produits que vous ne souhaitez pas vendre sur cette place de marché.
  • Les produits de votre flux qui ne correspondent pas à la typologie de produits attendue par l'univers Rue du Commerce.
  • Les "produits parents" si votre flux source en contient.

3.2 Réaliser le "Matching des Champs"

Pour procéder au "Matching des Champs", rendez-vous sur la page "Gestion du flux" > "Matching Champs" :


Vérifiez le "Matching des Champs" et complétez les informations manquantes. Lisez attentivement la définition des champs, vous y retrouverez :

  • Le nom du champ.
  • La définition du champ.
  • Un exemple s'il existe.
  • Le caractère obligatoire ou optionnel de ce champ. Un champ "obligatoire" devra être renseigné par une valeur pour que le produit soit créé ou mis à jour.
  • Le caractère libre ou imposé des valeurs attendues. Si des valeurs sont imposées, vous retrouverez le message suivant "Des valeurs sont imposées pour ce champ (liste disponible dans notre guide diffuseur)". Vous retrouverez la liste des valeurs obligatoires ici (un fichier pour chaque univers). Si vous utilisez un champ qui nécessite des valeurs valides, il est obligatoire d'adapter les valeurs de votre flux source. Si ces valeurs ne sont pas dans votre flux source, vous devez les adapter avec des rechercher/remplacer ou des règles automatiques.
  • Si le champ sert pour la création de vos produits (il est alors indiqué "Champ du flux produit") ou pour leurs mises à jour (la mention "Champ du flux produit" n'apparaît pas).

3.3 Paramétrer vos promotions / soldes / ventes flash

Pour une même offre, une promotion, les soldes et la vente flash ne peuvent pas cohabiter, dans le cas contraire l’offre serait invalidée.

3.3.1 Paramétrer des promotions

Pour indiquer des promotions, renseignez les champs suivants :

  • "price" : prix d'origine du produit
  • "discount_price" : prix réduit du produit
  • "discount_start_date" : date de début de la promotion (format AAAA-MM-JJTHH:MM:SS)
  • "discount_end_date": date de début de fin de la promotion (format AAAA-MM-JJTHH:MM:SS)

3.3.2 Paramétrer des soldes

Pour indiquer des soldes, consultez le guide dédié.

3.3.3 Paramétrer les ventes flash

Pour indiquer des ventes flash, renseignez les champs suivants :

  • "price" : prix d'origine du produit
  • "sales-flash-price" : prix réduit du produit pendant la vente falsh
  • "sales-flash-start-date" : date de début de la vente flash (format AAAA-MM-JJTHH:MM:SS)
  • "sales-flash-end-date": date de fin de la vente flash (format AAAA-MM-JJTHH:MM:SS)

3.4 Paramétrer vos frais de port

Rendez-vous dans votre back-office Mirakl-Rue Du Commerce pour activer le service de livraison souhaité. Les frais de port s'appliqueront à l'ensemble des classifications produits affectées à la famille logistique concernée. Pour plus d'information à ce sujet, contactez votre chargé(e) de compte Rue du Commerce.

3.5 Paramétrer vos déclinaisons

3.5.1 Réaliser une segmentation

Rue du Commerce ne souhaite pas recevoir les fiches parents dans votre catalogue produits. Réalisez une segmentation sur vos "produits parents" si votre flux source en contient.

3.5.2 Renseigner vos valeurs de déclinaisons

Vous pouvez paramétrer des déclinaisons selon la typologie de produits, voici les champs qui doivent être renseignés :

  • "group_code" : ce champ doit contenir l'identifiant parent de vos produits (référence commune à toutes les déclinaisons d'un produit). Cette donnée est obligatoire si le produit est décliné. Il permet de regrouper sur la même fiche produit toutes les déclinaisons d'un produit. Ce champ est commun à toutes les typologies de produits. 

3.6 Renseigner les attributs produits

3.6.1 Consulter le listing des attributs

Consultez le listing des attributs Rue du Commerce dédié à chaque univers pour connaître les attributs que vous devez obligatoirement renseigner pour la diffusion de votre catalogue (Voir ici comment lire ces fichiers).

3.6.2 Renseigner les attributs sur Lengow

Plusieurs options s'offrent à vous selon votre situation :

  • Les attributs demandés par Rue du Commerce sont dans votre catalogue produits
    • ​Ils correspondent exactement aux valeurs attendues par Rue du Commerce
    • Ils ne correspondent pas exactement aux valeurs attendues par Rue du Commerce
  • Les attributs demandés par Rue du Commerce ne sont pas dans votre catalogue produits
    • ​Vous pouvez et souhaitez les ajouter dans votre catalogue produits
    • Vous ne pouvez pas ou ne souhaitez pas les ajouter dans votre catalogue produits

Consultez les paragraphes ci-dessous pour connaître la marche à suivre :

  • Cas 1 : Les attributs demandés par Rue du Commerce sont dans votre catalogue produits et ils correspondent exactement aux valeurs attendues par Rue du Commerce

Rendez-vous sur le "Matching Champs" et faites correspondre le champ de votre catalogue produit avec le champ correspondant dans la structure Rue du Commerce.​

  • Cas 2 : Les attributs demandés par Rue du Commerce sont dans votre catalogue produits, mais pas dans un champ dédié (dans le champ "Titre" ou "description" par exemple) et/ou ils sont présents dans un champ dédié, mais ils ne correspondent pas exactement aux valeurs attendues par Rue du Commerce

​Rendez-vous sur le "Matching Champs" et faites correspondre le champ de votre catalogue produit avec le champ correspondant dans la structure Rue du Commerce.

  • Puis utilisez les fonctionnalités « Rechercher/Remplacer » et « Règles automatiques », pour adapter les valeurs de votre catalogue produits avec les valeurs d'attributs attendues par Rue du Commerce.
  • Pour l'attribut "Marque", la correspondance entre les valeurs de votre flux source et les attributs attendus par Rue du Commerce peut se faire dans un onglet dédié dans Lengow, sous la forme de menus déroulants. Suivez la marche à suivre détaillée en annexe.
  • Cas 3 : Les attributs demandés par Rue du Commerce ne sont pas dans votre catalogue produits et vous pouvez et souhaitez les ajouter dans votre catalogue produits

Ajoutez des champs supplémentaires à votre catalogue produits (un champ par attribut) et complétez-les avec les valeurs attendues par Rue du Commerce.

Puis, reportez vous au "Cas 1" ci-dessus.

  • Cas 4 : Les attributs demandés par Rue du Commerce ne sont pas dans votre catalogue produits et vous ne pouvez pas ou ne souhaitez pas les ajouter dans votre catalogue produits

Passez par un fichier CSV, que vous compléterez avec des valeurs qui seront injectées dans vos fiches produits sur Lengow.

La marche à suivre est détaillée en annexe de ce guide.

3.6.3 les champs virtuels

Pour vous aider des champs virtuels sont automatiquement créés et matchées lors de la création de votre flux.

Ils correspondent aux attributs obligatoires que vous devez renseigner pour la création de vos produits.

3.7 Réaliser le mapping des catégories

Pour bien catégoriser vos produits sur Rue du Commerce, utilisez le thésaurus Rue du Commerce pour faire correspondre vos catégories à celles de la Marketplace. Pour faire ce mapping, rendez-vous dans l'onglet "Gestion des Offres" :

  • Ouvrir le thésaurus Rue du Commerce 
  • Rechercher votre catégorie dans le thésaurus (effectuez un « Ctrl+F » pour rechercher le mot clé souhaité)
  • Cliquer sur la ligne correspondante
  • Cliquer sur "ENREGISTRER"
     


Pensez à bien cliquer sur "ENREGISTRER" une fois l'opération effectuée.

3.8 Onglet Options

Dans l'onglet "Options" de votre flux Rue du Commerce, vérifiez les différents points et modifiez-les au besoin. Pour plus de détails sur cet onglet, consultez notre tutoriel "Onglet Options".

3.9 Vérifier vos valeurs dans votre flux optimisé

Pour vérifier les données envoyées au diffuseur, consultez le flux optimisé. Toutes les optimisations réalisées dans Lengow sont visibles IMMEDIATEMENT (règles automatiques, rechercher/remplacer, matching…).

Remarque : Vérifiez votre flux optimisé le plus régulièrement possible pour vous assurer que les paramétrages que vous effectuez dans Lengow s'appliquent bien.

4. Intégration de votre catalogue chez Rue du Commerce

Si les données de votre flux optimisé correspondent à vos attentes et à celles de Rue du Commerce, vous pouvez envoyer vos produits sur Rue du Commerce. Pour cela, vous devez :

  • Vérifier qu'il n'y ait pas de règles dans votre Mirakl Rue du Commerce
  • Renseigner les identifiants API dans Lengow
  • Consulter le rapport d'intégration produits et offres

Pour rappel, votre boutique vendeur Rue du Commerce doit être créée sur votre interface Mirakl pour publier vos produits sur Rue du Commerce. Rapprochez-vous de votre chargé de compte Rue du Commerce si vous avez besoin d'aide sur ce point.

4.1 Assistant de configuration Mirakl

Si vous avez créé des règles à l'aide de l'assistant de configuration dans votre Mirakl Rue du Commerce, l'envoi des flux offres et produits peut bloquer. Pour éviter ce souci, il ne faut aucune règle au sein de votre Mirakl Rue du Commerce.

Si ces règles sont nécessaires (pour des produits non présents dans votre flux Lengow mais qui sont en ligne sur Rue du Commerce), rapprochez-vous de Rue du Commerce pour trouver une solution.

Si l'ensemble de vos produits est paramétré via Lengow, supprimez-les (en cas de doute, contactez votre chargé de compte Rue du Commerce).

4.2 Renseigner les identifiants API

Vous devez renseigner vos identifiants API dans Lengow pour que les données de votre catalogue produits puissent être envoyées et actualisées sur le site Rue du Commerce. Pour ce faire, rendez-vous dans la partie "Gestion du flux" > onglet "Identifiants API":

1/ Sélectionnez l'environnement Rue du Commerce sur lequel vous souhaitez pousser votre catalogue produits (Pre Production ou Production). Votre catalogue produits est poussé, par défaut, sur la Pre Production (environnement de tests). Rapprochez-vous de votre chargé(e) de compte Rue du Commerce avant d'activer l'envoi de votre catalogue produits sur la Production. Il est nécessaire d'obtenir la confirmation de Rue du Commerce avant toute modification.

2/ Renseignez les identifiants Mirakl correspondants :

  • Mirakl_key : Renseignez ici votre clé API. Cette clé vous sera normalement communiquée par Rue du Commerce mais vous pourrez également la retrouver en vous rendant sur votre boutique Mirakl. Pour ce faire, cliquez sur votre identifiant (en haut à droite de votre espace Mirakl) > puis sur l'onglet "Clé API". Si votre clé API est amenée à changer, il faudra également la modifier dans votre compte Lengow.
    Exemple de clé API : b36a2665-109a-4135-a0f0-460d70568ca4.
  • Mirakl_storeid : Renseignez ici votre identifiant Mirakl. Pour le trouver, connectez-vous sur votre espace Mirakl Rue du Commerce et cliquez sur "Boutique" > "Paramètres" (visible en haut de page : identifiant : XXXX).

Pensez bien à enregistrer vos modifications en appuyant sur "Appliquer".

4.3 Envoi du catalogue

Deux flux distincts sont envoyés à Rue du Commerce :

  • Flux Produits : il permet l'intégration et la création des produits. Il est transmis à Rue du Commerce deux fois par jour vers 11h45 et 16h45. Si vos produits ne sont pas en erreur, ils seront créés côté Rue du Commerce et apparaîtront en ligne sous 48h, suite à l’envoi du flux offres.
  • Flux Offres : il permet la mise à jour des prix, stock… Il est envoyé à Rue du Commerce toutes les 4 heures. Lorsque le flux offre est reçu par Rue du Commerce, la mise à jour est quasiment immédiate sur le site Rue du Commerce.

4.4 Rapport d'intégration produits et offres

Nous vous invitons à consulter les rapports d’intégration produits et offres pour vérifier que vos produits sont bien paramétrés, que ce soit au niveau de la création des produits (flux produits) ou des mises à jour (flux offres). Ces rapports ne contiennent que les articles de votre catalogue rejetés par Rue du Commerce. Pour chacun de vos produits en erreur, Rue du Commerce vous spécifie la raison du rejet.

Note : Si l’ensemble de vos produits a bien été intégré et mis à jour, l'ensemble du catalogue produits apparaît sans la colonne "errors".

Note 2 : Si le rapport d’intégration produits et/ou offres est vide, cela signifie qu'il n'est pas encore disponible.

Les rapports d’intégrations produits et offres sont visibles et téléchargeables :

  • au niveau de l'onglet "Historique des indexations" > "Rapports d'intégration" > cliquez sur le lien bleu "Report"
    • Rapport d'intégration du flux produits : Type = "product" 
    • Rapport d'intégration du flux offres : Type = "offer" 

  • dans votre espace Mirakl Rue du Commerce. Voici comment y accéder :
    • Rapport d'intégration du flux produits : onglet "Mon stock" > "Importer des offres par fichier" > "suivi d'import des produits"
    • Rapport d'intégration du flux offres : onglet "Mon stock" > "Importer des offres par fichier" > "suivi d'import des offres"

5. Gérer vos commandes

Un flux "Rue Du Commerce CSV 4" a été ajouté à votre compte Lengow par notre équipe Support. Ce flux permet de récupérer les commandes sur leur ancien système en attendant que Rue Du Commerce migre la gestion des commandes sur Mirakl.

Il est important de ne pas désactiver ce flux CSV 4 et de laisser renseigné vos identifiants Mirakl au niveau de la "Gestion du flux" > "Identifiants API" de ce flux.

6. Contact Rue Du Commerce

  • service.marchands@rueducommerce.com / 01 84 13 04 03

Annexe

A. Templates pour injection des attributs

B. Renseignez les attributs avec l'onglet "Déclinaison"

Rendez-vous dans l'onglet "Déclinaison" ​ > onglet "Marques"

Sur la gauche, vous trouverez l'ensemble des marques de votre flux source.

Sur la droite, vous trouverez un menu déroulant avec l'ensemble des marques Rue Du Commerce.

Vous devez mapper les marques de votre flux source avec celles de Rue Du Commerce.

Pensez bien à enregistrer votre mapping des marques en cliquant sur "Enregistrer" à droite de la page.

Lorsque vous ajoutez de nouveaux produits dans votre flux avec de nouvelles marques, il faut systématiquement venir vérifier le mapping et le réenregistrer.

C. Comment renseigner le fichier CSV ?

C.1 Pour les valeurs obligatoires

Téléchargez le fichier correspondant à votre univers de diffusion.

Renseignez dans la première colonne (colonne « Product ID ») l’identifiant de vos produits qui seront diffusés dans cet univers. Cet identifiant devra être le même que celui qui est matché au niveau du champ « article_sku » dans la structure du flux sur Lengow, sans quoi les valeurs ne pourront pas être injectées dans vos fiches produits sur Lengow.

Renseignez ensuite pour chaque produit, la valeur d’attribut (retrouvez ici comment lire le fichier d'attributs).

Voici un exemple pour des produits de l'univers Jardin :

  • Les attributs rdc_brand, rdc_foliage_type et rdc_tree_type ont été renseignés d'après les valeurs indiquées dans le listing des attributs.
  • Les attributs rdc_foliage_color, rdc_tree_height_cm ont été renseignés librement, car Rue du Commerce n'impose aucune valeur valide pour ces attributs.
  • L'attribut rdc_unity_capacity_l n'a pas été renseigné, car il ne correspond pas à la typologie des produits du catalogue.

Ne modifiez pas l'intitulé des champs dans le template que nous mettons à votre disposition. Ceux-ci permettront la correcte intégration de vos attributs dans vos fiches produits sur Lengow.

Une fois ce fichier complété, rendez-vous dans Lengow au niveau de l'onglet "Déclinaison" > "Gestion des attributs" téléchargez le au niveau de la rubrique "Injection des attributs".