> For the complete documentation index, see [llms.txt](https://connect.xentral.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://connect.xentral.com/tutorials/neuen-auftrag-per-event-abrufen/auftrags-label-anhand-auftragswert-setzen.md).

# 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**.

***

{% embed url="<https://www.loom.com/share/640fe521c65a4c20ad18071419265ea2>" %}

***

## **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

***