Shop-Integrationen#

Orderport kann Bestellungen direkt von gängigen Shopsystemen empfangen. Statt XML-basierter Einkaufsnetzwerke wie Ariba senden diese Systeme JSON-Webhooks, die Orderport automatisch normalisiert und in Ihr Zielformat konvertiert.

Unterstützte Shopsysteme#

Pipeline für ein Shopsystem einrichten#

Schritt 1: Format wählen#

Im Pipeline-Wizard wählen Sie als Eingabeformat Ihr Shopsystem (z. B. "Shopware 6") und als Ausgabeformat entweder openTrans oder JSON.

• openTrans – wenn Ihr ERP-System openTrans-XML erwartet
• JSON – wenn Ihr Zielsystem eine REST-API hat, die JSON entgegennimmt

Schritt 2: Feldmapping#

Orderport kennt die Struktur jedes Shopsystems und schlägt automatisch passende Zuordnungen vor (Auto-Mapping). Beispiele:

Die Vorschläge können Sie im Mapping-Editor anpassen, ergänzen oder überschreiben.

Schritt 3: Transport#

Für JSON-Pipelines steht neben HTTP POST auch REST API als Transporttyp zur Verfügung:

• HTTP POST – sendet die transformierte Bestellung als XML
• REST API – sendet JSON an eine REST-API mit konfigurierbarer HTTP-Methode (POST/PUT/PATCH) und Authentifizierung (Bearer Token, API Key Header, Basic Auth)

Schritt 4: Credential anlegen#

Für JSON-Pipelines stehen zwei Authentifizierungsarten zur Verfügung:

• Bearer Token – Ihr Shop sendet den Token im Authorization-Header
• HMAC-SHA256 – Ihr Shop signiert den Request-Body, Orderport prüft die Signatur

Mehr dazu im Artikel JSON-Webhooks.

Shopware 6#

Webhook im Flow Builder einrichten#

1. Öffnen Sie in Shopware 6 Einstellungen → System → Flow Builder
2. Erstellen Sie einen neuen Flow mit dem Trigger Bestellung aufgegeben
3. Fügen Sie die Aktion Webhook senden hinzu
4. Tragen Sie die Orderport Webhook-URL ein: https://orderport.app/api/v1/webhook/{token}
5. Wählen Sie als HTTP-Methode POST

Verfügbare Quellfelder#

Orderport extrahiert aus dem Shopware-6-Webhook unter anderem:

• order.number – Bestellnummer
• order.orderDateTime – Bestellzeitpunkt
• order.amountTotal – Gesamtbetrag
• order.amountNet – Nettobetrag
• order.currencyId – Währung
• billingAddress.* – Rechnungsadresse (Firma, Name, Straße, PLZ, Stadt, Land)
• shippingAddress.* – Lieferadresse
• customer.email – E-Mail des Kunden
• lineItems[].label – Artikelname
• lineItems[].quantity – Menge
• lineItems[].unitPrice – Einzelpreis
• lineItems[].totalPrice – Gesamtpreis der Position

Shopify#

Webhook in Shopify einrichten#

1. Öffnen Sie Settings → Notifications → Webhooks (oder im Admin unter Settings → Webhooks)
2. Klicken Sie auf Create webhook
3. Wählen Sie das Event Order creation
4. Format: JSON
5. URL: https://orderport.app/api/v1/webhook/{token}

Verfügbare Quellfelder#

• order.number / order.order_number – Bestellnummer
• order.created_at – Bestellzeitpunkt
• order.total_price – Gesamtbetrag
• order.currency – Währung
• order.email – E-Mail
• billing_address.* – Rechnungsadresse
• shipping_address.* – Lieferadresse
• lines[].sku – Artikelnummer
• lines[].title – Artikelname
• lines[].quantity – Menge
• lines[].price – Preis

WooCommerce#

Webhook in WooCommerce einrichten#

1. Öffnen Sie WooCommerce → Einstellungen → Erweitert → Webhooks
2. Klicken Sie auf Webhook hinzufügen
3. Name: z. B. "Orderport"
4. Status: Aktiv
5. Thema: Bestellung erstellt
6. Auslieferungs-URL: https://orderport.app/api/v1/webhook/{token}
7. Geheimnis: Tragen Sie hier Ihr HMAC-Secret ein (aus der Orderport Credential-Einrichtung)

Verfügbare Quellfelder#

• id / number – Bestellnummer
• date_created – Bestellzeitpunkt
• total – Gesamtbetrag
• currency – Währung
• billing.email – E-Mail
• billing.* – Rechnungsadresse (company, first_name, last_name, address_1, city, postcode, country)
• shipping.* – Lieferadresse
• line_items[].sku – Artikelnummer
• line_items[].name – Artikelname
• line_items[].quantity – Menge
• line_items[].price – Preis

Generisches JSON#

Wenn Ihr System keines der oben genannten Shopsysteme ist, wählen Sie Generisches JSON als Eingabeformat. Orderport flacht den JSON-Payload automatisch in eine flache Struktur ab und stellt alle Felder im Mapping-Editor zur Verfügung.

Typische Quellfelder:

• order_id – Bestellnummer
• order_date – Datum
• customer_email – E-Mail
• total_amount – Gesamtbetrag
• items[].sku – Artikelnummer
• items[].quantity – Menge

Nächste Schritte#

• JSON-Webhooks – Webhook-Endpunkt und Authentifizierung im Detail
• Feldmapping – Felder im Detail zuordnen
• Pipeline einrichten – vollständige Wizard-Anleitung