CSV 订单导入指南

通过 CSV 文件从任意来源导入订单。适用于尚未直连对接的平台，也适合手动录入订单。

何时使用 CSV 导入

最适合以下场景：

没有 API 对接的平台
手动录入订单
批量导入历史订单
自定义订单来源
基于表格的工作流程

CSV 文件要求

格式规范：

文件格式：.csv
编码：UTF-8
最大文件大小：10MB
最大行数：10,000

必填列

最少字段：

列名	说明	示例
order_id	唯一标识	ORD-001
ship_name	收件人姓名	John Smith
ship_address1	街道地址	123 Main St
ship_city	城市	New York
ship_state	州/省代码	NY
ship_zip	邮政编码	10001
ship_country	国家代码	US

可选列

附加字段：

列名	说明
ship_address2	公寓/单元号
ship_phone	电话号码
ship_email	电子邮箱
weight	包裹重量（盎司）
length	长度（英寸）
width	宽度（英寸）
height	高度（英寸）
service	配送服务
items	商品描述

CSV 示例

示例文件：

order_id,ship_name,ship_address1,ship_city,ship_state,ship_zip,ship_country,weight
ORD-001,John Smith,123 Main St,New York,NY,10001,US,16
ORD-002,Jane Doe,456 Oak Ave,Los Angeles,CA,90001,US,8
ORD-003,Bob Wilson,789 Pine Rd,Chicago,IL,60601,US,24

导入流程

分步操作：

准备好你的 CSV 文件
进入订单 → 导入
点击“上传 CSV”
将列映射到对应字段
预览导入内容
确认并导入

列映射

灵活映射：

自动识别常见表头
手动映射自定义列
保存映射模板
后续导入可复用

校验规则

导入前检查：

必填字段是否齐全
地址是否有效
格式是否正确
是否存在重复

错误处理

常见错误：

错误	原因	解决方法
地址无效	缺少字段	补全地址
订单重复	order_id 相同	删除重复项
州代码无效	代码错误	使用 2 位字母代码
编码错误	非 UTF-8	另存为 UTF-8

导入预览

导入前请核对：

行数
错误数量
警告列表
示例行

部分导入

处理错误：

跳过无效行
仅导入有效行
下载错误报告
修正后重新导入

导入历史

追踪所有导入记录：

日期和时间
文件名
行数
成功/错误数量
下载原始文件

模板

内置模板：

基础订单
含尺寸信息
国际订单
自定义模板

导出模板

获取空白模板：

订单 → 导入
下载模板
选择格式
填入数据

最佳实践

顺利导入的技巧：

使用 UTF-8 编码
包含表头
先校验地址
先用少量数据测试
检查是否有重复

地址格式

美国地址：

ship_state: 使用 2 位字母代码 (NY, CA)
ship_zip: 5 位或 9 位数字 (10001)
ship_country: US

国际地址：

ship_state: 省/地区
ship_zip: 当地格式
ship_country: 2 位 ISO 国家代码

重量与尺寸

单位：

重量：盎司（oz）
尺寸：英寸（in）
如有需要请自行换算

定时导入

自动化方式：

SFTP 上传
定时监控文件夹
API 上传接口

一单多包裹订单

处理方式：

每个包裹占一行
使用相同的 order_id
各自对应不同的物流单号

导入之后

后续步骤：

核对已导入的订单
验证地址
选择配送服务
生成面单

疑难排查

导入失败时：

检查文件编码
核对列表头
查看错误日志
校验地址
尝试更小的批次

限制说明

当前限制：

最多 10,000 行
文件大小 10MB
仅支持 UTF-8
不支持公式单元格