Hepsiburada API-Integration mit Odoo: Vollständige Einrichtungsanleitung

In der E-Commerce-Landschaft der Türkei gibt es zwei dominierende Plattformen, und Hepsiburada ist die Plattform, die jeder ernsthafte Verkäufer beherrschen muss. Hepsiburada wurde im Jahr 2000 gegründet und ist der älteste und einer der vertrauenswürdigsten Online-Marktplätze der Türkei mit über 100 Millionen monatlichen Besuchen, mehr als 65.000 Verkäufern und einem Produktkatalog, der alle Verbraucherkategorien von Elektronik und Mode bis hin zu Autoteilen und Industriebedarf abdeckt. Für Verkäufer, die ihre Geschäfte mit Odoo ERP betreiben, ist die Integration mit Hepsiburada über die robuste API der Weg zu effizientem, skalierbarem Verkauf auf dem türkischen Markt.

Wichtige Erkenntnisse

• Hepsiburada verzeichnet monatlich über 100 Millionen Besuche und ist der meistbesuchte Marktplatz der Türkei
• Die Plattform beherbergt mehr als 65.000 Verkäufer mit mehr als 50 Millionen Produkteinträgen
• Hepsiburada ging 2021 an die NASDAQ-Börse und demonstrierte damit eine Marktplatzinfrastruktur auf institutionellem Niveau – Die HepsiBurada API (HBAPI) bietet umfassende Integrationsendpunkte für Produkte, Bestellungen, Inventar und Ansprüche
• Der Konnektor von ECOSIRE kümmert sich um die türkische Lokalisierung, die Einhaltung der KDV-Steuervorschriften und die Multi-Cargo-Integration
• API-integrierte Verkäufer erreichen eine 40 % schnellere Bestellabwicklung und 90 % weniger Lagerfehler

---

Warum Hepsiburada wichtig ist

Während Trendyol in den Bereichen Mode und tägliches Bestellvolumen führend ist, verfügt Hepsiburada über deutliche Vorteile in den Kategorien Elektronik, Haushaltsgeräte, Automobil und Industrie. Der Ruf der Plattform für das Verbrauchervertrauen, den sie in 25 Jahren ihres Bestehens aufgebaut hat, beschert ihr einen treuen Kundenstamm, der sich mit der Zielgruppe von Trendyol überschneidet, sich jedoch von dieser unterscheidet. Die meisten erfolgreichen türkischen E-Commerce-Verkäufer arbeiten auf beiden Plattformen, sodass die Integration von Hepsiburada neben Trendyol eine Standardanforderung ist.

Hepsiburada-Statistik (2025-2026)

Hepsiburadas Wettbewerbsposition

Hepsiburada unterscheidet sich durch:

• Vertrauen: 25 Jahre Betrieb haben ein tiefes Vertrauen der Verbraucher aufgebaut, insbesondere bei hochwertigen Einkäufen
• Elektronikstärke: Führender Marktanteil in den Bereichen Unterhaltungselektronik, Computer und mobile Geräte
• HepsiJet-Logistik: Eigenes Logistiknetzwerk mit Lieferung am selben Tag in Großstädten
• HepsiPay: Integriertes Zahlungssystem mit Ratenzahlungsoptionen (kritisch im ratenbasierten Markt der Türkei)
• Corporate Sales: B2B-Marktplatzsegment für den Unternehmenseinkauf
• Hepsiglobal: Grenzüberschreitendes Verkaufsprogramm, das internationale Märkte erreicht

---

Hepsiburada API (HBAPI) Deep Dive

Hepsiburada bietet eine gut strukturierte REST-API, die eine umfassende Verkäuferintegration ermöglicht. Die API-Dokumentation ist (im Gegensatz zu einigen türkischen Plattform-APIs) auf Englisch verfügbar und somit für internationale Entwicklungsteams zugänglich.

API-Architektur

Die HBAPI ist in Servicedomänen organisiert:

Listing-Service

• Erstellen Sie Produktlisten mit vollständigen Attributsätzen
• Varianten verwalten (Farbe, Größe, Modell, Kapazität)
• Erledigung des Hochladens und Bestellens von Bildern
• Karte zur Kategorietaxonomie von Hepsiburada
• Eintragsstatus verwalten (aktiv, passiv, gesperrt)
• Erledigung der Barcode-Anforderungen (GTIN/EAN).

