PixPlace

1. Préparation de votre Flux PixPlace

Avant de soumettre votre catalogue produits à PixPlace, vous devez préparer votre flux :

  • Contrôler et adapter le matching des champs
  • Mapper vos catégories et marques
  • Renseigner vos identifiants API

1.1 Adapter votre matching des champs

Lorsque nous vous soumettons votre flux, vous devez dans un premier temps contrôler le matching des champs. Le plus important est le champ PixPlace « Id produit » qui doit être matché avec l’identifiant unique de votre produit. Ce dernier doit être l’identifiant produit que vous utilisez pour identifier le produit sur votre boutique e-commerce. Note : Si vous avez déjà des produits présents sur PixPlace, l’identifiant indiqué dans Lengow doit être le même que celui utilisé pour vos produits sur votre compte PixPlace

Le matching des champs commençant par « PixPlace_ » ne doit pas être modifié. Ils servent au bon fonctionnement de notre module.

Ce qu’il faut savoir sur les champs à matcher :

  • EAN ⇒ Champ obligatoire (sauf pour la mode - à définir au préalable avec PixPlace) : nous plaçons par défaut une segmentation pour n’envoyer que les produits contenant 13 caractères dans l’EAN. Celui-ci doit être unique à chaque produit.
  • Disponibilité ⇒ Il s’agit du temps nécessaire à la préparation et l’expédition de la commande (ne peut excéder 30 jours). Nous indiquons 2 par défaut.
  • Description livraison ⇒ Ce champ obligatoire ne peut excéder 255 caractères.

1.2 Titres et descriptions

Une fois vos produits importés, les titres et descriptions ne se mettent pas à jour de manière automatique. Assurez-vous avant le premier import que ces informations répondent aux exigences de PixPlace (par exemple : pas de marque dans le titre) et à ce que vous souhaitez. Si vous souhaitez par la suite mettre à jour ces informations, vous devez en faire la demande au support client Lengow. Cela ne peut pas se faire de manière automatisée.

1.3 Prix à indiquer en HT

PixPlace demande à ce que vous leur indiquiez des montants hors taxe pour l'ensemble des prix qui seront transmis. Cela concerne notamment les prix, prix en promotion, ecotaxe, frais de livraison. Vous pouvez appliquer des règles automatiques pour modifier vos montants depuis la solution. Dans ce cas vous devez utiliser la fonction {ttc2ht} permettant de passer les prix en HT (attention le calcul se base sur une TVA à 20).

Par exemple, vous pouvez passer par la règle automatique suivante pour passer votre prix de vente TTC en HT :

Autrement vous pouvez utiliser la fonction {division} :

Vous pouvez appliquer le même raisonnement pour l'ensemble de vos champs prix, vos frais de port et votre ecotax.

1.4 Gestion des soldes / promotions

Pour vos produits soldés / en promotions, renseignez les champs :

  • “Prix de vente HT” : l’ancien prix de vente du produit en HT
  • “Prix de vente discounte HT” : le prix de vente du produit en HT

1.5 Mapping des catégories

Vous devez maintenant utiliser le thésaurus PixPlace pour mapper vos catégories. L’objectif est d’indiquer dans quelles catégories PixPlace vous positionnez vos produits. Rendez-vous dans la Gestion des offres de votre flux puis cliquez sur le pictogramme permettant d’afficher le thésaurus PixPlace. Vous pouvez effectuer une recherche en cliquant sur la touche ctrl de votre clavier + la touche F dans votre navigateur. Sélectionnez la catégorie en cliquant sur son intitulé puis enregistrez la sélection.

Votre catégorie mappée est maintenant active.

1.6 Matching des marques PixPlace

1.6.1 Matching automatique et manuel

Vous devez effectuer un mapping par produit dans la gestion des offres de votre flux. Pour y accéder, cliquez sur le bouton vous permettant d’afficher le listing des produits par catégorie

Vous pourrez ensuite réaliser le matching des marques par produit de la façon suivante :

Pour information, il est nécessaire de matcher au moins un produit par marque avec le thésaurus de marque. Une fois que chaque marque a été matchée au moins une fois, il faut contacter notre support client Lengow pour lancer une routine qui va répercuter toutes les marques matchées sur tous les autres produits.

Nous proposons également des solutions pour vous faciliter le matching des marques

  • Vous pouvez demander au support client Lengow d'injecter l'id de marque PixPlace 701 (marque NONAME) pour l'ensemble des produits dont le matching de marque n'a pas fonctionné.
  • Autrement vous pouvez nous soumettre un fichier CSV contenant 2 colonnes séparées par un délimiteur point virgule (;)

1ère colonne : doit contenir l'intitulé exacte de votre champ marque

2ème colonne : doit contenir l'id de marque Pixplace à injecter

1.6.2 Marque PixPlace manquante

