Boulanger

1. Préambule - Gérez votre flux Boulanger sur Lengow

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

Voici les étapes pour publier vos produits et pour récupérer vos commandes Boulanger :

  • Contactez la marketplace Boulanger (Johanna Dendievel / johanna.dendievel@boulanger.com ou Nicolas Ferret / nicolas.ferret@boulanger.com) pour savoir si vous êtes éligible et autorisé à publier vos produits sur leur site et connaïtre le/les univers Boulanger sur lesquels vos produits seront diffusés.
  • Demandez la création votre boutique vendeur à Boulanger (cette étape est indispensable pour la diffusion de vos produits)
  • Demandez la création du ou des flux Boulanger côté Lengow
  • Réalisez une segmentation des produits que vous ne souhaitez pas diffuser ou qui ne correspondent pas à l'univers choisi
  • Complétez le "Matching Champs" pour faire correspondre les données de votre flux source à la structure Boulanger
  • Modifiez les valeurs de votre flux source à l'aide de "Règles Automatiques" ou/et "Rechercher-Remplacer" pour les adapter aux attentes du diffuseur
  • Réalisez le "Mapping des Catégories" pour faire correspondre vos catégories à celles de Boulanger
  • Paramétrez les options de votre flux (Fréquence d'indexation, alerte…)
  • Prévenez votre chargé(e) de compte Boulanger lorsque vous êtes prêt
  • Renseignez vos identifiants API pour lancer la diffusion de vos produits
  • Gérez vos commandes

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

2. Les univers Boulanger

2.1 Quel(s) univers pour vos produits ?

Boulanger fonctionne par univers. Chaque univers possède sa propre structure et correspond à une typologie précise de produits. Il est impossible de vendre des casques audio dans l'univers "Petit ménager", par exemple.

Pour savoir quel(s) univers ouvrir pour vos produits, contactez votre chargé(e) de compte Boulanger (cela est généralement défini à la signature de votre contrat avec Boulanger).

Une fois ce point défini avec votre chargé(e) de compte Boulanger, demandez la création des flux correspondants dans votre compte Lengow.

2.2 Ouvrez votre/vos flux Boulanger dans Lengow

Chaque univers Boulanger nécessite la création d'un nouveau flux dans Lengow.

Recherchez l'intitulé "Boulanger" pour voir l'ensemble des univers disponibles.

Ou rendez-vous dans la rubrique "Marketplaces", drapeau "français", puis choisissez le flux ou les flux Boulanger correspondant(s).

Vous disposerez d'autant de flux Boulanger dans Lengow que d'univers nécessaires à la diffusion de vos produits. Chaque flux Boulanger est indépendant des autres et, bien qu'il y ait des similitudes, requiert un paramétrage spécifique.

Voyons maintenant comment paramétrer l'un d'entre eux.

3. Configurez votre flux Boulanger

Boulanger demande de renseigner 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éalisez une segmentation

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

  • 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 de l'univers Boulanger.
  • Les "produits parents" si votre flux source en contient, car Boulanger ne gère par les déclinaisons.

3.2 Complétez le "Matching des Champs"

Boulanger demande une structure de flux particulière selon l'univers choisi.

Afin de 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é 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). (Voir ici comment bien lire ce fichier)
  • Si le champ sert pour la création de vos produits (il est alors indiqué "Champ du flux produit") ou pour leur mise à jour (la mention "Champ du flux produit" n'apparaît pas).

3.3 Paramétrez vos déclinaisons

Boulanger ne gère pas la publication de fiches produits déclinées et créera une fiche par produit présent dans votre catalogue.

Exemple : Pour une enceinte sans fil disponible en différents couleurs, Boulanger publiera plusieurs fiches produits sur son site :
- une fiche pour le produit X en noir
- une fiche pour le produit X en gris
- une fiche pour le produit X en rouge
- une fiche pour le produit X en bleu
- une fiche pour le produit X en vert

Vous devrez réaliser une segmentation pour exclure vos "produits parents" si votre flux source en contient.

3.4 Renseignez les attributs produits

La majorité des attributs produits sont indiqués comme "Optionnel" par Boulanger mais il est recommandé d'en renseigner un maximum pour que vos fiches produit soient les plus complètes possibles et qu'elles soient ainsi plus attractives. Vos produits seront également plus visibles car les attributs renseignés sont repris dans les filtres de recherche du site Boulanger.

Les valeurs pour chaque attribut peuvent être libres ou imposées par Boulanger. Si des valeurs sont imposées, vous retrouverez le message "Des valeurs sont imposées pour ce champ (liste disponible dans notre guide diffuseur)" dans la définition du champ dans l'onglet "Matching Champs". Dans ce cas, référez-vous aux fichiers de valeurs valides (un fichier pour chaque univers) pour connaître les valeurs autorisées par Boulanger pour chacun de ces attributs produit. (Voir comment bien lire le fichier)
Si les valeurs de votre flux source ne correspondent pas à celles attendues par Boulanger, vous devrez les adapter à l'aide de Rechercher-Remplacer ou Règles Automatiques.

REMARQUE: Un onglet "Déclinaison" est à votre disposition dans la "Gestion du Flux" Boulanger. Celui-ci a pour but de vous faciliter le travail pour l'attribut marque. Voici comment procéder :

Au niveau de l'onglet "Gestion du flux" > onglet "Matching Champs", matchez le champ "MARQUE" avec le champ de votre flux source correspondant .

Puis, au niveau de l'onglet "Gestion du flux" > "Déclinaison" > "Marques", effectuez la correspondance entre les marques contenues dans votre flux source et celles acceptées par Boulanger .

Les marques que vous mappez dans l'onglet "Déclinaison" remonteront ensuite dans le champ "MARQUE" du flux optimisé Boulanger.

Remarque : Si une marque est manquante dans le menu déroulant, rapprochez-vous de votre chargé(e) de compte Boulanger pour lui demander la création de la valeur concernée.

3.5 Configurez vos promotions / soldes et offres spéciales

3.5.1 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" (optionnel) : date de début de la promotion (format YYYY-MM-DD)
  • "discount_end_date" (optionnel) : date de début de fin de la promotion (format YYYY-MM-DD)

3.5.2 Soldes

Pour préparer une campagne de soldes, consultez notre guide dédié.

3.5.3 Offres spéciales

Pour participer au Black Friday, configurez vos offres de la même façon que les promotions. Renseignez bien les champs "discount_start_date" et "discount_end_date" et veillez à ce que vos offres actualisées soient envoyées idéalement la veille de l'événement.

3.6 Paramétrez vos frais de port

Les modes et les frais de livraison sont prédéfinis par Boulanger. Rapprochez-vous de votre chargé(e) de compte Boulanger pour obtenir la grille des classes logistiques.

3.6.1 Les modes de livraison

Le choix des modes de livraison s'effectue directement depuis votre back office Mirakl. Boulanger ne propose les modes de livraison suivants :

  • "STANDARD"
  • "EXPRESS"

3.6.2 Frais de livraison

Chaque type de produit est associé à une catégorie logistique et les frais de livraison se calculent en fonction :

  • de la classe logistique à laquelle est associé le produit
  • du mode de livraison sélectionné pour le produit

Pour la catégorie logistique, vous pouvez au choix :

  • Conserver les classes logistiques attribuées par défaut par Boulanger pour vos produits. Dans ce cas, aucune action n'est à réaliser dans Lengow. Rapprochez-vous de votre chargé(e) de compte Boulanger si vous souhaitez obtenir plus de détails à ce sujet.

OU

  • Modifier les classes logistiques attribuées par défaut par Boulanger pour vos produits et "forcer" une autre classe logistique. Pour ce faire, suivez les étapes suivantes :

1 / Créez un champ virtuel "Boulanger_logistic_class" en vous rendant dans "Gestion du Flux" > onglet "Flux Source".

2 / Matchez ce champ virtuel avec le champ "logistic_class" dans "Gestion du Flux" > "Matching Champs". Enregistrez vos modifcations en cliquant sur "Modifier les champs du flux" en bas de page.

3 / Réalisez une (ou plusieurs) règle(s) automatique(s) pour renseigner le champ virtuel "Boulanger_logistic_class" avec la valeur souhaitée (référez-vous à la grille des classes logistiques pour connaître les codes existants). Vous pourrez trouver, ci-dessous, des exemples de règles que vous pourrez établir pour forcer une classe logistique :

Exemple 1 : Règle automatique établie sur le champ Identifiant_unique

Exemple 2 : Règle automatique établie sur le champ Catégorie

OU

  • Indiquer des frais de port gratuits pour vos produits. Dans ce cas, vous devrez suivre la démarche expliquée ci-dessus et créer une règle automatique en indiquant ALORS "Boulanger_logistic_class" devient XXS. Les frais de port sont fixés à 0,00€ (gratuits) pour l'ensemble des modes de livraison de cette classe logistique XXS.

3.7 Réalisez le mapping des catégories

Pour bien catégoriser vos produits sur Boulanger, utilisez le thésaurus Boulanger pour faire correspondre vos catégories à celles de la Marketplace. Pour faire ce mapping, il faut se rendre dans l'onglet "Gestion des Offres" :

  • Ouvrir le thésaurus Boulanger 
  • 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 Boulanger, 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érifiez 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 vos paramétrages s'appliquent bien à tous vos nouveaux produits.

4. Intégration de votre catalogue chez Boulanger

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

  • Vérifiez qu'il n'y ait pas de règles dans votre Mirakl Boulanger
  • Renseignez les identifiants API dans Lengow
  • Consultez les rapport d'intégration produits et offres

Pour rappel, votre boutique vendeur Boulanger doit être créée pour que vous puissiez publier vos produits sur Boulanger. Rapprochez-vous de votre chargé(e) de compte Boulanger 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 Boulanger, l'envoi des flux offres et produits peut bloquer. Pour éviter ce souci, il ne faut aucune règle au sein de votre Mirakl Boulanger.

Si ces règles sont nécessaires (pour des produits non présents dans votre flux Lengow mais qui sont en ligne sur Boulanger), rapprochez-vous de Boulanger 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 Boulanger).

