Documento di trasporto (Delivery note)

Rappresenta un documento di consegna / DDT (delivery note): evasione merce verso il cliente con numero documento, data di consegna, collegamento all’ordine di vendita (salesOrderId / salesOrderNumber), cliente, magazzino di partenza, vettore e tracking, righe con quantità spedita e riferimento alla riga ordine (salesOrderLinePosition). È il modello tipico per flussi che registrano uscite di magazzino, integrazioni con corrieri o allineamento verso sistemi di logistica e fatturazione.

Esempio JSON completo

{
  "id": "dn_7Jk1Lm4No7Pq0",
  "channel": "demoipaas",
  "createdAt": "2026-01-23T08:00:00+00:00",
  "updatedAt": "2026-01-23T08:00:00+00:00",
  "number": "DN-2026-0093",
  "status": "posted",
  "deliveryDate": "2026-01-23",
  "salesOrderId": "so_8Km2Np5Qr8St1",
  "salesOrderNumber": "SO-2026-0118",
  "customerId": "cust_4Fx7Gy0Hz3Ja6",
  "shipFromWarehouseId": "wh_MIL01",
  "carrier": "Bartolini",
  "trackingNumber": "BR123456789IT",
  "lineItems": [
    {
      "position": 10,
      "salesOrderLinePosition": 10,
      "itemId": "itm_WIDGET_A",
      "description": "Widget mod. A — conf. 24 pz",
      "quantityShipped": 48
    }
  ],
  "notes": "Firma obbligatoria"
}

Note

• Nel campione, consegna parziale rispetto all’ordine di vendita (solo la riga 10); altre righe possono comparire in DDT successivi.
• status (es. bozza, registrato) e l’obbligo di numerazione dipendono dall’ERP di destinazione e dalla normativa locale.
• carrier e trackingNumber possono essere assenti per ritiro in sede o integrazioni che valorizzano il tracking in un secondo momento.