1 对接商品

接口地址： /merchantapi/distribution/goods/dockgoods

请求方式： POST

请求参数：

参数名	类型	必填	说明
goods_id	int	是	要对接的商品ID
cate_id	int	否	对接到的分类ID（默认0，需后续编辑）
status	int	否	对接后的上架状态（默认0）
price	float	否	对接后的售价（默认使用成本价）
auto_create_category	int	否	自动创建同名分类：0=否，1=是（默认0）新增于 2025-12-20
auto_online_restock	int	否	补货自动上架：0=否，1=是（默认0）新增于 2025-12-20
auto_offline_price_up	int	否	涨价自动下架：0=否，1=是（默认0）新增于 2025-12-20

响应示例：

{
  "code": 1,
  "msg": "对接成功"
}

业务规则：

• 不能对接自己的商品
• 不能重复对接同一商品
• 对接价格不能低于成本价
• 对接后会创建商品副本和对接关系记录
• 快速对接时只需要传 goods_id，所以可以通过这种逻辑前端实现进行对本页商品进行批量对接（快速对接后 在我的代理商品中合理编辑后上架）。也可以详细的弹出窗口一个个对接即上架。
• 新增于 2025-12-20 当 auto_create_category=1 且 cate_id=0 时，会自动创建与商品同名的分类

---

2 一键克隆上级商品（异步任务模式）

更新于 2025-12-20：改为异步任务模式，支持同步源头分类

接口地址： /merchantapi/distribution/goods/cloneGoodsByParent

请求方式： POST

请求参数：

参数名	类型	必填	说明
parent_id	int	是	上级商家ID
cate_id	int	否	对接到的分类ID（sync_source_category=0时必填）
sync_source_category	int	否	同步源头分类：0=否，1=是（默认0）新增于 2025-12-20
status	int	否	对接后的上架状态（默认0）
price_type	int	否	价格类型：1=固定加价，2=百分比加价，3=原成本价（默认1）
add_price	float	否	加价金额/百分比（默认0）
auto_online_restock	int	否	补货自动上架：0=否，1=是（默认0）新增于 2025-12-20
auto_offline_price_up	int	否	涨价自动下架：0=否，1=是（默认0）新增于 2025-12-20

响应示例：

{
  "code": 1,
  "msg": "克隆任务已提交，请稍后查看进度"
}

业务规则：

• 不能克隆自己
• 检查是否在对接黑名单中
• 更新于 2025-12-20 改为异步任务模式，避免大量商品克隆时超时
• 更新于 2025-12-20 同一上级只能有一个正在进行的克隆任务
• 更新于 2025-12-20 支持同步源头分类（sync_source_category=1）

---

3 获取克隆任务进度

新增于 2025-12-20

接口地址： /merchantapi/distribution/goods/getCloneProgress

请求方式： POST

请求参数：

参数名	类型	必填	说明
parent_id	int	是	上级商家ID

响应示例：

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "status": "running",
    "total": 100,
    "success": 50,
    "fail": 2,
    "progress": 52
  }
}

状态说明：

• running: 任务进行中
• completed: 任务完成
• none: 无任务