Trendyol-Integrationsleitfaden 2026: REST-API, XML-Anbindung und zentrale Shop-Verwaltung

1. Trendyol-API-Architektur 2026

Trendyols Marketplace-API ist eine RESTful-JSON-über-HTTPS-Schnittstelle, veröffentlicht auf einer einzigen Produktions-Basis-URL — https://api.trendyol.com — mit einer separaten Stage-Umgebung unter https://stageapi.trendyol.com. Jeder API-Aufruf wird per HTTP Basic Auth authentifiziert: Der Authorization-Header trägt ein base64-kodiertes ApiKey:ApiSecret-Paar, und die Supplier-ID wird als Pfadparameter bei jedem lieferantengebundenen Endpunkt übergeben. Es gibt keinen separaten Zugriffstoken-Austausch für Erstanbieter-Verkäufer — Basic Auth wird bei jeder Anfrage geprüft — was die Integration einfach hält, aber bedeutet, dass durchgesickerte Zugangsdaten sofort über das Partnerpanel rotiert werden müssen.

Basis-URL, Authentifizierung, Header

POST https://api.trendyol.com/sapigw/suppliers/{supplierId}/v2/products
Authorization: Basic BASE64(ApiKey:ApiSecret)
User-Agent: {supplierId} - SelfIntegration
Content-Type: application/json
Accept: application/json

Der User-Agent-Header ist nicht rein kosmetisch: Trendyols Traffic-Shaping und Rate-Limit-Abrechnung basieren darauf. Integratoren (wie Zunapro) senden {supplierId} - Zunapro; Erstanbieter-Verkäufer senden {supplierId} - SelfIntegration. Falsch gesetzte User-Agent-Header können auch bei gültigen Zugangsdaten 401/403-Antworten auslösen.

Rate Limits und Kontingente

Trendyol setzt pro Endpunkt und pro Lieferant Rate Limits durch. Die veröffentlichten Obergrenzen für 2026 sind:

• Produkt-Endpunkte — typischerweise 60 Anfragen/Minute pro Supplier-ID, mit Burst-Toleranz bis zu 90/Min. für 30 Sekunden
• Bestell-Endpunkte — typischerweise 600 Anfragen/Minute (Bestellungen sind konstruktionsbedingt ein Endpunkt mit hohem Traffic und niedriger Latenz)
• Preis- und Bestandsaktualisierungs-Endpunkte — typischerweise 100 Anfragen/Minute, wobei jede Anfrage bis zu 1.000 SKUs in einem einzigen Batch tragen kann
• Kategorie- und Attributabfragen — typischerweise 30 Anfragen/Minute (diese ändern sich langsam, daher wird aggressives Caching erwartet)

Jede Antwort enthält die Header X-RateLimit-Limit, X-RateLimit-Remaining und bei 429ern Retry-After. Eine gut gebaute Integration verwendet eine Token-Bucket-Warteschlange pro Supplier-ID und drosselt bei 429 mit exponentiellem Backoff; Zunapro implementiert dies standardmäßig, sodass selbst Bulk-Pushes mit mehreren Tausend SKUs die Limits nie überschreiten.

OAuth 2.0 für unabhängige Integratoren

Für unabhängige Zwischenschicht-Integratoren (Zunapro und ähnliche SaaS-Plattformen, die im Auftrag vieler Lieferanten agieren) bietet Trendyol einen OAuth-2.0-Authorization-Code-Flow anstelle von direktem Basic Auth an. Der Integrator registriert eine client_id / client_secret beim Developer-Relations-Team von Trendyol, der Lieferant autorisiert den Integrator im Partnerpanel, und der Integrator erhält ein einstündiges Zugriffstoken plus ein Refresh-Token zur Neuausstellung. Dies vermeidet, jemals das rohe ApiKey/ApiSecret des Lieferanten handhaben zu müssen, und ist der auditfreundliche Weg für Unternehmenskunden, die viele Trendyol-Shops verwalten.

Webhooks

Trendyol sendet Bestell-Lebenszyklus-Ereignisse an deine registrierte Webhook-URL: Created, Picking, Invoiced, Shipped, Delivered, Cancelled, Returned, UnDelivered. Der Webhook-Payload ist ein JSON-Umschlag, der die Bestell-ID und den neuen Status trägt; dein Endpunkt muss innerhalb von 3 Sekunden mit HTTP 200 antworten. Bei einem Fehler wiederholt Trendyol 5-mal mit exponentiellem Backoff und parkt dann das Ereignis — weshalb ein alle 5 Minuten laufender Abgleichs-Pull gegen /sapigw/suppliers/{id}/orders ein nicht verzichtbares Sicherheitsnetz ist.

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

Der offizielle Königsweg zur Verbindung mit Trendyols REST-API ist 2026 kurz und gut dokumentiert — aber die Reihenfolge der Schritte ist wichtig, weil einige rechtliche Voraussetzungen der API selbst vorgelagert sind.

2.1 Ein Trendyol-Verkäuferkonto eröffnen

