物流信息批量导入 | YCloud 文档
了解如何为店铺内已有订单批量导入物流信息，更新发货状态、承运商、运单号和追踪链接。
能做什么
-
本功能仅针对您店铺内已存在的订单，用于更新发货状态与物流快递信息。不会为店铺创建新的订单！
-
更新内容包括：发货状态、承运商、运单号以及追踪链接。
-
对 实物商品 订单：导入成功后订单会被标记为 已发货，并向顾客展示物流信息。
-
对 虚拟/数字商品 订单：仅标记为 已发货（无需填写运单号或追踪链接）。
开始前准备
为确保履约流程顺畅，请先完成以下设置：
-
安装并创建店铺、添加商品、设置运费模板与支付方式（COD / PayPal）。
-
建议熟悉 订单 → 发货 / 标记已付款（COD） / 退款与退货 基本操作，点此了解。
下载模板
在 Shop → 订单 页面，点击 导入
打开弹窗，再点击 下载模板。
操作路径：
模板填写的注意事项‼️
快递导入模板的字段说明‼️
| 列名 | 说明 | demo：实物订单 | demo：虚拟商品 |
|---|---|---|---|
| Order_ID | 系统生成的订单唯一标识，用于匹配目标订单。必填 | 100001250814000155 | 100001250814000153 |
| Shipping_Carrier | 承运商名称,如 ：SF、J&T、DHL 等实物商品：必填****虚拟商品：不填 | FedEx | (不填，空着) |
| Tracking_Number | 运单号/追踪号。实物商品：必填****虚拟商品：不填 | 1234 5678 9012 | (不填，空着) |
| Tracking_Url | 顾客点击“查看物流”使用的追踪链接。实物商品：必填****虚拟商品：不填 | https://www.fedex.com/wtrk/track/?trknbr=123456789012 | (不填，空着) |
上传与处理
1. 准备上传
点击 上传，进入文件选择器，
操作路径：
提示
提示
注意，请留意弹窗内，上传文件的要求：
-
csv格式
-
最大 15 MB，≤ 1,000 行数据。
-
仅支持上传 1 个文件/次
2. 选择文件，开始上传
选择一个csv文件，点击打开，
系统将自动开始解析表格
-
表格检测顺利通过后，就自动开始导入数据，并展示 执行结果（见4）
-
表格检测失败，则说明表格有问题，需要您根据问题检查文件（见3）
3. 文件导入失败
如果您的表格 不符合导入的要求，系统将不会导入任何一条数据。
此时，您会收到一个具体的错误信息。需要您先调整文件。
文件检测失败的截图demo
具体失败原因，可查看校验规则-文件级校验
如果顺利通过检测，则开始导入csv的数据。
注意，当文件内的数据行较多时，耗费时间也会相应增加，请耐心等待。
4. 文件导入成功
执行导入结束，会展示导入的结果：
-
导入成功：x条
-
导入失败：y条
点击-下载错误报告
浏览器会下载导入失败的数据，并展示错误的原因。
点击 下载失败行 获取仅包含失败行的 CSV（格式说明如下）。
字段说明（模板列）
| 列名 | 说明 |
|---|---|
Order_ID | 系统生成的订单唯一标识，用于匹配目标订单。 |
Shipping_Carrier | 承运商名称（如 SF、J&T、DHL 等）。 |
Tracking_Number | 运单号/追踪号。实物商品必填；数字商品忽略此字段。 |
Tracking_Url | 顾客点击“查看物流”使用的追踪链接。 |
| import status | 一般是失败 |
| error message | |
| 具体这条订单，导入失败的原因。 | |
| 如：这笔订单id不存在 | |
示例内容：
Order_ID,Shipping_Carrier,Tracking_Number,Tracking_Url
123456789012345678,FDX,123456789012,https://www.fedex.com/track
987654321000000001,,SF1234567890123,Excel 小技巧
注意，当您用excel打开csv文件时，为避免长订单号被自动转为科学计数法或截断，建议将 Order_ID 列设置为“文本格式”，或在值前添加英文单引号 '。
校验与错误报告
系统将进行文件级与行级校验：
文件级校验
-
表头缺失或不一致 →
Invalid template header -
非 CSV 类型 →
Unsupported file type -
文件为空或无有效行 →
No valid entries found -
文件超过大小或行数限制 →
Maximum allowed size is 15 MB and 1,000 rows -
上传多个文件 →
Please upload only one file at a time
行级校验
-
Order_ID为空、未找到或不属于当前店铺 →Order not found -
同一
Order_ID重复 →Duplicate Order ID; skipped -
实物订单缺失或格式错误的
Tracking_Number→Invalid Tracking Number -
数字商品订单跳过物流字段，仅标记为已发货
失败行报告示例（CSV）：
Order_ID,Shipping_Carrier,Tracking_Number,Tracking_Url,Result,Reason
412341234,,,,Failed,"Missing shipping data"
634563456354635,,,,Failed,"Order not found"提示
若遇网络或系统异常等提示，可能是网络波动引起的，请您几分钟后 再尝试导入。