Automatischer Auftragsimport

Technische Dokumentation zur Schnittstellen-Anbindung — für Enterprise-Kunden und deren IT.

Diese Schnittstelle läuft auf Ihrer eigenen Installation, nicht auf unseren Servern — sobald Sie das Lagersystem gekauft und eingerichtet haben, sendet Ihr Shop- oder Warenwirtschaftssystem Bestellungen direkt an Ihre eigene Domain. Verfügbar mit einer Lizenz, die das Modul „Schnittstelle" enthält (Enterprise). Es kann immer nur ein Anbieter gleichzeitig aktiv sein, eingerichtet unter Einstellungen → Schnittstelle in Ihrer Installation.

Einrichtung

In Ihrer Installation unter Einstellungen → Schnittstelle einen Anbieter auswählen — dort wird automatisch ein Secret erzeugt und die passende Webhook-URL angezeigt:

POST https://ihre-domain.de/api/webhook/orders/{anbieter}
X-Webhook-Secret: <automatisch erzeugtes Secret>

Unterstützte Anbieter

🔗 Generischer Webhook

Kein Hersteller-Signatur-Standard vorhanden. Das externe System sendet den Header „X-Webhook-Secret" mit dem generischen JSON-Format (siehe unten).

🛍️ Shopify

Unter Einstellungen → Benachrichtigungen → Webhooks: Ereignis „Bestellerstellung", die Webhook-URL eintragen. Das Secret als „Webhook signing secret" hinterlegen — Shopify signiert jede Zustellung im Header „X-Shopify-Hmac-Sha256" (HMAC-SHA256, base64).

🛒 WooCommerce

Unter Einstellungen → Erweitert → Webhooks: Thema „Bestellung erstellt", die Webhook-URL als Zustell-URL eintragen. Das Secret als Geheimnis hinterlegen — WooCommerce signiert im Header „X-WC-Webhook-Signature" (HMAC-SHA256, base64).

🧩 Shopware 6

Unter Einstellungen → System → Webhooks: Ereignis „checkout.order.placed", die Webhook-URL eintragen, Nutzlast mit Kunde/Adresse/Positionen (inkl. Artikelnummer) inkludieren. Das Secret als App-Secret hinterlegen — Shopware signiert im Header „shopware-shop-signature" (HMAC-SHA256, hex).

🅿️ PrestaShop

PrestaShop hat im Kern kein Webhook-Menü — ein kleines Modul auf dem Hook „actionValidateOrderAfter" sendet die Bestellung als JSON mit dem Header „X-Webhook-Secret" an die Webhook-URL. Modul-Vorlage auf Anfrage über unser Kontaktformular.

📊 JTL-Wawi

In JTL-Wawi einen Workflow einrichten, der bei Zahlungseingang eine HTTP-Aktion mit dem Header „X-Webhook-Secret" und Kunden-/Positionsdaten im generischen JSON-Format an die Webhook-URL sendet.

Generisches JSON-Format

Alle Anbieter werden intern in dieses Format übersetzt. Für den generischen Webhook, PrestaShop und JTL-Wawi ist es zugleich das direkt erwartete Format:

{
  // optional, wird sonst automatisch vergeben
  "order_number": "SHOP-10234",
  "kunde": {
    "name": "Muster GmbH",
    "email": "einkauf@muster-gmbh.de",
    "strasse": "Beispielweg 12",
    "plz": "12345",
    "ort": "Musterstadt",
    "land": "Deutschland"
  },
  "positionen": [
    { "sku": "ART-1001", "menge": 3 },
    { "sku": "ART-2044", "menge": 1 }
  ],
  // alle drei optional
  "versandart": "dhl",
  "liefertermin": "2026-09-20",
  "notizen": "Bitte bis 12 Uhr liefern"
}

Antwort

Bei Erfolg antwortet der Endpunkt mit HTTP 200 und der vergebenen Auftragsnummer, bei einem Problem mit einem passenden Fehlercode und einer Fehlermeldung im Klartext:

// 200 OK
{ "ok": true, "order_number": "SHOP-10234" }

// 401 / 404 / 422 bei Problemen
{ "ok": false, "error": "Artikel mit SKU \"ART-9999\" ist im Lagersystem nicht bekannt." }

Wichtig zu wissen

Jede SKU muss exakt der Artikelnummer oder dem Barcode eines bereits im Lagersystem angelegten Artikels entsprechen — eine unbekannte SKU bricht den kompletten Import mit einer Fehlermeldung ab (kein Teil-Import).
Die Schnittstelle importiert eingehende Bestellungen — es gibt aktuell keinen Bestandsrückspiel an den Shop (kein automatisches Aktualisieren der Lagerbestände im Webshop).
Jeder Importversuch (erfolgreich oder fehlgeschlagen) wird protokolliert und ist unter Einstellungen → Schnittstelle einsehbar.

Fragen zur Anbindung oder Ihrem Warenwirtschaftssystem? Kontakt aufnehmen →