Shopware Nexus

Hinweis: Dieses Feature befindet sich derzeit im Beta-Status.
Der Funktionsumfang ist in dieser Version noch eingeschränkt und kann in zukünftigen Updates weiter ausgebaut werden. Es kann sich in Verhalten und Umfang noch ändern.

Wir freuen uns über dein Feedback, um die Funktion gezielt weiterzuentwickeln.

Was ist Nexus?

Nexus ist ein visuelles Automatisierungstool, mit dem du deinen Shopware-Shop mit anderen Systemen und Services verbinden kannst – zum Beispiel mit ERP-Systemen oder Slack.

Du erstellst Workflows direkt auf einer visuellen Arbeitsfläche (Canvas). Dafür ziehst du einzelne Schritte (sogenannte Knoten) per Drag & Drop auf die Oberfläche, verbindest sie miteinander und definierst, was passieren soll:

• wenn ein bestimmtes Shop-Ereignis eintritt (z. B. eine neue Bestellung), oder

• zu einem festgelegten Zeitpunkt (zeitgesteuert).

So können automatisierte Prozesse ohne das Schreiben von benutzerdefiniertem Code konfiguriert werden.

Warum solltest du Nexus verwenden?

Mit Nexus kannst du:

• Routineaufgaben automatisieren: Zum Beispiel automatisch eine Slack-Benachrichtigung senden, sobald eine Bestellung eingeht.

• Shopware mit externen Systemen integrieren – ohne Code: Du konfigurierst Verbindungen und Datenflüsse visuell.

• Überwachen Sie die Workflow-Verarbeitung: Behalte den Überblick über deinen Workflow-Status und grundlegende Verarbeitungskennzahlen.

Hauptfunktionen (Beta)

Die folgenden Funktionen stehen dir aktuell in der Beta-Version zur Verfügung:

Trigger

• Shopware-Ereignis-Trigger: Reagiere auf Ereignisse in deinem Shop (z. B. Bestellung erstellt).

• Schedule Trigger (Cron-Style): Führe Workflows zeitgesteuert aus.

Konnektoren und Aktionen

• Business Central Connector: Create, Read, Update, Delete (CRUD) für viele Business-Central-Entitäten.

• Shopware API Calls: Rufe beliebige Shopware-API-Endpunkte auf.

• Slack Notifications: Sende Benachrichtigungen an Slack.

Logik und Datenverarbeitung

• Conditional Logic (If / Else): Baue bedingte Verzweigungen in deine Workflows ein.

• Data Transformation: Mappe und filtere Daten innerhalb deiner Workflows.

• Expression Placeholders {{ }}: Nutze Platzhalter, um Event-Daten in Vorlagen einzufügen, zum Beispiel in Slack-Nachrichten.

Monitoring

• Workflow-Überwachung: Zeige den Verarbeitungsverlauf und grundlegende Kennzahlen deiner Workflows an.

Mit Nexus kannst du wiederkehrende Prozesse strukturiert automatisieren und deinen Shop flexibel mit anderen Systemen verbinden – visuell, nachvollziehbar und ohne zusätzliche Entwicklung.

Voraussetzungen & Schnellstart

Voraussetzungen

• Shopware 6.7.1.0 oder neuer

• Aktives Shopware-Abonnement

• Für deinen Account aktivierter Beta-Zugang

• Aktivierter Nexus-Service für deinen Shop

Zugriff auf Nexus

1. Melde dich über den Shopware Single Sign-On (SSO) an.

2. Nach der Authentifizierung öffnet sich ein Demo-Workflow.

3. Deine Shopware-Shops sind bereits importiert und einsatzbereit.
   Hinweis (Beta): Nexus verwendet das erste Unternehmen, das mit deinem Benutzerkonto verknüpft ist. Es sind nur Shops verfügbar, die diesem Unternehmen zugeordnet sind.

Integrationen

Bevor du Konnektoren wie Slack oder Microsoft Dynamics Business Central in deinen Workflows verwenden kannst, musst du dich bei diesen Diensten authentifizieren.

1. Navigiere in der oberen Leiste zu Integrationen.

2. Klicke auf den Dienst, den du verbinden möchtest (z. B. Slack oder Microsoft Dynamics Business Central).
3. Folge dem Authentifizierungsprozess, um Nexus Zugriff zu gewähren.

Sicherheit: Deine Authentifizierungsdaten werden sicher und verschlüsselt gespeichert. Sie sind für niemanden einsehbar — auch nicht für das Entwicklungsteam.

Einen einfachen Workflow erstellen

1. Klicke auf Workflow erstellen > gib einen Namen ein > Workflow erstellen.

