Webhooks API

Webhooks sind die erste verfügbare API-Funktion in Scrollengine. Siehe den vollständigen Webhooks-Integrationsleitfaden für Einrichtung und Konfiguration.

Ereignisreferenz

order.created

Wird ausgelöst, wenn eine neue Liefer-/Abholbestellung aufgegeben wird.

{
  "event": "order.created",
  "timestamp": "2026-03-13T10:00:00Z",
  "data": {
    "order_id": "se-12345",
    "shopify_order_id": "98765",
    "delivery_method": "local_delivery",
    "scheduled_date": "2026-03-14",
    "time_slot": "09:00-12:00",
    "customer": {
      "name": "Jane Smith",
      "email": "jane@example.com",
      "phone": "+1234567890",
      "address": "123 Main St, City, State 10001"
    },
    "items": [
      {
        "name": "Product A",
        "quantity": 2,
        "sku": "PROD-A-001"
      }
    ]
  }
}

order.updated

Wird ausgelöst, wenn sich Bestelldetails oder der Status ändern.

order.delivered

Wird ausgelöst, wenn eine Lieferung als abgeschlossen markiert wird.

route.created

Wird ausgelöst, wenn eine neue Route erstellt wird.

route.completed

Wird ausgelöst, wenn alle Stopps einer Route abgeschlossen sind.

Payload-Struktur

Alle Webhook-Payloads folgen dieser Struktur:

Feld	Typ	Beschreibung
event	string	Ereignisname
timestamp	string	ISO 8601 Zeitstempel
data	object	Ereignisspezifische Daten

Signaturverifizierung

Überprüfen Sie die Webhook-Authentizität mithilfe des Headers X-Scrollengine-Signature:

const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}