一、业务背景
1688 作为国内 B2B 批发货源平台，和淘系 C 端商品接口有明显区别，核心多出起订量 MOQ、阶梯价、混批、代发、交货周期等批发专属字段。
跨境 ERP、无货源铺货、反向海淘选品系统，需要稳定拉取商品基础信息、SKU、阶梯拿货价、库存、发货、供应商信息，经过清洗、换算毛利、类目映射之后，同步到海外平台刊登。本文围绕跨境选品、ERP 同步两个场景，梳理入参、返回结构、字段取舍、工程落地要点。
二、返回结构分层解读（业务视角）
顶层返回对象为product，下面分为基础信息、图片、价格（阶梯价）、SKU、库存、批发规则、供应商、属性规格几大块。
2.1 商品基础信息（选品打分、标题翻译、刊登标题源）
{
"productId": "654321098765",
"title": "新款简约不锈钢水杯便携随行杯",
"moq": 2,
"canDropShip": true,
"sendGoodsCycle": "48小时内发货",
"categoryId": "123456"
}
moq：最小起订量，跨境毛利计算、刊登设置最小下单数量必备字段canDropShip：是否支持一件代发，反向海淘、无货源业务筛选核心标记sendGoodsCycle：供货交期，用于 ERP 预估发货时效、给海外买家展示备货周期categoryId：1688 内部类目 ID，需要维护类目映射表，转换为 Ozon、Temu 等海外平台类目
2.2 图片字段（铺货素材核心）
"mainImage": "https://cbu01.alicdn.com/xxx.jpg",
"images": [
{"url":"https://cbu01.alicdn.com/xxx1.jpg"},
{"url":"https://cbu01.alicdn.com/xxx2.jpg"}
]
重点踩坑：1688 图片存在防盗链，不能直接外链用于海外平台刊登。ERP 流程中必须异步下载、转存自有对象存储，再做白底处理、裁剪、多语种配图加工。
2.3 priceInfo 阶梯批发价（B2B 接口独有，跨境成本核算重中之重）
"priceInfo": {
"priceRanges": [
{"quantityStart": 2, "price": "12.50"},
{"quantityStart": 50, "price": "11.20"},
{"quantityStart": 200, "price": "9.80"}
]
}
- 含义：不同采购数量对应不同拿货单价
- ERP 业务处理：按采购阶梯分别核算成本、运费、平台佣金，自动计算多档毛利
- 坑点：部分商品只有一档价格，需要兼容单阶梯逻辑，避免数组越界
2.4 skuList SKU 规格列表（刊登最容易出错模块）
"skuList": [
{
"skuId": "123456",
"spec": "颜色:黑色;容量:500ml",
"skuPrice": "12.50",
"stock": "1200",
"outerSkuId": "BK-500"
}
]
spec：规格组合字符串，程序需要拆分键值对（颜色、容量等）skuPrice：该 SKU 对应价格，部分商品 SKU 价格和商品阶梯价互相独立，需要优先取 SKU 价格stock：实时库存，ERP 用来做库存同步、防止超卖outerSkuId：商家自定义编码，可作为我方系统内部关联编码
2.5 props 商品属性（报关、属性翻译、规格自动生成）
属性是 1688 内部标准属性，格式为属性ID:属性值
用途：
- 自动翻译生成海外平台规格参数
- 作为报关申报要素参考
- 选品筛选（材质、尺寸、适用人群等）
注意：1688 属性体系和海外电商平台不兼容，必须维护属性映射字典，不能直接原样上架。
2.6 supplierInfo 供应商信息
包含供应商名称、店铺 ID、是否实力商家、发货地址；
用于供应链评估、货源分级、运费预估、供应商台账管理。
