Fulfillment Webhook Mapping & Tracking Sync - Salp

Fulfillment Webhook Mapping & Tracking Sync

Volledige payload richtlijnen voor het mappen van trackingnummers, carrier codes en multi-warehouse fulfillment updates terug naar Saleor.

Laatst bijgewerkt: 3 juni 2026

De parameter 'warehouseId' is verplicht op alle inkomende webhooks om synchronisatielockups van de orderstatus te voorkomen.

Fulfillment Sync Workflow

Wanneer u een order fulfilt binnen uw primaire e-commerce systeem (bijv. Lightspeed, Shopify), wordt een fulfillment webhook geactiveerd en onderschept door onze achtergrond worker threads. Het trackingnummer en de carrier code moeten perfect overeenkomen om ervoor te zorgen dat de eindklant tijdige, accurate meldingen ontvangt.

Elk partner merk krijgt een primaire warehouse ID toegewezen tijdens de onboarding. Indien u vanuit meerdere locaties fulfilt, zorg er dan voor dat de warehouseId die in de payload wordt doorgegeven overeenkomt met een van uw actieve profielen.

json

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

Wij ondersteunen standaard codes: DHL_EXPRESS, POST_NL, DPD, UPS en FEDEX. Het gebruik van een niet-ondersteunde code zal terugvallen op algemene tracking.

Nadat de webhook payload is verwerkt, genereert het portaal een tracking URL en werkt automatisch de orderstatus op de klant storefront bij. Dit activeert een gelokaliseerde verzendbevestigingsemail.