Bestellservice

• Neue Bestellungen abrufen (packbare Bestellungen)
• Zugriff auf Bestelldetails (Einzelposten, Mengen, Adressen)
• Bestellpositionsstatus aktualisieren (Kommissionierung, Rechnung gestellt, versendet)
• Pakete erstellen und Frachtunternehmen zuweisen
• Abwicklung der teilweisen Erfüllung (Versand verfügbarer Artikel zuerst)

Inventarservice

• Aktualisieren Sie die Lagerbestände pro Angebot und Lager
• Verfügbarkeitsstatus festlegen
• Abwicklung der Bestandszuordnung für mehrere Lager

Schadenservice

• Bearbeitung von Käuferansprüchen (falscher Artikel, beschädigt, fehlt)
• Reichen Sie Anspruchsantworten mit Beweisen ein
• Verfolgen Sie die Ergebnisse und finanziellen Auswirkungen von Schadensfällen

Finanzdienstleistung

• Zugriff auf Abrechnungsberichte
• Provisionsaufschlüsselung anzeigen
• Verfolgen Sie Straf- und Anpassungsabzüge
• Laden Sie Rechnungen und Finanzdokumente herunter

Authentifizierung

HBAPI verwendet die HTTP-Basisauthentifizierung mit einer Händler-ID, einem Benutzernamen und einem Passwort, die über das Hepsiburada Merchant Panel bereitgestellt werden. Einige Endpunkte erfordern aus Sicherheitsgründen eine zusätzliche IP-Whitelist.

Tarifbegrenzungen und Best Practices

• Standardratenlimits: 100 Anfragen pro Minute und Endpunkt
• Bestandsaktualisierungen: Batch-Vorgänge empfohlen (bis zu 100 SKUs pro Anfrage)
• Auftragsabfrage: Empfohlen alle 10 Minuten
• Produkterstellung: In Spitzenzeiten auf 500 neue Einträge pro Stunde begrenzt

---

Integrationsarchitektur

Auftragsverarbeitungspipeline

Der Bestelllebenszyklus von Hepsiburada unterscheidet sich geringfügig von anderen Marktplätzen. Aufträge durchlaufen einen bestimmten Zustandsautomaten:

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

Die Integration muss diesen Zustandsautomaten respektieren – das Überspringen von Zuständen oder Aktualisierungen außerhalb der Reihenfolge führt zu API-Fehlern und potenziellen Fehlern bei der Auftragsverarbeitung.

Komponente 1: Integration von Produktlisten

Das Erstellen und Verwalten von Einträgen auf Hepsiburada erfordert die Beachtung plattformspezifischer Anforderungen:

• Kategorieattribute: Jede Kategorie verfügt über obligatorische und optionale Attribute. Für die Elektronik sind Marke, Modell, technische Daten und Garantiezeitraum erforderlich. Mode erfordert Größentabelle, Material und Pflegehinweise
• Barcode-Anforderung: Alle physischen Produkte müssen über gültige GTIN/EAN-Barcodes verfügen. Die Integration muss das Barcode-Format vor der Übermittlung validieren
• Bildanforderungen: Mindestens 500 x 500 Pixel, weißer Hintergrund für das Hauptbild, bis zu 8 Bilder pro Eintrag
• Markenüberprüfung: Marken müssen auf Hepsiburada genehmigt werden, bevor Produkte gelistet werden können. Die Integration sollte den Genehmigungsstatus der Marke prüfen, bevor versucht wird, einen Eintrag zu erstellen
• Inhaltssprache: Alle Eintragsinhalte müssen für den inländischen Marktplatz auf Türkisch sein

Der Connector ordnet Odoo-Produktdaten dem Listing-Format von Hepsiburada zu, validiert obligatorische Attribute und übernimmt die Konvertierung des Bildformats.

Komponente 2: Auftragsimport und Statusverwaltung

Der Connector fragt HBAPI nach neuen packbaren Bestellungen ab und erstellt Odoo-Verkaufsaufträge mit:

