DOCS
Landed Cost•
首頁為物流供應商而設 Landed Cost 建立貨件

為現有訂單建立貨件

使用 Zonos API 在計算完著陸成本並建立訂單後，建立貨件和標籤。

GraphQL

本指南適用於已整合 Zonos API 且需要為系統中現有訂單建立貨件的用戶。如果您是一個運送平台，希望向客戶提供 Zonos 貨件建立功能，請查看我們的 Shipment API 指南。

如果您已整合 Zonos API 並獲得批准 在 Dashboard 之外進行運送，請使用 shipmentCreateWorkflow mutation 建立貨件並提供追蹤資訊。這些 mutations 還允許您告知 Zonos 關於國內運送至交叉轉運設施的信息。

注意： 如果您使用的 Duty and Tax 應用與一個自動同步追蹤編號到 Zonos 的平台，或者您直接通過 Dashboard 進行運送，則不需要這些 mutations。

通過 API 建立貨件 

在計算完著陸成本並建立訂單後，您可以通過 API 向 Zonos 發送追蹤編號和其他貨件詳情。

當您為現有訂單建立貨件且不需要修改項目或單位詳情時，請使用此工作流程。它支持可選的追蹤編號、履約中心、服務級別選擇和宣告價值保險。

1mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {
2 shipmentCreateWorkflow(input: $input) {
3 id
4 status
5 trackingDetails {
6 number
7 }
8 serviceLevel {
9 id
10 name
11 carrier {
12 id
13 name
14 }
15 }
16 shipmentCartons {
17 id
18 carton {
19 id
20 width
21 length
22 height
23 weight
24 items {
25 item {
26 id
27 amount
28 description
29 }
30 }
31 }
32 label {
33 url
34 trackingNumber
35 id
36 documentFiling
37 }
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 還為超過 999 美元的宣告價值產生一份額外的保險表單（UPS Control Log），必須與標籤一起列印。

FedEx 和 DHL：在貨件層級處理宣告價值，無額外限制。

特殊服務

在紙箱上使用 specialServices 以指示電池、乾冰、危險品或簽名要求的特殊處理需求。請查看 特殊服務指南 以了解完整詳情和示例。

作廢貨件 

若要取消已建立的標籤，請使用以下 mutation 作廢貨件。任何相關聯的標籤也將自動作廢。請注意，一旦貨件被作廢，就無法更新或還原。

1mutation {
2 shipmentStatusUpdate(
3 input: {
4 shipment: "shipment_12345678-1234-1234-1234-123456789stu"
5 status: VOIDED
6 note: "Voiding shipment"
7 }
8 ) {
9 id
10 status
11 }
12}
GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput

MUTATIONS

cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate

這個頁面有幫助嗎？

獲取支持·法律文件·© 2026 Zonos
在此頁面：
  • 通過 API 建立貨件