2. Füge einen Trigger hinzu: Ziehe Shopware-Ereignis-Trigger auf die Canvas > Wähle deinen Shop und Ereignis (z. B. checkout.order.placed).

3. Füge eine Aktion hinzu: Ziehe Slack-Nachricht-Senden oder Microsoft Dynamics Business Central auf die Canvas.

4. Verbinde den Trigger-Output mit dem Action-Input.

5. Konfiguriere die Aktion (z. B. Slack-Channel und Nachrichtenvorlage oder Business-Central-Entität und Operation).

6. Speichere den Workflow, klicke auf Veröffentlichen und anschließend auf Starten, um ihn zu aktivieren.

Builder – Übersicht

• Canvas: Deine visuelle Arbeitsfläche, auf der du Workflows erstellst und Knoten miteinander verbindest.

• Knoten Panel: Übersicht aller verfügbaren Knoten, z. B. Trigger, Aktionen und Bedingungen.

• Knoten-Konfiguration: Hier konfigurierst du Parameter, Zugangsdaten, Templates sowie Debug-Hinweise für den ausgewählten Knoten.

• Toolbar: Enthält die wichtigsten Aktionen: Speichern, Veröffentlichen, Starten und Zurücknehmen.

Knoten-Typen

Trigger Knoten

• Shopware-Ereignis-Trigger: Reagiert auf Shop-Ereignisse (z. B. Bestellung aufgegeben).

• Zeitplan-Trigger: Führt einen Workflow zeitgesteuert aus (Cron).

Aktion Knoten

• Microsoft Dynamics Business Central: CRUD-Operationen auf Business-Central-Entitäten.

• Shopware-API-Aufruf: REST-Aufruf an Shopware.

• Slack-Nachricht-Senden: Sendet eine Nachricht an Slack.

• Shopware-E-Mail senden: Sendet eine E-Mail von deinem Shopware-Shop.

• API-Anfrage: Sendet API-Anfragen an externe Dienste. 

Bedingung Knoten

• Wenn: Ermöglicht bedingte Verzweigungen im Workflow.

Ausgabe Knoten

• S3-Speicher: Speichert Daten in S3 oder S3-kompatiblen Speicher.

Steuerung Knoten

• Verzögerung: Fügt eine Verzögerung hinzu, bevor fortgefahren wird.

Expressions

Nexus ordnet Ereignisdaten automatisch den verfügbaren Feldern zu. In jedem Texteingabefeld kannst du @ eingeben, um eine Liste der verfügbaren Eigenschaften aus vorherigen Nodes anzuzeigen.

Nach einem Shopware-Event-Trigger kannst du beispielsweise @ eingeben, um auf Felder wie payload.order.orderNumber zuzugreifen.

Verwende {{ }}, um Daten aus dem Event einzufügen, zum Beispiel: {{payload.order.orderNumber}}.

Workflow-Status

• Entwurf: Workflow wird bearbeitet. (verfügbare Schaltflächen: Speichern, Veröffentlichen)

• Veröffentlicht: Workflow ist bereit. (verfügbare Schaltfläche: Starten)

• Aktiv: Workflow ist bereit und verarbeitet Daten. (verfügbare Schaltfläche: Zurücknehmen)

• Wird bereitgestellt: Workflow wird erstellt.

Typische Anwendungsfälle

Bestellung synchronisieren

Shopware → Microsoft Dynamics Business Central

1. Trigger: checkout.order.placed

2. Microsoft Dynamics Business Central Kunden anhand der E-Mail-Adresse abrufen.

3. Prüfen:

   • Wenn Kunde existiert → bestehenden Kunden verwenden.

   • Wenn Kunde nicht existiert → neuen Kunden anlegen.

4. Sales Order in Microsoft Dynamics Business Central erstellen.

5. Shopware-Bestellung mit der Business-Central-Referenz aktualisieren.

6. Slack-Benachrichtigung senden.

Warnung bei niedrigem Lagerbestand

Zwei Ansätze:

1. Zeitgesteuert (täglich)

1. 1. Zeitplan-Trigger (täglich).

   2. Microsoft Dynamics Business Central nach Artikeln mit Bestand < definierter Schwelle abfragen.

   3. Wenn Artikel gefunden werden → Slack-Nachricht senden.

2. Event-basiert (sofort)

1. 1. Auf checkout.order.placed hören.

   2. Bestand der betroffenen Artikel in Microsoft Dynamics Business Central prüfen.

   3. Wenn Bestand unter der Schwelle → Slack-Nachricht senden.

Troubleshooting