Besuche partner.trendyol.com und reiche einen Antrag "Trendyol-Konto eröffnen" ein. Du benötigst:

• VKN (Vergi Kimlik Numarası) — türkische Steuernummer (oder ausländisch gleichwertige Unternehmensregistrierung für Trendyol International)
• Handelsregisterblatt (Ticaret Sicil Gazetesi) für Gesellschaften mit beschränkter Haftung oder Aktiengesellschaften
• Unterschriftszirkular (imza sirküleri)
• ETBİS-Registrierungsnachweis (Elektronik Ticaret Bilgi Sistemi) — seit 2018 für jeden türkischen E-Commerce-Betreiber verpflichtend
• Bankkonto (IBAN TR) im Namen der juristischen Person für Marktplatzauszahlungen

Die Genehmigung dauert in der Regel 2–5 Werktage. Nach der Genehmigung erhält der Verkäufer eine Supplier-ID und Zugang zum Trendyol-Partnerpanel.

2.2 API-Schlüssel und Secret generieren

Öffne im Partnerpanel Kontoeinstellungen → Integrationsinformationen und klicke auf "API-Schlüssel erstellen". Trendyol generiert einen 40-stelligen API-Schlüssel und ein 40-stelliges API-Secret. Beide Werte werden nur einmal angezeigt — sie können später nicht wieder abgerufen werden. Speichere sie in einem Passwort-Manager oder, besser noch, füge sie direkt in die Integrationskachel von Zunapro ein, die sie als maskierte, AES-256-verschlüsselte Geheimnisse speichert.

2.3 Erste Testanfrage

Bestätige, dass die Zugangsdaten aktiv sind, indem du den Lieferanteninfo-Endpunkt aufrufst:

curl -X GET "https://api.trendyol.com/sapigw/suppliers/{supplierId}/addresses" \
  -H "Authorization: Basic $(echo -n 'API_KEY:API_SECRET' | base64)" \
  -H "User-Agent: {supplierId} - SelfIntegration" \
  -H "Accept: application/json"

Eine erfolgreiche Antwort gibt die registrierten Lager- und Retourenadressen des Lieferanten im JSON-Format zurück. Ein 401 bedeutet, dass der Basic-Auth-Header falsch ist; ein 403 bedeutet, dass die Supplier-ID nicht zu den Zugangsdaten passt; ein 404 bedeutet, dass der Endpunktpfad fehlerhaft ist.

2.4 OAuth-Variante (für Multi-Lieferanten-Integratoren)

Für unabhängige Integratoren sieht der OAuth-2.0-Ablauf so aus:

1. Der Integrator leitet den Lieferanten weiter zu:
   https://partner.trendyol.com/oauth/authorize
     ?client_id={integratorClientId}
     &response_type=code
     &redirect_uri={integratorRedirectUri}

2. Der Lieferant genehmigt den Zugriff; Trendyol leitet zurück mit ?code={authCode}

3. Der Integrator tauscht den Code gegen Tokens ein:
   POST https://api.trendyol.com/oauth/token
     grant_type=authorization_code
     code={authCode}
     client_id={integratorClientId}
     client_secret={integratorClientSecret}

4. Antwort: { access_token, refresh_token, expires_in: 3600 }

Zugriffstoken sind 1 Stunde gültig und 30 Tage lang erneuerbar. Zunapro übernimmt alle vier Schritte transparent, sodass der Lieferant nur einen einzigen "Mit Trendyol verbinden"-Button sieht.

2.5 Dein erstes Produkt veröffentlichen

Verwende POST /sapigw/suppliers/{supplierId}/v2/products mit einem JSON-Array von Artikeln. Das minimale Produktobjekt erfordert barcode, title, productMainId, brandId, categoryId, quantity, stockCode, dimensionalWeight, description, currencyType (typischerweise TRY), listPrice, salePrice, vatRate, cargoCompanyId, ein images-Array (1–8 URLs) und ein attributes-Array mit kategoriespezifischen Attribut-IDs.

3. Produktsynchronisierung im großen Maßstab

Massen-Upload — 1.000 SKUs pro Batch

Trendyols POST /v2/products-Endpunkt akzeptiert bis zu 1.000 SKUs pro einzelner JSON-Anfrage. Für Verkäufer mit über 10.000 SKUs im Katalog ist das der Unterschied zwischen einem einstündigen und einem mehrtägigen Onboarding. Der Batch gibt pro Aufruf eine batchRequestId zurück; Trendyol verarbeitet jeden Batch asynchron und stellt nach Abschluss der Verarbeitung Erfolg/Misserfolg pro SKU bereit (typischerweise innerhalb von 1–15 Minuten, abhängig von der Tiefe der Validierungswarteschlange).

Kategoriezuordnung — der mit Abstand schwierigste Schritt

