Planen Sie die kontrollierte Übertragung Ihres Trendyol-Katalogs in einen eigenen Shop – einschließlich Feldzuordnung, Varianten, Preisen, Lagerbestand, Medien und Validierung.
Produkte von Trendyol in einen eigenen E-Commerce-Kanal zu übertragen, bedeutet nicht einfach, Titel und Preise aus einer Datei in eine andere zu kopieren. Bei einer zuverlässigen Migration werden Produktidentität, Kategorieattribute, Variantenbeziehungen, Lagerbestand, Steuern, Medienrechte und Abläufe nach der Bestellung in einem gemeinsamen Datenmodell zusammengeführt. Ziel ist nicht, den Verkauf über den Marktplatz einzustellen, sondern einen zusätzlichen Kanal zu eröffnen, in dem die Marke ihren Katalog selbst kontrolliert.
In der offiziellen Entwicklerdokumentation von Trendyol wird V2 als aktueller Integrationsbereich ausgewiesen. Endpunkte und Feldanforderungen können sich ändern. Die Implementierung muss daher stets der aktuellen V2-Dokumentation und den dem Händlerkonto zugewiesenen Berechtigungen entsprechen. Das Auslesen von Webseiten, automatisiertes Kopieren über die Verbraucheroberfläche oder nicht autorisierte Datenextraktion sind keine nachhaltigen Integrationsmethoden.
Ermitteln Sie zunächst, was übertragen werden kann
Teilen Sie die Daten in drei Gruppen ein:
- Stammdaten der Marke: die eigene SKU der Marke, Barcode, Produktname, Beschreibung, Kosten, Steuersatz und Medien, für die Nutzungsrechte vorliegen.
- Kanaldaten: Trendyol-Produkt- oder Händlerkennungen, Kategoriezuordnung, Kanalpreis und marktplatzspezifische Statuscodes.
- Daten, die der Plattform oder Dritten gehören können: Kundenbewertungen, Rezensionen, Abzeichen, Seitenlayout und von der Plattform erstellte Assets.
Richten Sie den neuen Shop auf Grundlage der ersten Gruppe ein. Behalten Sie die zweite Gruppe nur für Zuordnung und Abgleich bei. Prüfen Sie ausdrücklich die Rechte, bevor Sie Inhalte aus der dritten Gruppe übertragen. Gehen Sie insbesondere nicht davon aus, dass Bewertungen und Rezensionen von Kunden Kataloginhalte sind, die die Marke frei wiedergeben darf.
Erstellen Sie ein Zuordnungsverzeichnis für Quell- und Zielfelder
Erstellen Sie vor der Migration ein von allen Verantwortlichen genehmigtes Datenverzeichnis:
| Quellkonzept | Zielfeld | Umwandlungsregel | Fehlerverhalten |
|---|---|---|---|
| merchantSku | canonicalSku | Leerzeichen am Anfang und Ende entfernen; Groß-/Kleinschreibung beibehalten | Bei fehlendem Wert unter Quarantäne stellen |
| barcode | barcode | Als Text beibehalten; führende Nullen erhalten | Bei Duplikaten stoppen |
| productMainId | productGroupKey | Varianten unter einem Produkt gruppieren | Verwaiste Varianten melden |
| categoryId | targetCategoryId | Eine genehmigte Zuordnungstabelle verwenden | Bei fehlender Zuordnung als Entwurf behalten |
| attributes | attributes | Code, Wert und Einheit normalisieren | Nicht veröffentlichen, wenn erforderliche Daten fehlen |
| salePrice | channelPrice | Steuer- und Margenregeln anwenden | Bei Unterschreitung des Schwellenwerts Genehmigung anfordern |
| quantity | sourceInventory | Sicherheitsbestand abziehen; auf null begrenzen | Bei Auffälligkeiten Alarm auslösen |
| imageUrls | mediaAssets | HTTPS-Zugriff, Format und Rechte prüfen | Bei fehlerhaften Medien nicht veröffentlichen |
Selbst bei einem Produkttitel ist Urteilsvermögen gefragt. Ein mit Suchbegriffen überladener Marktplatztitel passt möglicherweise nicht zum redaktionellen Stil des eigenen Shops. Verwenden Sie im zentralen Katalog einen neutralen Namen und erstellen Sie kanalspezifische Titel. Gehen Sie bei Beschreibungen, SEO-Texten und Lieferzusagen ebenso vor.
Das Variantenmodell ist der entscheidende Punkt
Farb-, Größen- und Volumenoptionen können in der Quelle als separate Produktzeilen erscheinen, während der Zielshop sie auf einer Produktdetailseite als Auswahlmöglichkeiten darstellt. Bewahren Sie für jede Variante die Beziehungen zu SKU, Barcode, Lagerbestand, Preis und Medien auf.
Wird eine Variante „Schwarz / 38“ beispielsweise auf „38“ reduziert, besteht das Risiko, dass ein falscher Artikel versandt wird. Ein Variantenschlüssel kann eine deterministische Kombination aus Farb- und Größencodes sein, muss aber stabil bleiben. Prüfen Sie das übergeordnete Produkt und die Variantenmatrix auf folgende Bedingungen:
- Haben zwei Varianten innerhalb einer Gruppe dieselbe Optionskombination?
- Ist ein Barcode mehreren aktiven SKUs zugeordnet?
- Verfügt jede Variante über verkaufsfähigen Lagerbestand und einen Preis?
- Gehört ein Bild zum übergeordneten Produkt oder zu einer bestimmten Farbe?
- Wird eine in der Quelle inaktive Variante im Ziel versehentlich wieder aktiviert?
Eine sicherere Integrationsarchitektur
Eine direkte Pipeline nach dem Muster „aus Trendyol lesen, in den Live-Shop schreiben“ ist fehleranfällig. Ergänzen Sie eine überwachbare Staging-Ebene:
Autorisierte Quellverbindung → Rohdatenbereich → Transformation/Zuordnung → Validierung → zentraler Katalog → Shop-Publisher
Eine mit Zeitstempel versehene Rohantwort hilft bei der Untersuchung von Vorfällen. Unnötige personenbezogene Daten oder vertrauliche Informationen sollten jedoch nicht gespeichert werden, und der Zugriff muss eingeschränkt sein. Transformationen müssen wiederholbar sein: Wird dieselbe Quellversion zweimal verarbeitet, dürfen keine doppelten Produkte entstehen. Eine Kombination aus Quellhändleridentität, SKU und Datenversion kann als Idempotenzschlüssel dienen.
Der Connector muss die offiziellen Limits einhalten, vorübergehende Fehler mit zunehmend längeren Wartezeiten erneut versuchen und dauerhafte 4xx-Fehler nicht endlos wiederholen. Zugangsdaten gehören weder in den Code noch in eine Feed-URL. Bewahren Sie sie in einer Lösung zur Geheimnisverwaltung auf und gewähren Sie nur die geringstmöglichen Berechtigungen. Das Händlerkonto, über das die Integration erfolgt, muss ausdrücklich dazu autorisiert sein.
Trennen Sie die Erstübertragung von der laufenden Synchronisierung
Die erstmalige Katalogübertragung ist ein Projekt; Preis- und Bestandsaktualisierungen sind laufende Vorgänge.
- Erstimport: Produktinformationen, Varianten, Attribute und Medien als Entwürfe importieren.
- Bestandssynchronisierung: Verkaufbare Mengen in kurzen Intervallen aktualisieren und einen Sicherheitspuffer für den Kanal berücksichtigen.
- Preissynchronisierung: Eine von der Finanzabteilung genehmigte Preisquelle festlegen; automatische Änderungen dürfen die Mindestmarge nicht unterschreiten.
- Inhaltssynchronisierung: Änderungen zur Prüfung vorlegen, statt umfangreiche Texte im eigenen Shop automatisch zu überschreiben.
- Deaktivierung: Einen Artikel nicht löschen, wenn er an der Quelle nicht mehr erscheint oder geschlossen wird. Stattdessen deaktivieren und Verknüpfungen zu offenen Bestellungen und Berichten beibehalten.
Wenn in beiden Kanälen dieselben physischen Bestände verkauft werden, reicht die „zuletzt bekannte Menge“ nicht aus. Sie benötigen eine Reservierung zwischen dem Hinzufügen zum Warenkorb und der Zahlung, eine Freigabe nach einer Stornierung und eine Regelung für Überverkäufe. Bei wichtigen Produkten sind eine getrennte Zuteilung für die Kanäle oder ein Sicherheitspuffer der einfachste Schutz.
Drei Validierungsstufen
Stufe 1 — Schema: Pflichtfelder, Datentyp, Länge, zulässige Werte, Eindeutigkeit und Referenzbeziehungen.
Stufe 2 — Kommerzielles: Mehrwertsteuer, Listen-/Verkaufspreis, Mindestdeckungsbeitrag, Lagerbestand, Verkaufsberechtigung und Medienrechte.
Stufe 3 — Nutzererlebnis: Darstellung auf Mobilgeräten, Variantenauswahl, Warenkorb, Suche/Filter, Lieferinformationen und Checkout.
Der automatisierte Abgleichsbericht sollte mindestens Folgendes ausweisen: Anzahl der Quellprodukte im Vergleich zu den importierten Zeilen, Anzahl eindeutiger SKUs und Barcodes, Gesamtzahl der übergeordneten Produkte und Varianten, veröffentlichte Produkte sowie Entwürfe und unter Quarantäne gestellte Produkte, nicht zugängliche Bilder und Preis- oder Bestandsauffälligkeiten. Ergänzen Sie Stichprobenprüfungen durch Mitarbeitende für jede Kategorie.
Beispiel für eine Migrationsplanung
Betrachten wir eine Marke für Haus und Wohnen mit 600 Trendyol-Produktzeilen. Bei der Bestandsaufnahme zeigt sich, dass diese 420 übergeordneten Produkten und 180 Varianten entsprechen. Die erste Welle umfasst 80 übergeordnete Produkte, die in den vergangenen 90 Tagen verkauft wurden und über verlässliche Bestandsdaten verfügen. Die Kategoriezuordnung umfasst 12 Zielkategorien, 46 Pflichtattribute und sieben Einheitenumrechnungen. Die Produkte werden als Entwürfe in den Shop eingespielt; 11 fehlende Barcodes, acht doppelte SKUs und 17 nicht zugängliche Bilder werden unter Quarantäne gestellt. Nichts wird veröffentlicht, bevor diese Fehler behoben sind. Nach der Freigabe werden zunächst 10 und anschließend alle 80 Produkte veröffentlicht. 20 Testbestellungen prüfen Bestand, Versand und Retouren durchgängig.
RACI: Wer ist für welche Migrationsentscheidung zuständig?
| Arbeitsbereich | Verantwortlich für die Ausführung | Gesamtverantwortlich | Wird konsultiert | Wird informiert |
|---|---|---|---|---|
| Offizielle Verbindung und Sicherheit | Integration/Technologie | Technische Leitung | Trendyol-Kontoinhaber | E-Commerce |
| Feld- und Kategoriezuordnung | Katalogbetrieb | E-Commerce-Leitung | Produkt, SEO | Support |
| Preis und Steuern | Finanzen | Finanzleitung | E-Commerce | Management |
| Medien- und Textrechte | Marke/Content | Markenleitung | Recht | Katalogteam |
| Bestand und Bestellungen | Betrieb | Betriebsleitung | Technologie, Finanzen | Support |
| Go-live-Entscheidung | Projektleitung | E-Commerce-Leitung | Verantwortliche aller Arbeitsbereiche | Unternehmen |
Go-live-Checkliste
- Wurden die aktuelle offizielle V2-Dokumentation und die Kontoberechtigungen geprüft?
- Sind Quellidentität und Marken-SKU getrennt und nachvollziehbar?
- Sind Kategorie- und Attributzuordnungen versioniert und genehmigt?
- Wurden die Variantenmatrix, die Eindeutigkeit der Barcodes und die Medienzuordnung validiert?
- Wurden Preis-, Steuer-, Mindestmargen- und Bestandssicherheitsregeln getestet?
- Kann die Integration erneut ausgeführt werden, ohne doppelte Produkte zu erzeugen?
- Gibt es eine namentlich festgelegte zuständige Person für die Fehlerwarteschlange, Warnmeldungen, Wiederholungsversuche und manuelle Korrekturen?
- Wurden mindestens eine Stornierung, eine Retoure und ein Ausverkaufsfall anhand einer realistischen Bestellung getestet?
Sobald die Katalogmigration stabil läuft, sollten Sie nicht nur Produkte im neuen Shop listen. Verknüpfen Sie ausgewählte Kollektionen mit Creator-Shops, um Nachfrage für den neuen Kanal zu schaffen. Nutzen Sie dafür im nächsten Schritt den Leitfaden für Creator-Shops mit einem XML-Produktfeed.
Starten Sie das Onboarding als E-Commerce-Händler oder erstellen Sie ein Markenkonto, um Ihren Katalog in einem kontrollierten Prozess in einen eigenen Kanal und ein Influencer-Vertriebsnetzwerk zu integrieren.