批量上傳訂單

直接從 Dashboard 的上傳頁面下載 CSV 範本。該範本包括所有必需和可選欄位 — 必需欄位在表頭列中用星號 (*) 標記。

每列一項物品

每一列代表一件物品，而非一張訂單。共用相同 Order ID 的列會被歸為同一張多物品訂單，因此一張包含三件物品的訂單會有三列。訂單層級的數值 — 收件人、地址、服務級別、配送金額、貨幣、稅務支付人和紙箱 — 均以每個群組的第一列為準。

必需欄位

每列的必需資訊分為三類：

收件人 — 收件人的姓名、電話號碼和配送地址，包括目標國家/地區。電郵為可選項，但如有提供，系統會驗證其格式。郵遞區號和州/省份只在地址格式使用它們的國家/地區才是必需的 — 對於沒有郵遞區號的國家/地區（例如香港或坦桑尼亞），只需將該儲存格留空。對於有州/省份列表的國家/地區，請使用公認的地區名稱或代碼（例如「Dubayy」或「DU」表示杜拜），以便承運商能夠為目標地點定價。

物品 — 至少包括物品名稱和價格。數量為可選項，預設為 1。提供 HS 代碼和原產國可以提高分類準確性，並可以減少確認畫面上的處理時間。

配送 — 與您帳戶上配置的承運商相符的服務級別代碼（例如 fedex.international_priority、ups_worldwide_expedited）。Shipping Amount 欄位是可選的：輸入金額（允許為 0）以將其用作訂單的配送費用，或將其留空，系統會為您的服務級別計算承運商費率估算。計算的列在確認畫面上需要額外的幾秒鐘，最終承運商費用在建立標籤時可能與估算不同。某些目標地點無法自動定價（「服務不適用於目標國家/地區」錯誤）— 只在這些列上輸入配送金額；留空和已填寫的列可以在一個檔案中自由混合。

可選欄位

收件人稅號 — 使用 Tax ID Type 和 Tax ID Number 欄位在訂單上包括收件人稅務識別符。該類型必須是下列代碼之一（不分大小寫）。同時提供兩個欄位；缺少數字的類型（或反之）在確認畫面上會標記為錯誤。稅號儲存在訂單的收件人上，並在建立標籤時傳遞給承運商。對於多物品訂單，將使用訂單第一列的稅號。

如果存在特定於國家/地區的代碼，請使用該代碼；對於任何未列出的國家/地區，請使用 TIN。

當您的 Zonos 代表指示您使用特定用途代碼時（FED、FTZ、DUN 和 DAN/TAN/DTF 關稅和稅務遞延帳戶），接受其他特殊用途代碼。

稅務支付人 — 按訂單可選的 DDP 或 DDU。將其留空以使用預設行為：DDP 在目標地點支援的地方，在不支援的地方自動降級為 DDU。明確的 DDP 是嚴格的 — 列出現錯誤而不是降級 — 而 DDU 使收件人負責到貨時的關稅和稅款。確認畫面和結果下載顯示每個訂單實際著陸在哪個，DDU 列上有橙色徽章。對於多物品訂單，第一個指定的值獲勝，衝突的值是錯誤。

紙箱數量 — 如果訂單以多個相同的箱子配送，請在 Carton Length/Width/Height/Weight 欄位旁邊設定 Carton Quantity。紙箱欄位描述一個箱子（重量是一個打包箱子的重量），數量將其相乘 — 例如，360 個單位以每箱 30 個包裝，將使用箱子尺寸、一個滿箱子的重量和 12 的紙箱數量。留空表示 1。具有混合箱子尺寸的訂單無法在 CSV 中描述 — 在這些訂單上留下紙箱欄位為空，Zonos 將根據物品重量自動為它們打箱。

提示

