# 获取库存流水
# 接口说明
通过该接口可以获取微信小店的商品库存流水
# 注意事项
最多可以查今天往前180天内的数据。
库存回滚目前只会发生在以下场景：
- 下单后支付前取消订单
- 礼物单送出后未收下退款
# 接口调用请求说明
POST https://api.weixin.qq.com/channels/ec/product/stock/getflow?access_token=ACCESS_TOKEN
# 请求参数说明
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| product_id | string(uint64) | 是 | 内部商品ID |
| sku_id | string(uint64) | 是 | 内部sku_id |
| stock_type | number | 是 | 库存类型，参考StockType枚举值 |
| finder_id | string | 否 | 达人的视频号finder_id，若StockType=1则必填 |
| begin_time | number | 是 | 时间范围开始时间戳，秒级 |
| end_time | number | 是 | 时间范围结束时间戳，秒级 |
| op_type_list | array[number] | 否 | 库存事件类型，参考StockFlowOpType枚举值，填空获取全部 |
| page_size | number | 是 | 每页数量 |
| next_key | string | 否 | 由上次请求返回，记录翻页的上下文。传入时会从上次返回的结果往后翻一页，不传默认获取第一页数据。 |
# 请求参数示例
{
"product_id": "10000032267694",
"sku_id": "1064839936",
"stock_type": 0,
"begin_time": 1689218360,
"end_time": 1689736760,
"page_size": 10
}
# 返回参数说明
| 参数 | 类型 | 描述 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| data.stock_flow_info_list[] | obj array | 库存流水 |
| data.stock_flow_info_list[].amount | number | 操作数量 |
| data.stock_flow_info_list[].beginning_amount | number | 开始数量 |
| data.stock_flow_info_list[].ending_amount | number | 结束数量 |
| data.stock_flow_info_list[].stock_sub_type | number | 本次开始结束数量的库存子类型，参考StockSubType枚举值 |
| data.stock_flow_info_list[].op_type | number | 库存事件类型，参考StockFlowOpType枚举值 |
| data.stock_flow_info_list[].update_time | number | 流水发生时间，秒级时间戳 |
| data.stock_flow_info_list[].ext_info | obj | 额外信息 |
| data.stock_flow_info_list[].ext_info.unmove_from_stock_sub_type | number | 归还的源库存子类型，参考StockSubType枚举值，该字段仅对仅对op_type=6生效 |
| data.stock_flow_info_list[].ext_info.move_to_stock_sub_type | number | 分配的目标库存子类型，参考StockSubType枚举值，该字段仅对仅对op_type=7生效 |
| data.stock_flow_info_list[].ext_info.upload_source | number | 操作来源，参考UploadSource枚举值，该字段仅对op_type=1/2/3生效 |
| data.stock_flow_info_list[].ext_info.order_id | string(uint64) | 订单id，该字段仅对op_type=4/5生效 |
| data.stock_flow_info_list[].ext_info.out_warehouse_id | string | 区域仓库id，该字段仅对stock_sub_type=3生效 |
| data.stock_flow_info_list[].ext_info.limited_discount_id | string(uint64) | 限时抢购任务id，该字段仅对stock_sub_type=2生效 |
| data.stock_flow_info_list[].ext_info.finder_id | string | 达人的视频号finder_id，该字段仅对move_to_stock_sub_type=4和unmove_from_stock_sub_type=4生效 |
| data.next_key | string | 本次翻页的上下文，用于请求下一页 |
# 返回参数示例
{
"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": "0",
"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": ""
}
}
# 错误码
| 错误码 | 错误描述 |
|---|---|
| 公共错误码 | - |
| 10020052 | 商品不存在 |
# 枚举值
# StockType
库存类型
| 枚举值 | 描述 |
|---|---|
| 0 | 自营库存 |
| 1 | 达人库存 |
# StockFlowOpType
库存事件类型
| 枚举值 | 描述 |
|---|---|
| 1 | 设置库存 |
| 2 | 增加库存 |
| 3 | 减少库存 |
| 4 | 下单扣除库存 |
| 5 | 取消订单释放库存 |
| 6 | 分配库存 |
| 7 | 归还库存 |
# StockSubType
库存子类型
| 枚举值 | 描述 |
|---|---|
| 1 | 自营通用库存 |
| 2 | 自营限时抢购库存 |
| 3 | 自营区域库存 |
| 4 | 达人专属库存 |
| 5 | 自营预热专属库存 |
| 6 | 自营赠品库存 |
# UploadSource
操作来源
| 枚举值 | 描述 |
|---|---|
| 2 | API（开发者调用） |
| 3 | API（服务商代调用） |
| 5 | 手机端 |
| 6 | web端 |