Trendyols Kategoriebaum ist tief und streng. 2026 gibt es etwa 12.000 Blattkategorien, jede mit eigenem Satz an Pflicht- und optionalen Attributen. Eine unter "Herren → Hosen → Casual" gelistete Jeans benötigt die Attribute gender, size, color, material und fit-type; ein Smartphone unter "Elektronik → Mobil → Telefone" benötigt brand, model, memory, guaranteeType und warrantyPeriod. Das Einstellen eines Produkts in eine falsche Kategorie oder in die richtige Kategorie ohne ein Pflichtattribut führt zu einer stillen Ablehnung im Batch-Ergebnis.

Der unterstützte Ansatz ist:

1. Den aktuellen Kategoriebaum von GET /sapigw/product-categories abrufen (24 Std. zwischenspeichern)
2. Für jede Blattkategorie Pflicht- und optionale Attribute von GET /sapigw/product-categories/{categoryId}/attributes abrufen
3. Die SKUs deines Master-Katalogs den Trendyol-Blattkategorien zuordnen — Zunapro nutzt einen ML-Zuordner, trainiert auf Millionen historischer Trendyol-Angebote, der Kategorien aus Titel + Marke + deiner Taxonomie mit einer Trefferquote von über 92 % beim ersten Versuch vorschlägt
4. Jede SKU gegen Pflichtattribute validieren, bevor der POST-Endpunkt aufgerufen wird, um Rate-Limit-Verschwendung bei von vornherein zum Scheitern verurteilten Anfragen zu vermeiden

Markenliste und brandId

Jedes Produkt muss auf eine brandId verweisen, die im Markenregister von Trendyol existiert. Neue Marken können nicht spontan angelegt werden — sie durchlaufen einen manuellen Markenfreigabeprozess über das Partnerpanel (typischerweise 1–3 Werktage). Verwende GET /sapigw/brands?name={brandName}, um eine bestehende brandId nachzuschlagen, bevor du Produkte anlegst.

Regeln für den Bild-Upload

• 1–8 Bilder pro Produkt
• Öffentliche HTTPS-URLs (Trendyol crawlt und hostet die Bilder auf seinem eigenen CDN neu)
• Mindestens 1200×1800 px, weißer Hintergrund für Mode-Kategorien
• JPG oder PNG, max. ~10 MB pro Bild
• Das erste Bild wird zur Miniaturansicht in den Suchergebnissen — es lohnt sich, hier zu investieren

Batch-Status-Abfrage

GET https://api.trendyol.com/sapigw/suppliers/{supplierId}/products/batch-requests/{batchRequestId}

Antwort:
{
  "batchRequestId": "abc-def-...",
  "status": "COMPLETED",
  "itemCount": 1000,
  "items": [
    { "requestItem": {...}, "status": "SUCCESS" },
    { "requestItem": {...}, "status": "INVALID", "failureReasons": ["INVALID_BARCODE"] }
  ]
}

4. Bestellverwaltung — Webhooks und der Statusablauf

Der Bestell-Lebenszyklus 2026

Eine Trendyol-Bestellung durchläuft einen festen Statusablauf:

Created → Picking → Invoiced → Shipped → Delivered

Abzweigende Abläufe:
  Cancelled (jederzeit vor Shipped)
  Returned (nach Delivered, innerhalb des 14-Tage-Fensters)
  UnDelivered (Ausnahme beim Zustelldienst)

Jeder Übergang löst sowohl ein Webhook-Ereignis (Push) aus als auch spiegelt sich im nächsten GET /orders-Abruf (Poll) wider. Der Verkäufer ist für den Übergang Picking → Invoiced → Shipped verantwortlich; Trendyols Logistikpartner steuern Shipped → Delivered.

Webhook-Empfang und Idempotenz

Jeder Webhook trägt eine eindeutige shipmentPackageId. Verarbeite ihn idempotent — Trendyol wiederholt Ereignisse tatsächlich bei einer Nicht-200-Antwort, und eine doppelte Verarbeitung auf deiner Seite (doppelte Rechnungsstellung, doppelte Kommissionierung) ist ein reales Risiko. Das pragmatische Muster ist:

POST /webhook/trendyol
{
  "supplierId": 123456,
  "shipmentPackageId": 987654321,
  "status": "Picking",
  "timestamp": 1717930000000
}

Handler:
1. Lock auf shipmentPackageId erwerben
2. Gespeicherten Status prüfen; wenn bereits >= "Picking", 200 zurückgeben (No-op)
3. Neuen Status persistieren, nachgelagerte Aktionen planen (E-Rechnung, Kommissionierungsaufgabe)
4. HTTP 200 innerhalb von 3 Sekunden zurückgeben

Storno- und Rückerstattungsablauf

Vom Käufer initiierte Stornierungen kommen als Cancelled-Webhooks an; vom Verkäufer initiierte Stornierungen werden über POST /sapigw/suppliers/{id}/orders/{orderId}/cancel mit einem Stornogrund-Code gesendet (OUT_OF_STOCK, OTHER usw.). Rückerstattungen für zugestellte und zurückgesendete Artikel werden automatisch von Trendyol abgewickelt; die einzige Pflicht des Verkäufers ist die Bestätigung des Eingangs der zurückgesendeten Ware innerhalb von 48 Stunden nach dem Scan durch den Zustelldienst.