• 使用承運商設定中顯示的確切服務級別代碼。具有無法識別的服務級別代碼的列將在確認畫面上顯示警告。
• 美國領土不同：美國維京群島使用自己的國家/地區代碼（VI）並作為國際貨件配送，而波多黎各使用 US 並作為國內配送。
• 承運商（特別是 UPS）拒絕郵政信箱配送地址 — 地址行中帶有「P.O. Box」的列可能因通用服務可用性錯誤而失敗定價。盡可能使用街道地址。
• 來自 Word 或 Excel 的版式標點符號（捲曲引號、短破折號/長破折號）會自動更正。如果本應顯示重音字母的位置卻出現問號，即表示檔案編碼遺失 — 這些列會被標記，以便您重新輸入文本。
• 對於需要州或省份代碼的目標國家/地區（例如巴西、美國、加拿大），請確保州欄位已填寫正確的 ISO 代碼。
• Order ID 是必需的，並且必須在您的整個帳戶中唯一，包括之前的上傳 — 之前曾使用過的 ID（即使在較早季節的檔案或取消的訂單中）在訂單建立時會被拒絕。重新使用檔案？在 ID 上添加後綴（例如 ACALB-33 表示第 33 卷）。該 ID 出現在確認畫面上，並傳遞到建立的訂單作為商家參考。
• 收件人姓名、地址、城市、州/省份、公司名稱及物品名稱必須使用拉丁字符。日文或阿拉伯文等非拉丁文字會被拒絕。
• 完全空白的列會被忽略，因此檔案末尾的空白列不會造成影響。

標準範本中的每一欄位，按範本順序排列。條件性表示該欄位只在特定情況下才是必需的 — 詳情請參閱上方的必需欄位。

Japan Post 使用其專屬的 CSV 範本，下載方式與其他範本相同。它沒有服務級別欄位 — 上傳時會指派承運商的第一個服務級別，您需要在建立標籤流程中重新選擇 — 也沒有紙箱數量欄位，因為這類上傳一律以單一紙箱配送。

在標準範本中為可選、但在 Japan Post 中為必需的欄位：

• HS code
• Country of origin
• Item weight — 此處重量單位仍為可選，預設為公克
• Postal code
• State/province
• Shipping amount — 與標準範本不同，此欄不能留空

此範本還新增了 Japan Post 的配送欄位，這些欄位會儲存在訂單上，並在建立標籤時套用到貨件：Contents Type、Licence Number、Certificate Number、Invoice、Tax Code/VAT Number、Pay Condition、Remarks、Sender's Reference Number 及 Non-commercial。全部為可選。文字欄位最多接受 25 個字符，Non-commercial 只接受 true 或 false。

上傳後，確認畫面會在建立任何內容之前顯示每個訂單的計算著陸成本明細。該畫面顯示：

當目標地點在貨件的宣布價值上不收取進口費用時，列可能顯示 $0 的關稅、稅款和費用（低於國家/地區的最低限額閾值）— 著陸成本確實為零，並非遺漏，配送是這些訂單的唯一成本。

Create orders 按鈕顯示將提交的訂單計數（例如 Create 17 orders）。只有 Ready 或 Warning 狀態的列被包括 — 出現錯誤的列被排除。

使用 Download results CSV 匯出完整報價明細（所選費率、物品總計、配送、關稅、稅款、費用和每個訂單的總計）— 在建立任何訂單之前用於向客戶報價。點擊 Start over 放棄上傳並使用修訂的檔案重新開始。

當您將 Shipping Amount 留空時，服務級別欄位顯示與您 CSV 的服務級別相符的費率。如果您要求的服務級別不適用於目標地點，將選擇最接近的可用費率，並用 Different service level 徽章標記 — 或者，當存在多個替代方案時，Select a rate 下拉列表讓您在可以建立訂單之前選擇。

問題在確認畫面上內聯標記。

錯誤

出現錯誤的列在您點擊 Create orders 時會被排除。在您的 CSV 中修復問題並重新上傳以包括這些列。常見錯誤包括：

• 不允許低價值訂單 — 訂單價值低於您商店的最低限額。
• 無效州代碼 — 州或省份代碼對於目標國家/地區無效。加拿大、美國和巴西等國家/地區需要。
• 缺少必需欄位 — 必需欄位為空或無法解析。
• 訂單 ID 已存在 — 每個訂單 ID 必須在您的整個帳戶中唯一，包括之前上傳的訂單。具有已使用 ID 的列在建立時失敗，而檔案的其餘部分成功 — 使用新 ID 重新上傳失敗的列（像 -33 這樣的後綴可以正常運作）。

警告

出現警告的列包括在提交中。在點擊 Create orders 之前檢查它們。常見警告包括：

• 未配置服務級別 — CSV 中的服務級別代碼未連接到您的帳戶。訂單將被建立，但可能無法正確定價。檢查您的承運商設定或更新 CSV 中的服務級別代碼。

當前上傳限制為每個 CSV 200 個訂單。訂單以最多 50 個為一批通過 API 呼叫提交 — 如果您的上傳包含超過 50 個 Ready 訂單，它們會自動分多批處理。

即將推出： 未來更新將取消 200 訂單上限，並為更大上傳添加背景工作處理。