# Experten-Wizard

Der Experten-Wizard führt Sie in **vier Schritten** durch die Pipeline-Einrichtung und gibt Ihnen volle Kontrolle über Format-Wahl, Mapping, Transport(e) und Credentials. Wenn Sie eine der Standard-Konstellationen einrichten (Ariba → ERP, Shopware → JTL-Wawi …), ist der [Simple Wizard](/docs/simple-wizard) schneller.

## Wann Experten-Wizard?

- Sie wollen Mapping-Regeln manuell anpassen oder transform-Funktionen einsetzen
- Sie wollen mehrere Transporte mit Priorität (Fallback) anlegen
- Sie brauchen mehrere Credentials pro Pipeline (z. B. pro Einkäufer)
- Sie nutzen eine Integration, die im Simple Wizard nicht verfügbar ist

## Wizard starten

1. Klicken Sie in der Sidebar auf **Pipelines**
2. Klicken Sie auf **Neue Pipeline** → **Experten-Wizard**
3. Der Wizard führt Sie durch 4 Schritte

## Schritt 1: Format wählen

Geben Sie Ihrer Pipeline einen aussagekräftigen **Namen** (z. B. "Ariba Bestellungen" oder "Coupa Produktion").

Wählen Sie dann:

- **Eingabeformat**:
  - **cXML** – Einkaufsnetzwerke wie Ariba, Coupa, SAP
  - **Shopware 6** – Flow-Builder-Webhooks (JSON)
  - **Shopify** – Order-Webhooks (JSON)
  - **WooCommerce** – WooCommerce-Webhooks (JSON)
  - **EDIFACT** – klassisches EDI
  - **openTrans** – XML eines Partner-ERPs
  - **Generisches JSON** – beliebige JSON-Quelle
- **Ausgabeformat**:
  - **openTrans** – Standard-XML für ERP-Systeme
  - **JSON** – für REST-APIs und moderne Systeme
  - **JTL-Wawi** – Auftrags-XML für JTL-Wawi-Import

> Eine Seite pro Integration mit Kompatibilität und Einschränkungen finden Sie in der [Integrationen-Übersicht](/docs/kategorie/integrationen).

## Schritt 2: Feldmapping

Hier ordnen Sie Felder aus dem Eingabeformat den Feldern des Ausgabeformats zu. Orderport schlägt automatisch die wichtigsten Zuordnungen vor.

Sie können diesen Schritt auch **überspringen** und das Mapping später auf der Pipeline-Detailseite einrichten. Orderport erzeugt dann zur Laufzeit ein Default-Mapping aus den Auto-Map-Suggestions der Integration.

Mehr dazu: [Feldmapping](/docs/feldmapping) und [KI-Mapping](/docs/ai-mapping).

## Schritt 3: Transport konfigurieren

Ein **Transport** bestimmt, wohin die transformierte Bestellung zugestellt wird. Mindestens einer ist Pflicht.

Wählen Sie den Typ:

- [**HTTP POST**](/docs/http) – einfacher POST mit XML-Body
- [**REST API**](/docs/rest-api) – JSON, OAuth, Custom Header
- [**E-Mail**](/docs/email) – Datei-Anhang per E-Mail (Addon `delivery_email`)
- [**FTP/SFTP**](/docs/ftp-sftp) – Dateien in ein Verzeichnis legen (Addon `delivery_ftp`)

Mehrere Transporte mit Priorität ergeben eine Fallback-Kette. Die Reihenfolge lässt sich später per Drag & Drop anpassen.

## Schritt 4: Zusammenfassung

Im letzten Schritt sehen Sie:

- **Zusammenfassung** aller Einstellungen (Format, Mapping, Transport)
- Ihre **Webhook-URL**: `/api/v1/webhook/{token}` (auch für cXML; `/api/v1/cxml/{token}` ist ein zusätzlicher Alias)
- Möglichkeit, eine oder mehrere **Zugangsberechtigungen (Credentials)** anzulegen

### Credential anlegen

Stellt sicher, dass nur autorisierte Absender an Ihre Pipeline liefern können.

**Für cXML-Pipelines (Ariba, Coupa, SAP):**

- **From-Domain** / **From-Identity** – z. B. "NetworkId" + Ariba ANID des Absenders
- **To-Domain** / **To-Identity** – Ihre eigene Identity
- **SharedSecret** – automatisch generiert (einmalig anzeigen)

**Für JSON-Pipelines (Shopware, Shopify, WooCommerce, Generic):**

- **Bearer Token** – als `Authorization`-Header
- **HMAC-SHA256** – Signatur im konfigurierbaren Header
- **Shared-Secret-Header** – Custom-Header mit statischem Secret

> **Wichtig:** Tokens und Secrets werden nur **einmal** angezeigt. Kopieren und speichern Sie sie sofort! Bei Verlust muss eine neue Credential angelegt werden.

Klicken Sie auf **Pipeline erstellen**, um die Einrichtung abzuschließen. Die Pipeline startet inaktiv.

## Pipeline aktivieren und verwalten

### Aktivierung

Eine Pipeline kann nur aktiviert werden, wenn sie mindestens **einen aktiven Transport** hat. Der Aktivierungs-Button ist sonst ausgegraut. Siehe [Pipelines](/docs/pipelines) für den Lebenszyklus.

### Pipeline-Detailseite

Klicken Sie auf eine Pipeline in der Liste. Hier können Sie:

- **Einstellungen bearbeiten** – Name, Format, Mapping anpassen
- **Webhook-URL kopieren**
- **Transporte** hinzufügen, bearbeiten, löschen, priorisieren
- **Credentials** verwalten (hinzufügen, aktivieren/deaktivieren, löschen)
- **Pipeline aktivieren/deaktivieren**

### Mehrere Pipelines

Sie können beliebig viele Pipelines anlegen (bis zum Plan-Kontingent und Addon `additional_pipelines`). Jede hat eine eigene Webhook-URL und eigene Credentials.

## Nächste Schritte

- [Feldmapping](/docs/feldmapping) – Felder im Detail zuordnen
- [Simple Wizard](/docs/simple-wizard) – schnellere Variante für Standardfälle
- [Bestellungen verwalten](/docs/bestellungen) – eingegangene Bestellungen einsehen
- [Integrationen-Übersicht](/docs/kategorie/integrationen)