讓客戶能夠從您的平臺建立 Zonos 出貨和標籤。
本指南專為想要將 Zonos 出貨建立功能整合到其平臺中的運送平臺開發者設計，供其客戶使用。如果您已經在使用 Zonos API，只需要為現有訂單建立出貨，請參閱我們的出貨建立指南。
如果您是支援 Zonos 客戶進行國際運送的運送平臺，與 Zonos 整合出貨建立應該是首要考慮事項。這將使您能夠透過利用平臺現有功能，同時讓 Zonos 管理出貨、標籤和支援報關文件的建立，為您的商戶及其客戶提供最無縫的體驗。
使用 Zonos 建立出貨的優勢包括：
本指南將逐步引導您實施完整的端到端整合，讓您能夠從平臺呼叫 Zonos 進行出貨。
按照以下步驟，允許您的客戶從您的平臺擷取 Zonos 標籤。
Zonos API 可透過 credentialToken 存取。您的平臺需要讓客戶能夠從 Zonos 儀表板輸入其 credentialToken 到您的平臺中。藉此，您將能夠代表他們向 Zonos 發出請求。
credentialToken
為了擷取 label，您需要建立一個 shipment，label 將與該出貨關聯。Zonos 透過在相同請求中建立 shipments 和 labels 的工作流程來管理此流程。執行此變更時，您不需要傳遞 serviceLevel，因為我們將使用與 order 相關聯的 landedCost 中使用的 serviceLevel。對於 orderId，您可以使用 Zonos 訂單 ID 或可能已在您的系統中的 accountOrderNumber。
label
shipment
shipments
labels
serviceLevel
order
landedCost
orderId
accountOrderNumber
成功建立出貨和標籤後，我們將返回標籤作為 labelImage（即 BASE64_ENCODED_IMAGE），或作為可從中擷取標籤的 url。
labelImage
BASE64_ENCODED_IMAGE
url
使用此工作流程時，您正在為現有訂單建立出貨，且不需要修改項目或方詳細資訊。它支援選用的追蹤號碼、履行中心、服務等級選擇和宣告價值保險。
Shopify 為原始方在 person 傳遞 null 值。因此，orderId 單獨將無法為 Shopify 商戶運行 - 改為使用進階出貨建立分頁，並提供完整的方詳細資訊，包括 person。
person
mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {
shipmentCreateWorkflow(input: $input) {
id
status
trackingDetails {
number
}
serviceLevel {
name
carrier {
shipmentCartons {
carton {
width
length
height
weight
items {
item {
amount
description
label {
trackingNumber
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 以表示電池、乾冰、危險品或簽名要求的特殊處理要求。有關完整詳細資訊和範例，請參閱特殊服務指南。
specialServices
ShipStation UPS 解鎖：不支援多件出貨。當訂單在多個盒子中運送時，參考欄位會重複，導致後端上的訂單號碼匹配失敗。需要多件出貨的商戶應改為在 Zonos 儀表板中建立標籤。單個盒子出貨不受影響。
在客戶想要作廢 shipment 的情況下，您可以使用以下變更，這將作廢與 shipment 相關聯的所有 labels。
mutation {
shipmentStatusUpdate(
input: {
shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"
status: VOIDED
note: "Voiding shipment"
) {
CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput
cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate
平臺出貨整合
從您的平臺建立出貨
讓客戶能夠從您的平臺建立 Zonos 出貨和標籤。
本指南專為想要將 Zonos 出貨建立功能整合到其平臺中的運送平臺開發者設計，供其客戶使用。如果您已經在使用 Zonos API，只需要為現有訂單建立出貨，請參閱我們的出貨建立指南。
如果您是支援 Zonos 客戶進行國際運送的運送平臺，與 Zonos 整合出貨建立應該是首要考慮事項。這將使您能夠透過利用平臺現有功能，同時讓 Zonos 管理出貨、標籤和支援報關文件的建立，為您的商戶及其客戶提供最無縫的體驗。
使用 Zonos 建立出貨的優勢包括：
本指南將逐步引導您實施完整的端到端整合，讓您能夠從平臺呼叫 Zonos 進行出貨。
啟用標籤列印
按照以下步驟，允許您的客戶從您的平臺擷取 Zonos 標籤。
允許 API 憑證
Zonos API 可透過
credentialToken存取。您的平臺需要讓客戶能夠從 Zonos 儀表板輸入其credentialToken到您的平臺中。藉此，您將能夠代表他們向 Zonos 發出請求。建立出貨
為了擷取
label，您需要建立一個shipment，label將與該出貨關聯。Zonos 透過在相同請求中建立shipments和labels的工作流程來管理此流程。執行此變更時，您不需要傳遞serviceLevel，因為我們將使用與order相關聯的landedCost中使用的serviceLevel。對於orderId，您可以使用 Zonos 訂單 ID 或可能已在您的系統中的accountOrderNumber。成功建立出貨和標籤後，我們將返回標籤作為
labelImage（即BASE64_ENCODED_IMAGE），或作為可從中擷取標籤的url。使用此工作流程時，您正在為現有訂單建立出貨，且不需要修改項目或方詳細資訊。它支援選用的追蹤號碼、履行中心、服務等級選擇和宣告價值保險。
Shopify 為原始方在
person傳遞 null 值。因此，orderId單獨將無法為 Shopify 商戶運行 - 改為使用進階出貨建立分頁，並提供完整的方詳細資訊，包括person。mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {shipmentCreateWorkflow(input: $input) {idstatustrackingDetails {number}serviceLevel {idnamecarrier {idname}}shipmentCartons {idcarton {idwidthlengthheightweightitems {item {idamountdescription}}}label {urltrackingNumberiddocumentFiling}}}}變數選項：
"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: VOIDEDnote: "Voiding shipment"}) {idstatus}}CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput
cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate
這個頁面有幫助嗎？