Intégration de l'API Hepsiburada avec Odoo : guide de configuration complet

Le paysage du commerce électronique turc comporte deux plates-formes dominantes, et Hepsiburada est celle que tout vendeur sérieux doit maîtriser. Créée en 2000, Hepsiburada est la place de marché en ligne la plus ancienne et l'une des plus fiables de Turquie, avec plus de 100 millions de visites mensuelles, plus de 65 000 vendeurs et un catalogue de produits couvrant toutes les catégories de consommateurs, de l'électronique et de la mode aux pièces automobiles et fournitures industrielles. Pour les vendeurs qui gèrent leurs opérations sur Odoo ERP, l'intégration à Hepsiburada via son API robuste est la voie vers une vente efficace et évolutive sur le marché turc.

Points clés à retenir

• Hepsiburada reçoit plus de 100 millions de visites mensuelles et est le marché le plus visité de Turquie
• La plateforme héberge plus de 65 000 vendeurs avec plus de 50 millions de références de produits
• Hepsiburada est devenue publique au NASDAQ en 2021, démontrant une infrastructure de marché de niveau institutionnel
• L'API HepsiBurada (HBAPI) fournit des points de terminaison d'intégration complets pour les produits, les commandes, les stocks et les réclamations
• Le connecteur d'ECOSIRE gère la localisation turque, la conformité fiscale KDV et l'intégration multi-cargo
• Les vendeurs intégrés à l'API obtiennent un traitement des commandes 40 % plus rapide et 90 % d'erreurs d'inventaire en moins

---

Pourquoi Hepsiburada est important

Alors que Trendyol est leader en matière de mode et de volume de commandes quotidiennes, Hepsiburada possède des avantages distincts dans les catégories de l'électronique, de l'électroménager, de l'automobile et de l'industrie. La réputation de confiance des consommateurs de la plateforme, bâtie sur 25 ans d'activité, lui confère une clientèle fidèle qui chevauche mais diffère du public de Trendyol. La plupart des vendeurs de commerce électronique turcs à succès opèrent sur les deux plates-formes, ce qui fait de l'intégration d'Hepsiburada aux côtés de Trendyol une exigence standard.

Statistiques Hepsiburada (2025-2026)

Position concurrentielle d'Hepsiburada

Hepsiburada se différencie par :

• Confiance : 25 années d'activité ont permis d'établir une profonde confiance des consommateurs, en particulier pour les achats de grande valeur
• Force de l'électronique : part de marché leader dans les domaines de l'électronique grand public, de l'informatique et des appareils mobiles
• HepsiJet logistique : réseau logistique interne avec livraison le jour même dans les grandes villes
• HepsiPay : système de paiement intégré avec options de versement (critique sur le marché turc axé sur les versements)
• Ventes aux entreprises : segment de marché B2B pour les achats professionnels
• Hepsiglobal : programme de vente transfrontalière atteignant les marchés internationaux

---

API Hepsiburada (HBAPI) Analyse approfondie

Hepsiburada fournit une API REST bien structurée qui permet une intégration complète des vendeurs. La documentation de l'API est disponible en anglais (contrairement à certaines API de plateforme turque), la rendant accessible aux équipes de développement internationales.

###Architecture des API

Le HBAPI est organisé en domaines de services :

Service d'annonce

• Créer des listes de produits avec des ensembles d'attributs complets
• Gérer les variantes (couleur, taille, modèle, capacité)
• Gérer le téléchargement et la commande des images
• Carte de la taxonomie des catégories d'Hepsiburada
• Gérer le statut de l'annonce (actif, passif, verrouillé)
• Gérer les exigences en matière de codes-barres (GTIN/EAN)

Service de commande

• Récupérer les nouvelles commandes (commandes packables)
• Accéder aux détails de la commande (articles, quantités, adresses)
• Mettre à jour le statut des lignes de commande (picking, facturé, expédié)
• Créer des colis et affecter des sociétés de fret
• Gérer l'exécution partielle (expédier les articles disponibles en premier)

Service d'inventaire

• Mettre à jour les quantités de stock par listing par entrepôt
• Définir l'état de disponibilité
• Gérer l'allocation des stocks multi-entrepôts

Service de réclamation

