Hepsiburada Marketplace Sync - Mise à jour automatique des stocks et des prix par API ou CSV

Votre boutique fait référence. C'est à la marketplace de suivre.

Vendre sur Hepsiburada, c'est maintenir trois informations à jour sur chaque annonce : le prix, le stock disponible et le délai d'expédition. À la main, cela veut dire réexporter un tableur chaque matin ; un jour d'oubli et vous vendez du stock que vous n'avez plus, ou vous restez à un prix que vous n'aviez pas l'intention de proposer. Ce module fait de votre catalogue PrestaShop la source unique et répercute les changements.

Deux modes de livraison, un seul générateur de lignes

• Export CSV — téléchargez un fichier reprenant exactement les colonnes attendues par l'outil d'import en masse d'Hepsiburada, dans le même ordre, et envoyez-le vous-même depuis le portail marchand.
• API Listing — saisissez vos identifiants et le module dialogue directement avec Hepsiburada. Pointez une tâche cron sur l'adresse fournie et les changements de stock et de prix partent tout seuls.

Les deux chemins passent par le même générateur de lignes : le fichier que vous téléchargez et les données envoyées par l'API concordent toujours. Si vous voulez vérifier ce que fait l'API, téléchargez le fichier.

Ce qu'il envoie — et ce à quoi il ne touche pas

L'équipe catalogue d'Hepsiburada est propriétaire de l'annonce elle-même : ce module ne modifie donc jamais vos noms de produits, descriptions, images, catégories ou attributs. Il envoie les champs qui appartiennent au marchand : prix hors taxes, stock disponible, délai d'expédition, libellés de transporteur et d'adresse, quantité maximale achetable, ainsi que le type et la longueur de la personnalisation. Rien de ce qui relève de leur catalogue n'est écrasé.

Des garde-fous, parce qu'un mauvais prix coûte cher

• Hold back (retenue de stock) — soustrayez une réserve de chaque quantité avant l'envoi. Réglez-la sur 2 et un produit ayant 5 en stock est proposé à 3 : une commande marketplace ne peut donc pas survendre ce que votre boutique vient d'écouler.
• Multiplicateur de prix — envoyez le prix boutique tel quel, ou ajoutez une marge pour couvrir la commission de la marketplace. Les valeurs supérieures à 10 sont rejetées comme des fautes de frappe plutôt que publiées.
• Never send a price below (ne jamais envoyer un prix inférieur à) — un plancher de sécurité. Les lignes en dessous sont retenues et signalées au lieu de partir en ligne au mauvais montant.
• Never offer more than (ne jamais proposer plus de) — plafonnez la quantité affichée sur la marketplace, quel que soit le contenu de l'entrepôt.

Les produits désactivés ou non disponibles à la commande sont envoyés avec un stock à zéro plutôt que retirés : ils cessent ainsi de se vendre sur la marketplace au lieu d'y rester silencieusement obsolètes.

Il vous dit ce qui ne peut pas être envoyé, et pourquoi

Le panneau d'état de l'onglet Getting started nomme les produits concernés au lieu de vous laisser deviner : ni SKU ni code stock, un prix qui tombe à zéro, un prix sous votre plancher, un nom manquant dans la langue d'export. Les SKU en double sont détectés avant l'envoi — Hepsiburada rejette un lot entier si l'un d'eux apparaît deux fois, et le repérer en amont évite un réenvoi complet. Le champ transporteur est validé face aux transporteurs publiés par Hepsiburada et alerte sur un nom inconnu, que leur système ignorerait autrement en silence.

Une synchronisation planifiée qui rend des comptes honnêtement

L'onglet Send affiche une adresse cron protégée par jeton. Pointez-y la tâche cron de votre hébergement — toutes les trente minutes est une cadence courante — et par défaut le module envoie uniquement ce qui a changé depuis la dernière exécution réussie ; les enregistrements de produits et les mouvements de stock marquent automatiquement les annonces comme modifiées. Ajoutez &mode=full pour tout renvoyer après qu'Hepsiburada a rejeté ou perdu un lot. Le point de terminaison répond en JSON, ce qui permet à un outil de supervision de distinguer une vraie panne d'une exécution sans changement ; les exécutions simultanées sont refusées pour qu'une exécution lente ne s'empile pas, et régénérer l'adresse invalide immédiatement l'ancienne si l'URL venait à fuiter.

