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 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 PipelineExperten-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.

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 und KI-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 – einfacher POST mit XML-Body
  • REST API – JSON, OAuth, Custom Header
  • E-Mail – Datei-Anhang per E-Mail (Addon delivery_email)
  • 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 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