Einrichtungstutorial: Shopware 6 Connector

Der Shopware 6 Connector bindet deinen Shopware-6-Shop an dein tricoma System an. Damit kannst du Produktdaten, Lagerbestände an deinen Shopware-6-Shop übergeben und Bestellungen in dein System importieren.
Um dies abzubilden, benötigst du eine Schnittstelle, die entsprechend eingerichtet werden muss. Wie du dazu vorgehst, erfährst du folgend.

Shops

Um die Einrichtung zu beginnen, klicke auf Einstellungen → Shops. Beim ersten Aufruf erhältst du die Meldung: „Es ist kein Shopware 6 Shop angelegt.“

Trage für deine neue Schnittstelle einen beliebigen Shopnamen ein und klicke auf Anlegen. Damit wird die Schnittstelle angelegt.

Shop-Daten

Nach dem Anlegen deiner Schnittstelle öffnet sich die Konfiguration mit folgenden Einstellungen:

Titel
Hier kannst du nachträglich den Titel deines Shops ändern.

Shop URL
Trage hier die Domain ein, unter der dein Shop erreichbar ist. Beispiel: https://mein-shop.de/

Backend Benutzer
Lege im Shopware-Backend einen eigenen Benutzer für tricoma an, weise diesem Administratorrechte zu und trage den Benutzernamen hier ein.

Backend Passwort
Trage das Passwort des oben angelegten Benutzers ein.
Achtung: Verwende keine Sonderzeichen oder Umlaute!

API-Einstellungen

Hinweis: Ab tricoma 5.1 wird kein Plugin mehr im Shopware-6-Backend benötigt. Falls du nach dem Update noch das Plugin im Backend installiert hast, deinstalliere es bitte und befülle die folgenden Eingabefelder:

API Version
Trage hier die zweite Ziffer der API-Version ein. Für Shopware 6.4 gibst du die 4 ein, für 6.5 die 5 usw.

API ohne Versionsaufruf
Ab Shopware 6.4 solltest du diese Option aktivieren.

API URL
Bezieht sich auf deine Shop-URL (wie oben).

API Benutzer und API Passwort
Bezieht sich auf den Backend-Benutzer und das Passwort (wie oben).
Achtung: Verwende keine Sonderzeichen oder Umlaute!

API Client ID und API Schlüssel
Trage hier die API Client ID und den API Schlüssel ein — diese erhältst du im Shopware-6-Backend.

Im Anschluss kannst du über den Verbindungstest-Button prüfen, ob eine Verbindung zum neu eingerichteten Shopware-6-Shop besteht.
War der Verbindungstest erfolgreich, solltest du direkt danach in den Tools die Eigenschaften / Ausprägungen initialisieren:

Automatischer Abgleich:

Hier legst du fest, welche Automatismen regelmäßig ausgeführt werden sollen. Beachte bitte, dass die Automatismen nur greifen, wenn dein tricoma System live ist.

Bestellungen importieren
Mit diesem Automatismus holt tricoma die Bestellungen aus deinem Shop ab. Bestellungen werden nur importiert, wenn bestimmte Statuskombinationen zutreffen (z. B. Bestellstatus: offen, Zahlungsstatus: bezahlt). Sind beide auf offen, wird die Bestellung nicht importiert.

Statusmeldungen abgleichen
Legt fest, ob Statusänderungen des Bestellstatus von tricoma zurück an Shopware übergeben werden sollen (nach dem Import).

Lagerbestand abgleichen
Mit dieser Option wird der Bestand deiner Produkte abgeglichen werden. Werden Lieferungen in tricoma über den Checkout-Button ausgebucht, wird der Bestand entsprechend an Shopware übertragen.

Produkte vormerken
Wenn du Produkte mit neuen Daten versiehst, werden diese zum Abgleich automatisch vorgemerkt und beim nächsten Abgleich aktualisiert.

Produkte abgleichen
Produkte werden fortlaufend abgeglichen – jede Änderung an den Produktdaten wird an Shopware übertragen.

Eigenschaften abgleichen
Wenn diese Option aktiv ist, werden die Produkteigenschaften abgeglichen.
Wichtig ist, dass vorher in der erweiterten Konfiguration die Eigenschaften bearbeitet wurden.

Zuweisungen entfernen
Wenn ein Produkt nicht mehr im Shopware-6-Shop vorhanden ist, werden die Zuweisungen zum Produkt in tricoma entfernt.

Titel der Varianten vom Hauptartikel
Diese Einstellung betrifft deine Variantenartikel: der Titel des Hauptprodukts wird für die Varianten verwendet, wenn du Varianten in tricoma gepflegt hast.
Mehr dazu hier: Variantenübertragung im Shopware 6 Connector

