批量上傳訂單

從 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 稅金和關稅遞延帳戶）。

Duty Paid By — 每筆訂單可選的 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 的排版標點符號（捲曲引號、en/em 破折號）會自動修正。出現在應該有重音字母位置的問號表示檔案遺失了其編碼—這些列被標示，以便您可以重新輸入文字。
• 對於需要州或省份代碼的目的地國家/地區（例如巴西、美國、加拿大），確保州欄位中填入正確的 ISO 代碼。
• Order ID 是必需的，且必須在您的整個帳戶中唯一，包括先前的上傳—曾經使用過的 ID（即使在早期季節的檔案或已取消的訂單中）在訂單建立時會被拒絕。重複使用檔案？為 ID 新增尾碼（例如 ACALB-33 代表第 33 冊）。該 ID 在確認畫面上出現，並作為商家參考號傳遞到建立的訂單。
• 收件人名稱、地址、城市、州/省份、公司名稱和商品名稱必須使用拉丁字元。不接受日文或阿拉伯文等非拉丁文字。
• 完全空白的列會被忽略，因此檔案結尾的空白列不會造成問題。

標準範本中的每個欄位，依範本順序排列。有條件表示該欄僅在特定情況下為必需—詳情請參閱上方的必需欄位。

日本郵政使用自己的 CSV 範本，下載方式與其他範本相同。它沒有服務等級欄——上傳時會指派承運人的第一個服務等級，您需要在標籤流程中重新選擇一個——也沒有紙箱數量欄，因為這些上傳一律以單一紙箱出貨。

在標準範本中為選用、但日本郵政必需的欄位：

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

此範本還新增了日本郵政運送欄位，這些欄位會儲存在訂單上，並在建立標籤時套用至貨件：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。

上傳後，確認畫面會在建立任何內容之前顯示每筆訂單計算的 landed cost 明細。畫面顯示：

當目的地在貨物聲明價值不收進口費用時（其低於國家/地區的 de minimis 閾值），列會顯示 $0 關稅、稅金和費用—landed cost 確實為零，而非遺失，運送是這些訂單的唯一成本。

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

使用 Download results CSV 匯出完整報價明細（所選費率、商品總計、運送、關稅、稅金、費用和每筆訂單的總計）—在建立任何訂單之前向客戶報價時很有用。按一下 Start over 放棄上傳，並使用修訂的檔案重新開始。

當您將 Shipping Amount 留空時，服務等級欄會顯示與您 CSV 的服務等級相符的費率。如果您要求的服務等級對目的地不可用，系統會選擇最接近的可用費率並使用 Different service level 徽章標示—或者，當存在多個替代方案時，Select a rate 下拉式清單可讓您在建立訂單之前選擇。

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

錯誤

按一下 Create orders 時，具有錯誤的列會被排除。在您的 CSV 中修正問題並重新上傳以包含這些列。常見錯誤包括：

• Low-value orders not allowed（不允許低價值訂單）— 訂單價值低於您商店的最小閾值。
• Invalid state code（無效的州代碼）— 州或省份代碼對目的地國家/地區無效。巴西、美國和加拿大等國家需要。
• Missing required field（遺失必需欄位）— 必需欄位為空或無法解析。
• Order ID already exists（訂單 ID 已存在）— 每個訂單 ID 必須在您的整個帳戶中唯一，包括先前上傳的訂單。具有已使用 ID 的列在建立時失敗，而檔案的其餘部分成功—僅重新上傳具有新 ID 的失敗列（如 -33 這樣的尾碼效果很好）。

警告

具有警告的列會包括在提交中。在按一下 Create orders 之前檢視它們。常見警告包括：

• Service level not configured（未設定服務等級）— 您 CSV 中的服務等級代碼未連接到您的帳戶。訂單將被建立，但可能無法正確評定。驗證您的承運人設定或更新 CSV 中的服務等級代碼。

目前上傳限制為每個 CSV 200 筆訂單。訂單以每個 API 呼叫最多 50 筆的批次提交—如果您的上傳包含 50 筆以上的就緒訂單，系統會自動以多個批次處理它們。

即將推出： 未來的更新將移除 200 筆訂單上限，並為更大的上傳新增背景工作處理。