透過 API 建立出貨單
計算完著陸成本並建立訂單後，您可以透過 API 將追蹤號碼和其他出貨詳細資訊傳送到 Zonos。
當您為現有訂單建立出貨單且不需要修改品項或合作者詳細資訊時，請使用此工作流程。它支援選擇性追蹤號碼、履行中心、服務等級選擇和申報價值保險。
1
mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {2
shipmentCreateWorkflow(input: $input) {3
id4
status5
trackingDetails {6
number7
}8
serviceLevel {9
id10
name11
carrier {12
id13
name14
}15
}16
shipmentCartons {17
id18
carton {19
id20
width21
length22
height23
weight24
items {25
item {26
id27
amount28
description29
}30
}31
}32
label {33
url34
trackingNumber35
id36
documentFiling37
}38
}39
}40
}變數選項：
- 使用履行中心： 新增
"fulfillmentCenter": "fulfillment_center_12345"以指定原始位置 - 使用自訂追蹤： 設定
"generateLabel": false並新增"trackingNumbers": ["tracking_1", "tracking_2"] - 使用服務等級： 新增
"serviceLevel": "dhl.express_example"以選擇特定的運輸業者服務 - 使用申報價值保險： 新增
"isDeclaredValue": true以啟用申報價值覆蓋
申報價值
設定 "isDeclaredValue": true 以為出貨單中的所有品項啟用申報價值覆蓋。Zonos 自動索賠訂單中提交的所有品項的全額價值；商人無法修改此金額。這設定了運輸業者在運輸期間遺失、損壞或被盜的情況下願意接受的最高責任。此功能僅適用於 UPS、FedEx 和 DHL 出貨。Zonos 在您啟用申報價值時自動處理運輸業者特定的實現，包括對這些運輸業者的 API 呼叫中的適當參數，因此您無需管理不同的運輸業者要求。
UPS 限制：UPS 僅涵蓋 100.01-50,000 美元之間的值，並在紙箱級別處理申報價值。對於多紙箱出貨，商人必須分割出貨以指定每個紙箱的覆蓋範圍。UPS 也會產生額外的保險表單 (UPS Control Log)，必須隨標籤列印申報價值超過 999 美元的情況。
FedEx 和 DHL：在出貨級別處理申報價值，沒有其他限制。
特殊服務
在紙箱上使用 specialServices 以指示電池、乾冰、危險品或簽名要求的特殊處理要求。請參閱特殊服務指南以了解完整詳細資訊和範例。
作廢出貨單
要取消已建立的標籤，請使用下列 mutation 來作廢出貨單。任何相關的標籤也將自動作廢。請注意，出貨單一旦作廢，就無法更新或恢復。
1
mutation {2
shipmentStatusUpdate(3
input: {4
shipment: "shipment_12345678-1234-1234-1234-123456789stu"5
status: VOIDED6
note: "Voiding shipment"7
}8
) {9
id10
status11
}12
}GraphQL API ReferenceTypes, inputs, and operations used in this guide
為現有訂單建立出貨單
使用 Zonos API 在計算完著陸成本並建立訂單後，建立出貨單和標籤。
GraphQL
本指南適用於已經與 Zonos API 整合且需要為系統中現有訂單建立出貨單的使用者。如果您是運輸平台，希望為您的客戶提供 Zonos 出貨單建立功能，請參閱我們的運輸 API 指南。
如果您已與 Zonos API 整合並獲准在儀表板外運輸，請使用
shipmentCreateWorkflowmutation 來建立出貨單並提供追蹤資訊。這些 mutation 也允許您向 Zonos 通知有關到轉運設施的國內出貨。注意： 如果您使用的是具有自動同步追蹤號碼到 Zonos 的平台的責任稅務應用程式，或者您直接透過儀表板運輸，則不需要這些 mutation。