Kategoriezuweisungen beim Abgleich löschen
Wenn sich Kategoriezuweisungen häufig ändern, kannst du diesen Haken setzen. Bei jedem Abgleich wird die Kategoriezuweisung gelöscht und neu gesetzt, sodass die Zuweisungen im Shop immer denen in tricoma entsprechen.
Achte darauf, dass die Kategorien in der erweiterten Konfiguration korrekt zugeordnet sind.

Erweiterte Konfiguration:

Treffen Sie hier die erweiterte Konfiguration Ihrer Shopware 6 Schnittstelle.

• Kategorien:
• Unter dem Punkt Kategorien weisen Sie Ihre Shopkategorien den bereits angelegten Kategorien in Ihrem tricoma System zu. Achten Sie hierbei auf den Hacken, den Sie bei der Zuweisung der Kategorien treffen können. Sofern dieser gesetzt ist, werden alle Produkte dieser Kategorien nach Shopware übertragen. Ist der Hacken nicht gesetzt, werden vorerst keine Produkte übertragen.
  Genaueres dazu hier: Kategoriezuweisung in Shopware 6
• Eingenschaften und Optionen:
• Diese Einstellung lohnt sich auf jeden Fall, wenn Sie Variantenartikel bzw. Diversifikationen in Ihrer tricoma Warenwirtschaft gepflegt haben. Lesen Sie sich hierzu am besten folgende Anleitung durch: Was bedeutet die Übertragung der Eigenschaften in Shopware 6?
• Verkaufskanal:
• Ordnen Sie hier Ihren Verkaufskanal zu. Achtung bei mehreren Verkaufskanälen in Ihrem Shopware System. Mehrere Zuweisungen sind nicht möglich. Für den Abgleich der Produkte können Sie hier einen neuen Shop anlegen. Achten Sie hierbei darauf, dass Sie einen eigene Kategorien und Produkte für den neuen Verkaufskanal führen.
• Kundengruppen:
  • Definieren Sie hier, welche Kundengruppe aus Shopware 6 welcher Kundengruppe in tricoma zugewiesen werden soll. Zusätzlich können Sie ein Werbekennzeichen einstellen, um später weitere Filtereinstellungen in verschiedenen Apps treffen zu können. Die Zuweisung findet beim Bestellimport statt. Eine Übertragung der Kundengruppe zu Shopware 6 findet nicht statt.
    Mehr dazu hier: Shopware 6 - Kundengruppen Zuweisungen - Werbekennzeichen Zuweisungen
• Versandarten:
• Hier können Sie Ihre Versandarten abholen und den Versandarten und Versandkostenprodukt(en) aus Ihrem tricoma System zuordnen.
• Zahlungsweisen:
• Selbiges gilt für die Zahlungsweisen, diese können Sie unter diesem Punkt zuordnen.
• Bestellstatus:
• Ab Shopware 6.3.3.* ist es nicht mehr möglich den Bestellstatus einfach zu setzen. Die neu eingebaute Logik von Shopware lässt nur noch fest vorgegeben Status eintragen. Deswegen muss hier die Bestellstatus-Zuordnung konfiguriert werden.

Allgemeine Einstellungen:

Die allgemeinen Einstellungen des Shopware Connectors beschreiben, wie der Name schon sagt, die "Allgemeinen Einstellungen".
Hier hinterlegen Sie folgende Punkte:

• Werbekennzeichen:
• Hinterlegen Sie Ihr Werbekennzeichen. Für Shopware 6 empfiehlt sich natürlich eine Bezeichnung wie "Shopware 6". Wenn Sie dieses hinterlegen, können Sie später nach den importierten Bestellungen aus Shopware 6 in der App Bestellungen oder Lieferungen filtern. Somit erleichtern Sie es sich genau die Bestellungen oder Lieferungen zu finden, die aus diesem Verkaufskanal kommen. Mehr zu Werbekennzeichen finden Sie hier: Werbekennzeichen verwalten und auswerten
• Tracking-URLs übertragen:
• Dies beschreibt die Übertragung der eingetragenen Trackingcodes aus den Connectoren der Versanddienstleister. Wenn Sie also in die Lieferung Ihre Trackingcodes eintragen lassen, können Sie diese mit an Shopware 6 übergeben. Ihre Kunden können diese dann in deren Kundenaccount von Shopware 6 einsehen.
• Lieferantenbestand beachten:
  • Ist diese Option aktiv, wird der eingetragene Lieferantenbestand bei der Übertragung der Produkte / des Lagerbestands mit berücksichtigt. Ihr eigener Lagerbestand und die Lagerbestände Ihrer Lieferanten werden summiert und übertragen.
• Rabattprodukt zuweisen:
• Dies ist optional. Wird nur benötigt, wenn Sie Rabatt geben möchten. Tragen Sie hier die Produkt-ID des Systemartikels für Rabatte ein.
• API Entwickler Tools aktivieren:
• Hiermit können Sie über den Reiter "Tools" Ihre Schnittstelle testen. Nutzen Sie hier den Navigationspunkt "API Test DEBUG". Sie können hiermit unter Angabe der richtigen API-Version Ihres Shops einen API Aufruf generieren, der im besten Fall ein Ergebnis liefert. Liefert er keines, sollten Sie Ihre Version, bzw. Ihre eingetragenen Shopdaten überprüfen.

