Schnittstelle einrichten

... in Shopware 6

Um Hublify mit Shopware zu verbinden, benötigst du einen API-Zugang für deinen Shopware-Shop.

Hierzu einfach das Shopware Admin-Backend öffnen und dort zu "Einstellungen" / "System" / " Integrationen" wechseln.
Dort kann über den Button "Integration anlegen" ein neuer API-Zugang erstellt werden.

Der Name kann frei vergeben werden. "Administrator" aktivieren und "Zugangs-ID" und "Sicherheitsschlüssel" merken.
Nachdem du dort "Integration speichern" geklickt hast, kannst du mit dem Einrichten in Hublify fortfahren.

... in Hublify

Hierzu wechselst du in der Hublify App in den Bereich System / Datahub und füllst unter "Connect with..." / "Shopware 6"
das vorbereitete Formular aus.

Neben den Zugangs-ID und Sicherheitsschlüssel wird dafür auch noch die API-Url benötigt.
Dies ist üblicherweise "<shopware-shop-url>/api", also z.B. "https://mein.shopware.shop/api".

Mit "Verbindung prüfen" kannst du einen ersten Verbindungstest durchführen, um sicherzustellen, dass alle Werte richtig eingetragen sind. Über den Button "Verbindung einrichten" schließt du die Einrichtung der Schnittstelle ab.
Jetzt kannst du in der Hublify-App auf Livedaten aus deinem Shopware-Shop zugreifen und deine Auftrags- und Produktdaten synchronisieren.

Bei Bedarf kannst du die Konfiguration deiner Schnittstelle weiter anpassen, um z.B. spezielle Custom-Fields im Daten-Mapping zuzuordnen oder die Frequenz der automatisierten Im- und Exporte für deinen Use-Case anzupassen. Die durch die Erstrinrichtung vorbereiteten Konfigurationen sind in Folge beschrieben.

Aufträge synchronisieren

Direkt nach der Ersteinrichtung ist dein Connector bereit, Aufträge automatisiert aus Shopware abzuholen.
Hierfür wird in regelmäßigen Abständen geprüft, ob neue Aufträge im Shopware-System vorhanden sind. Diese werden dann in Hublify importiert (Rechnungs- und Lieferadresse, Kundendaten, bestellte Produkte und Zusatzposten wie z.B. Gutscheine, gewählte Versand- und Zahlungsart, ...)
Die Aufträge werden dabei dem bei der Einrichtung festgelegten POS Channel zugewiesen.
So kannst du auch mehrere Shopware-Shops in einem Hublify zusammen verwalten.

Falls du die Weiterverarbeitung der Aufträge in Hublify vornimmst, kannst du den Status der Aufträge und zugehörigen Lieferungen über den Connector an Shopware zurückmelden. 

Produkte und Produktgruppen

Du kannst entscheiden, ob du die Produkte und Kategorien in Shopware pflegst und in Hublify importierst oder umgekehrt.

Für die Produktgruppen wird hierbei in Hublify standardmäßig ein Katalog passend zum jeweiligen POS-Channel angelegt,
Dort wird der Kategoriebaum für den entsprechenden Shopware-Shop hinterlegt.

Du kannst die Produktdaten inkl. ihrer Varianten, Bilder und Custom-Fields in Hublify importieren.
Über das Data-Mapping kannst du bei Bedarf die Zuordnung der einzelnen Datenfelder auch individuell anpassen.
Für den Fall, dass du mehrere Shops mit Hublify synchronisierst, können Preise und Online-Status shopspezifisch in den Channelpreisen gespeichert werden.

Für den Export der Produkte sind zwei Versionen vorkonfiguriert, die miteinander kombiniert und individuell über das Data-Mapping angepasst werden können.

Zum einen die Übertragung des gesamten Produktes (inkl. Bildern, Kategorien, Preisen etc.). Dies kann automatisiert für alle Produkte erfolgen. Da sich diese Daten nicht so häufig ändern, empfiehlt sich hierfür eine geringere Synchronisierungsfrequenz oder auch eine rein manuelle Übertragung ganz ohne Automatismus.

Des Weiteren können auch nur die geänderten Lagerbestände und (Channel)Preise übertragen werden. Da sich diese häufiger ändern, wäre hier ein regelmäßiger automatisierter Abgleich zu empfehlen.

Zusätzlich zum Gesamtexport aller Produkte/Preise hast du die Möglichkeit, über die Aktion "Daten übertragen an..." manuell einzelne Produkte (oder Channelpreise) in das externe Shopware-System zu pushen.