Fulfillment Webhook Mapping & Tracking Sync - Salp

Fulfillment Webhook Mapping & Tracking Sync

Vollständige Payload-Richtlinien für die Zuordnung von Tracking-Nummern, Carrier-Codes und Multi-Warehouse-Fulfillment-Updates zurück an Saleor.

Zuletzt aktualisiert: 3. Juni 2026

Der Parameter 'warehouseId' ist für alle eingehenden Webhooks zwingend erforderlich, um Synchronisationssperren des Bestellstatus zu verhindern.

Fulfillment Sync Workflow

Wenn Sie eine Bestellung in Ihrem primären E-Commerce-System (z. B. Lightspeed, Shopify) bearbeiten, wird ein Fulfillment-Webhook ausgelöst und von unseren Hintergrund-Worker-Threads erfasst. Die Tracking-Nummer und der Carrier-Code müssen perfekt übereinstimmen, um sicherzustellen, dass der Endkunde zeitnahe und genaue Benachrichtigungen erhält.

Jede Partner-Marke erhält während des Onboardings eine primäre Warehouse-ID zugewiesen. Wenn Sie von mehreren Standorten aus bearbeiten, stellen Sie sicher, dass die in der Payload übergebene warehouseId mit einem Ihrer aktiven Profile übereinstimmt.

json

{
  "orderId": "ORD-772910-EU",
  "warehouseId": "wh-amsterdam-primary",
  "fulfillment": {
    "trackingNumber": "1Z999AA10123456784",
    "carrier": "DHL_EXPRESS",
    "shippedItems": [
      {
        "sku": "ELEC-SKU-990",
        "quantity": 1
      }
    ]
  }
}

Wir unterstützen Standardcodes: DHL_EXPRESS, POST_NL, DPD, UPS und FEDEX. Die Verwendung eines nicht unterstützten Codes führt zu einer allgemeinen Nachverfolgung.

Nachdem die Webhook-Payload verarbeitet wurde, generiert das Portal eine Tracking-URL und aktualisiert automatisch den Bestellstatus im Kunden-Storefront. Dies löst eine lokalisierte Versandbestätigungs-E-Mail aus.