Go Sport Mirakl

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

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

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

  • Contactez la marketplace Go Sport pour savoir si vous êtes éligible et autorisé à publier vos produits sur leur site
  • Créez votre boutique vendeur sur Go Sport (cette étape est indispensable pour la diffusion de vos produits)
  • Demandez la création du flux Go Sport côté Lengow
  • Réalisez une segmentation des produits que vous ne souhaitez pas diffuser sur Go Sport
  • Réalisez le "Matching Champs" pour faire correspondre les données de votre flux source à la structure de Go Sport
  • Modifiez les valeurs de votre flux source à l'aide de "Règles Automatiques" ou/et "Rechercher-Remplacer" pour les adapter aux attentes du diffuseur
  • Complétez le "Mapping des Catégories" pour faire correspondre vos catégories à celles de Go Sport
  • Paramétrez les options de votre flux (Fréquence d'indexation, alerte…)
  • Prévenez votre chargé(e) de compte Go Sport que 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. Ouvrez votre flux Go Sport Mirakl dans Lengow

Demandez la création d'un nouveau flux dans Lengow.

Recherchez l'intitulé "Go Sport Mirakl" et sélectionnez le pays qui vous convient.

Ou recherchez-le dans la rubrique "Marketplaces", drapeau "France", puis choisissez le flux.

Voyons maintenant comment paramétrer votre flux.

3. Configurez votre flux Go Sport Mirakl

Go Sport demande d’indiquer des valeurs spécifiques pour référencer vos produits sur leur place de marché. Vous devez donc adapter les valeurs de votre flux source dans 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 à Go Sport :

  • 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 Go Sport.
  • Les "produits parents" si votre flux source en contient.

3.2 Réalisez le "Matching des Champs"

Go Sport demande une structure de flux particulière pour quelques champs clés.

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 valides autorisées par Go Sport. (Voir ici comment bien lire ce fichier). 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étrez vos promotions / soldes

Pour indiquer des promotions, renseignez les champs suivants :

  • price : prix d'origine du produit
  • discount_price : prix réduit du produit
  • operation-co  :  type de promotion (Soldes, Promotion, Destockage, Bonnes_affaires, etc.)
  • discount_start_date : date de début de la promotion (format YYYY-MM-DD)
  • discount_end_date: date de début de fin de la promotion (format YYYY-MM-DD)

Remarque pour les soldes : Comme pour chaque opération commerciale, les marchands sont invités à paramétrer le champ « operation-co » avec la valeur « Soldes » dès la veille des soldes.

3.4 Paramétrez vos frais de port

Les modes et les frais de livraison sont à définir côté Go Sport. Rapprochez-vous de votre chargé(e) de compte Go Sport si vous avez des questions à ce sujet.

3.4.1 Les modes de livraison

Le choix des modes de livraison s'effectue directement depuis votre back office Mirakl.

3.4.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 Go Sport pour vos produits. Dans ce cas, aucune action n'est à réaliser dans Lengow. Rapprochez-vous de votre chargé(e) de compte Go Sport si vous souhaitez obtenir plus de détails à ce sujet.

OU

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

1 / Créez un champ virtuel "Go Sport_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 "Go Sport_logistic_class" avec la valeur souhaitée (référez-vous à la grille des classes logistiques pour connaître les codes existants).

OU

  • Offrir les frais de port pour vos produits. Une option est disponible côté Mirakl pour offrir les frais de port pour l'ensemble des produits. Rendez-vous dans votre back-office Mirakl pour l'activer. Contactez votre chargé(e) de compte Go Sport si vous avez des questions à ce sujet.

3.5 Paramétrez vos déclinaisons

Vous pouvez paramétrer des déclinaisons sur la taille, la couleur, le goût, le volume et les dimensions sur Go Sport. Pour cela, complétez les champs suivants :

  • variant_id: 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é. Ce champ doit être vide si le produit n'est pas décliné.
  • color_facet : Ce champ doit contenir la couleur du produit. Cette donnée est obligatoire si le produit est décliné sur la couleur.
  • size_facet : Ce champ doit contenir la taille du produit. Cette donnée est obligatoire si le produit est décliné sur la taille.
  • gout : Ce champ doit contenir le goût du produit. Cette donnée est obligatoire si le produit est décliné sur le goût.
  • vol_cont : Ce champ doit contenir le volume/la contenance du produit. Cette donnée est obligatoire si le produit est décliné sur le volume/la contenance.
  • dimensions : Ce champ doit contenir les dimensions du produit. Cette donnée est obligatoire si le produit est décliné sur les dimensions.

3.6 Renseignez les attributs produits

La majorité des attributs produits sont indiqués comme "Optionnel" par Go Sport 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.

Les valeurs pour chaque attribut peuvent être libres ou imposées par Go Sport. 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 au fichier de valeurs valides pour connaître les valeurs autorisées par Go Sport pour chacun de ces attributs produit. (Voir ici comment bien lire ce fichier)
Si les valeurs de votre flux source ne correspondent pas à celles attendues par Go Sport, 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" Go Sport. Celui-ci a pour but de vous faciliter le travail pour les attributs couleur et taille. Voici comment procéder :

Pour renseigner vos valeurs d'attributs, voici comment procéder :

Au niveau de l'onglet "Gestion du flux" > onglet "Matching Champs", matchez les champs "color_facet" et "size_facet" avec les champs de votre flux source correspondants.

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

Les valeurs que vous mappez via l'onglet "Déclinaison" sont ensuite disponibles dans le flux optimisé, comme ceci :

  • onglet "Tailles Go Sport Mirakl" > champ "size_facet"
  • onglet "Couleurs Go Sport Mirakl" > champ "color_facet"

3.7 Réalisez le mapping des catégories

Pour bien catégoriser vos produits sur Go Sport, utilisez le thésaurus Go Sport 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 Go Sport
  • 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 Go Sport Mirakl, 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 Go Sport

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

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

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

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

4.2 Renseignez les identifiants API

Vous devez renseigner vos identifiants API dans Lengow pour pouvoir transmettre votre catalogue produits à Go Sport. Pour ce faire, rendez-vous dans la partie "Gestion du flux" > onglet "Identifiants API":

  • Mirakl_key : Renseignez ici votre clé API. Cette clé vous sera normalement communiquée par Go Sport 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 Go Sport 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 à Go Sport :

  • Flux Produits : il permet l'intégration et la création des produits. Il est transmis à Go Sport une fois par jour. Si vos produits ne sont pas en erreur, ils seront créés côté Go Sport 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é à Go Sport toutes les heures. Lorsque le flux offre est reçu par Go Sport, la mise à jour est quasiment immédiate sur le site Go Sport.

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 Go Sport. Pour chacun de vos produits en erreur, Go Sport 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 Go Sport. 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 / Supprimez un produit

5.1 Dépublication d'un produit

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

Pour désactiver un produit en ligne sur Go Sport, 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 à Go Sport (sans avoir été envoyé en quantité à 0), l'offre restera visible sur Go Sport avec les dernières informations de stock connues par Go Sport.

Par défaut, Go Sport 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 à Go Sport.

5.2 Supprimez un produit de votre back office Mirakl

Vous pouvez supprimer une ou plusieurs annonces produit sur votre back office Mirakl Go Sport directement depuis Lengow. Pour cela, vous devrez utiliser le champ update-delete de Go Sport et indiquer la valeur "delete" dans ce champ. Cela permet la suppression d’un produit sur Go Sport et sur le back office Mirakl.

Voici comment procéder :

1 / Créez un champ virtuel "Go Sport_update_delete" au niveau de la "Gestion du Flux" > onglet "Flux Source".

2 / Matchez ce champ avec le champ Go Sport du même nom au niveau de la "Gestion du Flux" > onglet "Matching Champs". Enregistrez en cliquant sur "Modifier les champs du flux" en bas de page.

3 / Deux possibilités :

  • Recherchez votre produit au niveau de la "Gestion des Offres" et ouvrez sa fiche produit. En bas de la fiche produit, indiquez "delete" dans le champ "Go Sport_update_delete" et enregistrez vos modifications.

  • Créer une règle automatique comme suit (exemple donné pour le produit 67 du catalogue produits, veillez à bien adapter la condition selon vos besoins) :

L'information "delete" sera automatiquement reprise dans le flux optimisé et transmise à Go Sport. Les produits disparaîtront alors de votre interface Mirakl.

Remarque : Pour supprimer l'ensemble de votre catalogue, rendez-vous dans "Gestion du flux" > "Matching Champs" et enlevez le matching dans la colonne "champ marchand" au niveau du champ "update-delete" si vous en avez réalisé un au préalable.
Indiquez ensuite la valeur "delete" dans la colonne "champ personnalisé" au niveau du champ "update-delete" de Go Sport.

6. Gestion des commandes

6.1 Horaire de récupération des commandes

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

6.2 Traitement des commandes

1 / Lorsqu'une nouvelle commande est passée sur Go Sport, elle descend 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")
Refuser la commande : elle sera alors automatiquement renvoyée à Go Sport en tant que commande annulée. Cette commande ne sera pas à traiter, le client sera prévenu par Go Sport que sa commande est annulée.

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 "Go Sport Mirakl".

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

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

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 cela sera fait, confirmez l'envoi. La commande passera alors dans l'onglet "Commandes expédiées".

Si vous avez choisi un suivi comme mode de livraison, c'est à cette étape que vous renseignez le transporteur et le numéro de tracking colis.

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 Go Sport que votre commande a été envoyée au client. Go Sport 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, vous devez contacter votre chargé de compte Go Sport.

6.4 Les différents statuts de vos commandes Go Sport

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

  • 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 Go Sport.

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

6.4.1 Nouvelles commandes

"STAGING" : Statut "attente de scoring", la commande passe dans un système anti-fraude.
"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 Go Sport 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 Go Sport 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 Go Sport

  • Céline Scamps (Client Success Manager Marketplace) / c.scamps@mail.go-sport.fr