如何上傳訂單
- 前往 Dashboard -> Orders -> Manage -> Upload orders。
- 從上傳頁面下載 CSV 範本,並使用您的訂單資料進行填充。
- 上傳已完成的 CSV。
- 檢查確認畫面 — 著陸成本按列計算,任何錯誤或警告都會內聯顯示。
- 點擊 Create orders 提交所有 Ready 訂單。
CSV 格式
直接從 Dashboard 的上傳頁面下載 CSV 範本。該範本包括所有必需和可選列 — 必需列在表頭列中用星號 (*) 標記。
必需列
每一列代表一個訂單。每列的必需資訊分為三類:
收件人 — 收件人的姓名、電郵、電話號碼和配送地址,包括目標國家/地區。郵遞區號和州/省份只在地址格式使用它們的國家/地區才是必需的 — 對於沒有郵遞區號的國家/地區(例如香港或坦桑尼亞),只需將該儲存格留空。對於有州/省份列表的國家/地區,請使用公認的地區名稱或代碼(例如「Dubayy」或「DU」表示杜拜),以便承運商能夠為目標地點定價。
物品 — 至少包括物品名稱、數量和價格。提供 HS 代碼和原產國可以提高分類準確性,並可以減少確認畫面上的處理時間。
配送 — 與您帳戶上配置的承運商相符的服務級別代碼(例如 fedex.international_priority、ups_worldwide_expedited)。Shipping Amount 列是可選的:輸入金額(允許為 0)以將其用作訂單的配送費用,或將其留空,系統會為您的服務級別計算承運商費率估算。計算的列在確認畫面上需要額外的幾秒鐘,最終承運商費用在建立標籤時可能與估算不同。某些目標地點無法自動定價(「服務不適用於目標國家/地區」錯誤)— 只在這些列上輸入配送金額;留空和已填寫的列可以在一個檔案中自由混合。
可選列
收件人稅號 — 使用 Tax ID Type 和 Tax ID Number 列在訂單上包括收件人稅務識別符。該類型必須是下列代碼之一(不分大小寫)。同時提供兩列;缺少數字的類型(或反之)在確認畫面上會標記為錯誤。稅號儲存在訂單的收件人上,並在建立標籤時傳遞給承運商。對於多物品訂單,將使用訂單第一列的稅號。
如果存在特定於國家/地區的代碼,請使用該代碼;對於任何未列出的國家/地區,請使用 TIN。
| 國家 / 地區↕ | 代碼↕ | 稅號↕ |
|---|---|---|
| 阿根廷 | CUIL | CUIL 或 CUIT |
| 阿根廷/西班牙/秘魯 | DNI | 國家身份證/稅號 |
| 澳洲 | OSR | AUSid GST 登記 |
| 澳洲/紐西蘭 | LVG | 海外註冊供應商(低價值商品) |
| 巴西 | CNP | CNPJ(商業聯邦稅號) |
| 巴西 | CPF | CPF(個人納稅人登記) |
| 加拿大 | GST | GST/HST 登記號 |
| 智利 | RUN | Rol Único Tributario (RUT/RUN) |
| 歐盟 | EU_EORI | EU EORI 號碼 |
| 歐盟 | IOSS | Import One-Stop Shop 號碼 |
| 法國 | FTPC | 法國海關增值稅(低價值) |
| 印度 | PAN | 永久帳號 |
| 印尼 | NPWP | 稅務識別號碼 |
| 墨西哥 | RFC | Registro Federal de Contribuyentes |
| 墨西哥 | CURP | CURP(個人) |
| 挪威 | VOEC | VAT on E-Commerce 計劃號碼 |
| 挪威 | VOEC_NO | 挪威增值稅號碼 |
| 沙特阿拉伯 | SA_VAT | 沙特增值稅號碼 |
| 南非 | TRN | 稅務參考號碼 |
| 南韓 | PCC | 個人海關通關代碼 |
| 阿聯酋 | UAE_TRN | 稅務登記號碼 |
| 英國 | GB_EORI | 英國 EORI 號碼 |
| 英國 | HMRC | 英國增值稅登記(外國賣家) |
| 美國 | EIN | 僱主識別號碼 |
| 美國 | SSN | 社會安全號碼 |
| 美國 | STA | 州稅務 ID |
| 任何國家 | EORI | 經濟主體登記編號 |
| 任何其他國家 | 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 出現在確認畫面上,並傳遞到建立的訂單作為商家參考。
檢查確認畫面
上傳後,確認畫面會在建立任何內容之前顯示每個訂單的計算著陸成本明細。該畫面顯示:
| 列↕ | 說明↕ |
|---|---|
| Order ID | CSV 中的參考 ID。 |
| Items | 物品名稱和數量。 |
| Recipient | 收件人的姓名。 |
| Country | 目標國家/地區。 |
| Duty paid by | 所選報價是 DDP(您支付關稅和稅款)還是 DDU(收件人於到貨時支付,以橙色徽章顯示)。 |
| Service level | 用於定價的配送服務級別。 |
| Item total | 宣布的物品價值。 |
| Shipping | 計算的配送成本。 |
| Duties | 計算的關稅。 |
| Taxes | 計算的稅款。 |
| Fees | Zonos 費用。 |
| LC total | 總著陸成本(關稅 + 稅款 + 費用)。 |
| Grand total | 包括物品價值和著陸成本的總計。 |
| Status | Ready、Warning 或 Error。 |
當目標地點在貨件的宣布價值上不收取進口費用時,列可能顯示 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 個現成訂單,它們會自動分多批處理。
即將推出: 未來更新將取消 200 訂單上限,並為更大上傳添加背景工作處理。
批量上傳訂單
透過上傳 CSV 檔案,一次建立最多 200 個訂單。與其逐一建立訂單,您可以從 Dashboard 上傳 CSV 檔案以批量建立訂單。當您需要同時處理大量貨件時,這是一個很好的選擇。著陸成本會為每一列即時計算,並在任何訂單提交之前顯示在確認畫面上,以便您可以在提交前查看整個批次的完整成本明細。