Atlasformen

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

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

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

  • Contactez la marketplace Atlasformen (vendeur.marketplace@atlasformen.com) pour savoir si vous êtes éligible et autorisé à publier vos produits sur leur site et connaître le/les univers Atlasformen sur lesquels vos produits seront diffusés.
  • Demandez la création votre boutique vendeur à Atlasformen (cette étape est indispensable pour la diffusion de vos produits)
  • Demandez la création du ou des flux Atlasformen 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 Atlasformen
  • 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 Atlasformen
  • 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. Les univers Atlasformen

2.1 Quel(s) univers pour vos produits ?

Atlasformen fonctionne par univers. Chaque univers possède sa propre structure et correspond à une typologie précise de produits.

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

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

2.2 Ouvrez votre/vos flux Atlasformen dans Lengow

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

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

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

Vous disposerez d'autant de flux Atlasformen dans Lengow que d'univers nécessaires à la diffusion de vos produits. Chaque flux Atlasformen 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 Atlasformen

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

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

3.2 Complétez le "Matching des Champs"

Atlasformen 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)".  Consultez les fichiers de valeurs valides (un fichier par univers) pour connaître les valeurs autorisées par Atlasformen (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

Vous pouvez paramétrer des déclinaisons sur la taille sur Atlasformen. Pour cela, complétez les champs suivants :

  • "product_parent_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 devra rester vide si le produit n'est pas décliné sur la taille.
  • "taille_" (plusieurs champs possibles) : Ce champ doit contenir la taille de vos produits. Les valeurs de taille sont imposées par Atlasformen. Cette donnée est obligatoire si le produit est décliné sur la taille.

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

3.4 Renseignez les attributs produits

Certains attributs produits sont indiqués comme "Optionnel" par Atlasformen 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 Atlasformen. 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 pour connaître les valeurs autorisées par Atlasformen 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 Atlasformen, 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" (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)

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

3.6 Paramétrez vos frais de port

Les modes et les frais de livraison sont prédéfinis par Atlasformen. Rapprochez-vous de votre chargé(e) de compte Atlasformen 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.

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

OU

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

1 / Créez un champ virtuel "Atlasformen_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 "Atlasformen_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.

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 "Atlasformen_logistic_class" devient FD0. Les frais de port sont fixés à 0,00€ (gratuits) pour l'ensemble des modes de livraison de cette classe logistique FD0.

3.7 Réalisez le mapping des catégories

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

3.8 Onglet Options

Dans l'onglet "Options" de votre flux Atlasformen, 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 Atlasformen

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

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

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

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

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 Atlasformen. 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 Atlasformen 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 à Atlasformen :

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

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 Atlasformen. Pour chacun de vos produits en erreur, Atlasformen 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 Atlasformen. 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 Atlasformen, 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 à Atlasformen (sans avoir été envoyé en quantité à 0), l'offre restera visible sur Atlasformen avec les dernières informations de stock connues par Atlasformen.

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

5.2 Supprimez l'offre associée au produit

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

1 / Créez un champ virtuel "Atlasformen_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 pour renseigner le champ virtuel "Atlasformen_update_delete" avec la valeur delete dans le ALORS .

L'information "delete" sera automatiquement reprise dans le flux optimisé et transmise à Atlasformen. 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 Atlasformen, 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 Atlasformen toutes les heures.

6.2 Traitement des commandes

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

Refuser la commande : elle sera alors automatiquement renvoyée à Atlasformen en tant que commande refusée. Cette commande ne sera pas à traiter, le client sera prévenu par Atlasformen 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 Atlasformen que votre commande a été envoyée au client. Atlasformen 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 Atlasformen si vous souhaitez recevoir plus d'informations à ce sujet.

6.4 Les différents statuts de vos commandes Atlasformen

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

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

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

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

vendeur.marketplace@atlasformen.com