Lier les produits, et les déclinaisons

Chaque annonce Hepsiburada possède un HepsiburadaSku. Collez-le dans l'onglet Hepsiburada de la fiche produit, ou utilisez Link products automatically (lier les produits automatiquement) si vos références PrestaShop correspondent déjà à vos codes stock marchand Hepsiburada. Les déclinaisons sont entièrement prises en charge : chacune est liée et tarifée séparément, car Hepsiburada traite chaque variante comme une annonce à part entière.

Ce que la version 2.0 a corrigé

La version 1.x calculait toujours le prix à partir de wholesale_price, que la plupart des boutiques laissent vide : tous les prix exportés valaient donc 0,00. La version 2.0 utilise par défaut le prix de vente, refuse purement et simplement d'exporter un prix nul, et alerte lorsque la source « prix d'achat » est sélectionnée sur un catalogue dépourvu de prix d'achat. La version 1.x écrivait aussi le SKU à chaque actionProductUpdate : n'importe quel autre enregistrement — un changement de stock, le web service, un autre module — l'effaçait silencieusement ; la 2.0 n'écrit que lorsque le formulaire produit portait réellement les champs. Les liens sont désormais stockés par boutique plutôt qu'un seul SKU par produit au niveau global et, comme la 1.x stockait des identifiants API sans jamais envoyer la moindre requête, la mise à jour laisse l'API désactivée jusqu'à ce que vous l'activiez délibérément.

Compatibilité

PrestaShop 1.7, 8 et 9, sans override, en huit langues : allemand, anglais, espagnol, français, italien, néerlandais, polonais et turc. Compatible multiboutique — les liens sont stockés par boutique, si bien qu'un même produit peut porter des SKU Hepsiburada différents selon la boutique, et la page de configuration indique toujours sur quelle boutique elle agit. La désinstallation supprime les tables et les réglages du module ; vos annonces Hepsiburada conservent les dernières valeurs reçues et cessent simplement d'être mises à jour.

Foire aux questions

Ai-je besoin de l'API, ou puis-je me contenter d'un fichier ?

Au choix. Téléchargez le CSV et envoyez-le depuis le portail marchand, ou activez l'API et laissez une tâche cron livrer les changements. Les deux produisent des données identiques.

Cela va-t-il modifier mes titres de produits ou mes images sur Hepsiburada ?

Non. Leur équipe catalogue en est propriétaire. Le module envoie uniquement le prix, le stock, le délai d'expédition, les libellés de transporteur et d'adresse, la quantité maximale et les réglages de personnalisation.

Comment éviter de survendre ?

Définissez une quantité de retenue. Chaque niveau de stock en est diminué avant l'envoi, si bien que la marketplace ne voit jamais vos toutes dernières unités.

De quels identifiants l'API a-t-elle besoin ?

Des identifiants de l'API Listing d'Hepsiburada, qui ne sont pas ceux de votre portail marchand — demandez-les à Hepsiburada. Une erreur 401 signifie que l'identifiant ou le mot de passe est erroné, 403 que le compte n'a pas accès à l'API Listing, et 404 que l'identifiant marchand est incorrect. Un bouton Test connection affiche leur message exact.

Gère-t-il les déclinaisons ?

Oui. Chaque déclinaison est liée et tarifée séparément, car Hepsiburada traite chaque variante comme une annonce à part entière.

Pourquoi tout mon envoi a-t-il été rejeté ?

Presque toujours à cause d'un SKU en double — Hepsiburada rejette le lot entier si l'un d'eux apparaît deux fois. Le panneau d'état repère les doublons avant l'envoi.

Tous mes prix en 1.x s'exportaient à zéro. Est-ce corrigé ?

Oui. La 1.x calculait le prix depuis le champ prix d'achat, que la plupart des boutiques laissent vide. La version 2.0 utilise le prix de vente par défaut et refuse purement et simplement d'exporter un prix nul.