Anders als noch in Shopware 5 wird für die API-Verbindung zu Shopware 6 nicht die Kombination aus API-Benutzername und API-Passwort benötigt, sondern eine Kombination aus Client-ID und Client-Secret (Zugangsschlüssel und Sicherheitsschlüssel). Um diese Verbindungsdaten zu erhalten, navigieren Sie im Shopware-Backend bitte zunächst zu Ihrem administrativen Benutzerprofil, wählen hier die Systemeinstellungen aus und klicken dort dann auf den Menüpunkt "Benutzer & Rechte".


Anschließend gelangen Sie zu Ihren angelegten Benutzer-Accounts. Wählen Sie unter diesen bitte den passenden Account aus:


Haben Sie hier noch keinen Benutzer-Account erstellt, so holen Sie dies zunächst bitte nach, indem Sie im Bereich "Basisinformationen" alle wichtigen Grunddaten hinterlegen.


Im Anschluss scrollen Sie bitte weiter nach unten zu dem Punkt "Integrationen". Hier klicken Sie auf die Schaltfläche [ Zugangsschlüssel erstellen ], um Client-ID und Client-Secret für die API-Verbindung automatisiert generieren zu lassen:


Nach einem Klick auf den Button öffnet sich ein neues Dialogfenster, in welchem Ihnen direkt der Zugangsschlüssel sowie der dazugehörige Sicherheitsschlüssel angezeigt werden. Diese kopieren Sie bitte beide in die Zwischenablage. Wie die entsprechende Warnmeldung in dem Dialogfenster bereits suggeriert, ist insbesondere das Wegsichern des Sicherheitsschlüssels (bzw. des Client-Secrets) von großer Bedeutung, da dieser nur einmalig angezeigt wird. Unterhalb der Generierungsfunktion ist dann nur noch der Zugangsschlüssel ersichtlich.


Haben Sie Zugangs- und Sicherheitsschlüssel kopiert, können Sie beide Schlüssel anschließend im Grundlagenregister unter "Externer Shop / Grundlagen / Shops" in die Eingabefelder "API Benutzer / ClientID" (Zugangsschlüssel) sowie "API Passwort / Client-Secret" (Sicherheitsschlüssel) einfügen (siehe auch Unterkapitel "Reiter Grundlagen").

Die UUID erhalten Sie, wenn Sie im Shopware 6-Backend (Admin-Bereich) im Hauptmenü auf der linken Seite den Menüeintrag "Kataloge" anklicken bzw. aufklappen und dort dann den Untermenüpunkt "Kategorien" auswählen. Der hier angezeigte oberste Katalog (im Screenshot-Beispiel "Katalog #1") stellt die Root-Kategorie dar und beinhaltet somit die benötigte UUID. Klicken Sie daher bitte diese Root-Kategorie an und kopieren Sie die für diese Root-Kategorie in der Browser-Adresszeile angegebene UUID (zwischen den URL-Bestandteilen "index" und "base") in die Zwischenablage und von dort in das Eingabefeld "ID der Root-Kategorie Shop".

Das Varianten-Mapping muss über alphanumerische Zeichenketten (UUIDs) manuell durchgeführt werden, eine Automatisierung des Vorgangs ist aktuell nicht möglich.


Im Shopware-Backend bzw. Administrationsbereich navigieren Sie in der Menüleiste auf der linken Seite bitte zunächst zum Bereich "Kataloge" und klicken diesen an. In dem sich daraufhin aufklappenden Untermenü klicken Sie anschließend auf den Eintrag "Eigenschaften". Daraufhin wird ein neuer Übersichtsdialog mit Eigenschaften wie z.B. Farbe und Größe angezeigt. Diese entsprechen den Variantendimensionen in der myfactory.


In der Spalte "Eigenschaft" klicken Sie dann bitte auf die gewünschte Eigenschaft, welche Sie auf die entsprechende myfactory-Dimension - bspw. "Farbe" - mappen möchten. Anschließend gelangen Sie in den Detaildialog der Eigenschaft "Farbe". Richten Sie Ihr Augenmerk nun auf die Adresszeile des Browsers. Hinter dem Parameter "detail" findet sich in der URL eine Zeichenfolge bestehend aus Zahlen und Buchstaben. Diese UUID markieren Sie bitte und kopieren diese in die Zwischenablage (oder alternativ in eine Textdatei).