Bestellungen:

Im Reiter "Bestellungen" finden Sie alle importierten Bestellungen.
Sie können hier auch Details über die importierten Bestellungen einsehen (Welche Rohdaten von Shopware an tricoma übergeben wurden).
Jeweils ist hier der Kunde und die Bestellung verknüpft.

Beim Bestellimport wird in tricoma die Bestellung direkt mit den enthaltenen Produkten importiert. Achten Sie hier darauf, dass Ihre Artikelnummern immer übereinstimmen (Art.NR. tricoma = Art.NR. Shopware Shop).

Die Referenznummer wird jeweils in den Bestellungen mit eingetragen, sodass Sie auch in der App Bestellungen nach der Referenznummer aus Shopware suchen können.

Meldungen:

Im Reiter "Meldungen" erhalten Sie Informationen, falls es bspw. zu einer fehlerhaften Übertragungen kam oder Bestellungen die nicht importiert werden konnten. Bei Letzterem liegt es meistens daran, dass eine Artikelnummer bereits importiert wurde oder es keine Verknüpfung zum Produkt in tricoma gibt. Diese Meldungen sind sehr hilfreich, um eine einwandfreie Funktionalität zu gewährleisten. Sollten Sie Meldungen erhalten und nicht wissen, was diese bedeuten, können Sie sich gerne an den tricoma Support wenden. Wir helfen Ihnen gerne weiter.

Es empfiehlt sich, die Meldungen regelmäßig zu bereinigen, sofern diese nicht mehr benötigt werden, um eine stetige Ansammlung von Datenmüll zu vermeiden.

Produkte:

Im Reiter "Produkte" befinden sich alle zum Shop / zu den Shops abgeglichenen Produkte. Zum Produkt ist jeweils eine Verlinkung in der App Produkte vorhanden.
So können Sie schnell in das gewünschte Produkt switchen. Der jeweilige Status beschreibt die Aktion, die als nächstes ausgeführt wird.

Sie erhalten auch hier die übergebenen Produktdaten zu Shopware 6 in den jeweiligen Details, ähnlich wie im Reiter "Bestellungen".

Tools:

In den Tools können verschieden Aktionen manuell ausgeführt werden.

Shopdaten abholen

• Hier können Sie sämtliche Daten aus Ihrem ausgewählten Shop abholen. Dies macht vor allem Sinn, wenn Sie einen neuen Shop in dem Connector einrichten.

Bestellungen abholen

• Hier können Sie Bestellungen für einen bestimmten Zeitraum und Shop abholen. Sie können auch die Bestellnummer aus Shopware 6 eintragen, um eine einzelne oder mehrere einzelne Bestellungen aus dem Shop abzuholen. Aktivieren Sie die Debugausgabe, um zu sehen, ob die Abholung erfolgreich war oder nicht. (1 = erfolgreich, 0 = nicht erfolgreich)

Produkte abgleichen

• Über den Punkt "Produkte abgleichen" können Sie verschiedene Aktionen ausführen:
• Zum Produktabgleich vormerken: Hier können Sie alle Produkte, bei denen die Produktdaten geändert wurden, zum Abgleich vormerken.
• Zum Produktabgleich vormerken je Kategorie: Hier können Sie Produkte, bei denen die Produktdaten geändert wurden, je nach Produktkategorie zum Abgleich vormerken. Hierbei werden alle Produkte in der Kategorie, die online sind, vorgemerkt. Vorhandene Unterkategorien werden dabei nicht beachtet.
• Zum Bestandsabgleich vormerken: Hiermit können Sie Produkte zum Bestandsabgleich vormerken, bei denen sich der Bestand geändert hat.
• Zuweisung von Produkten: Sollten falsche oder keine Verknüpfungen zu Produkten zum Shop mehr vorhanden sein, können Sie diese mit diesem Button bereinigen.

Offene Abgleichaufträge

• Hier können Sie offene Abgleichsaufträge zurücksetzen. Nach dem Zurücksetzen wird jedoch beim nächsten Vormerken wieder die entsprechende Aktion gesetzt.

Bilder abgleichen

• Gleichen Sie hiermit die Bilder Ihrer Produkte manuell ab. Entweder alle Bilder oder unter Angabe der Artikelnummer(n) auch von einzelnen Produkten.

API Test DEBUG

• Sie haben hier die Möglichkeit, einen Verbindungstest pro angelegtem Shop durchzuführen. Anders als beim allgemeinen Verbindungstest in den Shopeinstellungen erhalten Sie hier auch eine Debugausgabe.