Fulfillment Webhook Mapping & Traziness Sync - Salp

Fulfillment Webhook Mapping & Traziness Sync

Linji ta' gwida tal-payload sħiħa għall-mapping tan-numri tat-traċċar, kodiċi tal-carrier, u aġġornamenti tal-fulfillment b'ħafna mħażen lura lejn Saleor.

L-aħħar aġġornat: 3 ta’ Ġunju 2026

Il-parametru 'warehouseId' huwa obbligatorju fuq il-webhooks kollha ta' ingestion biex jiġu evitati lockups tas-sinkronizzazzjoni tal-istatus tal-ordni.

Workflow ta' Sinkronizzazzjoni tal-Fulfillment

Meta timla ordni fi ħdan is-sistema primarja tal-e-commerce tiegħek (eż. Lightspeed, Shopify), jiġi attivat webhook tal-fulfillment u jinqabad mill-ħjut tax-xogħol tal-isfond tagħna. In-numru tat-traċċar u l-kodiċi tal-carrier iridu jaqblu perfettament biex jiġi żgurat li l-klijent finali jirċievi notifiki fil-pront u preċiżi.

Kull marka sieħba hija assenjata ID tal-maħżen primarju matul l-onboarding. Jekk qed timla minn nodi multipli, kun żgur li l-warehouseId mgħoddi fil-payload jaqbel ma' wieħed mill-profili attivi tiegħek.

json

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

Aħna nappoġġjaw kodiċi standard: DHL_EXPRESS, POST_NL, DPD, UPS, u FEDEX. L-użu ta' kodiċi mhux appoġġjat se jaqa' lura għal traċċar ġenerali.

Ladarba l-payload tal-webhook tiġi analizzata, il-portal jiġġenera URL tat-traċċar u jaġġorna awtomatikament l-istatus tal-ordni tal-ħanut tal-klijent. Dan jiskatta email lokalizzat ta' konferma tal-vjeġġ.