Alternative Produkt-IDs in Bestellungen verwenden
Lerne, wie alternatives ID-Mapping Channable hilft, Marktplatz-Bestellpositionen den richtigen Webshop-Produkten zuzuordnen.
Nutze die Zuordnung der alternativen ID, wenn Bestellartikel nicht zu Produkten passen. Das passiert meist dann, wenn Marktplätze einen anderen Bezeichner als dein Webshop verwenden.
Was ist eine Bestellsynchronisation?
Eine Bestellsynchronisation überträgt Bestellungen vom Marktplatz in deine E-Commerce-Plattform. Damit Channable eine Bestellposition anlegen kann, muss jedes Bestell-Item einem Produkt zugeordnet werden.
Wichtige Begriffe, damit der Rest dieser Seite Sinn ergibt
Eindeutige ID (Produktkennzeichnung im Webshop): Der Bezeichner, den deine E-Commerce-Plattform verwendet, um ein Produkt zu referenzieren (oft eine SKU, aber nicht immer).
Alternative ID: Ein weiterer Bezeichner, der beim selben Produkt gespeichert ist, zum Beispiel EAN/GTIN oder MPN.
Bezeichner des Marktplatz-Artikels: Der Bezeichner, der in den Bestelldaten zurückkommt. Das ist oft
Seller SKU.
Warum eindeutige IDs wichtig sind
Eindeutige IDs verknüpfen das Bestell-Item mit dem richtigen Webshop-Produkt. Wenn die ID in der Bestellung in deinem Webshop nicht existiert, schlägt das Anlegen der Bestellung fehl.
Eine eindeutige ID in Channable einrichten
Wenn du in Channable eine API für einen Marktplatz einrichtest, musst du im Schritt „Einstellungen“ der API-Setup den Feldnamen auswählen, der der eindeutigen ID entspricht. Diese ID wird dann an den Marktplatz gesendet und für den Produktabgleich verwendet.
Wenn auf dem Marktplatz eine Bestellung eingeht, nutzt Channable genau diese eindeutige ID, um das Produkt in der Bestellung mit dem passenden Produkt in deiner E-Commerce-Plattform abzugleichen.
Probleme mit falschen oder fehlenden eindeutigen IDs
Probleme entstehen, wenn deine Produkte ursprünglich nicht über Channable auf dem Marktplatz gelistet wurden oder wenn die eindeutige ID von der in deiner E-Commerce-Plattform verwendeten ID abweicht. In solchen Fällen kann Channable die Produkte in den Bestellungen nicht zuordnen.
Diese Abweichung führt zu einem Fehler mit dem Hinweis, dass das Produkt nicht gefunden werden konnte, und verhindert so das Erstellen der Bestellung.
Genau hier hilft Alternative ID-Zuordnung weiter.
So funktioniert die Zuordnung alternativer IDs
Wenn du deine Produkte in Channable importierst, verfolgen wir sowohl die primären Kennungen aus deiner Hauptimportquelle (deiner E-Commerce-Plattform) als auch häufig verwendete alternative Kennungen wie EAN-Codes und SKU-Codes.
Beim Verarbeiten einer Bestellung kann Channable:
die Kennung lesen, die in den Bestelldaten vom Marktplatz angekommen ist.
diesen Wert mit den erfassten alternativen IDs abgleichen (zum Beispiel EAN/GTIN).
Wenn genau ein Treffer gefunden wird, die Webshop-Bestellposition für das zugeordnete Produkt erstellen.
So kannst du Bestellungen verarbeiten, auch wenn die Marktplatz-Kennungen von der Hauptkennung deines Webshops abweichen.
Channable unterstützt aktuell die folgenden E-Commerce-Plattformen und ihre entsprechenden Standard-Felder für Kennungen:
BigCommerce
sku, GTIN
CCVShop
sku_number, ean, ean_number, mpn
Lightspeed Eseries
sku
Lightspeed
sku, article_code, ean
Magento
sku, ean
MijnWebWinkel
sku, uuid
Prestashop
ean13, GTIN, reference
Shopify
sku, GTIN
Shoptrader
sku, ean
Shopware
ean, article_number
Squarespace
sku
WooCommerce
sku
Wenn du Kennungsfelder verwenden möchtest, die aktuell nicht unterstützt werden, wende dich einfach an unser Support-Team. Wir prüfen deine Anfrage und berücksichtigen sie, wenn möglich, für zukünftige Updates.
Hinweis: Wenn du einen zweiten Import hinzufügst (zum Beispiel eine CSV) und einen Kennungswert überschreibst, können Bestellungen fehlschlagen. Die Zuordnung alternativer IDs basiert auf den Kennungen, die aus deiner Hauptimportquelle beim Abgleichen von Bestellartikeln erfasst wurden.
Wann du die Zuordnung alternativer IDs verwenden solltest
Die Zuordnung alternativer IDs ist in verschiedenen Szenarien besonders nützlich, um eine korrekte Bestellverarbeitung sicherzustellen. Typische Situationen, in denen diese Funktion hilfreich ist:
Mehrere Kennungen im Einsatz
Szenario: Deine Produktlistings auf Marktplätzen verwenden eine Mischung aus EAN-Codes und SKU-Codes als Hauptkennung.
Vorteil: Die Zuordnung alternativer IDs hilft dabei, sicherzustellen, dass Bestellungen korrekt mit den entsprechenden Produkten in deiner E-Commerce-Plattform abgeglichen werden, unabhängig davon, welche Kennung der Marktplatz verwendet.
Altsysteme mit anderen ID-Strukturen
Szenario: Deine E-Commerce-Plattform oder dein Bestellverwaltungssystem verwendet eine andere ID-Struktur als die, die der Marktplatz verlangt.
Vorteil: Mit der Zuordnung alternativer IDs kann Channable die Lücke zwischen verschiedenen ID-Systemen schließen und sicherstellen, dass Bestellungen den richtigen Produkten zugeordnet werden, ohne dass manuelle Eingriffe nötig sind.
Beim Wechsel zwischen Systemen
Szenario: Du wechselst zu einer neuen E-Commerce-Plattform oder aktualisierst dein ID-System, und in dieser Zeit haben deine Produkte möglicherweise sowohl alte als auch neue Kennungen.
Vorteil: Die Zuordnung alternativer IDs ermöglicht es dir, den Betrieb nahtlos fortzusetzen, indem beide Kennungssätze erkannt werden und Störungen in der Bestellverarbeitung vermieden werden.
Bevor du die Funktion aktivierst, prüfe die erfasste ID-Zuordnung deines Projekts. Im nächsten Abschnitt erfährst du, wie du auf diese Daten zugreifen kannst.
Auf die ID-Zuordnungsdaten zugreifen
Es gibt zwei Möglichkeiten, die ID-Zuordnungsdaten anzusehen.
ID-Zuordnung für alle Items anzeigen
Auf dieser Seite kannst du die ID-Zuordnungen prüfen, die Channable vor der Aktivierung der Funktion erfasst hat. Wenn du diese Daten überprüfst, stellst du sicher, dass alles korrekt zugeordnet ist. Dieser Schritt ist wichtig, um mögliche Probleme zu vermeiden, die auftreten könnten, wenn die Funktion ohne vorherige Prüfung aktiviert wird.
So bekommst du einen vollständigen Überblick über frühere und aktuelle ID-Zuordnungsdaten für alle Items, nicht nur für Bestellungen:
Gehe in deinem Projekt zu Setup > Bestellungen.
Klicke auf den Button „Alternative ID Mapping“. Es erscheint ein Popup mit allen früheren und aktuellen Zuordnungen deiner Produkte.
Nutze das Suchfeld oben rechts im Popup, um die Einträge nach ID, Titel oder anderen Kriterien zu filtern und die Navigation zu erleichtern.
ID-Zuordnung für in Bestellungen verwendete Items anzeigen
So bekommst du eine Ansicht mit früheren und aktuellen Einträgen für Items, die in Bestellungen verwendet werden:
Gehe in deinem Projekt zur Seite „Bestellungen“ und klicke auf „Alternative ID Mapping“.
Sieh dir frühere und aktuelle ID-Zuordnungsdaten für alle in Bestellungen verwendeten Items an.
Erklärung der Spalten in der ID-Zuordnungsansicht
Eindeutige ID: Die Kennung, die deine E-Commerce-Plattform verwendet, um das Produkt zu referenzieren.
Alternative ID: Der Kennungstyp, den Channable verfolgt, zum Beispiel SKU oder EAN/GTIN.
Wert: Der konkrete Wert der alternativen ID, zum Beispiel die spezifische SKU oder der EAN-Code.
Erstellt: Datum und Uhrzeit, wann der Zuordnungseintrag erstellt wurde.
Status: Zeigt an, ob die Zuordnung aktuell aktiv oder inaktiv ist.
Bevor du die Zuordnung alternativer IDs aktivierst
Prüfe zuerst diese Punkte. Das spart dir später Zeit.
Bestätige, welche Kennung der Marktplatz in den Bestelldaten zurückgibt (meist Seller SKU).
Bestätige, dass dieser Kennungswert irgendwo beim passenden Webshop-Produkt vorhanden ist.
Beispiel: Der Marktplatz sendet eine EAN, aber bei deinem Webshop-Produkt ist das EAN-Feld leer.
Prüfe auf Duplikate bei alternativen IDs.
Beispiel: Zwei Produkte haben dieselbe EAN/GTIN.
Prüfe, ob ein zweiter Import Kennungen überschreibt, die für den Abgleich verwendet werden.
Detaillierte Setup-Checkliste (empfohlen)
Nutze diese Checkliste, bevor du die Einstellung aktivierst. Sie verhindert die meisten Probleme vom Typ „Produkt nicht gefunden“.
1) Wähle deine Abgleichstrategie
Wähle eine Kennung aus, über die Bestellungen abgeglichen werden sollen.
Häufige Optionen:
SKU: Am besten, wenn jedes verkaufbare Item eine stabile SKU hat.
EAN/GTIN: Am besten, wenn jedes verkaufbare Item einen gültigen Barcode hat.
Vermeide es, Kennungen über verschiedene Listings hinweg zu mischen, außer du musst es wirklich.
2) Prüfe, ob die gewählte ID beim verkaufbaren Item vorhanden ist (oft bei Varianten)
Prüfe deinen Produktkatalog auf die gewählte ID:
Sie sollte auf der Variante -Ebene vorhanden sein, wenn du Varianten verkaufst.
Sie sollte bei den Produkten ausgefüllt sein, die du auf dem Marktplatz verkaufst.
Prüfe mindestens 10 Items stichprobenartig:
3 einfache Produkte
3 Variantenprodukte (mehrere Größen/Farben)
2 Bestseller
2 „Problemprodukte“, die vorher fehlgeschlagen sind
3) Prüfe die Konsistenz der Formatierung
Der Abgleich ist exakt. Kleine Abweichungen führen dazu, dass er fehlschlägt.
Prüfe auf:
führende oder nachgestellte Leerzeichen
abweichende Groß-/Kleinschreibung (vor allem bei SKUs relevant)
fehlende führende Nullen (häufig bei CSV-Exporten)
unterschiedliche Trennzeichen (
SKU-001vs.SKU001)
Behebe die Formatierung zuerst in deinem Quellsystem.
4) Entferne Duplikate für die gewählte alternative ID
Duplikate führen zum Szenario „mehrere Treffer gefunden“. Dann kann Channable nicht zuverlässig ein Produkt auswählen.
Führe in deinem Katalog eine Duplikatsprüfung für die gewählte ID durch:
Wenn zwei Produkte denselben EAN/GTINhaben, korrigiere oder entferne einen der Werte.
Wenn Platzhalter-SKUs vorhanden sind (
NA,0,DEFAULT), ersetze sie.
Wenn du keine Duplikate entfernen kannst, wechsle zu einer anderen Abgleichstrategie.
5) Bestätige, dass dein Hauptimport die maßgebliche Quelle ist
Die Zuordnung alternativer IDs basiert auf den Kennungen, die aus deiner Hauptimportquelle.
Vor der Aktivierung:
Stelle sicher, dass dein Hauptimport die richtigen SKU-/EAN-Werte enthält.
Vermeide es, diese Kennungen über einen zweiten Import zu überschreiben (zum Beispiel durch CSV-Anreicherung).
Wenn du Kennungen per CSV importieren musst, halte es konsistent und plane eine Übergangszeit ein.
6) Prüfe die Einträge der Zuordnung alternativer IDs
Öffne die Zuordnungsübersicht und prüfe, was Channable erfasst hat. Siehe Auf die ID-Zuordnungsdaten zugreifen.
Worauf du achten solltest:
Fehlende alternative IDs bei Produkten, die du verkaufst
Doppelte Werte bei unterschiedlichen Produkten
Alte/veraltete Werte nach einer Migration
7) Aktivieren und mit einer kleinen Stichprobe prüfen
Aktiviere Alternative IDs für Bestellartikel verwenden bei der Bestellsynchronisation.
Prüfe es dann mit mindestens einem:
zuvor fehlgeschlagenen Auftrag (ideal) oder
neu eingegangenen Auftrag
Prüfe beides:
Die Bestellung wird erfolgreich erstellt.
Der die richtige Variante wird zugeordnet.
8) Ausrollen und überwachen
Sobald der Abgleich korrekt funktioniert:
Aktiviere die Funktion auch bei anderen Bestellsynchronisationen, falls du welche hast.
Behalte Fehler wie „Produkt nicht gefunden“ und „mehrere Treffer gefunden“ im Blick.
Wenn die Fehler zunehmen, korrigiere zuerst die Katalogdaten. Vermeide Workarounds, die noch mehr Inkonsistenzen bei Kennungen erzeugen.
Alternative ID-Zuordnung aktivieren
Wähle das Kontrollkästchen Alternative IDs für Bestellartikel verwenden bei der Bestellsynchronisation aus, die du aktivieren möchtest.
Klicke Speichern. Danach kannst du Alternative ID-Zuordnung (Setup > Bestellungen) öffnen, um die erfassten Zuordnungen zu prüfen.
Was diese Einstellung nicht tut
Die Zuordnung alternativer IDs hilft dabei, Bestellartikel mit bestehenden Webshop-Produkten abzugleichen. Sie tut nicht Folgendes:
die Kennung ändern, die du an einen Marktplatz sendest, wenn du Produkte listest.
duplizierte EAN-/SKU-Werte in deinem Webshop-Katalog beheben.
die Bestellungserstellung garantieren, wenn der Marktplatz unbekannte Produktkennungen sendet.
Szenarien für den Abgleich alternativer Kennungen
Alternative Kennungen wie EAN- und SKU-Codes sind nicht immer eindeutig. In deinem Produktkatalog kann es mehrere Produkte mit derselben EAN geben oder Produkte ganz ohne EAN. Channable gleicht die richtige Datenbank-ID der E-Commerce-Plattform anhand der alternativen Kennung ab, die vom Marktplatz empfangen wurde.
Wir prüfen, ob eine der Datenbank-IDs der E-Commerce-Plattform der Produkt-ID aus den Bestelldaten über alle überwachten alternativen Kennungen hinweg entspricht. Drei Szenarien sind möglich:
Keine Übereinstimmung gefunden
Channable kann die Marktplatz-Kennung keinem Webshop-Produkt zuordnen. Channable versucht, die Bestellung mit der Marktplatz-Kennung zu erstellen. Das kann fehlschlagen, wenn dein Webshop diese Kennung nicht erkennt.
Lösung: Füge dem Webshop-Produkt die fehlende alternative ID hinzu oder ändere, was der Marktplatz sendet.
Mehrere Übereinstimmungen gefunden
Identische Werte über verschiedene Kennungen hinweg: Channable überwacht möglicherweise mehrere alternative Kennungswerte für deine E-Commerce-Plattform, zum Beispiel sowohl SKU als auch EAN, und beide haben für ein Produkt identische Werte. In diesem Fall gibt es eine einzige Datenbank-ID der E-Commerce-Plattform, und die Bestellung wird mit genau dieser einen Datenbank-ID erstellt. Channable prüft, ob die mit dem zugeordneten SKU- und EAN-Eintrag verknüpfte Datenbank-ID der E-Commerce-Plattform identisch ist.
Mehrere Produkte mit derselben Kennung: Mehrere unterschiedliche Produkte in deiner E-Commerce-Plattform haben denselben Wert für eine alternative ID. Channable kann nicht das richtige auswählen. Channable greift beim Erstellen der Bestellung auf die Marktplatz-Kennung zurück. Das kann in deinem Webshop zu einem Fehler beim Erstellen der Bestellung führen.
Lösung: Entferne doppelte Kennungswerte in deinem Webshop oder ändere, welche Kennung der Marktplatz verwendet.
Schnelle Checks zur Fehlerbehebung
Wenn du nach dem Aktivieren der Einstellung weiterhin „Produkt nicht gefunden“ siehst, liegt es meist an einem dieser Punkte.
Der Wert der alternativen ID ist beim Webshop-Produkt leer.
Der Marktplatz sendet eine andere Kennung als erwartet.
Beispiel: Du hast EAN erwartet, aber es wird Seller SKU gesendet.
Der Wert der alternativen ID ist vorhanden, kommt aber bei mehreren Produkten vor.
Ein zweiter Import hat die Kennungswerte überschrieben, nachdem sie erfasst wurden.
Zuletzt aktualisiert
War das hilfreich?