• Vollständige Produkt- und Variantenzuordnung
• Lieferadresse des Kunden
• IDs auf Auftrags- und Zeilenebene zur Nachverfolgung von Statusaktualisierungen
• Informationen zur Zahlungsmethode
• SLA-Anforderungen für die Lieferung

Zustandsaktualisierungen folgen der erforderlichen Reihenfolge von Hepsiburada:

1. Kommissionierung: Bestelleingang bestätigen und Lagerabwicklung starten
2. In Rechnung gestellt: Rechnung erstellen und registrieren (vor dem Verpacken erforderlich)
3. Verpackt: Erstellen Sie ein Paket mit Abmessungen, Gewicht und zugewiesenem Frachtunternehmen
4. Versand: Geben Sie die Sendungsverfolgungsnummer ein

Jeder Zustandsübergang ruft die HBAPI mit den entsprechenden Daten auf, und der Connector verarbeitet Wiederholungsversuche bei vorübergehenden Fehlern.

Komponente 3: Bestandsverwaltung

Die Lagerverfügbarkeit wird über Batch-API-Aufrufe von Odoo an Hepsiburada übertragen:

• Die Lagerbestände pro SKU werden alle 15–30 Minuten aktualisiert
• Sicherheitspuffer für Multi-Channel-Verkäufer angewendet
• Artikel ohne Lagerbestand werden auf Hepsiburada automatisch deaktiviert
• Die Wiederherstellung des Bestands löst eine automatische Reaktivierung aus

Die Koordinierung des Hepsiburada-Bestands mit anderen Vertriebskanälen erfordert den zentralisierten Ansatz, der in unserem [Leitfaden zur Echtzeit-Bestandssynchronisierung] (/blog/real-time-inventory-sync-webhooks-queues) beschrieben wird.

Komponente 4: Fracht und Logistik

Hepsiburada unterstützt mehrere Frachtoptionen:

• HepsiJet: Hepsiburadas eigenes Logistiknetzwerk (Lieferung am selben Tag in Großstädten)
• Yurtic Kargo: Der größte Frachttransporteur der Türkei
• Aras Kargo: Landesweite Abdeckung zu wettbewerbsfähigen Preisen
• MNG Kargo: Stark in der Lieferung von Firmen- und Sperrgutartikeln
• Surat Kargo: Budgetfreundliche Option für Standardlieferungen
• UPS Türkei: Für internationale und Premium-Lieferungen

Der Connector lässt sich in das Versandmodul von Odoo integrieren, um anhand konfigurierbarer Regeln (Produktkategorie, Zielort, Gewicht, Dringlichkeit) den entsprechenden Spediteur zuzuweisen und Tracking-Informationen an Hepsiburada weiterzuleiten.

Komponente 5: Reklamationen und After-Sales

Das Schadensystem von Hepsiburada bearbeitet Käuferstreitigkeiten:

• Falscher Artikel: Der Käufer hat ein anderes Produkt als bestellt erhalten
• Beschädigt: Das Produkt ist beschädigt angekommen
• Fehlende Artikel: Unvollständige Lieferung der Bestellung
• Qualität: Das Produkt stimmt nicht mit der Angebotsbeschreibung überein

Der Connector importiert Ansprüche in das Helpdesk-Modul von Odoo, sodass Ihr Kundenservice-Team Beweise überprüfen, Antworten einreichen und Ergebnisse verfolgen kann – alles von Odoo aus. Die Qualität der Schadensbearbeitung wirkt sich auf die Verkäuferbewertung aus und macht eine effiziente Bearbeitung zu einem entscheidenden Faktor.

Komponente 6: Finanzielle Abwicklung

Zu den zweiwöchentlichen Abrechnungen gehören:

• Bruttoumsatz pro Bestellposition
• Kategoriespezifische Provisionen (6–18 %)
• HepsiJet-Logistikgebühren
• Servicegebühren (Auflistung, Transaktion)
• Strafabzüge (verspäteter Versand, Stornierung, Schadensersatzansprüche)
• Werbebeiträge

Der Connector erstellt detaillierte Journaleinträge für jede Abrechnungskomponente und ermöglicht so eine genaue Rentabilitätsanalyse pro Produkt und pro Kategorie in Odoo.

---

Einrichtungsanleitung

Schritt 1: Hepsiburada-Händlerkonto

