# 获取库存流水

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

接口英文名：getstockflow

通过该接口可以获取视频号小店的商品库存流水

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/product/stock/getflow?access_token=ACCESS_TOKEN

# 云调用

本接口不支持云调用。

# 第三方调用

本接口支持第三方平台代微信小店商家调用。第三方服务商调用模式介绍
该接口所属的权限集 id 为：129、192
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代微信小店商家进行调用，具体可查看第三方调用说明文档。

# 2. 请求参数

# 查询参数 `Query String Parameters`

参数名	类型	必填	示例	说明
access_token	string	是	ACCESS_TOKEN	接口调用凭证，可使用 access_token（微信小店商家）、authorizer_access_token（服务商代调用）

# 请求体 `Request Payload`

参数名	类型	必填	说明	枚举
product_id	number	是	内部商品 ID	-
sku_id	number	是	内部 sku_id	-
stock_type	number	是	库存类型	枚举值
finder_id	string	否	达人的视频号 finder_id ，若 StockType 为 1 则必填	-
begin_time	number	是	时间范围开始时间戳，秒级	-
end_time	number	是	时间范围结束时间戳，秒级	-
op_type_list	numarray	否	库存事件类型	枚举值
page_size	number	是	每页数量	-
next_key	string	否	由上次请求返回，记录翻页的上下文。传入时会从上次返回的结果往后翻一页，不传默认获取第一页数据	-
stock_type_id	string	否	库存类型 id ，若 StockType 不为 0 且不为 1 则必填	-

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	说明
errcode	number	错误码
errmsg	string	错误信息
data	object	data

# Res.data `Object Payload`

data

参数名	类型	说明
next_key	string	本次翻页的上下文，用于请求下一页
stock_flow_info_list	objarray	库存流水

# Res.data.stock_flow_info_list(Array) `Object Payload`

库存流水

参数名	类型	说明	枚举
amount	number	操作数量	-
beginning_amount	number	开始数量	-
ending_amount	number	结束数量	-
stock_sub_type	number	本次开始结束数量的库存子类型	枚举值
op_type	number	库存事件类型	枚举值
update_time	number	流水发生时间，秒级时间戳	-
ext_info	object	额外信息	-

# Res.data.stock_flow_info_list(Array).ext_info `Object Payload`

额外信息

参数名	类型	说明
unmove_from_stock_sub_type	number	归还的源库存子类型，枚举值参考下文，该字段仅对仅对 op_type=7 生效
move_to_stock_sub_type	number	分配的目标库存子类型，枚举值参考下文，该字段仅对仅对 op_type=6 生效
upload_source	number	操作来源，该字段仅对 op_type=1/2/3 生效。2=API（开发者调用），3=API（服务商代调用），5=手机端，6=web端
order_id	number	订单 id ，该字段仅对 op_type=4/5 生效
out_warehouse_id	string	区域仓库 id ，该字段仅对 stock_sub_type=3 生效
limited_discount_id	number	限时抢购任务 id ，该字段仅对 stock_sub_type=2 生效
finder_id	string	达人的视频号 finder_id ，该字段仅对 move_to_stock_sub_type=4 和 unmove_from_stock_sub_type=4 生效

# 4. 枚举信息

# Body.stock_type `Enum`

库存类型

枚举值	描述
0	普通/通用库存
1	达人专属计划营销库存
2	B2C活动
3	同城配送门店库存
4	活动库存
5	限时抢购2.0库存

# Body.op_type_list `Enum`

库存事件类型

枚举值	描述
1	设置库存
2	增加库存
3	减少库存
4	下单扣除库存
5	取消订单释放库存
6	分配库存
7	归还库存
8	售后换货扣除库存
9	售后换货取消释放库存

# Res.data.stock_flow_info_list(Array).stock_sub_type `Enum`

本次开始结束数量的库存子类型

枚举值	描述
1	普通/通用库存
2	限时抢购库存
3	自营区域库存
4	达人专属计划营销库存
5	直播预热专属库存
6	赠品库存
7	B2C活动库存
8	活动库存
9	限时抢购2.0库存
10	不可售库存
11	直播预热专属库存2.0
12	商家自定义活动

# Res.data.stock_flow_info_list(Array).op_type `Enum`

库存事件类型

枚举值	描述
0	设置库存
2	增加库存
3	减少库存
4	下单扣除库存
5	取消订单释放库存
6	分配库存
7	归还库存
8	售后换货扣除库存
9	售后换货取消释放库存
10	系统转移

# 5. 注意事项

最多可以查今天往前 180 天内的数据。
库存回滚目前只会发生在以下场景：

下单后支付前取消订单
礼物单送出后未收下退款
售后换货取消

# 6. 代码示例

请求示例

{
	"product_id":"10000000000001",
	"sku_id":"1000000001",
	"stock_type": 0,
	"begin_time": 1689218360,
	"end_time": 1689736760,
	"page_size": 10
}

返回示例

{
	"errcode": 0,
	"errmsg": "ok",
	"data": {
		"stock_flow_info_list": [{
			"amount": 300,
			"beginning_amount": 842,
			"ending_amount": 542,
			"stock_sub_type": 1,
			"op_type": 6,
			"update_time": 1689735682,
			"ext_info": {
				"move_to_stock_sub_type": 4,
				"upload_source": 0,
				"order_id":"3700000000000000001",
				"out_warehouse_id": "",
				"limited_discount_id": "0",
				"finder_id": "sphn9rhffKDiLAf"
			}
		}, {
			"amount": 1,
			"beginning_amount": 843,
			"ending_amount": 842,
			"stock_sub_type": 1,
			"op_type": 4,
			"update_time": 1689520907,
			"ext_info": {
				"upload_source": 0,
				"order_id": "3712984209868589056",
				"out_warehouse_id": "",
				"limited_discount_id": "0"
			}
		}],
		"next_key": ""
	}
}

# 7. 错误码

以下是本接口的错误码列表，其他错误码可参考通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具辅助定位和分析问题。

错误码	错误描述
10020052	商品不存在

# 8. 适用范围

本接口在不同账号类型下的可调用情况：

微信小店	小店供货商
✔	✔

✔：该账号可调用此接口。
其他未明确声明的账号类型，如无特殊说明，均不可调用此接口。

接口变更日志（3条）

2026 年 07 月 10 日

op_type 字段新增「直播预热专属库存2.0」「商家自定义活动」等2个枚举选项

2026 年 04 月 08 日

更新 finder_id 字段描述，新增 stock_type_id 字段

2026 年 01 月 07 日

stock_type 、 stock_sub_type 字段枚举值描述更新， op_type 字段新增「售后换货扣除库存」「售后换货取消释放库存」等 2 个枚举值

# 获取库存流水

# 1. 调用方式

# HTTPS 调用

# 云调用

# 第三方调用

# 2. 请求参数

# 查询参数 Query String Parameters

# 请求体 Request Payload

# 3. 返回参数

# 返回体 Response Payload

# Res.data Object Payload

# Res.data.stock_flow_info_list(Array) Object Payload

# Res.data.stock_flow_info_list(Array).ext_info Object Payload