出貨前通知 (ASN) 擷取 API

測試端點:
https://transact.ti.com/v2/store/orders/T10999999/advanced-shipment-notices/test
https://transact.ti.com/v2/store/orders/T10999999/advanced-shipment-notices/499999999/test

生產端點:
https://transact.ti.com/v2/store/orders/{Order Number}/advanced-shipment-notices/
https://transact.ti.com/v2/store/orders/{Order Number}/advanced-shipment-notices/{Waybill Number}

在您完成訂單包裝並準備運送後,TI 會產生出貨追蹤資訊。使用出貨前通知 (ASN) API 可擷取有關出貨訂單的詳細資訊,包括追蹤編號、貨運業者詳細資料和商業發票。

ASN API 提供:

  • 即時更新:推播 API 會向您的系統傳送 Webhook,通知您的訂單已準備好出貨,且可用於觸發自動化流程。
  • 詳細運送資訊:取得追蹤編號、貨運業者資訊和商業發票。
  • 靈活的檢索選項:依訂單編號擷取整筆訂單資訊,或依運貨單編號擷取特定的出貨資訊。

使用 ASN API 的步驟:

  1. 驗證:您需要指派給您的 API 金鑰和密鑰,才能進行 API 驗證。
  2. 擷取出貨資訊:
    • 完整訂單:在您的要求中提供訂單編號。
    • 特定出貨資訊:請附上先前收到或 myTI 訂單記錄中提供的運貨單編號。
  3. API 回應:您會收到包含狀態程式碼 (200 OK) 的回應,以及附有出貨詳細資訊的 JSON。
  4. 擷取特定的訂單詳細資訊:
    • 若要取得特定訂單的詳細資訊,請使用訂單編號查詢訂單 API。
    • 例如:"https://transact.ti.com/v2/store/orders/T999999999"

測試 API:

將 API 用於即時資料之前,可先利用測試環境進行實驗。測試時:

  • 使用提供的測試端點 URL
  • 應一律以「T10999999」傳送訂單 ID,並一律以「0499999999」傳送運貨單編號。 

https://transact.ti.com/v2/store/orders/T10999999/advanced-shipment-notices/test?requestCommercialInvoicePDF=true&requestWaybillPDF=true 

或

https://transact.ti.com/v2/store/orders/T10999999/advanced-shipment-notices/499999999/test?requestCommercialInvoicePDF=true&requestWaybillPDF=true

其他注意事項:

  • 只要存取權杖有效,即可在一個工作階段內允許多個要求。
  • API 可用於推播或擷取實作。  請參閱「推播通知設定」以了解更多資訊。 

 

擷取要求範例:

curl --request GET \
--url 'https://transact.ti.com/v2/store/orders/{orderNumber}/advanced-shipment-notices/{wayBillNumber}'
--header 'Authorization: Bearer {access_token}' \