Sofern noch nicht geschehen, fügen Sie mithilfe der [ Hinzufügen ]-Schaltfläche zunächst bitte die für das Mapping benötigte myfactory-Dimension in das Register ein. Die Dimension "Farbe" können Sie über das "Dimension suchen"-Auswahlfenster selektieren.


Aus der Zwischenablage (oder Textdatei) fügen Sie anschließend die kopierte UUID in das Eingabefeld der Spalte "Shop-Wert ID" ein. Diesen Vorgang wiederholen Sie bitte für sämtliche Dimensionen, welche Sie für das Übertragen von Variantenartikeln über die Shopware-Schnittstelle benötigen.



Anders als beim Mapping der myfactory-Dimensionsnamen auf die Shopware 6-Eigenschaften lassen sich die für das Abbilden der myfactory-Dimensionswerte auf die Eigenschaftsausprägungen notwendigen UUIDs nicht aus der Browser-Adresszeile herausziehen.


Die zugehörigen UUIDs müssen stattdessen aus der Shopware 6-Datenbank entnommen werden. Melden Sie sich dazu mit Administratorrechten in der PHP-basierten Shopware-Datenbank auf Ihrem Server an, navigieren Sie zur Shopware-Tabelle "property_group_option_translation" und kopieren Sie aus der Spalte "property_group_option_id" die alphanumerische Zeichenkette hinter "0x" in die Zwischenablage. Bitte achten Sie hierbei unbedingt darauf, die Zeichenfolge "0x" wegzulassen und diese nicht zu kopieren. Diese dient nur der Darstellung hexadezimaler Werte und führt beim Abgleich bzw. Mappen der Daten sonst zu Fehlern.


Haben Sie die gewünschten UUIDs kopiert, dann können Sie diese in das Eingabefeld der Spalte "Shop-Wert (ID/Name)" in dem Dialog "Dimensionswerte" einfügen.



Zu diesem Dialog gelangen Sie über die kleine Lupen-Schaltfläche hinter der benötigten Dimensionsbezeichnung (also z.B. "Farbe" und/oder "Größe") im Shopgrundlagen-Register "Dimensionen".


Hierbei ist als Voraussetzung darauf zu achten, dass die aus den myfactory-Dimensionswerten zusammengesetzten Artikelvarianten im Artikelstamm für das Übertragen/Mappen aktiv geschaltet sind und nicht ausgeschlossen werden. Über den "Aktiv"-Schnellfilter auf der linken Seite des Dialogs "Artikelvarianten" (zu erreichen über die Schaltfläche [ Varianten ] im Register "Dimensionen" des betreffenden Artikels im Artikelstamm) können Sie dabei zügig prüfen, ob ihre myfactory-Artikelvarianten für die Übertragung zu Shopware verfügbar sind und hier ggf. tätig werden.


Anschließend können Sie zum Dialog "Artikel-Profil ausführen" (unter "Externer Shop / Aktionen") wechseln, um die gemappten myfactory-Varianten zu exportieren und im Shopware 6-Backend zu generieren. Denken Sie hierbei daran, ggf. die Artikelnummer des Hauptartikels im Artikel-Profil zu hinterlegen (Alternativ sollte der Hauptartikel in einem Artikelkatalog gepflegt sein und dieser in dem entsprechenden Eingabefeld hinterlegt werden.)




Bei erfolgreicher Variantenartikel-Übertragung erhalten Sie - wie bei den herkömmlichen Artikeln - eine entsprechende Erfolgsmeldung.


Das erfolgreiche Exportieren und Anlegen einer Variante im Shop können Sie in detaillierter Form außerdem dem Auswertungsdialog "Ereignismeldungen" entnehmen.


Nun finden Sie die übertragene Artikelvariante im Shopware 6-Backend vor. Dies können Sie leicht überprüfen, indem Sie im Backend in den Menüzweig "Kataloge / Produkte" wechseln, dort den betreffenden Hauptartikel anklicken (hier: Pullover Modell Isabell) und anschließend in den Detaildaten auf den Reiter "Varianten" klicken. Hier ist jetzt die gewünschte Variante samt Preis, Lagerbestand, Variantenartikelnummer und - falls bei dem Artikel hinterlegt - mit einem Artikelbild eingetragen.


Ihre Kunden sehen in der Shop-Oberfläche nun ebenfalls den Artikel mit den zugeordneten und übertragenen Varianten.