1. Registrieren Sie sich im Hepsiburada Merchant Panel
2. Vollständige Identitäts- und Steuerprüfung
3. Fordern Sie API-Zugriff an und erhalten Sie Anmeldeinformationen (Händler-ID, Benutzername, Passwort).
4. Senden Sie eine IP-Whitelist für den API-Zugriff
5. Fordern Sie Markengenehmigungen für Ihre Produktmarken an

Schritt 2: Odoo-Konfiguration

1. Türkische Lokalisierung: Installieren Sie türkeispezifische Buchhaltungs-, Steuer- und Dokumentenmodule
2. Währung: Konfigurieren Sie TRY mit automatischen Wechselkursaktualisierungen
3. KDV (Mehrwertsteuer)-Einrichtung: Steuersätze (1 %, 10 %, 20 %) pro Produktkategorie konfigurieren
4. Vertriebskanal: Erstellen Sie ein „Hepsiburada“-Vertriebsteam
5. Kunde: Kundendatensatz „Hepsiburada Marketplace“ erstellen
6. Transportunternehmen: Konfigurieren Sie HepsiJet und zugelassene Frachtunternehmen im Odoo-Liefermodul
7. Konten: Erstellen Sie Aufwandskonten für Provisionen, Logistikgebühren und Strafen

Schritt 3: Installieren Sie den ECOSIRE Connector

Stellen Sie den ECOSIRE Hepsiburada-Connector bereit:

1. Installation über Odoo Apps
2. Navigieren Sie zu Einstellungen > Hepsiburada-Integration
3. Geben Sie die Händler-ID, den API-Benutzernamen und das Passwort ein
4. Konfigurieren Sie bei Bedarf die IP-Whitelist
5. Synchronisierungsintervalle festlegen:

• Bestellungen: alle 10 Minuten
• Inventar: alle 15 Minuten
• Produkte: alle 4 Stunden oder manuell

6. Ordnen Sie Produktkategorien der Taxonomie von Hepsiburada zu

Schritt 4: Konfiguration der Produktliste

1. Ordnen Sie Odoo-Produkte Hepsiburada-Kategorien mit obligatorischen Attributen zu
2. Überprüfen Sie die GTIN/EAN-Barcodes für alle Produkte
3. Bereiten Sie türkischsprachige Produktinhalte vor
4. Laden Sie konforme Produktbilder hoch
5. Legen Sie TRY-Preise mit provisionsorientierten Margen fest
6. Synchronisieren Sie den ersten Katalog und überwachen Sie die Genehmigung der Auflistung

Schritt 5: Einrichtung des Auftragsworkflows

1. Bestellimport und Statusverwaltung konfigurieren
2. Legen Sie Lagerzuweisungsregeln für Hepsiburada-Bestellungen fest
3. Rechnungserstellung konfigurieren (erforderlich vor dem Verpacken im Hepsiburada-Flow)
4. Richten Sie Frachtzuweisungsregeln ein
5. Testen Sie die durchgängige Auftragsabwicklung

Schritt 6: Finanzielle Einrichtung

1. Ordnen Sie Provisionssätze pro Produktkategorie zu
2. Konfigurieren Sie den Abrechnungsimportplan
3. Richten Sie gebührenspezifische Spesenkonten ein
4. Definieren Sie die Abstimmungstoleranz für geringfügige Abweichungen

---

Hepsiburada-spezifische Herausforderungen

Herausforderung 1: Anforderung „Rechnung vor dem Paket“.

Hepsiburada verlangt von Verkäufern, dass sie eine Rechnung erstellen, bevor sie ein Versandpaket erstellen – eine Reihenfolge, die sich von den meisten Marktplätzen unterscheidet, wo die Rechnungsstellung nach oder gleichzeitig mit dem Versand erfolgt.

Lösung: Der Connector automatisiert den Schritt der Rechnungserstellung in Odoo und erstellt und registriert die Rechnung, sobald die Kommissionierung bestätigt wurde. Dadurch wird sichergestellt, dass immer die richtige Statusreihenfolge (Kommissionierung > Fakturiert > Verpackt > Versendet) eingehalten wird.

Herausforderung 2: Ratenzahlungskultur

