Mappatura Webhook di Evasione e Sincronizzazione Tracking - Salp

Mappatura Webhook di Evasione e Sincronizzazione Tracking

Linee guida complete del payload per la mappatura dei numeri di tracking, dei codici corriere e degli aggiornamenti di evasione multi-magazzino su Saleor.

Ultimo aggiornamento: 3 giugno 2026

Il parametro 'warehouseId' è obbligatorio su tutti i webhook di ingestione per prevenire blocchi di sincronizzazione dello stato dell'ordine.

Flusso di Lavoro Sincronizzazione Evasione

Quando evadi un ordine nel tuo sistema e-commerce primario (es. Lightspeed, Shopify), viene attivato un webhook di evasione catturato dai nostri thread worker in background. Il numero di tracking e il codice corriere devono essere mappati perfettamente per garantire che il cliente finale riceva notifiche tempestive e accurate.

A ogni brand partner viene assegnato un ID magazzino primario durante l'onboarding. Se si evade da più nodi, assicurarsi che il warehouseId passato nel payload corrisponda a uno dei profili attivi.

json

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

Supportiamo i codici standard: DHL_EXPRESS, POST_NL, DPD, UPS e FEDEX. L'utilizzo di un codice non supportato ripiegherà sul tracciamento generale.

Una volta analizzato il payload del webhook, il portale genera un URL di tracking e aggiorna automaticamente lo stato dell'ordine sulla vetrina del cliente. Questo attiva un'email di conferma spedizione localizzata.