异步批量修改阶梯价格（新）

接口状态

已完成

接口URL

/seller_api.php/goods/batch_update_price_by_sku

环境	URL

请求方式

POST

Content-Type

application/x-www-form-urlencoded

详细说明

根据货号和仓库ID创建批量阶梯价更新任务，接口校验并持久化任务后立即返回 task_id。

• 单次最多1000条。
• 每个明细必须包含1至3个阶梯价。
• min_num 必须为正整数且不能重复，服务端按升序排列。
• price 必须大于0且最多两位小数。
• 仓库ID只用于定位规格，价格本身是规格维度，不支持同一规格的仓库独立价格。
• 商品主表价格最终按全部有效规格的最低价重算。

请求Body参数

参数名	示例值	参数类型	是否必填	参数描述
items	[{"sku":"00123","warehouse_id":12,"price_list":[{"min_num":1,"price":"10.50"},{"min_num":10,"price":"9.50"}]}]	string	否	价格明细JSON数组，最多1000条，每条最多3个阶梯价

认证方式 请求Header参数

参数名	示例值	参数类型	是否必填	参数描述
token	your_access_token	String	是	鉴权 token，通过 get_oauth_token 接口获取
appid	your_appid	String	是	分配的 appid

响应示例

• 任务创建成功或幂等返回已有任务 (200)

{
  "errcode": 0,
  "data": {
    "task_id": 12346,
    "status": "pending",
    "total": 1
  },
  "errmsg": ""
}

参数名	示例值	参数类型	参数描述
errcode	0	Integer	业务错误码，0 表示请求处理成功，非 0 表示请求失败
data	-	Object	任务数据
data.task_id	12345	Integer	异步任务的唯一标识整数ID，用于精准定位对应的处理任务
data.status	pending	String	任务的当前状态，可选枚举值为 pending（待处理）、processing（处理中）、completed（已完成）
data.total	2	Integer	表示与当前任务相关的总数量，例如任务涉及的总条目数、待处理总任务量等整数类型数值
errmsg	-	String	错误提示信息，请求成功时为空字符串，请求失败时返回对应错误的详细描述

失败响应

暂无数据