4.2 Renseignez 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 Boulanger. Pour ce faire, vous devez vous rendre dans la partie "Gestion du flux" > onglet "Identifiants API":

  • Mirakl_key : Renseignez ici votre clé API. Vous pourrez 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 Boulanger 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 produits

Deux flux distincts sont envoyés à Boulanger :

  • Flux Produits : Il permet l'intégration et la création des produits. Il est transmis à Boulanger une fois par jour aux alentours de 4h. Vos produits pourront être créés par Boulanger sous 48 heures s'ils ne sont pas en erreur.
  • Flux Offres : Il permet la mise à jour des prix, stock… Il est envoyé à Boulanger toutes les 4 heures. Lorsque le flux offres est reçu par Boulanger, la mise à jour est quasiment immédiate sur le site Boulanger.  

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 Boulanger. Pour chacun de vos produits en erreur, Boulanger vous spécifie la raison du rejet.

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

Remarque 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 :

  • dans Lengow 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 = "products_mirakl"
    • Rapport d'intégration du flux offres : Type = "offers_mirakl"

  • dans votre espace Mirakl Boulanger. 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. Dépubliez un produit

Remarque : Les quantités des fiches produits sont mises à jour à 10h et 15h par Boulanger. Si un produit est envoyé en quantité 0 il ne sera plus commandable au niveau du panier mais il faudra attendre quelques heures avant qu'il n'apparaisse comme indisponible à la vente sur la fiche produit.