Trendyol-Express-Versandetikett

Sobald ein Paket in den Status Picking wechselt, fordere das Versandetikett über GET /sapigw/suppliers/{id}/orders/{orderId}/labels an — Trendyol gibt ein PDF zurück (und optional ZPL für Thermodrucker) mit dem Trendyol-Express-Barcode, der Adresse des Käufers und der Sendungsverfolgungsnummer des Zustelldienstes. Der Barcode ist das einzige Artefakt für die Zustellrouting — drucken, anbringen, in dein WMS einscannen, an einer Trendyol-Express-Abholstelle abgeben (oder eine Kurierabholung für Verkäufer mit hohem Volumen planen).

5. Bestands- und Preisaktualisierungen in Echtzeit

Das Bestands-Preis-Push-Muster

Trendyol stellt einen dedizierten Endpunkt für Bestands- und Preisaktualisierungen bereit: POST /sapigw/suppliers/{id}/products/price-and-inventory. Jeder Aufruf akzeptiert bis zu 1.000 Artikel mit barcode, quantity, salePrice und optionalem listPrice pro Artikel. Aktualisierungen greifen innerhalb von Sekunden für den Bestand, innerhalb von 2–5 Minuten für den Preis (Trendyol cacht den Preis zur Konsistenz des Shopping-Feeds).

POST /sapigw/suppliers/{id}/products/price-and-inventory
{
  "items": [
    { "barcode": "8690123456789", "quantity": 42, "salePrice": 549.90, "listPrice": 699.90 },
    { "barcode": "8690987654321", "quantity": 0, "salePrice": 199.00 }
  ]
}

Die Master-→-Lokal-→-Ziele-Sync-Architektur

Für Verkäufer, die mehrere Vertriebskanäle betreiben (Trendyol + Hepsiburada + Çiçeksepeti + eigener Shop), ist die einzig sinnvolle Architektur ein Master-Bestand in Zunapro, der an jeden Ziel-Marktplatz pusht. Der Zunapro-Produktionsstack 2026 führt einen 15-Minuten-Cron plus ereignisgesteuerten Push aus: Jede Bestandsänderung im Master löst einen sofortigen Preis-und-Bestands-Push an Trendyol aus, während der Cron für eventuelle Konsistenz bei jedem Push sorgt, der durchs Raster fiel. SKUs werden per Barcode (primär) oder StockCode (Fallback) abgeglichen — niemals über Trendyols interne Produkt-ID, die sich bei Kategorie-Neuzuordnungen ändern kann.

USt.- und Preisanzeigeregeln

Trendyol-Preise sind USt.-inklusive. Die türkische USt.-Regelung (KDV) für 2026 sieht 20 % Standardsatz, 10 % ermäßigt (Lebensmittel, Bücher, Medikamente, Grundgüter) und 1 % Sonder­satz (essenzielle Lebensmittel, bestimmte landwirtschaftliche Produkte) vor. Der Verkäufer gibt den vatRate pro Produkt an und ist für die Wahl des korrekten Satzes verantwortlich; Fehler zeigen sich nachträglich als E-Rechnungsablehnung durch die GİB, deren Behebung teuer ist.

Trendyol Fast Sale und Kampagnensynchronisierung

Trendyols Flaggschiff-Kampagnen — Trendyol Fast Sale (Hızlı Satış), Trendyol Week, Çarşamba Pazarı (Mittwochsmarkt) — sind Kampagnen mit verpflichtender Teilnahmefähigkeit, die die Sichtbarkeit von Angeboten erhöhen, aber eine zusätzliche Kampagnenprovision von 1–3 % mit sich bringen. Verkäufer melden SKUs über POST /sapigw/suppliers/{id}/products/campaigns mit rabattierten Preis­überschreibungen für Kampagnen an; Zunapro validiert automatisch Kampagnenpreisuntergrenzen gegen deine Master-Margenregeln, um Verpflichtungen unter Selbstkosten zu verhindern.

6. XML-/CSV-Alternative — wann (und wann nicht) sie sinnvoll ist

Das XML-Pull-Modell

Trendyol unterstützt ein XML-Feed-Modell als Alternative zum REST-POST-Ablauf. Der Verkäufer hostet eine XML-Datei unter einer öffentlichen HTTPS-URL, die den Katalog beschreibt; Trendyol ruft sie in konfigurierbarem Takt ab (typischerweise alle 1–4 Stunden). Das XML-Schema wird im Partnerpanel veröffentlicht und spiegelt die Form des Produktobjekts des REST-Endpunkts — Barcode, Titel, brandId, categoryId, Attribute, Bilder, Preis, Bestand.

Dasselbe Muster wird auch per CSV unterstützt (eine Zeile pro SKU) für Verkäufer, deren ERP CSV natürlicher exportiert als XML.

Vergleich: REST-API vs. XML/CSV

Wann XML/CSV wirklich die richtige Wahl ist

