# 仓储库存调用接口流程指南
# 1、相关接口说明
# 1.1、接口调用流程
# 1.2、相关接口说明
| 接口名称 | 需求参数 | 功能说明 |
|---|---|---|
| 添加商品 addproduct | skus-stock_num（商品sku-库存）、skus-sku_deliver_info（sku库存信息） | 通用库存可通过添加商品时在stock_num参数中进行填写，在sku_deliver_info参数中对sku库存的信息进行填写（库存情况、发货节点等） |
| 创建区域仓库 createwarehouse | out_warehouse_id（外部仓库ID）、name（仓库名称）、intro（仓库介绍）、cover_locations（覆盖区域） | 通过该接口可创建区域仓库，获得out_warehouse_id用于在设置区域仓库优先级、更新库存数量接口中调用所需要调整的仓库id，其中覆盖区域address_id1为必填 |
| 查询区域仓库列表 getwarehouselist | page_size（每页数量）、next_key（记录翻页的上下文） | 通过该接口可对区域仓库列表进行查询，获得创建好的out_warehouse_id |
| 获取指定地址下区域仓库的优先级 getaddressprioritysort | address_id1（省份地址编码）、address_id2（市地址编码）、address_id3（区地址编码）、address_id4（街道地址编码） | 通过该接口可获取指定地址下区域仓库的优先级，会根据address_id并按照out_warehouse_id排序优先级从高到低 |
| 设置指定地址下区域仓库的优先级 setaddressprioritysort | address_id1（省份地址编码）、address_id2（市地址编码）、address_id3（区地址编码）、address_id4（街道地址编码）、priority_sort优先级模式 | 通过该接口对指定地址下区域仓库的优先级进行设置，会根据address_id并按照out_warehouse_id排序优先级从高到低 |
| 获取区域仓库存数量 getwarehousestock | product_id（商品ID）、sku_id（skuID）、out_warehouse_id（外部仓库ID） | 通过该接口可获取区域仓库存数量，可根据product_id、sku_id、out_warehouse_id查询当前商品sku下库存数量 |
| 更新区域仓库存数量 updatewarehousestock | product_id（商品ID）、sku_id（skuID）、out_warehouse_id（外部仓库ID）、diff_type（修改类型）、num（库存值） | 通过该接口区域仓库可对区域仓库存数量进行更新操作，根据out_warehouse_id查询到的库存进行1增加、2减少或3设置 |
# 2、商品仓储库存更新调用流程
# 2.1、接口调用流程图
# 2.2、相关接口说明
| 接口名称 | 需求参数 | 功能说明 |
|---|---|---|
| 批量获取库存信息 batchgetstock | product_id（商品ID） | 通过该接口可以根据商品ID获取当前商品下所有sku的库存，包括区域库存外部id以及库存数量 |
| 快速更新库存 （updatestock） | product_id（内部商品ID）、sku_id（内部sku_id）、diff_type（修改类型）、num（增加、减少或者设置的库存值） | 通过该接口快速更新微信小店商品下sku的库存量 |
| 更新区域仓库存数量 updatewarehousestock | product_id（商品ID）、sku_id（skuID）、out_warehouse_id（外部仓库ID）、diff_type（修改类型）、num（库存值） | 通过该接口区域仓库可对区域仓库存数量进行更新操作，根据out_warehouse_id查询到的库存进行1增加、2减少或3设置 |
| 查询区域仓库列表 getwarehouselist | page_size（每页数量）、next_key（记录翻页的上下文） | 通过该接口可对区域仓库列表进行查询，获得创建好的out_warehouse_id |
| 获取区域仓库 getwarehouse | out_warehouse_id（外部仓库ID） | 可通过该接口获取区域仓库信息，包括外部仓库ID、仓库名称、仓库介绍及覆盖区域 |
| 修改区域仓库详情 updatewarehousedetail | out_warehouse_id（外部仓库ID）、name（仓库名称）、intro（仓库介绍） | 可通过该接口对仓库名称和仓库介绍进行修改 |
| 批量增加覆盖区域 addcoverlocation） | out_warehouse_id（外部仓库ID）、cover_locations（覆盖区域） | 可通过该接口对区域仓库进行批量增加覆盖区域的操作 |
| 批量删除覆盖区域 delcoverlocations | out_warehouse_id（外部仓库ID）、cover_locations（覆盖区域） | 可通过该接口对区域仓库可进行批量删除覆盖区域操作 |
| 获取指定地址下区域仓库的优先级 getaddressprioritysort | address_id1（省份地址编码）、address_id2（市地址编码）、address_id3（区地址编码）、address_id4（街道地址编码） | 通过该接口可获取指定地址下区域仓库的优先级，会根据address_id并按照out_warehouse_id排序优先级从高到低 |
| 设置指定地址下区域仓库的优先级 setaddressprioritysort | address_id1（省份地址编码）、address_id2（市地址编码）、address_id3（区地址编码）、address_id4（街道地址编码）、priority_sort优先级模式 | 通过该接口对指定地址下区域仓库的优先级进行设置，会根据address_id并按照out_warehouse_id排序优先级从高到低 |
文档变更日志（1条）2025 年 12 月 04 日
新增 仓储库存调用接口流程指南