Produkt-Matching per SKU & Web-ID

Damit ein Artikel nicht doppelt in Shopware angelegt wird, gleicht der Connector vor dem Upload ab, ob das Produkt dort bereits existiert. Grundlage ist die Artikelnummer, die in Shopware der productNumber (SKU) entspricht.

So funktioniert der Abgleich

• Hat der Artikel keine Web-ID, sucht der Connector in Shopware nach einem Produkt mit productNumber = Artikelnummer (SKU). Technisch erfolgt das über den Endpunkt search/product mit einem Filter auf das Feld productNumber.
• Wird ein Treffer gefunden, wird dessen Shopware-ID als Web-ID übernommen – der Artikel gilt damit als verknüpft.
• Danach werden Aktualisierungen per PATCH ausgeführt, nicht als Neuanlage. Das verhindert Duplikate.

Voraussetzung ist, dass die Artikelnummer in BC der SKU/productNumber in Shopware entspricht. Achten Sie auf konsistente Nummern.

Sonderfälle

Kein Treffer

Es existiert kein Produkt mit dieser SKU – der Artikel wird neu angelegt.

Abweichende SKU

Nummern stimmen nicht überein – es entsteht ein Duplikat. Nummern angleichen und erneut matchen.

Bereits verknüpft

Web-ID ist gesetzt – der Abgleich wird übersprungen, es folgt direkt ein Update.

Web-ID zurücksetzen

Möchten Sie die Verknüpfung lösen (z. B. beim Wechsel des Shops), setzen Sie die Web-IDs über die entsprechenden Reset-Funktionen zurück. Siehe Sauberer Neustart per Reset.

Umfangreiche Übernahme

Sollen zusätzlich Bilder, Attribute, Kategorien und Varianten aus Shopware übernommen werden, lesen Sie:

• Artikel-Matching & Datenübernahme aus Shopware
• Attribute & Eigenschaften (Property Groups) abgleichen
• Varianten abgleichen (Farbe & Größe)
• Produktbilder & Medien-Infos abrufen

Häufige Fragen

Welcher Schlüssel wird für das Matching zwischen Business Central und Shopware verwendet?

Primärer Matching-Schlüssel ist die Artikelnummer: Sie wird als productNumber (SKU) in Shopware geschrieben. Sekundär dient die „SOUSHW Web ID“ (Shopware-Produkt-UUID) zur eindeutigen Verknüpfung. Ist die Web-ID gefüllt, aktualisiert der Connector das Produkt per PATCH auf product/{id}; ist sie leer, erfolgt eine Neuanlage per POST.

Wie vermeidet der Connector doppelte Produkte bei der Neuanlage?

Vor einer Neuanlage (Web-ID leer) sucht der Connector über search/product mit Filter field=productNumber, value={Artikelnr.}, type=equalsAll nach einem bereits vorhandenen Produkt mit gleicher SKU. Wird eines gefunden, wird es entfernt und anschließend sauber neu angelegt – so entstehen keine Dubletten. Leerzeichen in der SKU werden dabei über EncodeSKU als %20 kodiert.