Aperçu de l'intégration Hepsiburada 2026 — Lecture rapide
Hepsiburada est la plateforme e-commerce historique de Turquie : fondée en 2000 par Hanzade Doğan Boyner, cotée au NASDAQ:HEPS en juillet 2021 et double-cotée à la BIST:HEPSI en 2022. En 2026, elle sert 13 M+ de clients actifs et 60 K+ vendeurs actifs, exploite le réseau de transport propriétaire HepsiJet (1 500+ points de retrait, livraison le jour même dans les grandes métropoles) et l'équivalent FBA HepsiLojistik. L'intégration API utilise un schéma REST sur mpop.hepsiburada.com, piloté par le panneau vendeur HMS (Hepsiburada Marketplace Service). Les commissions vont de 8 à 22 % selon la catégorie ; l'émission de la GİB e-Fatura, la protection des données KVKK et l'enregistrement ETBİS sont obligatoires pour les vendeurs turcs.
1. Architecture de l'API Hepsiburada 2026
REST sur mpop.hepsiburada.com
L'API vendeur de Hepsiburada est un pur service REST/JSON hébergé sous l'hôte parapluie mpop.hepsiburada.com (mpop = « Merchant Platform Open API »). Il n'existe pas de variante GraphQL ou gRPC. Tout le trafic authentifié passe par HTTPS, rattaché à un Merchant ID délivré lors de l'onboarding HMS. La surface de l'API est répartie en sous-domaines logiques plutôt qu'en un seul root monolithique :
listing-external.hepsiburada.com— CRUD des annonces (prix, stock, statut de l'annonce)mpop.hepsiburada.com/product/api/products— création de produits et attributs de catégorieoms-external.hepsiburada.com— gestion des commandes (commandes, colis, expéditions)returns-external.hepsiburada.com— retours et remboursementsintegration.hepsiburada.com/finance— dépôt de factures et rapprochement financier
Chaque sous-domaine partage le même schéma d'authentification HTTP Basic mais expose ses propres limites de débit et conventions de pagination. Le connecteur HB de Zunapro masque cet éclatement derrière une interface unique normalisée.
Authentification : HTTP Basic via HTTPS
Contrairement à l'API légèrement plus permissive de Trendyol ou au flux OAuth SP-API d'Amazon, Hepsiburada utilise un schéma HTTP Basic auth délibérément simple : l'en-tête Authorization porte Basic base64(username:password), où username est votre clé API et password le secret associé. Chaque requête doit aussi porter un en-tête User-Agent incluant votre Merchant ID. Les valeurs User-Agent manquantes ou malformées sont de loin la cause la plus fréquente de 401 Unauthorized en production.
GET /listings/merchantid/{MERCHANT_ID}/sku/{MERCHANTSKU}
Host: listing-external.hepsiburada.com
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
User-Agent: {MERCHANT_ID} - SelfIntegration
Accept: application/jsonHMS — Le panneau Hepsiburada Marketplace Service
Le panneau HMS sur merchant.hepsiburada.com est la console web opérationnelle couplée à l'API. Chaque capacité de l'API a un équivalent HMS — édition d'annonces, acceptation de commandes, émission de remboursements, rapprochement financier — et HMS est le seul endroit où vous provisionnez les clés API, configurez les adresses de retrait HepsiJet et gérez les autorisations des utilisateurs. La refonte HMS 2024–2026 a apporté une navigation gauche unifiée, des rapports de règlement en temps réel et un nouveau tableau de bord « API Health » qui expose les taux 4xx/5xx par point de terminaison, précieux pour déboguer une intégration.
Limites de débit et idempotence
Hepsiburada applique des limites de débit généreuses mais imposées — généralement ~30 requêtes/seconde par marchand sur les mises à jour d'annonces et plus basses (~10/s) sur les points de terminaison de commandes. Les imports de produits en masse sont limités séparément et renvoient 202 Accepted avec un trackingId ; vous interrogez ensuite /import/{trackingId} jusqu'à achèvement. L'API de commandes prend en charge l'idempotence via les identifiants de colis et de commande qui restent stables entre les lectures.
Évitez la plomberie de l'API — connectez-vous via Zunapro
Ne gaspillez pas un sprint sur les en-têtes User-Agent, les sous-domaines éclatés et le polling de trackingId. Le connecteur Hepsiburada certifié de Zunapro gère l'authentification, les retries, la limitation de débit et le rapprochement des webhooks clés en main.
2. Connexion via l'API REST — étape par étape
Prérequis : compte HMS & ETBİS
Avant tout appel API, une entreprise enregistrée en Turquie disposant d'un vergi numarası (numéro fiscal), d'un enregistrement ETBİS (Elektronik Ticaret Bilgi Sistemi — le registre des entreprises e-commerce du ministère du Commerce) et d'un IBAN turc (TR…) doit s'onboarder via HMS. La vérification KYC est généralement validée en 1 à 3 jours ouvrés pour les entités enregistrées à l'ETBİS ; les vendeurs non-ETBİS sont dirigés vers une file de revue manuelle pouvant prendre 1 à 2 semaines.
Onboarding API étape par étape
- Créez un compte HMS sur
merchant.hepsiburada.comavec votre vergi numarası et votre IBAN. Téléversez votre certificat ETBİS, votre circulaire de signature (imza sirküleri) et votre document fiscal. - Générez les identifiants API sous Hesabım → Entegrasyon Bilgileri → API Anahtarı. Le système renvoie un nom d'utilisateur, un mot de passe et votre Merchant ID stable. Stockez les secrets dans un coffre — Hepsiburada n'affichera plus le mot de passe.
- Autorisez les IP sortantes si votre plateforme d'intégration l'exige. Zunapro publie une plage d'IP d'egress fixe afin que les vendeurs puissent l'épingler sur la liste d'autorisation HMS.
- Testez avec une lecture d'annonce — appelez
GET /listings/merchantid/{MERCHANT_ID}et confirmez un200 OKavec votre inventaire existant. - Abonnez-vous aux webhooks pour les événements de commande :
POST /webhook-subscriptionsavec votre URL de callback et les types d'événements (order.created,order.cancelled,return.created). - Poussez votre premier produit via
POST /product/api/products/import— Hepsiburada renvoie un trackingId ; interrogez-le jusqu'àstatus:DONE. - Passez en production — basculez l'intégration sur « Aktif » dans HMS une fois les tests réussis.
En-têtes et pièges courants
La régression d'intégration la plus fréquente est un User-Agent manquant ou malformé. Hepsiburada exige strictement le format {MERCHANT_ID} - {AppName} ; un User-Agent par défaut axios/1.6 ou okhttp/4 renvoie 401 Unauthorized sans corps descriptif. Définissez toujours le User-Agent explicitement et journalisez-le dans votre middleware de requête.
3. Synchronisation des produits — arbre de catégories, attributs, variantes
L'arbre de catégories
Le catalogue de Hepsiburada est organisé en un arbre de catégories strict de trois à cinq niveaux exposé via GET /product/api/categories/get-all-categories. Chaque produit doit correspondre à un ID de catégorie de niveau feuille ; les nœuds intermédiaires sont rejetés avec VALIDATION_ERROR. La refonte des catégories de 2024 a fusionné plusieurs nœuds hérités (les « Bluetooth Kulaklık » et « Kablosuz Kulaklık » listés séparément ont été fusionnés en « Kablosuz Kulaklık & Bluetooth »), de sorte que toute intégration plus ancienne nécessite un rafraîchissement du mappage de catégories.
Les attributs obligatoires bloquent l'approbation
Chaque catégorie expose une liste d'attributs obligatoires et facultatifs via GET /product/api/categories/{categoryId}/attributes. Contrairement à Trendyol, Hepsiburada traite les attributs obligatoires manquants comme un blocage strict de l'annonce — le produit passe à l'état WAITING_FOR_APPROVAL et n'atteint jamais « Active » tant que chaque attribut requis n'est pas renseigné avec une valeur de recherche valide. Coupables fréquents :
- Marque — doit correspondre exactement au registre des marques de Hepsiburada ; « Apple » et « APPLE » sont des ID différents
- Couleur, taille, capacité — issues de vocabulaires contrôlés, pas de texte libre
- Durée de garantie — requise pour l'électronique, exprimée en mois sous forme d'énumération
- Pays d'origine (Menşei) — requis pour les cosmétiques, l'alimentation, les compléments
Variantes : séparation annonce & produit
Hepsiburada utilise une séparation produit vs annonce plus stricte que la plupart des concurrents. Un seul produit (HB-SKU, identifiant interne) peut avoir de nombreuses annonces (merchantSku) — une par vendeur, avec son propre prix, stock, état (neuf/reconditionné) et garantie. Pour les produits à variantes (par ex. un T-shirt en S/M/L × Rouge/Bleu/Noir), chaque combinaison est un nœud produit distinct, éventuellement regroupé sous un varyantGroupID afin que la page produit affiche les échantillons de couleur et de taille.
Import en masse via trackingId
Les pushs de catalogue en production utilisent POST /product/api/products/import avec un tableau de jusqu'à 100 produits par requête. L'API renvoie un trackingId ; les intégrateurs doivent interroger GET /product/api/products/import/{trackingId} jusqu'à ce que le statut soit DONE, puis parcourir les résultats ligne par ligne pour repérer les erreurs de validation. Zunapro regroupe les imports par lots de 100 lignes, réessaie les échecs légers et expose des rapports d'erreurs au niveau de la ligne dans le panneau vendeur.
POST /product/api/products/import
Host: mpop.hepsiburada.com
Authorization: Basic ...
User-Agent: {MERCHANT_ID} - Zunapro
{
"merchant": "{MERCHANT_ID}",
"items": [{
"merchantSku": "ZP-TSHIRT-RED-M",
"categoryId": 18021982,
"productName": "Premium Pamuklu T-Shirt — Kırmızı M",
"brand": "Zuna",
"attributes": [
{"name":"Renk","value":"Kırmızı"},
{"name":"Beden","value":"M"}
],
"price": 249.90,
"availableStock": 87,
"varyantGroupID": "ZP-TSHIRT-2026"
}]
}4. Gestion des commandes — webhooks, flux de statut, étiquettes
Le cycle de vie de la commande
Une commande Hepsiburada traverse une machine à états fixe que chaque intégration doit implémenter. Les statuts comptent — des transitions prématurées déclenchent des points de pénalité contre votre score vendeur :
- Open — commande reçue, en attente d'acceptation (SLA de 24 heures sur la plupart des catégories, 48 h pour les meubles)
- InProgress / Picking — vendeur ayant accusé réception, préparation et emballage
- Packaged — colis créé via l'API, en attente de remise au transporteur
- Shipped — le transporteur a scanné le colis ; numéro de suivi actif
- Delivered — livraison du dernier kilomètre confirmée
- Cancelled / Returned — portail de retour initié par le client ou le marchand
Webhook vs polling
Hepsiburada prend en charge à la fois les webhooks (préférés) et le polling. Les webhooks sont configurés par Merchant ID dans HMS ou via POST /webhook-subscriptions ; la plateforme pousse des événements JSON vers votre point de terminaison HTTPS avec des signatures HMAC dans l'en-tête X-HB-Signature. Le polling se rabat sur GET /orders?status=Open&offset=0&limit=100 sur un cron de 30 à 60 secondes. Zunapro utilise par défaut les webhooks avec un réconciliateur de polling de 5 minutes qui rattrape tout événement manqué — un modèle « bretelles et ceinture » qui maintient l'exhaustivité des commandes au-dessus de 99,99 %.
Étiquettes d'expédition : génération auto HepsiJet
Lorsque vous marquez une commande comme Packaged avec HepsiJet sélectionné, l'API génère automatiquement une étiquette d'expédition PDF imprimable et renvoie une URL de téléchargement ainsi qu'un numéro de suivi. Il n'y a pas de requête d'étiquette séparée — l'étiquette est incluse dans la réponse de création de colis :
POST /packages
Host: oms-external.hepsiburada.com
{
"orderId": "HB-72184",
"lineItems": [{"id": "HB-72184-1", "qty": 1}],
"cargoCompany": "HepsiJet"
}
→ 201 Created
{
"packageId": "PKG-998812",
"trackingNumber": "HJ73219840TR",
"labelUrl": "https://mpop.hepsiburada.com/labels/PKG-998812.pdf",
"status": "Packaged"
}Le portail de retour
Les retours sont initiés par le client via le portail de retour standard de Hepsiburada (Iade Talepleri) et remontent aux vendeurs via GET /returns?status=Open. Les vendeurs disposent de 3 jours ouvrés pour approuver ou contester le retour ; l'approbation automatique s'active ensuite. Les retours approuvés déclenchent un remboursement via le rail de paiement de Hepsiburada (que le vendeur verra lors du prochain règlement financier), et le stock doit être recrédité via PUT /listings/{merchantSku}/stock.
5. Synchronisation stock & prix — temps réel, Buy Box, repricer
Le point de terminaison de stock
Le stock est mis à jour via l'API d'annonces avec une charge utile sensible au delta :
PUT /listings/merchantid/{MERCHANT_ID}/sku/{MERCHANTSKU}
{
"availableStock": 42,
"price": 299.90
}Le point de terminaison accepte le prix et le stock dans le même appel, mais le cache interne de Hepsiburada peut prendre 30 à 90 secondes pour se propager à la vitrine. Les mises à jour en masse utilisent POST /listings/import avec le même modèle de trackingId que l'import de produits.
Synchronisation temps réel vs cron
Les vendeurs de niveau production utilisent une synchronisation événementielle (chaque changement de stock dans votre ERP déclenche un PUT vers Hepsiburada en quelques secondes) plutôt qu'un cron de 15 minutes. Le risque d'une synchronisation par cron seul est la survente pendant les périodes de forte affluence (Ramazan kampanyası, Black Friday, Efsane Cuma). Le modèle hybride de Zunapro déclenche des PUT immédiats et un réconciliateur de 15 minutes en cas d'événements perdus — le même modèle documenté dans notre architecture d'auto-synchronisation prix & stock master→local→targets.
Gagner la Buy Box
La Buy Box de Hepsiburada (offre par défaut « Sepete Ekle » sur une page produit partagée) est attribuée par une formule pondérée combinant :
- Prix — compétitif à 1–2 % près de l'offre valide la plus basse
- Santé du stock — profondeur, fraîcheur, pas de rupture récente
- Promesse de livraison — HepsiJet l'emporte toutes choses égales par ailleurs
- Note vendeur — minimum 9,0+ sur les KPI de livraison et de service
- Taux de défauts de commande — annulations, expéditions tardives, retours pénalisés
Un repricer bien réglé qui réévalue les prix concurrents toutes les 5 à 10 minutes augmente généralement la part de Buy Box de 15 à 30 % sur les SKU disputés.
Astuce Buy Box Hepsiburada : si deux offres sont à égalité de prix à 1 % près, l'offre avec HepsiJet (transporteur propriétaire) l'emporte par défaut. Passer d'un kargo tiers à HepsiJet sur les SKU disputés est un levier de Buy Box gratuit avant de baisser le prix. Planifier une migration HepsiJet →
6. HepsiJet — réseau de transport propriétaire
Le dernier kilomètre verticalement intégré de Hepsiburada
HepsiJet est le réseau de transport du dernier kilomètre propriétaire de Hepsiburada, lancé en 2017 pour rompre la dépendance à Yurtiçi et Aras Kargo sur les SKU sensibles au temps. En 2026, HepsiJet exploite 1 500+ points de retrait dans 81 provinces, assure la livraison le jour même à Istanbul, Ankara et Izmir, et utilise sa propre flotte de plus de 2 500 véhicules ainsi qu'un réseau de shubeleri en franchise.
Norme de code-barres et format d'étiquette
Chaque étiquette d'expédition HepsiJet porte un code-barres Code-128 encodant un numéro de suivi de 12 caractères préfixé HJ (par exemple HJ73219840TR). L'étiquette PDF générée par l'API utilise une mise en page A6 adaptée aux imprimantes thermiques ; les étiquettes peuvent être imprimées directement via la file ZPL intégrée.
Le jour même & Yarın Kapında
HepsiJet propose deux niveaux de livraison premium visibles sur la page produit :
- « Yarın Kapında » — livraison le lendemain dans 81 provinces lorsque la commande est expédiée avant 14h00 heure locale
- « Bugün Kapında » — livraison le jour même à Istanbul, Ankara, Izmir, Bursa, Adana pour les commandes passées avant 11h00
Les deux badges augmentent nettement la conversion — les propres données de Hepsiburada indiquent une hausse de conversion de 15 à 25 % sur les annonces portant ces badges, soit à peu près l'effet « Hızlı Teslimat » de Trendyol.
Retrait vs Şubeye Bırak
Les vendeurs choisissent entre le retrait HepsiJet (le transporteur collecte à l'entrepôt, facturé par colis) et Şubeye Bırak (le vendeur dépose les colis à l'agence HepsiJet la plus proche, moins cher par colis mais plus lourd opérationnellement). L'API d'intégration prend en charge les deux — la réponse de colis inclut un champ pickupAddressId qui détermine le routage.
7. HepsiLojistik — le modèle FBA
Ce qu'est HepsiLojistik
HepsiLojistik est le service d'exécution par la marketplace de Hepsiburada — l'analogue turc d'Amazon FBA, de Trendyol TFC et d'Allegro One Fulfillment. Les vendeurs expédient leur stock en masse vers les centres d'exécution de Hepsiburada ; Hepsiburada gère le stockage, la préparation, l'emballage, la livraison du dernier kilomètre (via HepsiJet) et les retours. Les commandes HepsiLojistik portent un badge distinct « Hepsiburada Garanti » et bénéficient de la pondération de visibilité la plus élevée dans la formule de la Buy Box.
Le réseau de centres d'exécution
- Gebze (Kocaeli) — centre d'exécution phare, ~150 000 m², dessert Istanbul + Marmara
- Çorlu (Tekirdağ) — ajouté en 2023, axé sur l'ouest de la Turquie + transfrontalier balkanique
- Kemalpaşa (Izmir) — couverture égéenne, ouvert en 2024 pour le sud-ouest de la Turquie
- Ankara (Polatlı) — hub d'Anatolie centrale, optimisé pour la livraison de la région de la capitale
La structure des frais
La tarification HepsiLojistik est publiée sous forme de frais d'exécution par unité plus un stockage mensuel :
- Frais d'exécution par unité — généralement ₺25–₺75 selon la tranche de poids et la catégorie
- Stockage mensuel — facturé par m³ par mois, échelonné selon la vélocité (les SKU à longue traîne paient plus)
- Expédition entrante — le vendeur paie l'acheminement vers le centre d'exécution
- Traitement des retours — inclus dans les frais d'exécution pour les retours conformes à la politique
Candidature & onboarding
HepsiLojistik n'est pas ouvert par défaut. Les vendeurs postulent via HMS → Lojistik Hizmetleri → HepsiLojistik Başvuru, en fournissant 6 mois d'historique de ventes et une liste de SKU cibles. Hepsiburada priorise les vendeurs au-dessus de ~500 commandes mensuelles avec des schémas de demande prévisibles ; les vendeurs à moindre volume restent généralement sur le modèle de retrait HepsiJet autonome.
HepsiLojistik vs HepsiJet — lequel vous convient ?
L'assistant d'onboarding de Zunapro analyse la vélocité de vos SKU, votre taux de retour et votre marge unitaire pour recommander HepsiLojistik pour les SKU de classe A prévisibles et HepsiJet autonome pour la longue traîne. Un seul panneau, les deux modèles d'exécution.
8. Intégration e-facture (e-Fatura) — GİB & ERP
La GİB e-Fatura est obligatoire
La GİB turque (Gelir İdaresi Başkanlığı — administration des recettes) impose l'e-Fatura (factures XML structurées soumises au portail GİB) à toutes les entreprises au-dessus du seuil de chiffre d'affaires annuel (actuellement ~₺3 M, abaissé pour les vendeurs e-commerce sous les amendements 2026). En dessous du seuil, l'e-Arşiv Fatura s'applique — tout aussi électronique, un peu plus légère à la signature. Les commandes de marketplace ne sont pas exemptées : chaque commande de marketplace B2C et B2B nécessite une facture électronique émise dans les 7 jours suivant l'événement d'expédition.
Le point de terminaison de facture Hepsiburada
Hepsiburada expose un point de terminaison financier pour les dépôts de factures — les vendeurs (ou leurs intégrateurs e-Fatura) poussent l'UUID GİB et le rendu PDF de la facture émise, qui est ensuite présenté au client via le lien standard « Faturayı İndir » sur la page de commande :
POST /finance/invoices
Host: integration.hepsiburada.com
{
"orderId": "HB-72184",
"invoiceNumber": "ZUN2026000087421",
"invoiceUuid": "f8e7d6c5-1234-5678-9abc-def012345678",
"invoiceDate": "2026-06-09",
"pdfBase64": "JVBERi0xLjQKJ..."
}Fournisseurs ERP & e-Fatura compatibles
La plupart des vendeurs turcs émettent la facture sous-jacente via leur ERP / entegratör e-Fatura et acheminent le résultat vers Hepsiburada. Zunapro fournit des connecteurs natifs pour :
- Logo Tiger 3 / Logo Wings — l'ERP le plus déployé de Türkiye
- Mikro Yazılım — fort dans le commerce de détail PME
- Netsis (partenaire SAP) — pour les vendeurs entreprise
- Foriba, Uyumsoft, Digital Planet, izibiz — intégrateurs GİB e-Fatura purs
La couche KVKK
Les données personnelles clients qui transitent par le pipeline de facturation sont régies par le KVKK turc (Kişisel Verilerin Korunması Kanunu — loi sur la protection des données personnelles), la réglementation locale équivalente au RGPD appliquée par la KVKK Kurumu (autorité de protection des données). Les vendeurs sont responsables conjoints des données personnelles côté commande et doivent enregistrer les activités de traitement sur VERBİS le cas échéant.
9. Erreurs courantes et solutions
Principales erreurs de production
| HTTP / Code | Symptôme | Cause profonde | Correctif |
|---|---|---|---|
| 401 Unauthorized | Toutes les requêtes rejetées | En-tête User-Agent manquant ou malformé |
Définir User-Agent: {MERCHANT_ID} - {AppName} explicitement |
| 403 Forbidden | Point de terminaison spécifique bloqué | La clé API manque de scope ; marchand non approuvé pour le module | Réémettre la clé dans HMS avec les scopes complets, contacter le Merchant Support |
| VALIDATION_ERROR | Produit bloqué en WAITING_FOR_APPROVAL | Attribut de catégorie obligatoire manquant ou valeur de recherche invalide | Récupérer /categories/{id}/attributes, remplir les champs requis avec des valeurs d'énumération valides |
| BRAND_NOT_FOUND | Import de produit rejeté | La chaîne de marque ne correspond pas exactement au registre des marques HB | Interroger /brands?name=..., utiliser l'ID renvoyé, demander la création de la marque si absente |
| 429 Too Many Requests | Trafic en rafale limité | Dépassement de ~30 req/s sur les annonces ou ~10/s sur les commandes | Implémenter un back-off exponentiel prenant en charge l'en-tête Retry-After |
| STOCK_UPDATE_DELAY | La vitrine affiche un stock obsolète pendant 30–90 s | Latence de propagation du cache, pas un bug | Réduire préventivement le stock en cas de risque de survente ; rapprocher après le délai |
| HEPSIJET_PICKUP_FAIL | Colis créé mais aucune collecte par le transporteur | pickupAddressId incorrect ou adresse hors de la couverture HepsiJet |
Vérifier l'adresse de retrait dans HMS, se rabattre sur Yurtiçi/Aras pour les codes postaux exclus |
| INVOICE_UPLOAD_REJECTED | Le dépôt de l'e-Fatura renvoie 400 | Format d'UUID invalide ou corruption du base64 du PDF | Valider le format UUID v4, réencoder le PDF, réessayer avec un numéro de facture idempotent |
Flux de diagnostic
Lorsqu'une intégration Hepsiburada commence à se comporter étrangement, l'ordre de diagnostic que suit Zunapro est :
- Vérifier le tableau de bord HMS → API Health pour les taux d'erreur par point de terminaison
- Valider le User-Agent et les identifiants Basic-auth avec un test curl
- Inspecter l'en-tête
X-Request-Idd'une réponse en échec — le Merchant Support de Hepsiburada en a besoin pour tracer un ticket - Comparer au changelog de developers.hepsiburada.com pour les changements de schéma récents
10. Commission Hepsiburada 2026 — de 8 % à 22 %
Le barème de commission 2026 de Hepsiburada est échelonné par catégorie, publié chaque trimestre dans HMS sous Hesabım → Komisyon Oranları et divisé en trois grandes tranches plus quelques catégories atypiques (or, automobile, gros électroménager).
Comparatif des commissions 2026 — Hepsiburada vs Trendyol vs Amazon TR
| Marketplace | Tranche basse | Tranche moyenne | Tranche haute | Abonnement / Autre |
|---|---|---|---|---|
| Hepsiburada | 8 % – 12 % | 12 % – 17 % | 15 % – 22 % | Compte gratuit · HepsiAd en option · frais HepsiLojistik si utilisé |
| Trendyol | 9 % – 13 % | 13 % – 18 % | 16 % – 24 % | Compte gratuit · frais TFC si utilisé · Trendyol Ads en option |
| Amazon TR | 5 % – 12 % | 12 % – 17 % | 15 % – 22 % | Professional Seller ~₺99 / mois · frais FBA si utilisé |
| n11 | 6 % – 10 % | 10 % – 15 % | 13 % – 18 % | Compte gratuit · niveau d'abonnement n11 Pro en option |
| Çiçeksepeti | 10 % – 14 % | 14 % – 18 % | 16 % – 22 % | Compte gratuit · spécialisation fleurs/cadeaux le jour même |
Lecture du tableau : Hepsiburada est à peu près au même niveau qu'Amazon TR et légèrement moins cher que Trendyol sur toutes les tranches. Le facteur différenciant n'est pas la commission mais la logistique — le dernier kilomètre propriétaire de HepsiJet donne à Hepsiburada un avantage structurel sur les promesses de livraison dans les grandes métropoles, tandis que la base d'utilisateurs plus large de Trendyol compense ses frais légèrement plus élevés.
Cadre juridique turc 2026 — TVA, e-Fatura, KVKK, ETBİS
Taux de TVA (KDV) 2026
La TVA turque — KDV (Katma Değer Vergisi) — utilise trois taux légaux en 2026 :
- Taux normal de 20 % — la plupart des biens de consommation, l'électronique, la mode, la maison & décoration
- Taux réduit de 10 % — produits alimentaires de base, textiles pour certaines catégories, livres, hôtellerie-restauration
- Taux super-réduit de 1 % — aliments de base (pain, lait, œufs), intrants agricoles, certains produits médicaux
Les vendeurs de marketplace s'enregistrent à la KDV via le Vergi Dairesi (bureau des impôts) régional ; les vendeurs transfrontaliers peuvent utiliser, après 2024, le régime spécial de TVA e-commerce récemment étendu de Türkiye.
e-Fatura & e-Arşiv — mandat GİB
- e-Fatura — factures XML structurées soumises à la GİB, obligatoires au-dessus du seuil de chiffre d'affaires annuel et pour tous les vendeurs e-commerce sous les amendements 2026
- e-Arşiv Fatura — tout aussi électronique mais plus légère ; pour le B2C en dessous du seuil e-Fatura
- Fenêtre d'émission de 7 jours — chaque commande de marketplace nécessite une facture électronique dans les 7 jours suivant l'expédition
- e-İrsaliye, e-Müstahsil, e-Smm — documents complémentaires pour les flux logistiques, agricoles et de freelance
KVKK — l'équivalent RGPD de Türkiye
Le KVKK (Kişisel Verilerin Korunması Kanunu), en vigueur depuis 2016 et renforcé en 2024 en alignement avec le RGPD, régit le traitement des données personnelles. Les vendeurs de marketplace sont responsables conjoints des données personnelles côté commande (nom, adresse, téléphone, IBAN le cas échéant) et doivent :
- S'enregistrer sur VERBİS (Veri Sorumluları Sicil Bilgi Sistemi) s'ils dépassent les seuils
- Maintenir une politique de confidentialité écrite (Aydınlatma Metni) accessible aux clients
- Honorer les droits des personnes concernées (accès, rectification, suppression) sous 30 jours
- Signaler les violations à la KVKK Kurumu sous 72 heures
ETBİS — le registre des entreprises e-commerce
ETBİS (Elektronik Ticaret Bilgi Sistemi), géré par le ministère du Commerce (Ticaret Bakanlığı), est le registre obligatoire pour toute entreprise e-commerce opérant en Türkiye. L'enregistrement est gratuit et en ligne ; le numéro ETBİS doit être affiché dans les profils vendeurs de marketplace et dans les pieds de page des boutiques propres. Le KYC de Hepsiburada vérifie automatiquement l'ETBİS lors de l'onboarding.
La conformité n'est pas optionnelle en 2026. e-Fatura, KVKK et ETBİS sont appliqués avec de véritables sanctions ; le ministère du Commerce cible spécifiquement les vendeurs e-commerce pour des contrôles ponctuels ETBİS. Zunapro regroupe un pack de conformité turc — émission automatique d'e-Fatura, modèle KVKK Aydınlatma Metni, rapprochement ETBİS — aux côtés des intégrations de marketplace. Voir le pack de conformité →
Logistique & expédition — HepsiJet en priorité, Yurtiçi/Aras en secours
Le choix par défaut : HepsiJet
HepsiJet est le transporteur par défaut des commandes Hepsiburada et le seul à déclencher automatiquement les badges « Yarın Kapında » / « Bugün Kapında ». Pour la plupart des vendeurs des grandes métropoles, acheminer 80 à 100 % du volume via HepsiJet est le bon choix.
Transporteurs tiers intégrés
Hepsiburada intègre également les transporteurs nationaux établis de Türkiye, les étiquettes d'expédition étant générées via le même point de terminaison de création de colis en modifiant simplement la valeur cargoCompany :
- Yurtiçi Kargo — la couverture rurale la plus dense, fort sur les codes postaux d'Anatolie orientale que HepsiJet exclut
- Aras Kargo — SLA B2B compétitifs, populaire pour les meubles et les biens volumineux
- DHL Kargo — créneaux le jour même flexibles sur certains corridors
- PTT Kargo — opérateur postal d'État, portée rurale, SLA plus lents
- UPS Türkiye / DHL — lignes transfrontalières internationales
Logique de routage dans Zunapro
Le routeur logistique de Zunapro évalue chaque commande selon une matrice configurable — poids, code postal de destination, valeur déclarée, classe de SKU — et sélectionne HepsiJet par défaut, avec repli sur Yurtiçi pour les codes postaux exclus et Aras pour les colis de plus de 30 kg. Le transporteur choisi est poussé via le même point de terminaison de colis Hepsiburada, de sorte que le client voit une expérience de suivi unique.
Comment commencer à vendre sur Hepsiburada — 2026 étape par étape
Le lancement en 5 étapes
- Enregistrez-vous sur ETBİS & HMS — ouvrez votre dossier ETBİS via etbis.ticaret.gov.tr, puis onboardez-vous sur merchant.hepsiburada.com avec vergi numarası, IBAN et circulaire de signature. Le KYC est validé en 1 à 3 jours ouvrés.
- Générez les identifiants API — Hesabım → Entegrasyon Bilgileri → API Anahtarı. Stockez nom d'utilisateur/mot de passe dans votre coffre ; notez le Merchant ID pour les en-têtes User-Agent.
- Câblez l'e-Fatura — choisissez votre intégrateur GİB (Logo, Mikro, Foriba, izibiz) et confirmez que le point de terminaison de dépôt de factures de Hepsiburada est joignable. Testez avec une commande B2C.
- Choisissez votre pile logistique — retrait HepsiJet vs Şubeye Bırak, plus repli Yurtiçi/Aras pour les codes postaux exclus. Préparez à l'avance les étiquettes et le matériel d'emballage.
- Connectez-vous via Zunapro (10 minutes) — collez les identifiants API dans la tuile Hepsiburada, mappez votre catalogue master, activez les étiquettes auto HepsiJet et l'e-Fatura, basculez en production.
Le flux de connexion Zunapro
- Connectez-vous à Zunapro et ouvrez le module Turquie
- Cliquez sur « Connect Hepsiburada » — collez le nom d'utilisateur API, le mot de passe et le Merchant ID
- Mappage automatique des catégories — le ML de Zunapro propose des mappages de catégories feuilles pour chaque SKU master ; confirmez en quelques clics
- Activez les étiquettes auto HepsiJet + l'e-Fatura — un seul interrupteur pour chacune
- Passez en production — la première synchronisation d'annonces d'un catalogue de 1 000 SKU s'achève en environ 10 minutes ; les webhooks s'enregistrent automatiquement
Connectez Hepsiburada en 10 minutes
API HMS + étiquettes auto HepsiJet + GİB e-Fatura + conformité KVKK — le tout depuis un seul panneau Zunapro. Synchronisation du stock en temps réel, repricer pour la Buy Box, HepsiLojistik FBA prêt lorsque vous passez à l'échelle.
🛒 Connecter Hepsiburada maintenant →FAQ intégration Hepsiburada 2026
Comment obtenir une clé API Hepsiburada en 2026 ?
Connectez-vous au panneau HMS sur merchant.hepsiburada.com, accédez à Hesabım → Entegrasyon Bilgileri → API Anahtarı, et cliquez sur « Generate ». HMS renvoie un nom d'utilisateur, un mot de passe et votre Merchant ID stable ; les clés sont délivrées instantanément aux vendeurs vérifiés.
Les entreprises enregistrées à l'ETBİS sont approuvées automatiquement ; les entités non-ETBİS sont dirigées vers une file de revue manuelle (1 à 2 semaines). Une fois délivrée, la clé API utilise l'authentification HTTP Basic standard — Authorization: Basic base64(username:password) — plus un en-tête User-Agent obligatoire au format {MERCHANT_ID} - {AppName}.
Qu'est-ce que le panneau HMS et quel est son lien avec l'API ?
HMS — Hepsiburada Marketplace Service — est la console vendeur en ligne sur merchant.hepsiburada.com. C'est le pendant opérationnel de l'API REST : chaque action disponible dans HMS (édition d'annonces, acceptation de commandes, émission de remboursements, rapprochement financier) a un point de terminaison API correspondant sur mpop.hepsiburada.com et ses sous-domaines.
HMS est aussi le seul endroit où les clés API sont provisionnées, les adresses de retrait HepsiJet configurées et les autorisations au niveau utilisateur gérées. En production, les vendeurs font presque tout passer par l'API (via Zunapro ou des intégrations internes) ; HMS est réservé aux cas particuliers manuels, aux mises à jour de documents KYC et au nouveau tableau de bord API Health.
HepsiJet est-il obligatoire pour les vendeurs Hepsiburada ?
Non — HepsiJet est l'option par défaut mais pas la seule. Les vendeurs peuvent acheminer les colis via HepsiJet, Yurtiçi Kargo, Aras Kargo, DHL Kargo, PTT ou des transporteurs internationaux comme UPS Türkiye, tous via le même point de terminaison de création de colis en modifiant la valeur cargoCompany.
Cela dit, les annonces HepsiJet obtiennent des badges visibles « Yarın Kapında » / « Bugün Kapında » qui augmentent nettement la conversion (~15–25 % dans les propres données de Hepsiburada) et la pondération de la Buy Box favorise HepsiJet à prix égal. Pour la plupart des vendeurs des grandes métropoles, acheminer 80 à 100 % du volume via HepsiJet est le bon choix par défaut.
À qui s'adresse HepsiLojistik FBA ?
HepsiLojistik est le service d'exécution équivalent au FBA de Hepsiburada. Les vendeurs expédient leur stock en masse vers les centres d'exécution de Hepsiburada à Gebze, Çorlu, Kemalpaşa et Polatlı ; Hepsiburada gère le stockage, la préparation, l'emballage, l'expédition via HepsiJet et les retours.
Il est optimal pour les vendeurs au-dessus de ~500 commandes mensuelles, avec des SKU de classe A prévisibles, qui veulent le badge « Hepsiburada Garanti » et l'exécution le jour même à Istanbul, Ankara et Izmir. Les SKU à longue traîne et à faible vélocité restent généralement sur le retrait HepsiJet autonome — les frais de stockage HepsiLojistik pénalisent les articles à rotation lente.
Quels sont les taux de commission Hepsiburada en 2026 ?
Les commissions 2026 de Hepsiburada vont de 8 % (gros électroménager, composants informatiques, smartphones) à 22 % (mode, accessoires, bijoux), la plupart des produits maison, électronique et biens de consommation se situant dans la tranche moyenne de 12–17 %.
Le barème officiel est publié dans HMS sous Hesabım → Komisyon Oranları et mis à jour environ chaque trimestre. Il n'y a pas de frais d'abonnement mensuel fixe — seulement la commission par transaction, plus les frais optionnels HepsiAd et HepsiLojistik si vous les utilisez.
Comment fonctionne la Buy Box sur Hepsiburada ?
La Buy Box de Hepsiburada (offre par défaut « Sepete Ekle » sur une page produit partagée) est attribuée par une formule pondérée combinant prix, profondeur de stock, promesse de livraison (HepsiJet l'emporte toutes choses égales par ailleurs), note vendeur (9,0+) et taux de défauts de commande.
Un repricing en moins de 30 minutes via l'API augmente généralement le taux de gain de la Buy Box de 15 à 30 % sur les SKU disputés. Un levier de Buy Box gratuit avant de baisser le prix : basculez le transporteur du SKU de Yurtiçi/Aras vers HepsiJet — à prix égal, HepsiJet l'emporte par défaut.
Les vendeurs étrangers (non turcs) peuvent-ils vendre sur Hepsiburada ?
Hepsiburada sert principalement les entreprises enregistrées en Turquie disposant d'un vergi numarası (numéro fiscal) et d'un IBAN turc (TR…). Les vendeurs étrangers créent généralement une anonim şirket / limited şirket turque (≈1 à 2 semaines via un avocat turc ou un service de création d'entreprise) ou s'associent à un revendeur turc de référence.
L'enregistrement ETBİS est obligatoire et rattache le vendeur à la conformité e-commerce turque — obligations de données personnelles KVKK, émission d'e-Fatura GİB et règles de protection des consommateurs au titre du Tüketicinin Korunması Hakkında Kanun.
API Trendyol vs API Hepsiburada — quelle différence ?
Toutes deux sont des API REST via HTTPS avec authentification HTTP Basic, mais les schémas diffèrent. Trendyol utilise supplierId et un schéma produit plus plat avec des groupes de variantes ; Hepsiburada utilise merchantId et une séparation stricte produit vs annonce (un produit peut avoir de nombreuses annonces, chacune avec son propre SKU, prix, stock et état).
Le système d'attributs de catégorie de Hepsiburada est plus rigide — des attributs obligatoires manquants bloquent entièrement l'approbation de l'annonce — tandis que Trendyol est plus souple sur les attributs facultatifs. Trendyol met à l'échelle les imports en masse via des points de terminaison par lots, Hepsiburada utilise le polling par trackingId. Zunapro normalise les deux derrière un modèle produit unifié, de sorte que le vendeur ne voit jamais la différence de schéma.
Quelle est la différence entre e-Fatura et e-Arşiv ?
Toutes deux sont des formats de facture électronique GİB. L'e-Fatura est la version lourde — XML signé acheminé via le système e-Fatura de la GİB, obligatoire au-dessus du seuil de chiffre d'affaires annuel et pour tous les vendeurs e-commerce sous les amendements 2026. L'e-Arşiv Fatura est plus légère — archivée électroniquement mais non acheminée via le système GİB, applicable aux transactions B2C en dessous du seuil e-Fatura.
Chaque commande de marketplace nécessite l'une ou l'autre, émise dans les 7 jours suivant l'expédition. Zunapro sélectionne automatiquement le bon format selon la présence du vergi numarası de l'acheteur et votre tranche de chiffre d'affaires.
Comment Kaspi.kz s'inscrit-il dans la stratégie de Hepsiburada ?
En juillet 2024, le kazakh Kaspi.kz (NASDAQ:KSPI) a annoncé l'acquisition stratégique d'une participation majoritaire dans Hepsiburada, valorisant la marketplace turque à environ 1,13 milliard USD et finalisée début 2026. Depuis, Kaspi a renforcé les ambitions de super-app de Hepsiburada — paiements (Hepsipay), épicerie (HepsiExpress), petites annonces et une poussée BNPL HepsiPay plus agressive faisant écho au playbook de services financiers de Kaspi sur son marché d'origine.
Pour les vendeurs, l'implication concrète est un rythme plus rapide de sorties de fonctionnalités — paiements, BNPL, finance embarquée — et une intégration API plus étroite avec la super-app Hepsiburada élargie. La feuille de route de l'API HMS pour 2026 est la plus ambitieuse depuis l'IPO de 2021.
Comment fonctionne le système de webhooks de Hepsiburada ?
Hepsiburada prend en charge à la fois les webhooks et le polling. Les webhooks sont configurés par Merchant ID dans HMS ou via POST /webhook-subscriptions ; la plateforme pousse des événements JSON vers votre point de terminaison HTTPS avec des signatures HMAC dans l'en-tête X-HB-Signature.
Les événements abonnables incluent order.created, order.cancelled, return.created, return.completed, question.received. La bonne pratique — le choix par défaut de Zunapro — est de combiner les webhooks avec un réconciliateur de polling de 5 minutes pour rattraper tout événement perdu, maintenant l'exhaustivité des commandes au-dessus de 99,99 %.
Combien de temps prend l'intégration Hepsiburada avec Zunapro ?
Environ 10 minutes pour une connexion de bout en bout sur un catalogue de 1 000 SKU, incluant l'import du catalogue, le mappage des catégories, l'activation des étiquettes auto HepsiJet, le câblage de l'e-Fatura et l'abonnement aux webhooks. Connecter Hepsiburada en même temps que Trendyol, Amazon TR et n11 s'achève généralement en moins d'une heure.
L'assistant d'onboarding de Zunapro détecte automatiquement votre ERP (Logo, Mikro, Netsis), propose des mappages de catégories Hepsiburada par ML face à vos SKU existants et pré-remplit les attributs de catégorie obligatoires — les vendeurs confirment en quelques clics plutôt que par le travail manuel attribut par attribut qui bloque la plupart des intégrations internes.
Que se passe-t-il si Hepsiburada modifie le schéma de l'API ?
Hepsiburada publie un changelog versionné sur developers.hepsiburada.com, les changements majeurs typiques étant annoncés 60 à 90 jours à l'avance avec une fenêtre de dépréciation. Les ajouts non-cassants (nouveaux champs facultatifs, nouveaux points de terminaison) sont livrés en continu.
Zunapro suit le changelog quotidiennement, verrouille votre intégration sur le schéma actuel et pousse une migration coordonnée avant la fermeture des fenêtres de dépréciation. La page de statut du connecteur expose la version actuelle de l'API, la dernière synchronisation réussie et toute alerte de dépréciation ouverte.
Connectez Hepsiburada en 10 minutes — gestion centralisée des vendeurs
API REST HMS · étiquettes auto HepsiJet · HepsiLojistik FBA · GİB e-Fatura · KVKK · ETBİS — le tout depuis un seul panneau Zunapro. Aucune démo requise, aucun contrat long. Commencez à vendre sur Hepsiburada avec le même catalogue que vous exploitez déjà sur Trendyol, Amazon TR et n11.
🇹🇷 Connecter Hepsiburada maintenant →Besoin d'aide ?
Service associé: Marketplace