• Traiter les réclamations des acheteurs (article erroné, endommagé, manquant)
• Soumettre des réponses à la réclamation avec des preuves
• Suivre les résultats des réclamations et l'impact financier

Service financier

• Accéder aux rapports de règlement
• Afficher la répartition des commissions
• Suivre les pénalités et les déductions d'ajustement
• Télécharger les factures et les documents financiers

Authentification

HBAPI utilise l'authentification de base HTTP avec un identifiant de commerçant, un nom d'utilisateur et un mot de passe fournis via le panneau de marchand Hepsiburada. Certains points de terminaison nécessitent une liste blanche IP supplémentaire pour des raisons de sécurité.

Limites de débit et bonnes pratiques

• Limites de débit standard : 100 requêtes par minute et par point de terminaison
• Mises à jour des stocks : opérations par lots recommandées (jusqu'à 100 SKU par demande)
• Sondage des commandes : recommandé toutes les 10 minutes
• Création de produits : Limitée à 500 nouvelles inscriptions par heure en période de pointe

---

Architecture d'intégration

Pipeline de traitement des commandes

Le cycle de vie des commandes d'Hepsiburada diffère légèrement de celui des autres marchés. Les commandes passent par une machine à états spécifique :

New → Picking → Invoiced → Packaged → Shipped → Delivered
  ↓        ↓         ↓          ↓
Cancel  Re-stock  [Skip if    Tracking
                   digital]    Push

L'intégration doit respecter cette machine à états : sauter des états ou mettre à jour dans le désordre entraîne des erreurs d'API et des échecs potentiels de traitement des commandes.

Composant 1 : Intégration de la liste de produits

La création et la gestion d'annonces sur Hepsiburada nécessitent une attention particulière aux exigences spécifiques à la plateforme :

• Attributs de catégorie : chaque catégorie possède des attributs obligatoires et facultatifs. L'électronique nécessite une marque, un modèle, des spécifications techniques et une période de garantie. La mode nécessite un tableau des tailles, du matériel et des instructions d'entretien.
• Exigence relative aux codes-barres : tous les produits physiques doivent avoir des codes-barres GTIN/EAN valides. L'intégration doit valider le format du code-barres avant la soumission
• Exigences relatives aux images : minimum 500 x 500 pixels, fond blanc pour l'image principale, jusqu'à 8 images par annonce
• Vérification de la marque : Les marques doivent être approuvées sur Hepsiburada avant que les produits puissent être répertoriés. L'intégration doit vérifier le statut d'approbation de la marque avant de tenter de créer une annonce.
• Langue du contenu : tout le contenu de l'annonce doit être en turc pour le marché national

Le connecteur mappe les données des produits Odoo au format de liste d'Hepsiburada, valide les attributs obligatoires et gère la conversion du format d'image.

Composant 2 : Importation des commandes et gestion de l'état

Le connecteur interroge HBAPI pour les nouvelles commandes packables et crée des commandes de vente Odoo avec :

• Cartographie complète des produits et des variantes
• Adresse de livraison du client
• ID au niveau de la commande et au niveau de la ligne pour le suivi des mises à jour de l'état
• Informations sur le mode de paiement
• Exigences SLA de livraison

Les mises à jour de l'état suivent la séquence requise par Hepsiburada :

1. Picking : confirmez la réception de la commande et démarrez le traitement en entrepôt
2. Facture : générer et enregistrer la facture (obligatoire avant l'emballage)
3. Emballé : créez un colis avec les dimensions, le poids et la société de fret assignée
4. Expédié : envoyez le numéro de suivi du fret

Chaque transition d'état appelle l'HBAPI avec les données appropriées et le connecteur gère les tentatives en cas d'échecs transitoires.

Composante 3 : Gestion des stocks

La disponibilité des stocks est transmise d'Odoo à Hepsiburada via des appels API par lots :

• Quantités de stock par SKU mises à jour toutes les 15 à 30 minutes
• Tampons de sécurité appliqués pour les vendeurs multicanaux
• Articles sans stock automatiquement désactivés sur Hepsiburada
• La restauration du stock déclenche une réactivation automatique

La coordination des stocks d'Hepsiburada avec d'autres canaux de vente nécessite l'approche centralisée décrite dans notre guide de synchronisation des stocks en temps réel.

Composante 4 : Fret et logistique

Hepsiburada prend en charge plusieurs options de fret :

• HepsiJet : réseau logistique propre à Hepsiburada (livraison le jour même dans les grandes villes)
• Yurtic Kargo : le plus grand transporteur de fret de Turquie
• Aras Kargo : couverture nationale avec des prix compétitifs
• MNG Kargo : Fort dans la livraison d'articles en entreprise et encombrants
• Surat Kargo : option économique pour les livraisons standard
• UPS Turquie : Pour les livraisons internationales et premium

Le connecteur s'intègre au module d'expédition d'Odoo pour attribuer le transporteur approprié en fonction de règles configurables (catégorie de produit, destination, poids, urgence) et transmet les informations de suivi à Hepsiburada.

Composante 5 : Réclamations et SAV

Le système de réclamation d'Hepsiburada gère les litiges des acheteurs :

• Mauvais article : l'acheteur a reçu un produit différent de celui commandé
• Endommagé : Le produit est arrivé endommagé
• Articles manquants : livraison de la commande incomplète
• Qualité : le produit ne correspond pas à la description de l'annonce

Le connecteur importe les réclamations dans le module d'assistance d'Odoo, permettant à votre équipe de service client d'examiner les preuves, de soumettre des réponses et de suivre les résultats, le tout depuis Odoo. La qualité de la résolution des réclamations a un impact sur le score du vendeur, ce qui rend un traitement efficace essentiel.

Composante 6 : Règlement financier

Les règlements bihebdomadaires comprennent :

• Chiffre d'affaires brut par ligne de commande
• Commissions spécifiques à la catégorie (6-18%)
• Frais de logistique HepsiJet
• Frais de service (inscription, transaction)
• Déductions de pénalités (expédition tardive, annulation, sinistres pertes)
• Contributions promotionnelles

Le connecteur crée des écritures de journal détaillées pour chaque composant de règlement, permettant une analyse précise de la rentabilité par produit et par catégorie dans Odoo.

---

Guide de configuration

Étape 1 : Compte marchand Hepsiburada

1. Inscrivez-vous sur le panel de marchands Hepsiburada
2. Compléter la vérification d'identité et fiscale
3. Demandez l'accès à l'API et recevez les informations d'identification (ID marchand, nom d'utilisateur, mot de passe)
4. Soumettez la liste blanche IP pour l'accès à l'API
5. Demandez des approbations de marque pour vos marques de produits

Étape 2 : Configuration d'Odoo

1. Localisation en turc : installez des modules de comptabilité, de fiscalité et de documents spécifiques à la Turquie
2. Devise : configurez TRY avec des mises à jour automatiques des taux de change
3. Configuration KDV (TVA) : configurez les taux de taxe (1 %, 10 %, 20 %) par catégorie de produits
4. Canal de vente : Créer une équipe commerciale "Hepsiburada"
5. Client : Créer une fiche client "Hepsiburada Marketplace"
6. Transporteurs : configurez HepsiJet et les sociétés de fret agréées dans le module de livraison Odoo
7. Comptes : créez des comptes de dépenses pour les commissions, les frais de logistique et les pénalités

Étape 3 : Installer le connecteur ECOSIRE

Déployez le connecteur ECOSIRE Hepsiburada :

1. Installer via les applications Odoo
2. Accédez à Paramètres > Intégration Hepsiburada
3. Saisissez l'identifiant du marchand, le nom d'utilisateur API et le mot de passe
4. Configurez la liste blanche IP si nécessaire
5. Définissez les intervalles de synchronisation :

• Commandes : toutes les 10 minutes
• Inventaire : toutes les 15 minutes
• Produits : toutes les 4 heures ou manuel

6. Mapper les catégories de produits à la taxonomie d'Hepsiburada

Étape 4 : Configuration de la liste de produits

1. Mappez les produits Odoo aux catégories Hepsiburada avec des attributs obligatoires
2. Vérifiez les codes-barres GTIN/EAN pour tous les produits
3. Préparer le contenu du produit en langue turque
4. Téléchargez des images de produits conformes
5. Fixez la tarification TRY avec des marges tenant compte des commissions
6. Synchronisez le catalogue initial et surveillez l'approbation de la liste

Étape 5 : Configuration du flux de travail des commandes

1. Configurer l'importation des commandes et la gestion de l'état
2. Définir les règles d'affectation des entrepôts pour les commandes Hepsiburada
3. Configurer la génération de facture (obligatoire avant le packaging dans le flux Hepsiburada)
4. Configurer les règles d'affectation des marchandises
5. Testez le traitement des commandes de bout en bout

Étape 6 : Configuration financière

1. Cartographier les taux de commission par catégorie de produits
2. Configurer le calendrier d'importation des règlements
3. Créez des comptes de dépenses spécifiques aux frais
4. Définir la tolérance de rapprochement pour les écarts mineurs

---

Défis spécifiques à Hepsiburada

Défi 1 : Exigence de facturation avant le colis

Hepsiburada exige que les vendeurs génèrent une facture avant de créer un colis d'expédition – une séquence qui diffère de la plupart des marchés où la facturation a lieu après ou simultanément avec l'expédition.

Solution : Le connecteur automatise l'étape de génération de facture dans Odoo, créant et enregistrant la facture dès la confirmation du picking. Cela garantit que la séquence d'état correcte (Prélèvement > Facturé > Emballé > Expédié) est toujours suivie.

Défi 2 : Culture du paiement échelonné

La Turquie a une forte culture de paiement échelonné : les consommateurs paient souvent leurs achats en 3, 6, 9 ou 12 mensualités. Tandis qu'Hepsiburada et HepsiPay gèrent la relation de paiement échelonné avec le consommateur, les vendeurs reçoivent le paiement intégral (moins les commissions) selon les conditions de règlement normales.

Solution : Le connecteur enregistre correctement le montant total du paiement dans Odoo quel que soit le plan de versement du consommateur. La structure des échéances est enregistrée à titre informatif mais n'affecte pas le traitement comptable du vendeur.

Défi 3 : Complexité transfrontalière d'Hepsiglobal

Le programme Hepsiglobal d'Hepsiburada permet la vente transfrontalière, en introduisant une tarification multidevises, une logistique d'expédition internationale et des exigences en matière de documentation douanière.

Solution : Le connecteur prend en charge Hepsiglobal avec des configurations de tarification distinctes par marché cible, l'intégration des transporteurs internationaux et la génération de documentation douanière via Odoo.

Défi 4 : Forte concurrence dans l'électronique

L'électronique est la catégorie la plus forte d'Hepsiburada, mais c'est aussi la plus compétitive. La sensibilité aux prix est extrême et la concurrence Buy Box nécessite une réactivité en matière de prix en temps réel.

Solution : le connecteur prend en charge les règles de tarification qui s'ajustent en fonction de la position concurrentielle et des marges planchers. Les mises à jour des prix peuvent être déclenchées plus fréquemment pour les catégories très concurrentielles tout en maintenant des garde-fous en matière de rentabilité.

Défi 5 : Pics de demande saisonniers

Le commerce électronique turc connaît d'importants pics de demande au cours du 11.11 (Journée des célibataires), du Black Friday et des périodes de shopping précédant le Ramadan. Les volumes de commandes peuvent augmenter de 3 à 5 fois lors de ces événements.

Solution : le connecteur prend en charge les configurations en mode pointe avec une fréquence de synchronisation accrue, des tampons de sécurité plus importants et des alertes de capacité automatisées. Les listes de contrôle préalables à l'événement garantissent que les stocks, les prix et la capacité d'exécution sont préparés avant les pics de demande.

---

Manuel vs connecteur ECOSIRE

---

Stratégie double plateforme : Hepsiburada + Trendyol

Les vendeurs de commerce électronique turcs les plus performants opèrent simultanément sur Hepsiburada et Trendyol. Les deux plateformes ont des atouts différents :

• Hepsiburada : Plus fort dans l'électronique, l'électroménager, le B2B. Groupe démographique plus âgé et aux revenus plus élevés
• Trendyol : Plus fort dans la mode, la beauté et l'épicerie. Une population plus jeune et axée sur le mobile

Exécuter les deux depuis Odoo nécessite :

1. Inventaire unifié : pool de stocks unique réparti sur les deux plates-formes avec tampons de sécurité
2. Tarifs spécifiques à la plateforme : différents taux de commission et dynamique concurrentielle par plateforme
3. Suivi des performances séparé : chaque plateforme possède son propre algorithme de score du vendeur
4. Rapports consolidés : comparaison des revenus, de la marge et des performances multiplateformes

Le connecteur ECOSIRE prend en charge la configuration multiplateforme Odoo, et notre guide de gestion multi-marketplace couvre la stratégie opérationnelle en détail.

---

Services d'intégration ECOSIRE

Les services d'intégration Odoo d'ECOSIRE fournissent un support complet aux vendeurs Hepsiburada :

• Déploiement et configuration du connecteur de bout en bout
• Localisation turque (KDV, comptabilité, facture électronique)
• Conception de flux de travail d'exécution personnalisé
• Intégration et optimisation des transporteurs de fret
• Configuration double plateforme (Hepsiburada + Trendyol depuis un Odoo)
• Formation du personnel et accompagnement continu

Parcourez le catalogue de connecteurs de marché d'ECOSIRE pour toutes les intégrations disponibles.

---

Questions fréquemment posées

Le connecteur prend-il en charge HepsiJet et d'autres sociétés de fret turques ?

Oui. Le connecteur s'intègre à HepsiJet, Yurtic Kargo, Aras Kargo, MNG Kargo, Surat Kargo et UPS Turkey. L'attribution du transporteur est basée sur des règles (vous configurez des règles pour la catégorie de produit, le poids, la destination et l'urgence) et les numéros de suivi sont automatiquement transmis à Hepsiburada à partir du module de livraison d'Odoo.

Comment sont gérés les impôts turcs (KDV) ?

Le connecteur mappe les catégories de produits Hepsiburada au taux KDV correct (1 %, 10 % ou 20 %). Les factures générées dans Odoo comportent les calculs de taxes appropriés, et le rapprochement des règlements valide les montants de taxes par rapport aux enregistrements d'Hepsiburada. Le format de facture électronique turc (e-Fatura) est pris en charge pour la conformité réglementaire.

Que se passe-t-il si l'appel API échoue lors de la mise à jour de l'état de la commande ?

Le connecteur implémente une logique de nouvelle tentative avec une interruption exponentielle pour les échecs transitoires de l'API. Si une mise à jour de l'état échoue après les tentatives, la commande est signalée dans Odoo pour une attention manuelle et une alerte est envoyée au contact des opérations configuré. Le système suit les mesures de fiabilité des API pour identifier les problèmes systémiques.

Quelles versions d'Odoo sont prises en charge ?

Le connecteur ECOSIRE Hepsiburada prend en charge Odoo 17, 18 et 19 (éditions Community et Enterprise). Les fonctionnalités de localisation turque sont fournies avec le module.

---

Conclusion

La combinaison d'un trafic massif, de la confiance des consommateurs bâtie sur 25 ans et d'un positionnement solide dans des catégories à forte valeur ajoutée en fait un canal de vente essentiel pour tout vendeur ciblant le marché turc. L'API structurée de la plateforme fournit une base solide pour l'automatisation, mais l'intégration doit respecter les exigences spécifiques d'Hepsiburada : la machine d'état des commandes, le flux de travail de facturation avant colis, l'intégration du fret et le traitement des réclamations ont tous des nuances spécifiques à la plateforme.

Les vendeurs qui investissent dans une bonne intégration Hepsiburada-Odoo bénéficient d'un avantage cumulatif : un traitement plus rapide des commandes améliore les scores des vendeurs, ce qui augmente la visibilité, ce qui génère davantage de commandes - un cercle vertueux alimenté par l'efficacité opérationnelle. Ceux qui s'appuient sur des processus manuels constatent le contraire : un traitement lent entraîne une dégradation des scores, une visibilité réduite et une baisse des ventes.

La voie à suivre est claire. Que vous établissiez votre première présence Hepsiburada ou que vous développiez une opération existante, la connexion de la plateforme à votre ERP Odoo via le connecteur spécialement conçu par ECOSIRE élimine les frictions opérationnelles qui limitent la croissance et érodent les marges.