Auftrags-Label anhand Auftragswert setzen

Template: Neuen Auftrag per Event abrufen

In diesem Tutorial baust du einen eigenen Flow auf Basis des Templates „Neuen Auftrag per Event abrufen“.

Ziel:

▶️ Ein Label wird automatisch am Auftrag gesetzt, wenn der Auftragswert größer ist als ein definierter Grenzwert.

---

---

1. Template importieren

1. Öffne die Workflow Library.

2. Wähle das Template „Neuen Auftrag per Event abrufen“.

3. Klicke auf Übernehmen, akzeptiere die Nutzungsbedingungen.

4. Der Flow erscheint jetzt in deinem Projekt (Standard: Default Project).

---

2. Flow öffnen & Grundlogik verstehen

1. Öffne den Flow über das Pinsel-Symbol.

2. Im Flow siehst du folgende Standardlogik:

   • Der Flow reagiert später auf ein Event (Trigger noch nicht gesetzt).

   • Die Sales Order ID und Projekt-ID werden aus dem Event ausgelesen.

   • Die komplette Sales Order wird anschließend per API nachgeladen.

   • Die Daten werden im Log ausgegeben.

Damit ist der Flow bereit, um erweitert zu werden.

---

3. Trigger konfigurieren

Damit der Flow automatisch startet:

1. Klicke im Editor auf + → Trigger hinzufügen.

2. Wähle den Event-Trigger:

   SalesOrderCreated

3. Speichern.

Der Flow startet ab jetzt automatisch, sobald ein neuer Auftrag in Xentral angelegt wird.

---

4. Funktionstest: Erste Ausführung prüfen

1. Lege in Xentral einen neuen Auftrag an.

2. Öffne die Flow-Ausführungen (Journal).

3. Du siehst eine Ausführung des Flows.

4. Wähle sie aus und prüfe:

   • Die Sales Order wurde korrekt geladen

   • Die vollständigen Sales Order-Felder erscheinen im Output

   • Log-Nachrichten zeigen die Payload

Jetzt hast du die Basisfunktion bestätigt.

---

5. Parameter für deinen Use Case definieren

Damit dein Flow flexibel bleibt, definierst du jetzt zwei Parameter:

Parameter 1: Mindestauftragswert

Gibt an, ab welchem Wert ein Label gesetzt werden soll.

Beispiel:

50

Parameter 2: Label-ID

Welches Label soll gesetzt werden?

Falls du die Label-ID noch nicht kennst:

1. Lege im Label-Manager ein neues Label an.

2. Finde die ID über:

   Smart Search → Datenbankansicht → Tabelle: label_type → Feld: Id

Trage beide Parameter im Flow unter den Flow-Konfigurationen (Stift-Symbol) ein.

---

6. Auftragswert aus der Sales Order Payload ermitteln

Der Auftragswert steckt im Feld:

total.amount

Um die Struktur zu bestätigen:

1. Gehe in den Log der letzten Flow-Ausführung.

2. Öffne die Sales Order Payload.

3. Klicke auf „Struktur anzeigen“, um die Feldstruktur zu kopieren.

Das hilft beim Erstellen der benötigten Assignment-Variablen.

---

7. Variable für die Prüfung vorbereiten

Der Flow soll vergleichen:

Wenn total.amount > Mindestauftragswert → Label setzen

Dazu:

1. Nutze das bestehende Assignment-Element.

2. Füge die Sales Order Struktur ein (z. B. per Paste aus der Zwischenablage).

3. Du hast nun Zugriff auf total.amount für deine spätere Verzweigung.

---

8. Verzweigung anlegen

Jetzt baust du die Bedingung in den Flow:

1. Füge ein Condition/Verzweigung-Element hinzu.

2. Definiere die Bedingung:

{{output.salesOrder.total.amount}} > {{parameter.salesOrderValue}}

Wenn die Bedingung erfüllt ist → weiter in den True-Pfad (Label setzen)

Wenn nicht → Flow endet.

---

9. API Payload zum Setzen des Labels vorbereiten

Xentral API Endpoint:

Assign tags to multiple resources

Benötigt werden:

• resourceIds → die Sales Order ID

• tagIds → die ID des zu setzenden Labels

Erstelle dafür:

Variable: tagUpdate

In einem neuen Assignment:

tagUpdate.values.0.id = {{output.salesOrderId}}
tagUpdate.values.0.tag.id = {{parameter.tagId}}

Damit erzeugst du die Payload genau in der Struktur, die die API erwartet.

---

10. API-Aufruf zum Setzen des Labels einfügen

1. Füge innerhalb des True-Pfads einen Xentral API Connector ein.

2. Wähle den Endpoint:

   TagAssignment → Bulk assign tags to multiple resources

3. Übergib:

   • Resource: salesOrder

   • Input: Variable tagUpdate

Speichern.

---

11. Flow testen

1. Erstelle in Xentral einen neuen Auftrag mit einem Wert über deinem Schwellenwert.

2. Prüfe im Journal, ob der Flow ausgeführt wurde.

3. Öffne den Auftrag in Xentral → Tab „Aufträge“.

Du solltest jetzt dein Label sehen.

---

12. Flow finalisieren & dokumentieren

Jetzt benenne den Flow um, z. B.:

„Auftrags-Label setzen wenn Auftrag einen bestimmten Auftragswert übersteigt“

Ergänze ggfls. eine Beschreibung oder weitere gewünschte Parameter.

Dein Flow erscheint nun sauber dokumentiert in der Übersicht – als fertiger, wiederverwendbarer Use Case.

---

Fertig!

Mit diesem Tutorial hast du gelernt:

✔ Wie man ein Template importiert

✔ Wie der Standard-Workflow aufgebaut ist

✔ Wie man Parameter definiert

✔ Wie man die Sales Order Payload analysiert

✔ Wie man Bedingungen einbaut

✔ Wie man einen API Call vorbereitet und ausführt

✔ Wie man Labels automatisch setzt

✔ Wie man einen Use-Case-Flow sauber dokumentiert

---