啟用標籤列印
請按照下列步驟，讓您的客戶能夠從您的平台擷取 Zonos 標籤。
允許 API 認證
建立出貨
為了擷取 label，您需要建立與 label 相關聯的 shipment。Zonos 透過工作流程管理此程序，該工作流程在同一請求中建立 shipments 和 labels。執行此變更時，您無需傳遞 serviceLevel，因為我們將使用與 order 相關聯的 landedCost 中使用的 serviceLevel。對於 orderId，您可以使用 Zonos 訂單 ID 或系統中可能已存在的 accountOrderNumber。
當出貨和標籤建立成功時，我們將以 labelImage（BASE64_ENCODED_IMAGE）或 url 的形式返回標籤，以便從中擷取標籤。
當您為現有訂單建立出貨且無需修改項目或參與方詳細資訊時，請使用此工作流程。它支援可選的追蹤編號、履行中心、服務級別選擇和聲明價值保險。
mutation CreateShipment($input: ShipmentCreateWorkflowInput!) { shipmentCreateWorkflow(input: $input) { id status trackingDetails { number } serviceLevel { id name carrier { id name } } shipmentCartons { id carton { id width length height weight items { item { id amount description } } } label { url trackingNumber id documentFiling } } }}變數選項：
- 搭配履行中心： 新增
"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-50,000 美元之間的價值，並在紙箱級別處理聲明價值。對於多紙箱出貨，商家必須分割出貨以指定每個紙箱的保險範圍。UPS 還會生成必須與標籤一起列印的額外保險表格。
FedEx 和 DHL：在出貨級別處理聲明價值，沒有額外限制。
特殊服務
使用紙箱上的 specialServices 以指示電池、乾冰、危險品或簽名需求的特殊處理需求。如需完整詳細資訊和範例，請參閱特殊服務指南。
ShipStation UPS 解鎖：不支援多件出貨。當訂單在多個盒子中出貨時，參考欄位重複，導致後端的訂單編號比對失敗。需要多件出貨的商家應改為在 Zonos 儀表板中建立標籤。單一盒子出貨不受影響。
作廢出貨
如果客戶想要作廢 shipment，您可以使用下列變更，該變更將作廢與 shipment 相關聯的所有 labels。
mutation { shipmentStatusUpdate( input: { shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223" status: VOIDED note: "Voiding shipment" } ) { id status }}
從您的平台建立出貨
讓客戶能夠從您的平台建立 Zonos 出貨和標籤。
本指南專為想要將 Zonos 出貨建立功能整合至平台的出貨平台開發人員設計，供其客戶使用。如果您已經在使用 Zonos API，只是需要為現有訂單建立出貨，請參閱我們的出貨建立指南。
如果您是支援 Zonos 客戶進行國際出貨的出貨平台，與 Zonos 整合進行出貨建立應該是首要考量。這將透過利用您平台現有的功能，同時讓 Zonos 管理出貨、標籤和支援海關文件的建立，為您的商家及其客戶提供最無縫的體驗。
使用 Zonos 建立出貨的優勢包括：
本指南將引導您實施完整的端到端整合，使您能夠從平台呼叫 Zonos 進行出貨。