> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/shopware/haufige-fragen-faq/faq-download-and-matching.md). # FAQ – Download & Matching Der Shopware 6 API Connector überträgt Daten nicht nur von Business Central nach Shopware, sondern kann auch **Daten aus Shopware zurückholen** und bestehende Objekte **automatisch zuordnen (Matching)**. Die folgenden Fragen erklären ausführlich, wie das funktioniert und worauf Sie achten sollten. ### Was bedeutet „Matching“ beim Shopware 6 API Connector? Als **Matching** bezeichnet man die automatische Zuordnung zwischen einem Objekt in Business Central (z. B. einem Artikel oder Kunden) und dem entsprechenden Objekt in Shopware. Statt bei jeder Übertragung ein neues Objekt anzulegen, prüft der Connector zuerst, ob in Shopware bereits ein passendes Objekt existiert. Ist das der Fall, wird dessen Kennung – die **Web-ID** – in Business Central gespeichert und beide Objekte gelten fortan als **verknüpft**. Dieser Mechanismus ist die Grundlage dafür, dass spätere Änderungen als **Aktualisierung (PATCH)** und nicht als Neuanlage übertragen werden. Dadurch bleiben Ihre Daten in beiden Systemen konsistent und es entstehen keine doppelten Datensätze. ### Wie ordnet der Connector bestehende Shopware-Produkte den BC-Artikeln zu? Beim Produkt-Upload prüft der Connector zunächst, ob der Artikel bereits eine **Web-ID** besitzt. Ist keine Web-ID vorhanden, sucht er über die Shopware-Admin-API (Endpunkt `search/product`) nach einem Produkt, dessen **`productNumber` exakt der Artikelnummer** in Business Central entspricht. Wird genau ein solches Produkt gefunden, übernimmt der Connector dessen **Shopware-Produkt-ID als Web-ID** und verknüpft damit den BC-Artikel mit dem bestehenden Shopware-Produkt. Erst wenn kein passendes Produkt gefunden wird, legt der Connector ein neues Produkt an. Eine ausführliche Beschreibung mit Ablaufdiagramm finden Sie unter Produkt-Matching per SKU & Web-ID. ### Wie vermeide ich doppelte Produkte in Shopware? Duplikate entstehen typischerweise, wenn ein Artikel ohne Web-ID hochgeladen wird, obwohl das Produkt in Shopware bereits existiert. Der Connector beugt dem auf zwei Wegen vor: Erstens durch das oben beschriebene **SKU-Matching**, das vorhandene Produkte erkennt und verknüpft, statt neue anzulegen. Zweitens durch die konsequente Verwendung der Web-ID: Sobald diese gesetzt ist, wird jede weitere Übertragung als **PATCH** ausgeführt. Achten Sie deshalb darauf, dass die **Artikelnummer in BC** und die **SKU/productNumber in Shopware** übereinstimmen – dann funktioniert der Abgleich zuverlässig. ### Was passiert, wenn die BC-Artikelnummer nicht mit der Shopware-SKU übereinstimmt? In diesem Fall kann der Connector das vorhandene Shopware-Produkt nicht automatisch erkennen und würde beim Upload ein neues, zusätzliches Produkt anlegen. Um das zu vermeiden, sollten Sie vor dem ersten Upload sicherstellen, dass die Artikelnummern konsistent sind, oder die vorhandenen Produkte gezielt übernehmen und die Web-ID setzen. Umfangreiche Übernahmeoptionen – inklusive Bilder, Attribute, Kategorien und Varianten – beschreibt die Seite Artikel-Matching & Datenübernahme. ### Wie hole ich Bestellungen aus Shopware nach Business Central? Bestellungen werden über den **inkrementellen Download** geladen. Der Connector merkt sich die zuletzt geladene Bestellung anhand der fortlaufenden Shopware-Nummer (**Auto-Increment**) und holt bei jedem Lauf nur die neuen Bestellungen ab diesem Stand. So werden bereits verarbeitete Bestellungen nicht erneut geladen. Sie können den Download manuell starten oder über die Aufgabenwarteschlange automatisieren. Details unter Auto-Increment & inkrementeller Download. ### Werden beim Bestellimport unbekannte Artikel automatisch angelegt? Ja, sofern die entsprechende Option aktiviert ist. Ist **Unbekannte Artikel erstellen** eingeschaltet, legt der Connector Artikel, die in einer Shopware-Bestellung enthalten sind, aber noch nicht in Business Central existieren, beim Herunterladen der Bestellung **automatisch an**. Die Zuordnung erfolgt über die Artikelnummer. Beachten Sie, dass so angelegte Artikel unter Umständen unvollständige Stammdaten haben (z. B. fehlende Buchungsgruppen) und nachgepflegt werden sollten. Mehr dazu unter Automatische Anlage beim Bestellimport. ### Wie werden Kunden beim Bestellimport zugeordnet? Der Connector sucht zuerst über die **Web-ID** nach dem passenden Debitor, danach über die **E-Mail-Adresse**. Wird kein passender Kunde gefunden, greifen die konfigurierten Regeln für die automatische Kundenanlage bzw. für Standard- und Gastkunden. So lässt sich steuern, ob für jede Bestellung ein eigener Debitor entsteht oder auf einen Sammel-Debitor gebucht wird. Details unter Bestelleingang aus Shopware in BC. ### Kann ich Kategorien, Tags und Gruppenartikel aus Shopware herunterladen? Ja. Für diese Stammdaten stehen dedizierte Download-Funktionen zur Verfügung, damit Sie bestehende Shopware-Strukturen verknüpfen können, statt sie doppelt anzulegen: Kategorien herunterladen, Tags herunterladen sowie das Herunterladen von Gruppenartikel-Daten. Jeweils wird die Shopware-ID mitgeladen, sodass die Objekte korrekt verknüpft sind. ### Welche Stammdaten lädt „Erstdaten laden“ herunter? Die Funktion **Shopware Erstdaten laden** befüllt die Zuordnungstabellen mit den vorhandenen Shopware-Werten. Dazu gehören unter anderem Zahlungsarten, Versandarten, Steuern und Steuerregeln, Währungen, Verkaufskanäle, Kundengruppen, Anreden, Länder, Sprachen sowie die Statusverwaltung und deren Übergänge. Diese Daten bilden die Grundlage für nahezu alle weiteren Prozesse und sollten daher direkt nach dem Verbindungsaufbau geladen werden. Details unter Shopware Erstdaten laden. ### Wie setze ich die Web-ID-Verknüpfung zurück? Möchten Sie die Verknüpfung zwischen BC und Shopware lösen – etwa beim Umzug in eine neue Shopware-Instanz – nutzen Sie die gestuften **Reset-Funktionen**. Damit lassen sich Web-IDs einzelner Objektarten oder die gesamte Anbindung zurücksetzen. Sichern Sie vorher unbedingt Ihre Konfiguration. Eine Anleitung finden Sie unter Sauberer Neustart per Reset. ### Kann ich Bilder und Attribute aus Shopware übernehmen? Ja. Neben dem reinen Produkt-Matching können auch **Bilder, Property Groups (Attribute) und deren Optionen** aus Shopware übernommen und den BC-Artikeln zugeordnet werden. Das Coverbild wird dabei als Standardbild in BC gesetzt. Diese erweiterten Übernahmefunktionen sind je nach Edition/Ausbaustufe verfügbar und werden unter Artikel-Matching & Datenübernahme beschrieben. {% hint style="success" %} Einen kompletten Überblick über alle Download- und Abgleichfunktionen bietet der Bereich Daten aus Shopware (Download & Matching). {% endhint %} ### Wie ordne ich Shopware-Varianten den richtigen Business-Central-Artikeln zu? Beim Varianten-Abgleich werden der übergeordnete Artikel (Parent) und die Kind-Artikel über die Eigenschaften (z. B. Option 1/2/3 für Farbe und Größe) zugeordnet. Der Connector setzt die Web-ID je Variante. Wichtig ist eine konsistente Konfiguration der Farb- und Größen-Eigenschaften. Details unter Varianten abgleichen (Farbe & Größe). ### Was passiert, wenn eine SKU in Shopware und Business Central unterschiedlich ist? Das Matching erfolgt primär über die SKU (productNumber). Weicht die SKU ab, findet der Connector keinen automatischen Treffer und Sie müssen die Web-ID manuell zuordnen oder die SKU angleichen. Details unter Produkt-Matching per SKU & Web-ID. ### Wie übernehme ich Attribute aus bestehenden Shopware-Produkten? Die Aktion **Attribute abgleichen** verknüpft Shopware-Property-Groups per Namens-Matching mit Business-Central-Artikelattributen und setzt die Web-ID sowie die Optionswerte. Es werden keine neuen Attribute angelegt – die Schreibweise muss exakt übereinstimmen. Details unter Attribute & Eigenschaften (Property Groups) abgleichen. ### Wie vermeide ich doppelte Web-IDs nach dem Matching? Sollten durch Fehlbedienung doppelte Web-IDs entstehen, gibt es die Funktion **Fix Duplicated Web IDs**, die doppelte Zuordnungen bereinigt. Grundsätzlich verhindert das SKU-basierte Matching Duplikate, sofern die Artikel sauber gepflegt sind. Details unter Artikel-Matching & Datenübernahme aus Shopware. ### Kann ich Kategorien und Tags aus Shopware übernehmen? Ja. Kategorien und Tags lassen sich aus Shopware herunterladen und per Matching den Business-Central-Objekten zuordnen, sodass Sie bestehende Strukturen weiterverwenden. Details unter Kategorien aus Shopware herunterladen und Tags aus Shopware herunterladen. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.solutioo.de/shopware/haufige-fragen-faq/faq-download-and-matching.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.