5.1 Envoyez une quantité 0

Lengow peut mettre à jour uniquement les produits qui sont présents dans votre flux source.

Pour désactiver un produit en ligne sur Boulanger, indiquez une quantité à "0" dans Lengow (à l’aide d’une règle automatique ou directement dans la fiche produit par exemple).

ATTENTION : Si le produit n'est plus transmis à Boulanger (sans avoir été envoyé en quantité à 0), l'offre restera visible sur Boulanger avec les dernières informations de stock connues par Boulanger.

Par défaut, Boulanger fonctionne par mise à jour de données et non par écrasement.

Lengow a mis en place une sécurité qui permet de conserver les produits virtuellement lorsqu'ils disparaissent de votre flux source. Ils sont contenus dans la catégorie "virtual products", au niveau de l'onglet “gestion des offres”. Cependant, afin d'éviter tout problème de sur-vente, veillez à conserver les produits hors stock dans votre flux source pendant 1 à 2 jours, avec une quantité de 0 unité. Ainsi, l'information “produit indisponible” sera bien envoyée à Boulanger.

5.2 Supprimez l'offre associée au produit

Vous pouvez supprimer une offre de votre back office Mirakl Boulanger directement depuis Lengow. Pour cela, utilisez le champ "update_delete" de Boulanger et y indiquer la valeur "delete". Voici comment procéder :

1 / Créez un champ virtuel "Boulanger_update_delete" au niveau de la "Gestion du Flux" > onglet "Flux Source" :

2 / Matchez ce champ avec le champ "update_delete" au niveau de la "Gestion du Flux" > onglet "Matching Champs". Enregistrez en cliquant sur "Modifier les champs du flux" en bas de page:

3 / Créez une règle automatique comme suit (exemple donné pour l'Identifiant_produit 12 du catalogue produits, veillez à bien adapter la condition selon vos données et besoins) :

L'information "delete" sera automatiquement reprise dans le flux optimisé et transmise à Boulanger. Les offres concernées disparaîtront de votre back office Mirakl > onglet "Suivi des offres".

Remarque : Pour supprimer l'ensemble de vos offres de votre back office Mirakl Boulanger, rendez-vous dans "Gestion du flux" > "Matching Champs" et indiquez la valeur "delete" dans la colonne "champ personnalisé" au niveau du champ "update-delete".

Note : Si vous avez réalisé un matching au préalable, veillez à vider la colonne "champ marchand" au niveau du champ "update-delete".

6. Gestion des commandes

6.1 Horaire de récupération des commandes

Lengow récupère les commandes passées chez Boulanger toutes les heures.

6.2 Traitement des commandes

1 / Lorsqu'une nouvelle commande est passée sur Boulanger, elle remonte dans Lengow dans l'onglet "Nouvelles Commandes". A ce stade, vous pouvez soit :

Accepter la commande : elle passera alors en attente d'expédition (onglet "Commandes en attente d'expédition")

Remarque 1 : Il est possible d'automatiser cette étape en acceptant automatiquement les commandes. Pour cela, rendez-vous dans l'onglet "Commandes" > onglet "Automatisation des commandes" > cochez la case "Boulanger".

Enregistrer en cliquant sur "Enregistrer les paramètres".

En activant cette option, vous devez vous assurer de pouvoir honorer l'ensemble de vos commandes.

Refuser la commande : elle sera alors automatiquement renvoyée à Boulanger en tant que commande refusée. Cette commande ne sera pas à traiter, le client sera prévenu par Boulanger que sa commande est annulée.

2 / Lorsque votre commande est dans l'onglet "Commandes en attente d'expédition", vous devez préparer votre commande et l'envoyer au client. Lorsque la commande est prête à être expédiée, renseignez le numéro de tracking colis et le nom du transporteur puis confirmez l'expédition. La commande passera alors dans l'onglet "Commandes expédiées".

Remarque 2 : Si vous utilisez un de nos modules ou notre webservice pour importer les commandes dans votre back office e-commerce, c'est à partir du statut "SHIPPING" (onglet "Commandes en attente d'expédition") que la commande est importable dans votre back office. Lorsque vous aurez traité la commande et confirmé l'envoi depuis votre back office, la commande passera automatiquement dans l'onglet "Commandes expédiées" dans Lengow.

3 / Lorsque votre commande est dans l'onglet "Commandes expédiées", nous informons Boulanger que votre commande a été envoyée au client. Boulanger se charge alors de prévenir le client que la commande a été expédiée.

6.3 Annulation d'une commande

Pour annuler une commande après la première étape d'acceptation, rendez-vous dans votre backoffice Mirakl et cliquez sur "Mes commandes à traiter". Sélectionnez le numéro de la commande que vous souhaitez annuler puis cliquez sur "Remboursement". Vous devrez alors préciser le motif de d'annulation. Rapprochez-vous de votre chargé(e) de compte Boulanger si vous souhaitez recevoir plus d'informations à ce sujet.

6.4 Les différents statuts de vos commandes Boulanger

Les commandes passent par différents onglets sur Lengow durant le processus de traitement de vos commandes Boulanger :

  • Nouvelles commandes
  • Commandes en attente d'expédition
  • Commandes expédiées
  • Commandes annulées

Dans chaque onglet, différents statuts sont visibles en dessous du numéro de votre commande Boulanger.

Voici une explication par onglet pour chaque statut. Pour plus de détails à ce sujet, merci de contacter directement votre chargé de compte Boulanger :

6.4.1 Nouvelles commandes

"STAGING" : La commande vient d’être passée par le client et elle est arrivée sur Lengow.
"WAITING_ACCEPTANCE" : Statut "en attente d’acceptation de la commande". C’est à ce statut que vous acceptez ou refusez la commande.
"WAITING_DEBIT" : La demande de débit de la commande est en cours.
"WAITING_DEBIT_PAYMENT" : Le paiement de la commande est en cours.

6.4.2 Commandes en attente d'expédition

"SHIPPING" : La commande est en attente d’expédition. C’est à ce statut que vous validez l’expédition de la commande.
"INCIDENT_OPEN" : Le client a ouvert un litige, rendez-vous dans votre Mirakl Boulanger pour le traiter.
"INCIDENT_CLOSED" : Le litige du client est clôturé.
"WAITING_REFUND" : Une demande de remboursement est en cours, rendez-vous dans votre Mirakl Boulanger pour la traiter.
"WAITING_REFUND_PAYMENT" : Le remboursement de la commande est en cours.

6.4.3 Commandes expédiées

"SHIPPED" : Statut "envoyée", la commande est envoyée et est en cours d’acheminement.
"RECEIVED" : Statut "reçue", le client a reçu la commande.
"CLOSED" : Statut "clôturée", le client a reçu la commande et n’a pas ouvert de litige.

6.4.4 Commandes annulées

"CANCELED" : La commande a été annulée par le marchand ou le client.
"REFUNDED" : La commande a été remboursée.
"REFUSED" : La commande a été refusée par le marchand lors de l’action.

7. Contact Boulanger

Johanna Dendievel : johanna.dendievel@boulanger.com
Nicolas Ferret : nicolas.ferret@boulanger.com