Macway

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

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

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

  • Contactez la marketplace Macway (contact.marketplace@macway.com) pour savoir si vous êtes éligible et autorisé à vendre vos produits sur leur site.
  • Demandez la création de votre boutique vendeur à Macway (cette étape est indispensable pour la diffusion de vos produits)
  • Demandez la création du flux Macway côté Lengow
  • Réalisez une segmentation des produits que vous ne souhaitez pas diffuser sur Macway
  • Complétez le "Matching Champs" pour faire correspondre les données de votre flux source à la structure Macway
  • 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 Macway
  • Paramétrez les options de votre flux (Fréquence d'indexation, alerte…)
  • 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 Macway dans Lengow

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

Recherchez l'intitulé "Macway" et sélectionnez-le.

Ou rendez-vous dans la rubrique "Marketplaces", drapeau "français", puis choisissez le flux Macway.

Voyons maintenant comment paramétrer un flux Macway.

3. Configurez votre flux Macway

Macway 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 à Macway :

  • 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 Macway.
  • Les "produits parents" si votre flux source en contient car Macway ne gère pas la publication de fiches produits déclinées.

3.2 Complétez le "Matching des Champs"

Macway 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é 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)". Consulter le fichier de valeurs valides pour connaître les valeurs autorisées par Macway. (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 leur mise à jour (la mention "Champ du flux produit" n'apparaît pas).

3.3 Paramétrez vos déclinaisons

Macway 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 carte mémoire disponible en différentes capacités, Macway publiera plusieurs fiches produits sur son site :
- une fiche pour le produit X en 8 Go
- une fiche pour le produit X en 16 Go
- une fiche pour le produit X en 32 Go
- une fiche pour le produit X en 64 Go

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 Macway 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 Macway. 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 Macway 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 Macway, vous devrez les adapter à l'aide de Rechercher-Remplacer ou Règles Automatiques.

3.5 Configurez vos promotions / soldes

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

Les soldes se paramètrent de la même manière que les promotions. Si vous envoyez vos produits soldés en avance dans votre catalogue, renseignez bien les champs "discount_start_date" et "discount_end_date" avec les dates des soldes.

3.6 Paramétrez vos frais de port

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

3.6.1 Les modes de livraison

L'activation des modes de livraison s'effectue directement depuis votre back office Mirakl. Plusieurs modes de livraison existent :

  • Standard
  • Express

3.6.2 Frais de livraison

Chaque type de produit est associé à une classe 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 les frais de livraison, vous pouvez au choix :

  • Conserver les montants de frais de port attribués par défaut par Macway. Pour ce faire, vous n'aurez qu'à activer le(s) mode(s) de livraison de votre choix côté Mirakl. Pour ce faire, rendez-vous dans votre back office Mirakl > Boutique > Paramètres > Livraison et activer le(s) mode(s) de livraison de votre choix en cliquant sur "Montant par défaut".

OU

  • Modifier les frais de port attribués par Macway pour chaque mode de livraison. Rendez-vous dans votre back office Mirakl > Boutique > Paramètres > Livraison et activer le(s) mode(s) de livraison de votre choix en cliquant sur "Montant libre". Vous aurez alors la possibilité de modifier le montant de frais de port défini par défaut et de renseigner celui de votre choix.

OU

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

1 / Créez un champ virtuel "Macway_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 "Macway_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 livraison gratuits pour l'ensemble de vos produits. Cela se configure au niveau du backoffice Mirakl : Boutique > Paramètres > Offrir les frais de port > cochez la case "Frais de port offert".

Rapprochez-vous de votre chargé(e) de compte Macway si vous souhaitez obtenir plus de détails à ce sujet.

3.7 Réalisez le mapping des catégories

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

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

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

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

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

4.2 Renseignez vos 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 Macway. 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_path : Renseignez ici votre identifiant Mirakl. Pour le trouver, connectez-vous sur votre espace Mirakl Macway et cliquez sur "Boutique" > "Paramètres" (visible en haut de page : identifiant : XXXX).

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

4.3 Envoi du catalogue produits

Deux flux distincts sont envoyés à Macway :

  • Flux Produits : Il permet l'intégration et la création des produits. Il est transmis à Macway une fois par jour aux alentours de 3h30. Si vos produits ne sont pas en erreur, ils seront créés côté Macway et apparaîtront en ligne sous 24 heures suite à l’envoi du flux offres.

  • Flux Offres : Il permet la mise à jour des prix, stock… Il est envoyé à Macway toutes les heures. Lorsque le flux offres est reçu par Macway, la mise à jour est quasiment immédiate sur le site Macway.

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 Macway. Pour chacun de vos produits en erreur, Macway 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 :

  • 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 Macway. 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

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 Macway, indiquez une quantité à "0" dans Lengow (à l’aide d’une Règle Automatique ou directement dans la fiche produit, par exemple).

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

Par défaut, Macway 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. Ainsi, l'information "produit indisponible" sera bien envoyée à Macway.

5.2 Supprimez l'offre associée au produit

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

1 / Créez un champ virtuel "Macway_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 à Macway. 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 Macway, rendez-vous dans "Gestion du flux" > "Matching Champs" et indiquez la valeur "delete" dans la colonne "champ personnalisé" au niveau du champ "update-delete". 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 Macway toutes les heures.

6.2 Traitement des commandes

1 / Lorsqu'une nouvelle commande est passée sur Macway, 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")

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 "Macway".

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 à Macway en tant que commande refusée. Cette commande ne sera pas à traiter, le client sera prévenu par Macway 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 Macway que votre commande a été envoyée au client. Macway se charge alors de prévenir le client que la commande a été expédiée.

6.3 Annulation d'une commande

Si vous souhaitez annuler une commande après la première étape d'acceptation, rapprochez-vous de votre chargé(e) de compte Macway pour connaître la procédure à suivre.

6.4 Les différents statuts de vos commandes Macway

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

  • 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 Macway.

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

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 Macway 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 Macway 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 Macway

  • Contact pour l'ouverture de votre boutique : contact.marketplace@macway.com
  • Contact support : support.marketplace@macway.com