• Legacy-ERP ohne HTTP-Client-Fähigkeit, das bereits nächtlich XML/CSV exportiert
• Sich langsam ändernde Kataloge (unter 500 SKUs, wöchentliche Preisänderungen, monatliche Katalogerweiterungen)
• Erstmigration von einem anderen Marktplatz, bei der ein einmaliger CSV-Export die erste Synchronisierung beschleunigt

Für alles andere — Bestell-Webhooks, Echtzeit-Bestand, Kampagnen-Opt-ins, Multichannel-Sync — ist REST 2026 der einzig praktikable Weg. Zunapro unterstützt beide Modi, setzt aber standardmäßig auf REST und nutzt XML/CSV ausschließlich als ETL-Eingangsquelle aus Legacy-ERPs.

7. Trendyol Express und FBA Trendyol

Trendyol Express — die Logistikschicht

Trendyol Express ist Trendyols vollständig eigener Logistikarm — 2018 gestartet und betreibt heute das dichteste e-commerce-native Paketnetzwerk der Türkei. 2026 deckt es über 50.000 Self-Service-Paketstationen und Abholpunkte zusammen mit einer eigenen Kurierflotte ab, erreicht 81 Provinzen mit Same-Day-Lieferung in Istanbul, Ankara, Izmir, Bursa und Antalya sowie Next-Day-Lieferung im restlichen türkischen Festland. Käufer sehen "Hızlı Teslimat" (Schnelllieferung)-Abzeichen bei berechtigten Angeboten, und Trendyols Suchranking gewichtet diese stark.

FBA Trendyol — Trendyol-Logistiklager

FBA Trendyol (manchmal "Trendyol Lojistik Deposu" oder "Trendyol Mağaza Plus" genannt) ist das Äquivalent zu Amazon FBA: Verkäufer senden Bestand an Trendyols Fulfillment-Zentren in Çorlu (die Flaggschiff-Anlage, 250.000 m² nahe Istanbul), Sancaktepe und Ankara, und Trendyol übernimmt Lagerung, Kommissionierung, Verpackung, Zustellung auf der letzten Meile über Trendyol Express und Retouren. FBA-Angebote tragen ein eigenes "Trendyol'dan Gönderim"-Abzeichen und erhalten eine prioritäre Sichtbarkeitsgewichtung in der Suche.

Gebühren und Voraussetzungen für FBA Trendyol

• Onboarding — Antrag über das Partnerpanel; das Vertriebsteam von Trendyol prüft monatliches Volumen, SKU-Dimensionen und Kategorieeignung
• Lagergebühr — monatlich pro Kubikmeter belegtem Lagerraum abgerechnet; variiert saisonal (Lagerung im Q4 kostet mehr)
• Pick-and-Pack-Gebühr — pauschal pro Bestellung, variiert nach Paketgewichtsklasse (unter 500 g, 500 g–2 kg, 2–5 kg, 5–10 kg, über 10 kg)
• Retourenabwicklung — bei Standardretouren in der Pick-and-Pack-Gebühr enthalten; markierte Zustände werden separat abgerechnet

Wann FBA Trendyol Sinn ergibt

Der Break-even-Punkt für FBA Trendyol gegenüber Eigenabwicklung liegt bei etwa 800–1.200 Einheiten pro Monat pro Lager-SKU für schnelldrehende Konsumgüter, Elektronik oder Mode in Größenreihen. Darunter ist die Eigenabwicklung über Trendyol-Express-Abgabe plus eigenen Aras-/Yurtiçi-/MNG-Vertrag meist günstiger. Darüber überwiegt der Konversionsgewinn durch das "Trendyol'dan Gönderim"-Abzeichen plus das Same-Day-Lieferversprechen fast immer die Fulfillment-Kosten pro Einheit.

8. GİB-E-Rechnungsintegration (E-Fatura/E-Arşiv)

Das GİB-Mandat

Die türkische Gelir İdaresi Başkanlığı (GİB — Finanzverwaltung) hat E-Fatura für jedes Unternehmen mit einem Jahresumsatz über der von der GİB veröffentlichten Schwelle (jährlich überarbeitet; ca. 3 Mio. TRY im Jahr 2026) verpflichtend gemacht und E-Arşiv Fatura für alle B2C-Rechnungen über ca. 30.000 TRY (jährlich überarbeitet). Für aktive Trendyol-Verkäufer im Jahr 2026 ist die E-Fatura-/E-Arşiv-Abdeckung praktisch universell — nahezu jede Marktplatzbestellung muss innerhalb des Bestellstatus-Fensters eine GİB-gestempelte elektronische Rechnung erzeugen, sonst drohen Strafen.

Die fünf GİB-zertifizierten Integratoren

Verkäufer können entweder das GİB-Portal direkt nutzen (bei Marktplatzvolumen unpraktisch) oder einen GİB-zertifizierten Özel Entegratör (Spezialintegrator) beauftragen. Die fünf dominierenden Anbieter im Jahr 2026 sind:

