Hepsiburada-Integrationsleitfaden 2026: REST-API, HepsiJet & zentrales Verkäufer-Management

1. Hepsiburada-API-Architektur 2026

REST auf mpop.hepsiburada.com

Hepsiburadas Verkäufer-API ist ein reiner REST/JSON-Dienst, gehostet unter dem Dach-Host mpop.hepsiburada.com (mpop = „Merchant Platform Open API"). Es gibt keine GraphQL- oder gRPC-Variante. Aller authentifizierter Verkehr läuft über HTTPS, gebunden an eine Merchant-ID, die beim HMS-Onboarding ausgestellt wird. Die API-Oberfläche ist in logische Sub-Domains aufgeteilt statt in einen einzigen monolithischen Root:

• listing-external.hepsiburada.com — Listing-CRUD (Preis, Bestand, Listing-Status)
• mpop.hepsiburada.com/product/api/products — Produkterstellung und Kategorieattribute
• oms-external.hepsiburada.com — Auftragsverwaltung (Bestellungen, Pakete, Sendungen)
• returns-external.hepsiburada.com — Retouren und Erstattungen
• integration.hepsiburada.com/finance — Rechnungs-Upload und Finanzabgleich

Jede Sub-Domain teilt sich dasselbe HTTP-Basic-Auth-Schema, hat aber eigene Rate-Limits und Paginierungskonventionen. Zunapros HB-Connector abstrahiert diese Aufspaltung hinter einer einzigen normalisierten Schnittstelle.

Authentifizierung: HTTP Basic über HTTPS

Anders als Trendyols etwas nachsichtigere API oder Amazons SP-API-OAuth-Flow nutzt Hepsiburada ein bewusst einfaches HTTP-Basic-Auth-Schema: Der Authorization-Header trägt Basic base64(username:password), wobei username Ihr API-Schlüssel und password das zugehörige Secret ist. Jede Anfrage muss außerdem einen User-Agent-Header führen, der Ihre Merchant-ID enthält. Fehlende oder fehlerhafte User-Agent-Werte sind die mit Abstand häufigste Ursache für 401 Unauthorized in der Produktion.

GET /listings/merchantid/{MERCHANT_ID}/sku/{MERCHANTSKU}
Host: listing-external.hepsiburada.com
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
User-Agent: {MERCHANT_ID} - SelfIntegration
Accept: application/json

HMS — Das Hepsiburada-Marketplace-Service-Panel

Das HMS-Panel unter merchant.hepsiburada.com ist die operative Web-Konsole, die mit der API gekoppelt ist. Jede API-Funktion hat ein HMS-Äquivalent — Listing-Bearbeitung, Auftragsannahme, Erstattungsausstellung, Finanzabgleich — und HMS ist der einzige Ort, an dem Sie API-Schlüssel bereitstellen, HepsiJet-Abholadressen konfigurieren und Benutzerberechtigungen verwalten. Das HMS-Redesign 2024–2026 brachte eine einheitliche linke Navigation, Echtzeit-Abrechnungsberichte und ein neues „API Health"-Dashboard, das 4xx/5xx-Raten pro Endpunkt anzeigt, was beim Debugging einer Integration von unschätzbarem Wert ist.

Rate-Limits und Idempotenz

Hepsiburada wendet großzügige, aber durchgesetzte Rate-Limits an — typischerweise ~30 Anfragen/Sekunde pro Händler bei Listing-Updates und niedriger (~10/s) bei Auftrags-Endpunkten. Bulk-Produktimporte werden separat gedrosselt und geben 202 Accepted mit einer trackingId zurück; anschließend pollen Sie /import/{trackingId} bis zum Abschluss. Die Auftrags-API unterstützt Idempotenz über Paket- und Auftrags-IDs, die über Lesevorgänge hinweg stabil bleiben.

2. Verbindung über REST-API — Schritt für Schritt

Voraussetzungen: HMS-Konto & ETBİS

Vor jedem API-Aufruf muss ein türkisch registriertes Unternehmen mit einer vergi numarası (Steuernummer), einer ETBİS-Registrierung (Elektronik Ticaret Bilgi Sistemi — das E-Commerce-Unternehmensregister des Handelsministeriums) und einer türkischen IBAN (TR…) über HMS onboarden. Die KYC-Prüfung ist bei ETBİS-registrierten Einheiten meist innerhalb von 1–3 Werktagen abgeschlossen; nicht-ETBİS-Verkäufer landen in einer manuellen Prüf-Warteschlange, die 1–2 Wochen dauern kann.

Schritt-für-Schritt-API-Onboarding

1. HMS-Konto erstellen unter merchant.hepsiburada.com mit Ihrer vergi numarası und IBAN. Laden Sie Ihr ETBİS-Zertifikat, Ihren Unterschriftszirkular (imza sirküleri) und Ihr Finanzamtsdokument hoch.
2. API-Zugangsdaten generieren unter Hesabım → Entegrasyon Bilgileri → API Anahtarı. Das System liefert einen Benutzernamen, ein Passwort und Ihre stabile Merchant-ID. Speichern Sie Secrets in einem Vault — Hepsiburada zeigt das Passwort nicht erneut an.
3. Ausgehende IPs freischalten, falls Ihre Integrationsplattform dies erfordert. Zunapro veröffentlicht einen festen Egress-IP-Bereich, sodass Verkäufer ihn auf der HMS-Allow-Liste pinnen können.
4. Smoke-Test mit einem Listing-Read — rufen Sie GET /listings/merchantid/{MERCHANT_ID} auf und bestätigen Sie ein 200 OK mit Ihrem bestehenden Bestand.
5. Webhooks abonnieren für Auftragsereignisse: POST /webhook-subscriptions mit Ihrer Callback-URL und den Ereignistypen (order.created, order.cancelled, return.created).
6. Erstes Produkt pushen mit POST /product/api/products/import — Hepsiburada gibt eine trackingId zurück; pollen Sie sie bis status:DONE.
7. Live gehen — stellen Sie die Integration in HMS auf „Aktif", sobald die Smoke-Tests bestanden sind.

Header und häufige Stolperfallen

Die mit Abstand häufigste Integrationsregression ist ein fehlender oder fehlerhafter User-Agent. Hepsiburada verlangt strikt das Format {MERCHANT_ID} - {AppName}; ein Standard-axios/1.6- oder okhttp/4-User-Agent gibt 401 Unauthorized ohne aussagekräftigen Body zurück. Setzen Sie den User-Agent immer explizit und protokollieren Sie ihn in Ihrer Request-Middleware.

3. Produktsynchronisation — Kategoriebaum, Attribute, Varianten

Der Kategoriebaum

Hepsiburadas Katalog ist als strikter drei- bis fünfstufiger Kategoriebaum organisiert, exponiert über GET /product/api/categories/get-all-categories. Jedes Produkt muss einer Kategorie-ID auf Blattebene zugeordnet werden; Zwischenknoten werden mit VALIDATION_ERROR abgelehnt. Die Kategorie-Überarbeitung 2024 fasste mehrere Alt-Knoten zusammen (die separat gelisteten „Bluetooth Kulaklık" und „Kablosuz Kulaklık" wurden zu „Kablosuz Kulaklık & Bluetooth" zusammengeführt), sodass jede Integration, die älter ist, ein Kategorie-Mapping-Refresh benötigt.

Pflichtattribute blockieren die Freigabe

Jede Kategorie exponiert eine Liste von Pflicht- und optionalen Attributen über GET /product/api/categories/{categoryId}/attributes. Anders als Trendyol behandelt Hepsiburada fehlende Pflichtattribute als harte Listing-Sperre — das Produkt geht in den Status WAITING_FOR_APPROVAL und erreicht nie „Active", bis jedes erforderliche Attribut mit einem gültigen Lookup-Wert befüllt ist. Häufige Verursacher:

• Marke — muss exakt Hepsiburadas Markenregister entsprechen; „Apple" und „APPLE" sind unterschiedliche IDs
• Farbe, Größe, Kapazität — aus kontrollierten Vokabularen gezogen, kein Freitext
• Garantiezeitraum — für Elektronik erforderlich, in Monaten als Enum ausgedrückt
• Ursprungsland (Menşei) — erforderlich für Kosmetik, Lebensmittel, Nahrungsergänzung

Varianten: Trennung von Listing & Produkt

Hepsiburada nutzt eine striktere Produkt-vs.-Listing-Trennung als die meisten Wettbewerber. Ein einzelnes Produkt (HB-SKU, interner Identifier) kann viele Listings (merchantSku) haben — eines pro Verkäufer, mit eigenem Preis, Bestand, Zustand (neu/generalüberholt) und Garantie. Bei Variantenprodukten (z. B. T-Shirt in S/M/L × Rot/Blau/Schwarz) ist jede Kombination ein separater Produktknoten, optional gruppiert unter einer varyantGroupID, sodass die Produktseite Farb- und Größen-Swatches zeigt.

Bulk-Import über trackingId

Produktive Katalog-Pushes nutzen POST /product/api/products/import mit einem Array von bis zu 100 Produkten pro Anfrage. Die API gibt eine trackingId zurück; Integratoren müssen GET /product/api/products/import/{trackingId} pollen, bis der Status DONE ist, und dann die Ergebnisse Zeile für Zeile auf Validierungsfehler prüfen. Zunapro batcht Importe in 100-Zeilen-Chunks, wiederholt weiche Fehler und zeigt Fehlerberichte auf Zeilenebene im Verkäuferpanel an.

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. Auftragsverwaltung — Webhooks, Statusfluss, Labels

Der Auftragslebenszyklus

Eine Hepsiburada-Bestellung durchläuft eine feste Statusmaschine, die jede Integration implementieren muss. Die Status sind entscheidend — verfrühte Übergänge lösen Strafpunkte gegen Ihren Verkäufer-Score aus:

• Open — Bestellung eingegangen, Annahme ausstehend (24-Stunden-SLA in den meisten Kategorien, 48 h bei Möbeln)
• InProgress / Picking — Verkäufer bestätigt, Kommissionierung und Verpackung
• Packaged — Paket über API erstellt, Übergabe an Carrier ausstehend
• Shipped — Carrier hat das Paket gescannt; Sendungsnummer aktiv
• Delivered — Last-Mile-Zustellung bestätigt
• Cancelled / Returned — Retourenportal von Kunde oder Händler initiiert

Webhook vs. Polling

Hepsiburada unterstützt sowohl Webhooks (bevorzugt) als auch Polling. Webhooks werden pro Merchant-ID in HMS oder über POST /webhook-subscriptions konfiguriert; die Plattform pusht JSON-Ereignisse an Ihren HTTPS-Endpunkt mit HMAC-Signaturen im X-HB-Signature-Header. Polling greift auf GET /orders?status=Open&offset=0&limit=100 mit einem 30–60-Sekunden-Cron zurück. Zunapro verwendet standardmäßig Webhooks mit einem 5-Minuten-Polling-Reconciler, der etwaige verpasste Ereignisse abfängt — ein Gürtel-und-Hosenträger-Muster, das die Auftragsvollständigkeit über 99,99 % hält.

Versandetiketten: HepsiJet-Auto-Generierung

Wenn Sie eine Bestellung mit ausgewähltem HepsiJet als Packaged markieren, generiert die API automatisch ein druckbares PDF-Versandetikett und gibt eine Download-URL plus eine Sendungsnummer zurück. Es gibt keine separate Label-Anfrage — das Label ist in der Paketerstellungsantwort gebündelt:

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"
}

Das Retourenportal

Retouren werden vom Kunden über Hepsiburadas Standard-Retourenportal (Iade Talepleri) initiiert und erreichen Verkäufer über GET /returns?status=Open. Verkäufer haben 3 Werktage, um die Retoure zu genehmigen oder anzufechten; danach greift die automatische Genehmigung. Genehmigte Retouren lösen eine Erstattung über Hepsiburadas Zahlungsschiene aus (die der Verkäufer bei der nächsten Finanzabrechnung sieht), und der Bestand sollte über PUT /listings/{merchantSku}/stock wieder gutgeschrieben werden.

5. Bestands- & Preissynchronisation — Echtzeit, Buy Box, Repricer

Der Bestands-Endpunkt

Der Bestand wird über die Listing-API mit einem delta-fähigen Payload aktualisiert:

PUT /listings/merchantid/{MERCHANT_ID}/sku/{MERCHANTSKU}
{
  "availableStock": 42,
  "price": 299.90
}

Der Endpunkt akzeptiert Preis und Bestand im selben Aufruf, aber Hepsiburadas interner Cache kann 30–90 Sekunden brauchen, um zum Storefront zu propagieren. Bulk-Updates nutzen POST /listings/import mit demselben trackingId-Muster wie der Produktimport.

Echtzeit- vs. Cron-Sync

Produktionsreife Verkäufer nutzen ereignisgesteuerte Synchronisation (jede Bestandsänderung in Ihrem ERP löst innerhalb von Sekunden ein PUT an Hepsiburada aus) statt eines 15-Minuten-Crons. Das Risiko einer reinen Cron-Sync ist Überverkauf während Aktionsperioden (Ramazan kampanyası, Black Friday, Efsane Cuma). Zunapros Hybridmodell feuert sofortige PUTs und einen 15-Minuten-Reconciler für den Fall verworfener Ereignisse — dasselbe Muster, das in unserer master→local→targets-Preis- & Bestands-Auto-Sync-Architektur dokumentiert ist.

Die Buy Box gewinnen

Hepsiburadas Buy Box („Sepete Ekle"-Standardangebot auf einer geteilten Produktseite) wird durch eine gewichtete Formel vergeben, die kombiniert:

• Preis — wettbewerbsfähig innerhalb von 1–2 % des niedrigsten gültigen Angebots
• Bestandsgesundheit — Tiefe, Aktualität, keine kürzlichen Stockouts
• Lieferversprechen — HepsiJet gewinnt bei sonst gleichen Bedingungen
• Verkäuferbewertung — mindestens 9,0+ über Liefer- und Service-KPIs
• Order-Defect-Rate — Stornierungen, verspätete Sendungen, Retouren werden bestraft

Ein gut abgestimmter Repricer, der Wettbewerberpreise alle 5–10 Minuten neu bewertet, hebt den Buy-Box-Anteil bei umkämpften SKUs typischerweise um 15–30 %.

6. HepsiJet — Eigenes Kuriernetz

Hepsiburadas vertikal integrierte Last-Mile

HepsiJet ist Hepsiburadas eigenes Last-Mile-Kuriernetz, 2017 gestartet, um die Abhängigkeit von Yurtiçi und Aras Kargo bei zeitkritischen SKUs zu durchbrechen. Bis 2026 betreibt HepsiJet 1.500+ Abholpunkte in 81 Provinzen, bietet Same-Day-Lieferung in Istanbul, Ankara und Izmir und nutzt eine eigene Flotte von mehr als 2.500 Fahrzeugen plus ein Netz von Franchise-Shubeleri.

Barcode-Standard und Label-Format

Jedes HepsiJet-Versandetikett trägt einen Code-128-Barcode, der eine 12-stellige Sendungsnummer mit dem Präfix HJ codiert (zum Beispiel HJ73219840TR). Das per API generierte PDF-Label nutzt ein A6-Layout, geeignet für Thermodrucker; Labels können direkt über die integrierte ZPL-Queue gedruckt werden.

Same-Day & Yarın Kapında

HepsiJet bietet zwei Premium-Lieferstufen, die auf der Produktseite sichtbar sind:

• „Yarın Kapında" — Lieferung am nächsten Tag in 81 Provinzen, wenn die Bestellung vor 14:00 Uhr Ortszeit versandt wird
• „Bugün Kapında" — Same-Day-Lieferung in Istanbul, Ankara, Izmir, Bursa, Adana für Bestellungen vor 11:00 Uhr

Beide Badges heben die Conversion spürbar — Hepsiburadas eigene Daten weisen auf einen Conversion-Anstieg von 15–25 % bei Angeboten mit den Badges hin, was ungefähr Trendyols „Hızlı Teslimat"-Effekt entspricht.

Abholung vs. Şubeye Bırak

Verkäufer wählen zwischen HepsiJet-Abholung (der Kurier holt aus dem Lager ab, pro Paket berechnet) und Şubeye Bırak (der Verkäufer gibt Pakete in der nächsten HepsiJet-Filiale ab, günstiger pro Paket, aber operativ aufwendiger). Die Integrations-API unterstützt beides — die Paketantwort enthält ein pickupAddressId-Feld, das das Routing bestimmt.

7. HepsiLojistik — Das FBA-Modell

Was HepsiLojistik ist

HepsiLojistik ist Hepsiburadas Fulfillment-by-Marketplace-Dienst — das türkische Pendant zu Amazon FBA, Trendyol TFC und Allegro One Fulfillment. Verkäufer senden Warenbestand in großen Mengen an Hepsiburadas Fulfillment-Zentren; Hepsiburada übernimmt Lagerung, Kommissionierung, Verpackung, Last-Mile-Zustellung (via HepsiJet) und Retouren. HepsiLojistik-Bestellungen tragen ein eigenes „Hepsiburada Garanti"-Badge und qualifizieren sich für die höchste Sichtbarkeitsgewichtung in der Buy-Box-Formel.

Das Netz der Fulfillment-Zentren

• Gebze (Kocaeli) — Flaggschiff-Fulfillment-Zentrum, ~150.000 m², bedient Istanbul + Marmara
• Çorlu (Tekirdağ) — 2023 hinzugekommen, Fokus auf Westtürkei + grenzüberschreitender Balkan
• Kemalpaşa (Izmir) — Ägäis-Abdeckung, 2024 für die Südwesttürkei eröffnet
• Ankara (Polatlı) — Hub für Zentralanatolien, optimiert für die Zustellung in der Hauptstadtregion

Die Gebührenstruktur

Die HepsiLojistik-Preise werden als Fulfillment-Gebühr pro Einheit plus monatliche Lagerung veröffentlicht:

• Fulfillment-Gebühr pro Einheit — typischerweise ₺25–₺75 je nach Gewichtsband und Kategorie
• Monatliche Lagerung — abgerechnet pro m³ pro Monat, gestaffelt nach Umschlaggeschwindigkeit (Long-Tail-SKUs zahlen mehr)
• Inbound-Versand — der Verkäufer zahlt den Inbound zum Fulfillment-Zentrum
• Retourenabwicklung — in der Fulfillment-Gebühr für richtlinienkonforme Retouren enthalten

Bewerbung & Onboarding

HepsiLojistik ist nicht standardmäßig offen. Verkäufer bewerben sich über HMS → Lojistik Hizmetleri → HepsiLojistik Başvuru und liefern 6 Monate Verkaufshistorie sowie eine Ziel-SKU-Liste. Hepsiburada priorisiert Verkäufer über ~500 Bestellungen pro Monat mit planbaren Nachfragemustern; volumenschwächere Verkäufer bleiben meist beim eigenständigen HepsiJet-Abholmodell.

8. e-Rechnung (e-Fatura) Integration — GİB & ERP

GİB e-Fatura ist verpflichtend

Die türkische GİB (Gelir İdaresi Başkanlığı — Finanzverwaltung) verlangt e-Fatura (strukturierte XML-Rechnungen, die an das GİB-Portal übermittelt werden) für alle Unternehmen über der jährlichen Umsatzschwelle (derzeit ~₺3 Mio., unter den Änderungen 2026 für E-Commerce-Verkäufer gesenkt). Unterhalb der Schwelle gilt e-Arşiv Fatura — ebenso elektronisch, etwas leichter bei der Signatur. Marktplatzbestellungen sind nicht ausgenommen: Jede B2C- und B2B-Marktplatzbestellung erfordert eine elektronische Rechnung, ausgestellt innerhalb von 7 Tagen nach dem Versandereignis.

Der Hepsiburada-Rechnungs-Endpunkt

Hepsiburada exponiert einen Finanz-Endpunkt für Rechnungs-Uploads — Verkäufer (oder ihre e-Fatura-Integratoren) pushen die GİB-UUID und das PDF-Rendering der ausgestellten Rechnung, die dem Kunden dann über den Standard-Link „Faturayı İndir" auf der Bestellseite angezeigt wird:

POST /finance/invoices
Host: integration.hepsiburada.com

{
  "orderId": "HB-72184",
  "invoiceNumber": "ZUN2026000087421",
  "invoiceUuid": "f8e7d6c5-1234-5678-9abc-def012345678",
  "invoiceDate": "2026-06-09",
  "pdfBase64": "JVBERi0xLjQKJ..."
}

Kompatible ERP- & e-Fatura-Anbieter

Die meisten türkischen Verkäufer stellen die zugrunde liegende Rechnung über ihr ERP / ihren e-Fatura-entegratör aus und leiten das Ergebnis an Hepsiburada weiter. Zunapro liefert native Connectoren für:

• Logo Tiger 3 / Logo Wings — Türkiyes am weitesten verbreitetes ERP
• Mikro Yazılım — stark im KMU-Einzelhandel
• Netsis (SAP-Partner) — für Enterprise-Verkäufer
• Foriba, Uyumsoft, Digital Planet, izibiz — reine GİB-e-Fatura-Integratoren

Die KVKK-Ebene

Kunden-PII, die durch die Rechnungs-Pipeline fließen, unterliegen der türkischen KVKK (Kişisel Verilerin Korunması Kanunu — Gesetz zum Schutz personenbezogener Daten), der GDPR-äquivalenten lokalen Regelung, durchgesetzt von der KVKK Kurumu (Datenschutzbehörde). Verkäufer sind gemeinsam Verantwortliche für auftragsseitige PII und müssen Verarbeitungstätigkeiten gegebenenfalls auf VERBİS registrieren.

9. Häufige Fehler und Lösungen

Top-Produktionsfehler

HTTP / Code	Symptom	Grundursache	Behebung
401 Unauthorized	Alle Anfragen abgelehnt	Fehlender oder fehlerhafter User-Agent-Header	User-Agent: {MERCHANT_ID} - {AppName} explizit setzen
403 Forbidden	Bestimmter Endpunkt blockiert	API-Schlüssel fehlt Scope; Händler nicht für Modul freigegeben	Schlüssel in HMS mit vollen Scopes neu ausstellen, Merchant Support kontaktieren
VALIDATION_ERROR	Produkt hängt in WAITING_FOR_APPROVAL fest	Pflicht-Kategorieattribut fehlt oder ungültiger Lookup-Wert	/categories/{id}/attributes abrufen, Pflichtfelder mit gültigen Enum-Werten füllen
BRAND_NOT_FOUND	Produktimport abgelehnt	Marken-String stimmt nicht exakt mit HB-Markenregister überein	/brands?name=... abfragen, zurückgegebene ID verwenden, Markenanlage anfordern falls fehlend
429 Too Many Requests	Burst-Traffic gedrosselt	~30 Anf./s bei Listings oder ~10/s bei Bestellungen überschritten	Exponentielles Back-off mit Unterstützung des Retry-After-Headers implementieren
STOCK_UPDATE_DELAY	Storefront zeigt 30–90 s veralteten Bestand	Cache-Propagationsverzögerung, kein Bug	Bestand bei Überverkaufsrisiko präventiv reduzieren; nach der Verzögerung abgleichen
HEPSIJET_PICKUP_FAIL	Paket erstellt, aber keine Kurierabholung	Falsche pickupAddressId oder Adresse außerhalb der HepsiJet-Abdeckung	Abholadresse in HMS prüfen, für ausgeschlossene PLZ auf Yurtiçi/Aras zurückfallen
INVOICE_UPLOAD_REJECTED	e-Fatura-Upload gibt 400 zurück	Ungültiges UUID-Format oder PDF-base64-Korruption	UUID-v4-Format validieren, PDF neu codieren, mit idempotenter Rechnungsnummer erneut versuchen

Diagnose-Workflow

Wenn sich eine Hepsiburada-Integration seltsam zu verhalten beginnt, ist die Diagnosereihenfolge, der Zunapro folgt:

1. HMS → API-Health-Dashboard auf Fehlerraten pro Endpunkt prüfen
2. User-Agent und Basic-Auth-Zugangsdaten mit einem curl-Smoke-Test validieren
3. Den X-Request-Id-Header aus einer fehlgeschlagenen Antwort inspizieren — Hepsiburada Merchant Support benötigt ihn, um ein Ticket zurückzuverfolgen
4. Mit dem developers.hepsiburada.com-Changelog auf kürzliche Schema-Änderungen abgleichen

10. Hepsiburada-Provision 2026 — 8 % bis 22 %

Hepsiburadas Provisionsplan 2026 ist kategorie-gestaffelt, vierteljährlich in HMS unter Hesabım → Komisyon Oranları veröffentlicht und in drei breite Bänder plus einige Ausreißer-Kategorien (Gold, Automotive, Großgeräte) gegliedert.

Provisionsvergleich 2026 — Hepsiburada vs. Trendyol vs. Amazon TR

Marktplatz	Niedriges Tier	Mittleres Tier	Hohes Tier	Abonnement / Sonstiges
Hepsiburada	8 % – 12 %	12 % – 17 %	15 % – 22 %	Kostenloses Konto · HepsiAd optional · HepsiLojistik-Gebühren bei Nutzung
Trendyol	9 % – 13 %	13 % – 18 %	16 % – 24 %	Kostenloses Konto · TFC-Gebühren bei Nutzung · Trendyol Ads optional
Amazon TR	5 % – 12 %	12 % – 17 %	15 % – 22 %	Professional Seller ~₺99 / Monat · FBA-Gebühren bei Nutzung
n11	6 % – 10 %	10 % – 15 %	13 % – 18 %	Kostenloses Konto · n11-Pro-Abonnementstufe optional
Çiçeksepeti	10 % – 14 %	14 % – 18 %	16 % – 22 %	Kostenloses Konto · Same-Day-Blumen/Geschenk-Spezialisierung

Die Tabelle lesen: Hepsiburada ist ungefähr auf Augenhöhe mit Amazon TR und über alle Bänder leicht günstiger als Trendyol. Der Unterschied liegt nicht in der Provision, sondern in der Logistik — HepsiJets eigene Last-Mile verschafft Hepsiburada einen strukturellen Vorteil bei Lieferversprechen in großen Metropolen, während Trendyols größere Nutzerbasis die etwas höheren Gebühren ausgleicht.

Türkischer Rechtsrahmen 2026 — MwSt., e-Fatura, KVKK, ETBİS

MwSt. (KDV) Sätze 2026

Die türkische MwSt. — KDV (Katma Değer Vergisi) — verwendet 2026 drei gesetzliche Sätze:

• 20 % Regelsatz — die meisten Konsumgüter, Elektronik, Mode, Haus & Wohnen
• 10 % ermäßigter Satz — Grundnahrungsmittel, Textilien für bestimmte Kategorien, Bücher, Gastgewerbe
• 1 % super-ermäßigt — Grundnahrungsmittel (Brot, Milch, Eier), landwirtschaftliche Vorleistungen, bestimmte medizinische Produkte

Marktplatzverkäufer registrieren sich für KDV über das regionale Vergi Dairesi (Finanzamt); grenzüberschreitende Verkäufer können nach 2024 Türkiyes kürzlich erweitertes Sonder-MwSt.-Regime für E-Commerce nutzen.

e-Fatura & e-Arşiv — GİB-Mandat

• e-Fatura — strukturierte, an GİB übermittelte XML-Rechnungen, verpflichtend über der jährlichen Umsatzschwelle und für alle E-Commerce-Verkäufer unter den Änderungen 2026
• e-Arşiv Fatura — ebenso elektronisch, aber leichter; für B2C unterhalb der e-Fatura-Schwelle
• 7-Tage-Ausstellungsfenster — jede Marktplatzbestellung erfordert eine elektronische Rechnung innerhalb von 7 Tagen nach Versand
• e-İrsaliye, e-Müstahsil, e-Smm — Begleitdokumente für Logistik-, Landwirtschafts- und Freiberufler-Flows

KVKK — Türkiyes GDPR-Pendant

KVKK (Kişisel Verilerin Korunması Kanunu), seit 2016 in Kraft und 2024 in Angleichung an die GDPR verschärft, regelt die Verarbeitung personenbezogener Daten. Marktplatzverkäufer sind gemeinsam Verantwortliche für auftragsseitige PII (Name, Adresse, Telefon, IBAN wo relevant) und müssen:

• Sich auf VERBİS (Veri Sorumluları Sicil Bilgi Sistemi) registrieren, wenn über den Schwellen
• Eine schriftliche Datenschutzerklärung (Aydınlatma Metni) für Kunden zugänglich halten
• Betroffenenrechte (Auskunft, Berichtigung, Löschung) innerhalb von 30 Tagen erfüllen
• Verletzungen innerhalb von 72 Stunden an die KVKK Kurumu melden

ETBİS — Das E-Commerce-Unternehmensregister

ETBİS (Elektronik Ticaret Bilgi Sistemi), betrieben vom Handelsministerium (Ticaret Bakanlığı), ist das obligatorische Register für jedes E-Commerce-Unternehmen, das in Türkiye tätig ist. Die Registrierung ist kostenlos und online; die ETBİS-Nummer muss in Marktplatz-Verkäuferprofilen und in den Footern eigener Shops angezeigt werden. Hepsiburadas KYC prüft ETBİS während des Onboardings automatisch.

Logistik & Versand — HepsiJet zuerst, Yurtiçi/Aras als Backup

Der Standard: HepsiJet

HepsiJet ist der Standard-Carrier für Hepsiburada-Bestellungen und der einzige, der automatisch die „Yarın Kapında" / „Bugün Kapında"-Badges auslöst. Für die meisten Verkäufer in großen Metropolen ist es die richtige Wahl, 80–100 % des Volumens über HepsiJet zu leiten.

Integrierte Drittanbieter-Carrier

Hepsiburada integriert außerdem Türkiyes etablierte nationale Carrier, wobei Versandetiketten über denselben Paketerstellungs-Endpunkt generiert werden, indem einfach der cargoCompany-Wert geändert wird:

• Yurtiçi Kargo — dichteste ländliche Abdeckung, stark bei ostanatolischen PLZ, die HepsiJet ausschließt
• Aras Kargo — wettbewerbsfähige B2B-SLAs, beliebt für Möbel und sperrige Güter
• DHL Kargo — flexible Same-Day-Fenster in ausgewählten Korridoren
• PTT Kargo — staatlicher Postbetreiber, ländliche Reichweite, langsamere SLAs
• UPS Türkiye / DHL — internationale grenzüberschreitende Strecken

Routing-Logik in Zunapro

Zunapros Logistik-Router bewertet jede Bestellung gegen eine konfigurierbare Matrix — Gewicht, Ziel-PLZ, deklarierter Wert, SKU-Klasse — und wählt standardmäßig HepsiJet, mit Rückfall auf Yurtiçi für ausgeschlossene PLZ und Aras für Pakete über 30 kg. Der gewählte Carrier wird über denselben Hepsiburada-Paket-Endpunkt gepusht, sodass der Kunde ein einheitliches Tracking-Erlebnis sieht.

So starten Sie den Verkauf auf Hepsiburada — 2026 Schritt für Schritt

Der 5-Schritte-Start

1. Auf ETBİS & HMS registrieren — legen Sie Ihren ETBİS-Eintrag über etbis.ticaret.gov.tr an, onboarden Sie dann unter merchant.hepsiburada.com mit vergi numarası, IBAN und Unterschriftszirkular. KYC ist in 1–3 Werktagen abgeschlossen.
2. API-Zugangsdaten generieren — Hesabım → Entegrasyon Bilgileri → API Anahtarı. Speichern Sie Benutzername/Passwort in Ihrem Vault; notieren Sie die Merchant-ID für User-Agent-Header.
3. e-Fatura verkabeln — wählen Sie Ihren GİB-Integrator (Logo, Mikro, Foriba, izibiz) und bestätigen Sie, dass Hepsiburadas Rechnungs-Upload-Endpunkt erreichbar ist. Testen Sie mit einer B2C-Bestellung.
4. Ihren Logistik-Stack wählen — HepsiJet-Abholung vs. Şubeye Bırak, plus Yurtiçi/Aras-Rückfall für ausgeschlossene PLZ. Etiketten und Verpackungsmaterialien vorbereiten.
5. Über Zunapro verbinden (10 Minuten) — API-Zugangsdaten in die Hepsiburada-Kachel einfügen, Ihren Master-Katalog mappen, HepsiJet-Auto-Labels und e-Fatura aktivieren, Schalter live umlegen.

Der Zunapro-Verbindungsablauf

1. Bei Zunapro anmelden und das Türkei-Modul öffnen
2. Auf „Connect Hepsiburada" klicken — API-Benutzername, Passwort und Merchant-ID einfügen
3. Automatisches Kategorie-Mapping — Zunapro-ML schlägt Blattkategorie-Mappings für jede Master-SKU vor; mit wenigen Klicks bestätigen
4. HepsiJet-Auto-Labels + e-Fatura aktivieren — je ein einzelner Toggle
5. Live gehen — die erste Listing-Synchronisation eines 1.000-SKU-Katalogs ist in etwa 10 Minuten abgeschlossen; Webhooks registrieren sich automatisch

Hepsiburada-Integration FAQ 2026