In der Türkei herrscht eine starke Ratenzahlungskultur vor – Verbraucher zahlen ihre Einkäufe häufig in 3, 6, 9 oder 12 Monatsraten. Während Hepsiburada und HepsiPay die Ratenzahlungsbeziehung für Verbraucher verwalten, erhalten Verkäufer die vollständige Zahlung (abzüglich Provisionen) gemäß den normalen Abrechnungsbedingungen.

Lösung: Der Connector erfasst den gesamten Zahlungsbetrag korrekt in Odoo, unabhängig vom Ratenzahlungsplan des Verbrauchers. Die Ratenstruktur wird zu Informationszwecken erfasst, hat jedoch keinen Einfluss auf die buchhalterische Behandlung des Verkäufers.

Herausforderung 3: Hepsiglobal Cross-Border Complexity

Das Hepsiglobal-Programm von Hepsiburada ermöglicht den grenzüberschreitenden Verkauf durch die Einführung von Preisen in mehreren Währungen, internationaler Versandlogistik und Anforderungen an die Zolldokumentation.

Lösung: Der Connector unterstützt Hepsiglobal mit separaten Preiskonfigurationen pro Zielmarkt, internationaler Carrier-Integration und der Erstellung von Zolldokumenten über Odoo.

Herausforderung 4: Hoher Wettbewerb in der Elektronik

Elektronik ist Hepsiburadas stärkste Kategorie, aber auch die wettbewerbsfähigste. Die Preissensibilität ist extrem und der Buy-Box-Wettbewerb erfordert eine Preisreaktionsfähigkeit in Echtzeit.

Lösung: Der Connector unterstützt Preisregeln, die sich an die Wettbewerbsposition und Margenuntergrenzen anpassen. Preisaktualisierungen können für Kategorien mit starkem Wettbewerb häufiger ausgelöst werden, während gleichzeitig die Rentabilitätsgrenzen gewahrt bleiben.

Herausforderung 5: Saisonale Nachfragespitzen