• Logo Yazılım — der größte türkische ERP-Anbieter; e-Logo für die Rechnungsstellung
• Mikro Yazılım — ERP- und E-Rechnungsanbieter im Mittelmarkt, stark im KMU-Segment
• Uyumsoft — unabhängiger Integrator mit robuster REST-API und der größten Marktplatz-Verkäuferbasis
• Foriba — Anbieter im Enterprise-Segment (2019 von Sovos übernommen), stark in regulierten Branchen
• Veriban — schnell wachsende Alternative mit wettbewerbsfähigen Preisen und entwicklerfreundlicher API

Der Marktplatz-E-Rechnungs-Ablauf

1. Trendyol-Webhook: Bestellstatus -> "Picking"
2. Zunapro ruft Bestelldetails ab (Käufername, VKN/TCKN, Adresse, Artikel)
3. Zunapro sendet Rechnungsentwurf an den Integrator (Logo/Mikro/Uyumsoft/Foriba/Veriban)
4. Integrator signiert mit E-Signaturzertifikat, reicht bei der GİB ein
5. GİB gibt die ETTN zurück (eindeutige Nummer des elektronischen Dokuments)
6. Zunapro speichert die ETTN, hängt das PDF an die Trendyol-Bestellung an
7. Zunapro überführt die Trendyol-Bestellung per API von Picking -> Invoiced

Praktische Wahl für 2026

Für neue Verkäufer sind Uyumsoft und Veriban am einfachsten anzubinden (Web-Registrierung, REST-API, keine On-Premise-Abhängigkeit). Verkäufer, die bereits Logo- oder Mikro-ERP nutzen, sollten für den Buchhaltungsabgleich beim E-Rechnungsprodukt desselben Anbieters bleiben. Foriba ist die Wahl für Großunternehmen mit komplexen Steuerabläufen. Zunapro liefert alle fünf Integrationen hinter einem einzigen Konfigurationsbildschirm — Integrator auswählen, API-Zugangsdaten einfügen, und jede Trendyol-Bestellung wird automatisch fakturiert.

9. Häufige Fehler und wie man sie konstruktiv vermeidet

Kategorie-Fehlzuordnung

Symptom: Das Batch-Ergebnis zeigt INVALID_CATEGORY oder CATEGORY_NOT_LEAF. Ursache: Einstellen in eine Nicht-Blattkategorie oder in eine Blattkategorie, deren Attributsatz die SKU nicht erfüllt. Lösung: Immer nur in Blattkategorien einstellen (die API lehnt Nicht-Blattkategorien ab) und Attribute vor dem POST gegen das required: true-Set der Kategorie vorvalidieren.

Fehlende Pflichtattribute

Symptom: MANDATORY_ATTRIBUTE_MISSING bei ansonsten gültigen SKUs. Ursache: Trendyol markiert ca. 30 % der Attribute je Kategorie als Pflicht (Geschlecht bei Mode, Garantie bei Elektronik usw.). Lösung: Die Attributanforderungskarte pro Kategorie cachen und POSTs anhand der Vollständigkeit blockieren; Zunapro füllt, wo möglich, automatisch aus deiner Master-Taxonomie.

Verzögerungen bei der Bestandssynchronisierung

Symptom: Eine ausverkaufte SKU zeigt sich auf Trendyol mehrere Minuten lang noch als auf Lager, was zu Überverkäufen führt. Ursache: Preis-und-Bestands-Pushes sind eventually consistent mit einer medianen Latenz von ~5–8 Sekunden, und während Traffic-Spitzen (Black Friday, Trendyol Week) kann sich die Warteschlange auf 30–60 Sekunden verlängern. Lösung: Einen lokalen Sicherheitspuffer implementieren (die letzten 1–2 Einheiten pro hochfrequenter SKU als Ausverkauft-Puffer reservieren) und Bestandsänderungen synchron beim Bestellbestätigungs-Ereignis pushen, nicht nur per Cron.

Verpasste Webhooks

Symptom: Der Bestell-Webhook kommt nie an oder kommt Stunden später an. Ursache: meist eine Firewall-Änderung auf Verkäuferseite, eine TLS-Zertifikatserneuerung, die die Webhook-URL beschädigt hat, oder ein kurzer Ausfall, der Trendyols 5-Wiederholungen-Budget überschritten hat. Lösung: Immer einen parallelen 5-Minuten-Abgleichs-Pull gegen /sapigw/suppliers/{id}/orders?status=Created&startDate=... ausführen; Zunapro tut dies standardmäßig und fügt jede abgerufene Bestellung idempotent mit der auch per Webhook zugestellten zusammen.

Mehrere Angebote, gleicher Barcode (Mükerrer Listing)

Symptom: Eine einzelne SKU erscheint als mehrere Trendyol-Angebote, und der Bestand verringert sich bei jedem anders. Ursache: historische Zusammenführungen, doppelte Barcode-Einträge oder Multi-Shop-Verzweigung desselben Produkts. Lösung: Zunapros MIN-Bestands-Deduplizierungsrichtlinie (eingeführt im Produktions-Update vom 06.06.2026) fasst alle doppelten Angebote unter einem Barcode zusammen und verfolgt den minimalen Bestandswert unter ihnen, wodurch das klassische Desaster "zweimal auf zwei Angeboten verkauft, eine Lieferung versprochen" verhindert wird.

