一句定义
Amazon Custom 订单导出 Excel = 把 Amazon 卖家后台的 customization ZIP 解压、解析嵌套 JSON、把 surfaces / areas / TextPrinting / OptionSelection / ImageUpload 节点对应到工厂中文字段,再按你工厂的模板列名落到 Excel。
它不是「点一下下载」的动作。Amazon 给你的是 ZIP + JSON 嵌套结构 + UUID 文件名图片,工厂要的是中文字段 + 已绑订单号的图片 + 一行一单的 Excel——中间这段工作就是导出。
适用场景
Amazon Custom 类目卖家:刻字项链、戒指、手镯、宠物牌、门牌、首字母字母牌、家庭照片定制等,一条订单平均 6-12 个定制字段。
多 SKU 多变体卖家:同一个父 ASIN 下有 20-50 个子 SKU,每个子 SKU 的 customization 选项命名不一样,需要统一映射到一份 Excel。
对接外协工厂的卖家:工厂不上系统,只认 Excel。你需要每天把当日订单整理成「工厂 A 模板.xlsx」「工厂 B 模板.xlsx」分别发出。
5 人左右的小团队:没有专职开发,手工解析 customization ZIP 平均每条订单要 2-3 分钟,一天 200 单就是 6-10 个小时纯手工——这正是导出工具要解决的成本。
输入输出示例
输入:Amazon Seller Central → Manage Orders → 选中订单 → Customization Info → 下载 ZIP。ZIP 里典型结构:
- `customizationData.json`(主结构)
- `images/` 目录下若干 UUID 文件名 jpg/png
- 嵌套层级:`customizationInfo.surfaces[N].areas[M].customizationType`,类型有 `TextPrinting` / `OptionSelection` / `ImageUpload` 三类。
字段对应表(Amazon 原字段 → 工厂中文字段):
| Amazon 原字段路径 | 含义 | 工厂中文字段 | 处理要点 |
|---|---|---|---|
| `surfaces[i].name` | 定制面名称(front/back/inside) | 定制位置 | 翻译 + 与产品图位置对应 |
| `areas[j].text` | 客户填写的文本 | 刻字内容 | 原文保留,不要自动修拼写 |
| `areas[j].fontFamily` | 字体名 | 字体 | 归一到工厂认的精确字体名 |
| `areas[j].colorHex` | 字体色 hex | 字体色 | 同时保留中文名 + hex |
| `areas[j].fontSize` | 字号 pt | 字号 | 单位统一为 pt |
| `OptionSelection.value` | 选项值(如颜色、材质) | 对应商品字段 | 按选项 name 路由 |
| `ImageUpload.imageName` | 上传图 UUID 文件名 | 客户上传图 | 必须重命名绑订单号 |
| `orderId` | 订单号 | 订单号 | 图片重命名前缀 |
输出(工厂 Excel 模板列名建议):
| 列号 | 列名 | 示例值 | 必填 |
|---|---|---|---|
| A | 订单号 | 102-7345891-1234567 | 是 |
| B | SKU | NL-925-18-GOLD | 是 |
| C | 数量 | 1 | 是 |
| D | 材质 | 925 纯银 | 是 |
| E | 颜色 | 金色 | 是 |
| F | 链长 | 18 inch(45cm) | 是 |
| G | 定制位置 | 背面 | 是 |
| H | 刻字内容 | Mom 2026 | 是 |
| I | 字体 | Bree Serif | 是 |
| J | 字体色 | 黑色 #000000 | 是 |
| K | 字号 | 14pt | 否 |
| L | 客户上传图 | 102-7345891_back.jpg | 条件必填 |
| M | 包装 | 礼盒 | 是 |
| N | 加急 | 是 / 否 | 是 |
| O | 交付截止 | 2026-06-15 | 否 |
| P | 客户原文 | (完整保留) | 是 |
| Q | 审核状态 | 通过 / 待审 / 拦截 | 是 |
整条链路:ZIP 解压 → JSON 解析 → 字段对应 → 同义词归一 → 图片重命名绑订单 → 写 Excel 行 → 按工厂分文件输出。
常见误区
误区一:直接用 Amazon 自带的 Order Report。Order Report 里 customization 字段经常被截断、嵌套结构丢失,工厂拿到只能猜——必须走 customization ZIP 这条路。
误区二:图片用原 UUID 文件名直接发工厂。`8f0001-a7b3-...jpg` 没绑订单号,工厂打印 200 单后根本对不上谁是谁——文件名必须重命名为 `订单号_位置.jpg` 这种结构。
误区三:字段值不做同义词归一。同一个「Bree Serif」字体客户写法有 `Bree Serif` / `BreeSerif` / `bree serif` / `「Bree Serif」`,工厂模板只认一种写法;不归一 = 工厂照着错的字体名找不到字库。
误区四:丢掉客户原文。出了客诉(「我明明写的是 Sliver 不是 Silver」)没原文 = 没证据 = 100% 卖家赔。Excel 里必须留一列「客户原文」。
误区五:所有订单合一份 Excel 发所有工厂。A 工厂不需要「包装」列、B 工厂的字段是「印刷区域」不是「定制位置」——一份 Excel 通用 = 每家工厂都要自己再处理一遍。刻字错误一次的重做成本通常是原材料的 3-5 倍(人工 + 物流 + 时效赔付),不分工厂模板得不偿失。
Koru 如何处理
Koru 把 Amazon Custom 的 ZIP 解析做成 6 步可见流水线:ZIP 上传 → JSON 解析 → 字段映射 → 同义词归一 → 图片重命名绑订单 → 多工厂模板导出。每一步的中间结果都能在工作台看到、能改。
字段映射表由你团队维护。Amazon `areas[j].fontFamily` 映射到中文「字体」之后,遇到 `BreeSerif` 这种变体写法系统会询问要不要并入「Bree Serif」——你确认一次,下次自动归。
图片重命名规则可配置。默认 `订单号_位置序号.扩展名`(例:`102-7345891_back_01.jpg`),需要给工厂 A 用别的命名规则也能改。
Excel 模板按工厂维护。一份订单一次解析,可以同时导出「工厂 A 模板.xlsx」「工厂 B 模板.xlsx」「客服自查.xlsx」三个文件,列名顺序、必填项各不相同。
原文一列永远在。不管你后面字段怎么归一、怎么翻译,客户原始字符串始终保留在 Excel 的「客户原文」列——出问题时一查到底。
行动建议
第一步:去 Amazon Seller Central 随便挑 5 条最近的 Custom 订单,下载 customization ZIP,手工打开 JSON 看一遍——你会立刻明白为什么工厂要的不是这个结构。
第二步:照本文的「字段对应表」做一份你自己的版本——把你品类用到的字段填上去,没用到的删掉。一张 1 页纸的对应表是接下来所有工作的基础。
第三步:照「Excel 模板列名建议」给你每一家工厂出一份模板.xlsx,列名顺序按工厂偏好排——这是工厂愿不愿意配合你的关键。
第四步:每周复盘一次「导出后工厂回问的次数」——回问 = 字段没传清楚 = 模板要迭代。3 周后这个数字应该降到接近 0。