Si votre marque n’est pas présente dans le thésaurus de PixPlace, vous devez contacter PixPlace pour leur demander de l’ajouter. Cette nouvelle marque sera alors disponible sur Lengow dans un délai de 24h. Si ce n'est pas le cas, demandez à PixPlace l’identifiant de cette marque (Id_marque) ainsi que son intitulé. Il faudra alors l’envoyer à notre support client Lengow pour que nous l’ajoutions dans la solution.

2. Intégration de votre catalogue PixPlace

En coordination avec le support Pixplace et dans un souci de bonne intégration de votre catalogue sur cette place de marché, nous suivons chaque premier import pour nous assurer que tout fonctionne correctement. De ce fait, nous désactivons par défaut votre flux pour éviter tout import automatique sans notre suivi.

2.1 Création de vos produits

La création des produits se fait directement avec Pixplace. Il faut que vous leur transmettiez le flux optimisé que vous retrouvez dans Lengow. Il faut que toutes les optimisations soient bien en place pour que la création se fasse le plus rapidement possible.

A noter : Lorsque vous consultez le flux optimisé, vous remarquez que la ligne d'entête est vide. C'est normal. Référez-vous au champ du matching des champs pour savoir à quoi correspond chaque colonne.

2.2 Renseigner vos identifiants API

Dans l’onglet « Identifiants API » de la page Gestion de flux, vous pouvez indiquer votre Serial PixPlace. Ce Serial vous est transmis par votre chargé de compte PixPlace.

2.3 Publication des déclinaisons sur PixPlace

Lengow ne vous permettra pas de publier vos déclinaisons sur PixPlace. Nous ne générons pas le fichier “Tech Info” demandé par Pixplace et nécessaire à la mise en place des déclinaisons. Nos tests d'intégration de ce fichier via l'API n'ayant jamais aboutis.

Si vous souhaitez tout de même publier vos produits en mode déclinaison et gérer vous même l'upload d'un fichier "Tech Info" depuis votre back-office PixPlace, merci de nous le faire savoir en transmettant un mail à notre support client Lengow. Cela nécessitera un paramétrage particulier du flux.

3. Fonctionnement de l’API PixPlace

Nous transmettons 2 fichiers à PixPlace via l’API :

  • Matching EAN : Ce fichier contient tous les produits avec un EAN. Il permet la récupération des Fupids pour publication de vos produits. Ce fichier est envoyé tous les jours à 2h du matin.
  • Import PriceStock: Il contient les informations de prix, promotion, frais de livraison, quantité en stock… URL du fichier généré par Lengow > http://flux.lengow.com/marketplace/pixplace/#Id_Flux#/pixplace/IMPORT_PRICESTOCK/. Ce fichier est envoyé toutes les heures.

Si des mises à jour ne se font pas correctement, vous devez vérifier l’état du dernier import de ces fichiers dans votre interface PixPlace (visible dans « Gestion du catalogue » puis « dernier fichier importé »)

Vous pourrez également vérifier la bonne intégration de votre fichier dans Lengow, dans Gestion du Flux / Historique des indexations, en cliquant sur le bouton Report.

Un fichier txt s’ouvrira alors, et vous indiquera si vous avez des erreurs dans le flux.

Attention : Si le moindre produit pose problème le catalogue entier ne pourra être intégré. Si vous ne voyez pas d'import dans votre BO PixPlace alors que votre flux est actif sur Lengow, vérifiez :

  • que votre Serial PixPlace est bon
  • ue PixPlace vous a bien ouvert les droits en écriture pour l'utilisation de leur API
  • que PixPlace vous autorise à publier vos produits sur les segments choisis (catégorie Pixplace)

4. Gestion du catalogue

4.1 Mise à jour des produits

La mise à jour de votre catalogue sur PixPlace est calquée sur la fréquence d’indexation de votre flux source. Après chaque indexation du flux source, nous transmettons votre catalogue à PixPlace pour mise à jour (prix, stock, frais de port).

Pour une modification des titres, descriptifs ou visuels, il faut que vous contactiez Pixplace directement.

4.2 Suppression d’un produit

Pour supprimer un produit de Pixplace, vous devez le supprimer de votre flux source ou passer la quantité de ce produit à 0 via la gestion des offres de Lengow (en vous rendant sur la fiche produit)

5. Gestion des commandes PixPlace

5.1 Horaires de récupération des commandes

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

5.2 Types de commandes récupérées

Nous récupérons les commandes qui ont un statut OrderstoDeliver (ou Validated) et CheckOrder (ou Checked). Les commandes récupérées via l’API PixPlace changent automatiquement de statut pour passer en Checked dans votre interface PixPlace

5.3 Actions possibles sur les commandes

Aucune action sur les commandes PixPlace n'est possible depuis Lengow. Vous devez traiter vos commandes directement depuis votre back office PixPlace.

6. Liens Utiles

PixPlace met à votre disposition une documentation complète sur le fonctionnement de son API et sur ses services à partir de votre back office PixPlace.