10. Trendyol-Provisionen und Verkäufergebühren 2026

Trendyols Provisionsstruktur für 2026 ist nach Kategorie gestaffelt, mit drei breiten Bändern und ohne feste Gebühr pro Artikel. Die Teilnahme an Kampagnen (Trendyol Fast Sale, Trendyol Week, Çarşamba Pazarı) bringt zusätzlich 1–3 % auf den Kategoriesatz.

Verkäufer-/Abonnementgebühren

Trendyol erhebt kein monatliches Abonnement. Es gibt keine Amazon-artige "Professional Seller"-Stufe. Verkäufer zahlen:

• Kategorieprovision auf jeden Verkauf (8–22 %)
• Kampagnenprovision bei Teilnahme an Trendyol Fast Sale / Week (+1–3 %)
• Trendyol Express-Gebühr pro Sendung (vom Käufer bezahlt, fließt aber in die Gewinn-und-Verlust-Rechnung des Verkäufers ein)
• FBA-Trendyol-Lagerung + Pick-and-Pack (nur bei Anmeldung)
• Trendyol Ads CPC (optional, vom Verkäufer gesteuert)

Auszahlungszyklus

Standardverkäufer werden in einem T+14-Zyklus ausgezahlt (14 Tage nach Bestellzustellung), reduziert auf T+7 für Verkäufer mit Top-Verkäuferbewertung. Strittige Bestellungen, Retouren innerhalb des 14-Tage-Fensters und Rückbuchungen werden von der Auszahlung einbehalten. Auszahlungen gehen auf die registrierte TR-IBAN.

Türkischer Rechtsrahmen 2026 — was Marktplatzverkäufer wissen müssen

KDV (USt.) und KDV-Satzbänder

Die türkische USt. — KDV (Katma Değer Vergisi) — kennt 2026 drei Sätze: 20 % Standard, 10 % ermäßigt (Lebensmittel, Bücher, Medikamente, Gastgewerbe), 1 % Sonder­satz (Grundnahrungsmittel, Landwirtschaft). In der Türkei ansässige Marktplatzverkäufer registrieren sich beim örtlichen Finanzamt für die KDV; grenzüberschreitende Verkäufer oberhalb der Schwelle für digitale Dienstleistungen nutzen die KDV-Regelung für Gebietsfremde. Das Feld vatRate muss bei jedem Trendyol-Produkt-POST dem rechtlich korrekten Satz entsprechen — Fehler pflanzen sich in E-Rechnungen fort und können Korrekturmeldungen erfordern.

E-Fatura/E-Arşiv (GİB-Pflicht)

Bereits in Abschnitt 8 ausführlich behandelt. Fazit für 2026: Jede Marktplatzbestellung erzeugt eine GİB-gestempelte elektronische Rechnung (E-Fatura für B2B/registrierte E-Fatura-Empfänger, E-Arşiv für B2C). Der Verkäufer haftet für die Ausstellung innerhalb des Bestellstatus-Fensters. Manuelle Ausstellung ist bei Marktplatzvolumen unpraktisch — wähle einen der fünf GİB-Integratoren und automatisiere.

KVKK — die türkische DSGVO

Das KVKK (Kişisel Verilerin Korunması Kanunu — Gesetz Nr. 6698) ist die türkische Datenschutzregelung, strukturell ähnlich der DSGVO und durchgesetzt von der KVKK Kurumu. Marktplätze handhaben die käuferseitige Einwilligung und Verarbeitung, aber Verkäufer bleiben gemeinsam Verantwortliche für jeden direkten Kundenservice-Kontakt, Marketing oder Nachkauf-Kommunikation. Strafen bei Nichteinhaltung reichen je nach Verstoßklasse von 60.000 TRY bis über 3 Mio. TRY.

ETBİS — verpflichtendes E-Commerce-Register

Das ETBİS (Elektronik Ticaret Bilgi Sistemi) ist das verpflichtende Register des Handelsministeriums für jeden E-Commerce-Betreiber in der Türkei, in Kraft seit 2018. Verkäufer müssen sich registrieren, bevor sie auf Trendyol Angebote einstellen, und jährliche Transaktionsvolumen melden. ETBİS-Daten fließen in die Durchsetzung des Verbraucherschutzes, das Betrugsscreening und die Wettbewerbsanalytik ein.

Verbraucherschutz — 14-tägiges Widerrufsrecht, 2-jährige Gewährleistung

• 14-tägiges Widerrufsrecht — türkische Verbraucher können jedes im Fernabsatz gekaufte Produkt innerhalb von 14 Tagen ohne Angabe von Gründen zurücksenden (Tüketicinin Korunması Hakkında Kanun, Gesetz Nr. 6502)
• 2-jährige gesetzliche Gewährleistung — verpflichtend bei B2C-Verkäufen, unabhängig von jeder Herstellergarantie
• Verpflichtende Produktinformationen auf Türkisch — Titel, Beschreibung, Gewährleistung, Rückgaberichtlinie allesamt auf Türkisch

