啟用標籤列印
按照以下步驟，允許您的客戶從您的平臺擷取 Zonos 標籤。
允許 API 憑證
建立出貨
為了擷取 label，您需要建立一個 shipment，label 將與該出貨關聯。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 進行出貨。