Der türkische E-Commerce verzeichnet während des 11.11. (Singles' Day), des Black Friday und der Einkaufszeiten vor dem Ramadan große Nachfragespitzen. Während dieser Ereignisse kann sich das Bestellvolumen um das Drei- bis Fünffache erhöhen.

Lösung: Der Connector unterstützt Peak-Mode-Konfigurationen mit erhöhter Synchronisierungsfrequenz, größeren Sicherheitspuffern und automatischen Kapazitätswarnungen. Checklisten vor der Veranstaltung stellen sicher, dass Bestand, Preise und Erfüllungskapazität vorbereitet sind, bevor die Nachfrage ansteigt.

---

Handbuch vs. ECOSIRE Connector

---

Dual-Plattform-Strategie: Hepsiburada + Trendyol

Die erfolgreichsten türkischen E-Commerce-Verkäufer sind gleichzeitig auf Hepsiburada und Trendyol tätig. Die beiden Plattformen haben unterschiedliche Stärken:

• Hepsiburada: Stärker in den Bereichen Elektronik, Haushaltsgeräte und B2B. Ältere Bevölkerungsgruppe mit höherem Einkommen
• Trendyol: Stärker in den Bereichen Mode, Schönheit und Lebensmittel. Jüngere, mobilorientierte Bevölkerungsgruppe

Um beides von Odoo aus ausführen zu können, ist Folgendes erforderlich:

1. Einheitlicher Bestand: Ein einziger Bestandspool, der auf beiden Plattformen mit Sicherheitspuffern verteilt ist
2. Plattformspezifische Preise: Unterschiedliche Provisionssätze und Wettbewerbsdynamik pro Plattform
3. Separate Leistungsverfolgung: Jede Plattform verfügt über ihren eigenen Verkäuferbewertungsalgorithmus
4. Konsolidierte Berichterstattung: Plattformübergreifender Umsatz-, Margen- und Leistungsvergleich

Der ECOSIRE-Connector unterstützt die plattformübergreifende Odoo-Konfiguration und unser Multi-Marktplatz-Verwaltungsleitfaden behandelt die Betriebsstrategie im Detail.

---

ECOSIRE-Integrationsdienste

Die Odoo-Integrationsdienste von ECOSIRE bieten umfassende Unterstützung für Hepsiburada-Verkäufer:

• End-to-End-Connector-Bereitstellung und -Konfiguration
• Türkische Lokalisierung (KDV, Buchhaltung, E-Rechnung)
• Benutzerdefiniertes Fulfillment-Workflow-Design
• Integration und Optimierung von Frachtführern
• Dual-Plattform-Setup (Hepsiburada + Trendyol von einem Odoo)
• Mitarbeiterschulung und fortlaufende Unterstützung

Durchsuchen Sie den Marktplatz-Connector-Katalog von ECOSIRE nach allen verfügbaren Integrationen.

---

Häufig gestellte Fragen

Unterstützt der Connector HepsiJet und andere türkische Frachtunternehmen?

Ja. Der Connector lässt sich in HepsiJet, Yurtic Kargo, Aras Kargo, MNG Kargo, Surat Kargo und UPS Turkey integrieren. Die Zuweisung von Spediteuren erfolgt regelbasiert (Sie konfigurieren Regeln für Produktkategorie, Gewicht, Zielort und Dringlichkeit), und die Sendungsverfolgungsnummern werden automatisch aus dem Liefermodul von Odoo an Hepsiburada übertragen.

Wie werden türkische Steuern (KDV) gehandhabt?

Der Connector ordnet Hepsiburada-Produktkategorien dem korrekten KDV-Satz zu (1 %, 10 % oder 20 %). In Odoo erstellte Rechnungen enthalten die entsprechenden Steuerberechnungen und der Abrechnungsabgleich validiert die Steuerbeträge anhand der Aufzeichnungen von Hepsiburada. Zur Einhaltung gesetzlicher Vorschriften wird das türkische E-Rechnungsformat (e-Fatura) unterstützt.

Was passiert, wenn der API-Aufruf während der Aktualisierung des Bestellstatus fehlschlägt?

Der Connector implementiert eine Wiederholungslogik mit exponentiellem Backoff für vorübergehende API-Fehler. Wenn eine Statusaktualisierung nach Wiederholungsversuchen fehlschlägt, wird die Bestellung in Odoo zur manuellen Bearbeitung markiert und eine Warnung wird an den konfigurierten Betriebskontakt gesendet. Das System verfolgt API-Zuverlässigkeitsmetriken, um systemische Probleme zu identifizieren.

Welche Odoo-Versionen werden unterstützt?

Der ECOSIRE Hepsiburada-Connector unterstützt Odoo 17, 18 und 19 (Community- und Enterprise-Editionen). Türkische Lokalisierungsfunktionen sind im Modul enthalten.

---

Fazit

Die Kombination aus massivem Traffic, über 25 Jahre aufgebautem Verbrauchervertrauen und starker Positionierung in hochwertigen Kategorien macht Hepsiburada zu einem unverzichtbaren Vertriebskanal für jeden Verkäufer, der auf den türkischen Markt abzielt. Die strukturierte API der Plattform bietet eine solide Grundlage für die Automatisierung, aber die Integration muss die spezifischen Anforderungen von Hepsiburada berücksichtigen – die Auftragsstatusmaschine, der Rechnung-vor-Paket-Workflow, die Frachtintegration und die Schadensbearbeitung weisen alle plattformspezifische Nuancen auf.

Verkäufer, die in eine ordnungsgemäße Hepsiburada-Odoo-Integration investieren, gewinnen einen zusätzlichen Vorteil: Eine schnellere Auftragsabwicklung verbessert die Verkäuferbewertung, was die Sichtbarkeit erhöht, was zu mehr Bestellungen führt – ein positiver Kreislauf, der durch betriebliche Effizienz angetrieben wird. Wer auf manuelle Prozesse setzt, stellt das Gegenteil fest: Eine langsame Verarbeitung führt zu einer Verschlechterung der Punktzahl, einer geringeren Sichtbarkeit und sinkenden Umsätzen.

Der Weg nach vorne ist klar. Unabhängig davon, ob Sie Ihre erste Hepsiburada-Präsenz aufbauen oder einen bestehenden Betrieb skalieren, eliminiert die Verbindung der Plattform mit Ihrem Odoo ERP über den speziell entwickelten Connector von ECOSIRE die betrieblichen Reibungsverluste, die das Wachstum einschränken und die Margen schmälern.