Connecter votre boutique à un fournisseur par API : stock, tarifs et images à jour

Importer une fois le catalogue d'un fournisseur représente quelques jours de travail. Le tenir à jour est un travail sans fin : les prix changent, le stock s'épuise, de nouveaux coloris sortent, des références sont retirées. Si vous le faites à la main, votre boutique a toujours un temps de retard, et vous vendez ce qui n'existe plus ou à un prix qui n'est plus le bon.

Quand le fournisseur propose une API, la boutique peut l'interroger en continu. Cet article traite de cette synchronisation permanente ; si votre fournisseur ne vous fournit que des fichiers CSV ou XML, nous avons un autre guide consacré à ce cas.

Ce qui change avec une API par rapport à un fichier

• Des données en temps réel : le stock est consulté quand c'est nécessaire, pas quand le fournisseur génère le fichier.
• Des requêtes partielles : on peut demander uniquement le stock ou uniquement les prix, sans télécharger tout le catalogue.
• Des données riches : beaucoup de fournisseurs publient dans l'API des choses qui ne tiennent pas dans un CSV : tarifs par paliers, techniques de personnalisation, images par coloris, textes en plusieurs langues.
• Plus exigeant : il faut gérer l'authentification, les limites de requêtes, les erreurs réseau et les changements de version de l'API.

Quoi synchroniser et à quelle fréquence

Ce qui n'a pas de sens, c'est de télécharger tout le catalogue toutes les heures : vous chargez le serveur du fournisseur et le vôtre, et vous risquez de dépasser ses limites.

Prix d'achat n'est pas prix de vente

Le fournisseur vous donne son tarif ; c'est vous qui fixez votre prix. La connexion a besoin de règles claires :

• Une marge par catégorie, marque ou tranche de prix, et non une marge unique pour tout.
• Des paliers par quantité : dans des secteurs comme le textile ou l'objet publicitaire, le coût baisse fortement au-delà d'un certain volume. Ces paliers doivent devenir des prix par quantité dans votre boutique.
• Des arrondis qui évitent des prix comme 12,37 €.
• Des prix auxquels on ne touche pas : si vous avez baissé un produit à la main pour une campagne, la synchronisation ne devrait pas l'écraser sans prévenir.

Stock : le vôtre et celui du fournisseur

Si vous avez aussi de la marchandise dans votre entrepôt, mélanger votre stock et celui du fournisseur en un seul chiffre trompe le client : « je l'ai et il part aujourd'hui » n'est pas la même chose que « je le commande à l'usine et cela prend une semaine ». La bonne pratique est de les séparer et d'afficher un délai différent selon la provenance de chaque unité. Et de décider quoi faire quand la quantité demandée dépasse la somme des deux : bloquer la vente ou demander au client de prendre contact pour un devis.

Déclinaisons, langues et images

• Coloris et tailles doivent devenir des déclinaisons PrestaShop associées aux attributs que vous avez déjà, et non de nouveaux attributs en double (« Rouge », « rouge », « ROUGE »).
• Des images par coloris, associées à leur déclinaison.
• Des textes dans chaque langue active de votre boutique, si le fournisseur les publie.
• Catégories : l'arborescence du fournisseur n'est pas la vôtre. Il faut faire correspondre ses catégories aux vôtres.
• Caractéristiques (matière, dimensions) sous forme de caractéristiques PrestaShop, pour qu'elles fonctionnent dans les filtres.

Personnalisation

Dans l'objet publicitaire ou le textile personnalisé, le produit ne se vend pas seul : il se vend avec un marquage. Le fournisseur publie les techniques, les zones, le nombre de couleurs et les coûts (souvent avec des frais fixes de préparation). Les reprendre dans la boutique permet au client de choisir la technique et de voir le prix final calculé, au lieu de demander un devis pour tout.

Erreurs fréquentes

1. Écraser ce que vous avez amélioré : des textes SEO ou des photos propres que la synchronisation remplace à nouveau par ceux du fournisseur.
2. Ne pas enregistrer ce qui change : sans historique, vous ne savez pas pourquoi un prix a augmenté.
3. Synchroniser aux heures de pointe et ralentir la boutique.
4. Ne pas alerter quand l'API est en panne : la synchronisation s'arrête et personne ne s'en aperçoit jusqu'à ce qu'on vende un produit épuisé.
5. Des identifiants dans le code : les clés de l'API vont dans la configuration, jamais dans des fichiers qu'on copie ou qu'on envoie sur un dépôt.

Check-list

1. Vous savez quelles données fournit l'API et avec quelles limites.
2. Des règles de prix par catégorie et des paliers par quantité.
3. Stock propre et stock du fournisseur séparés, avec des délais différents.
4. Les produits retirés sont désactivés, pas supprimés.
5. Attributs et catégories mis en correspondance avec les vôtres.
6. Historique des changements et alerte en cas d'échec de la synchronisation.

Comment le résoudre dans PrestaShop

RKR Conector Makito est un exemple de ce type de connexion : un paquet comprenant un hub qui compare et écrit dans la boutique, le connecteur à l'API de Makito, un module optionnel de multiples de vente et RKR Supplier Stock (optionnel, PrestaShop 9). Il récupère les quatre paliers de tarif du fournisseur (à l'unité et à partir de 500, 2 000 et 5 000 unités) convertis en prix de vente selon vos règles et en prix par quantité, les textes, coloris et caractéristiques dans les sept langues que publie Makito, et permet au client d'ajouter au panier le produit avec son marquage et le prix déjà calculé. Avec RKR Supplier Stock, votre stock et celui de Makito sont conservés séparément, par déclinaison, avec des messages et des délais différents pour chaque cas, et par défaut on ne vend pas plus que la somme des deux. Sans ce module, le connecteur fonctionne de PrestaShop 1.7.6 à 9.x. Pour d'autres fournisseurs, les connecteurs sur mesure qui accompagnent cet article suivent la même approche.