批量上传订单

从 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 出现在确认屏幕上并进入已创建订单的商家参考中。
• 收件人姓名、地址、城市、州/省、公司名称和物品名称必须使用拉丁字符。日语或阿拉伯语等非拉丁文字将被拒绝。
• 完全空白的行会被忽略，因此文件末尾的空行不会造成影响。

标准模板中的每一列，按模板中的顺序排列。条件性表示该列仅在特定情况下才是必需的 — 详情请参见上文的必需列。

日本邮政使用其自己的 CSV 模板，下载方式相同，从上传页面进行下载。该模板没有服务级别列 — 上传时会分配承运商的第一个服务级别，您可以在标签流程中重新选择 — 也没有纸箱数量列，因为这些上传始终作为单个纸箱发货。

标准模板中为可选、但对日本邮政为必需的列：

• HS code
• Country of origin
• Item weight — 重量单位在此仍为可选，默认为克
• Postal code
• State/province
• Shipping amount — 与标准模板不同，此项不能留空

该模板还添加了日本邮政的配送字段，这些字段会存储在订单上，并在创建标签时应用于货运：内容类型、许可证号、证书号、发票、税码/增值税号、付款条件、备注、发件人参考号以及非商业性质。所有字段均为可选。文本字段最多接受 25 个字符，非商业性质仅接受 true 或 false。

上传后，确认屏幕会在创建任何内容之前显示每个订单的计算到岸成本明细。屏幕显示：

当目的地在申报价值（低于国家/地区的最低门槛）的发货处不征收进口费时，行可以显示 $0 关税、税收和费用 — 到岸成本确实是零，不是缺失，运费是这些订单的唯一成本。

创建订单按钮显示将被提交的订单计数（例如，创建 17 个订单）。仅包括就绪或警告状态的行 — 有错误的行被排除。

使用下载结果 CSV 导出完整报价明细（选定费率、物品总计、运费、关税、税收、费用和每个订单的总计） — 对于在创建任何订单前向您的客户报价很有用。点击重新开始以放弃上传并用修改后的文件从新开始。

当您留空 Shipping Amount 时，服务级别列会显示与您 CSV 的服务级别相匹配的费率。如果您请求的服务级别不适用于某个目的地，最接近的可用费率会被选择并用不同的服务级别徽章标记 — 或者，当存在多个选项时，选择费率下拉列表让您在创建订单前选择。

问题会在确认屏幕上内联标记。

错误

有错误的行在您点击创建订单时被排除。修复 CSV 中的问题并重新上传以包含这些行。常见错误包括：

• 不允许低价值订单 — 订单价值低于您商店的最低阈值。
• 无效的州代码 — 州或省代码对目的地国家/地区无效。对于巴西、美国和加拿大等国家/地区是必需的。
• 缺少必需字段 — 必需列为空或无法解析。
• 订单 ID 已存在 — 每个订单 ID 必须在您的整个账户中唯一，包括以前上传的订单。具有已使用 ID 的行在创建时失败，同时文件的其余部分成功 — 仅重新上传失败的行，使用新的 ID（后缀如 -33 效果很好）。

警告

警告的行包含在提交中。在点击创建订单前审查它们。常见警告包括：

• 未配置服务级别 — CSV 中的服务级别代码未连接到您的账户。订单将被创建但可能无法正确评级。验证您的承运商设置或更新 CSV 中的服务级别代码。

当前上传限制是每个 CSV 200 个订单。订单以最多 50 个为一批，通过每次 API 调用提交 — 如果您的上传包含超过 50 个就绪订单，它们将自动分多批处理。

即将推出： 未来的更新将移除 200 订单上限并为更大的上传添加后台作业处理。