Logistik und Versand in der Türkei — Trendyol Express zuerst

Trendyol Express — die dominierende Schicht

Trendyol Express ist der Standard-Zustelldienst bei rund 70 %+ der Trendyol-Bestellungen im Jahr 2026. Der Käufer sieht kostenlosen oder günstigen Versand mit Same-Day- oder Next-Day-Lieferung in den großen Metropolen sowie über 50.000 Self-Service-Paketstationen (Trendyol Hızlı Teslimat Noktaları), an denen Käufer rund um die Uhr Pakete abholen. Verkäufer geben Pakete entweder an einer Trendyol-Express-Sammelstelle ab oder vereinbaren eine Kurierabholung; der Routing-Zettel trägt den über die Bestelletikett-API erhaltenen Trendyol-Express-Barcode.

Die weiteren integrierten Zustelldienste

• Yurtiçi Kargo — etablierter türkischer Zustelldienst, starkes B2C- und B2B-Netzwerk, für Trendyol-Bestellungen integriert
• Aras Kargo — Wettbewerber mit starker anatolischer Abdeckung, häufig für selbst abgewickelte Trendyol-Bestellungen genutzt
• MNG Kargo — drittgrößter türkischer Zustelldienst, gängiger Fallback für Verkäufer mit hohem Volumen
• PTT Kargo — staatlicher Postbetreiber, breiteste ländliche Reichweite, langsamere SLAs
• Sürat Kargo — regionaler Akteur, wettbewerbsfähig in den Regionen Marmara und Ägäis

Praktischer Versand-Stack 2026

Der pragmatische Stack 2026 für einen Trendyol-Verkäufer: Trendyol Express als Standard (das erwarten Käufer), Yurtiçi oder Aras als verkäuferseitiger Fallback für selbst abgewickelte Bestellungen, die das Trendyol-Express-Abholfenster verpassen, PTT Kargo für rein ländliche Postleitzahlen, wo kein anderer Zustelldienst wirtschaftlich ist, und FBA Trendyol für schnelldrehende SKUs, sobald das Volumen die Lagerverpflichtung rechtfertigt.

So startest du den Verkauf auf Trendyol — 5-Schritte-Onboarding

1. Trendyol-Verkäuferkonto

Bewirb dich unter partner.trendyol.com. Gib VKN, Handelsregisterblatt, Unterschriftszirkular, ETBİS-Registrierungsnachweis und TR-IBAN an. Genehmigung in 2–5 Werktagen.

2. ETBİS + Steuerregistrierung

Registriere die juristische Person im ETBİS über das Portal des Handelsministeriums (etbis.gtb.gov.tr) und bestätige die KDV-Registrierung beim örtlichen Finanzamt. Ausländische Verkäufer, die über Trendyol International tätig sind, benennen entweder einen türkischen Vertreter oder nutzen Trendyols Import-of-Record-Programm.

3. API-Schlüssel + Secret generieren

Klicke im Partnerpanel → Kontoeinstellungen → Integrationsinformationen auf "API-Schlüssel erstellen". Kopiere den API-Schlüssel (40 Zeichen) und das API-Secret (40 Zeichen) sofort — sie werden nur einmal angezeigt. Füge sie in die Trendyol-Kachel von Zunapro ein, wo sie AES-256-verschlüsselt und maskiert gespeichert werden.

4. Über das Zunapro-Panel verbinden

1. Bei Zunapro anmelden und das Türkei-Modul öffnen
2. Supplier-ID + API-Schlüssel + API-Secret in die Trendyol-Integrationskachel einfügen
3. Den automatischen Gesundheitscheck ausführen (Zugangsdaten, Adress-Endpunkt, Lieferanteninfo)
4. Die ML-vorgeschlagenen Kategoriezuordnungen für deine Top-100-SKUs bestätigen
5. Deinen E-Rechnungsintegrator (Logo, Mikro, Uyumsoft, Foriba oder Veriban) wählen und dessen Zugangsdaten einfügen
6. "Trendyol Express" + "FBA Trendyol" aktivieren (sofern angemeldet)

5. Eine Testbestellung durchführen

Platziere 3–5 Stage-Bestellungen gegen stageapi.trendyol.com, um Pick-Pack, Etikettendruck, Statusübergang und Rückerstattung end-to-end zu üben. Sobald alles grün ist, schalte die Integration mit einem einzigen Schalter auf Produktion um. Die erste Produktionssynchronisierung eines Katalogs mit 5.000 SKUs ist angesichts der Rate Limits von Trendyol in etwa 30–60 Minuten abgeschlossen.

Die drei Trendyol-Integrationswege — im Vergleich

Bevor du dich auf eine Integrationsarchitektur festlegst, hilft es, die drei legitimen Wege nebeneinander zu vergleichen.

Trendyol-Integration — FAQ 2026