异步批量修改库存（新）

接口状态

已完成

接口URL

/seller_api.php/goods/batch_update_stock_by_sku

环境	URL

请求方式

POST

Content-Type

application/x-www-form-urlencoded

接口说明

根据货号和仓库ID创建批量库存更新任务，接口校验并持久化任务后立即返回 task_id，实际更新由后台任务异步执行。

• 单次最多 1000 条。
• 同一请求内不允许重复 sku + warehouse_id。
• stock 必须是不小于 0 的整数，小数不会被截断而是直接报错。
• warehouse_id=0 仅适用于未启用多仓的商品；多仓商品必须传仓库ID。
• 每条明细独立执行，部分失败不影响其他明细。

请求Body参数

参数名	示例值	参数类型	是否必填	参数描述
items	[{"sku":"00123","warehouse_id":12,"stock":100},{"sku":"A002","warehouse_id":12,"stock":50}]	string	否	库存明细JSON数组，最多1000条。sku必须按字符串传递，以保留前导零

认证方式 请求Header参数

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

响应示例

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

{
	"errcode": 0,
	"data": {
		"task_id": 12345,
		"status": "pending",
		"total": 2
	},
	"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	错误提示信息，请求成功时为空字符串，请求失败时返回对应错误的详细描述

失败响应

暂无数据