讓客戶能夠從您的平台建立 Zonos 出貨和標籤。
本指南專為想要將 Zonos 出貨建立功能整合至平台的出貨平台開發人員設計，供其客戶使用。如果您已經在使用 Zonos API，只是需要為現有訂單建立出貨，請參閱我們的出貨建立指南。
如果您是支援 Zonos 客戶進行國際出貨的出貨平台，與 Zonos 整合進行出貨建立應該是首要考量。這將透過利用您平台現有的功能，同時讓 Zonos 管理出貨、標籤和支援海關文件的建立，為您的商家及其客戶提供最無縫的體驗。
使用 Zonos 建立出貨的優勢包括：
本指南將引導您實施完整的端到端整合，使您能夠從平台呼叫 Zonos 進行出貨。
請按照下列步驟，讓您的客戶能夠從您的平台擷取 Zonos 標籤。
Zonos API 可透過 credentialToken 存取。您的平台需要讓客戶能夠從 Zonos 儀表板輸入其 credentialToken 至您的平台。從這裡，您將能夠代表客戶向 Zonos 提出請求。
credentialToken
為了擷取 label，您需要建立與 label 相關聯的 shipment。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 傳遞空值。因此，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，您需要建立與label相關聯的shipment。Zonos 透過工作流程管理此程序，該工作流程在同一請求中建立shipments和labels。執行此變更時，您無需傳遞serviceLevel，因為我們將使用與order相關聯的landedCost中使用的serviceLevel。對於orderId，您可以使用 Zonos 訂單 ID 或系統中可能已存在的accountOrderNumber。當出貨和標籤建立成功時，我們將以
labelImage（BASE64_ENCODED_IMAGE）或url的形式返回標籤，以便從中擷取標籤。當您為現有訂單建立出貨且無需修改項目或參與方詳細資訊時，請使用此工作流程。它支援可選的追蹤編號、履行中心、服務級別選擇和聲明價值保險。
Shopify 為來源參與方中的
person傳遞空值。因此，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
這個頁面有幫助嗎？