OPEN-API-客户对接【外】
  1. 库存
OPEN-API-客户对接【外】
  • 默认分组
    • 产品
      • sku批量分页查询
      • 创建/编辑产品 V2(字段覆盖完整)
      • 创建/编辑 产品
      • 创建产品识别码
      • 查询 sku
      • 渠道产品---渠道产品关系查询
    • 入库计划单
      • 入库计划创建修改(支持默认草稿状态可编辑)
      • 修改发运信息
      • 船公司代码列表
      • 入库计划分页查询
      • 入库计划创建
      • 入库计划发运操作
      • 入库计划添加附件
      • 取消入库订单
      • 查询入库信息
    • 库存
      • 批量查询库龄
        GET
      • 批量查询库存
        GET
      • 查询库存
        POST
      • winit快照查询
        POST
      • 查询库内变更明细
        POST
      • 库存批次明细查询
        POST
    • 订单
      • 测算
      • 创建销售订单(带附件的 )
      • 获取订单的详细信息
      • 获取订单的详细信息(获取店铺订单)
      • 订单-- 查询列表
      • 订单上传附件
      • 订单取消
    • 退货
      • 退货单物流追踪
      • 退货条目处理
      • 退货附件上传
      • 删除附件
      • 退货计划确认处理
      • 创建销售退货
      • 销售退货取消
      • 销售退货计划查询
    • 调拨
      • 创建
      • 取消(根据来源单号)
      • 上传附件
      • 查看
    • 预约
      • 查询是否可预约
    • 基础数据
      • 查询仓库
      • 根据仓库编码查询产品服务列表
    • 三方授权
      • 开发者账号注册
      • 应用注册
      • 服务商授权
    • 运费
      • 运费结算明细查询
    • 费用
      • 结算明细
  1. 库存

批量查询库存

GET
https://hwc-open-api.yqn.com/v2/inventory/get_inventory_by_page
inventory

请求参数

Query 参数
warehouseCodes
array[string]
仓库CODE列表
可选
示例值:
["code1,code2"]
inventoryType
integer 
可选
库存类型 0 可售库存 1 不可售库存
示例值:
0
page
string 
页码
可选
示例值:
1
rows
integer 
可选
页面大小(默认最高500)
示例值:
100
sidx
string 
可选
排序字段, 可写死 'id'
sort
string 
可选
排序规则 升序'asc' ,降序 'desc '
Header 参数
x-api-key
string 
必需
示例值:
abc123(认证信息)
Content-Type
string 
必需
示例值:
application/json
Body 参数application/json
object {0}
示例
{}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://hwc-open-api.yqn.com/v2/inventory/get_inventory_by_page?warehouseCodes=code1,code2&inventoryType=0&page=1&rows=100&sidx&sort' \
--header 'x-api-key: abc123(认证信息)' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功
application/json
Body
code
string 
必需
返回状态 200表示成功
message
string 
返回信息
必需
statusCode
string 
必需
status
string 
必需
data
object 
必需
pageable
object 
必需
totalElements
number 
必需
totalPages
number 
必需
last
boolean 
必需
first
boolean 
必需
sort
object 
必需
numberOfElements
number 
必需
size
number 
必需
number
number 
必需
empty
boolean 
必需
content
array [object {17}] 
多条库存的详情返回
必需
示例
{
  "statusCode": 200,
  "status": 0,
  "code": 200,
  "message": "获取库存数据成功",
  "data": {
    "pageable": {
      "draw": 0,
      "offset": 0,
      "pageNumber": 0,
      "pageSize": 5,
      "paged": true,
      "unpaged": false
    },
    "totalElements": 614,
    "totalPages": 123,
    "last": false,
    "first": true,
    "sort": {
      "sorted": true,
      "unsorted": false,
      "empty": false
    },
    "numberOfElements": 5,
    "size": 5,
    "number": 0,
    "empty": false,
    "content": [
      {
        "warehouse_code": "RF_NY_US",
        "product_line_name": "Demo",
        "sku": "test_AWS_04_sn",
        "inventory_type": 1,
        "inventory_available": 0,
        "inventory_reserved": 0,
        "inventory_transport": 0,
        "inventory_current": 0,
        "updated_at": "2025-05-13 15:15:47",
        "is_over_warehouse": 0,
        "parent_sku": "test_AWS_04_sn",
        "sale_type": 0,
        "standard_quantity": 1,
        "inventory_pcs_available": 0,
        "inventory_pcs_reserved": 0,
        "inventory_pcs_transport": 0,
        "inventory_pcs_current": 0
      },
      {
        "warehouse_code": "RF_NY_US",
        "product_line_name": "Demo",
        "sku": "test_0507_001",
        "inventory_type": 0,
        "inventory_available": 5,
        "inventory_reserved": 0,
        "inventory_transport": 0,
        "inventory_current": 5,
        "updated_at": "2025-05-09 03:22:39",
        "is_over_warehouse": 0,
        "parent_sku": "test_0507_001",
        "sale_type": 0,
        "standard_quantity": 1,
        "inventory_pcs_available": 5,
        "inventory_pcs_reserved": 0,
        "inventory_pcs_transport": 0,
        "inventory_pcs_current": 5
      },
      {
        "warehouse_code": "RF_NY_US",
        "product_line_name": "Demo",
        "sku": "t_web_04",
        "inventory_type": 0,
        "inventory_available": 8,
        "inventory_reserved": 0,
        "inventory_transport": 0,
        "inventory_current": 8,
        "updated_at": "2025-05-08 12:33:37",
        "is_over_warehouse": 0,
        "parent_sku": "t_web_04",
        "sale_type": 0,
        "standard_quantity": 1,
        "inventory_pcs_available": 8,
        "inventory_pcs_reserved": 0,
        "inventory_pcs_transport": 0,
        "inventory_pcs_current": 8
      },
      {
        "warehouse_code": "RF_NY_US",
        "product_line_name": "Demo",
        "sku": "t_web_03_3X",
        "inventory_type": 0,
        "inventory_available": 99,
        "inventory_reserved": 2,
        "inventory_transport": 0,
        "inventory_current": 101,
        "updated_at": "2025-05-09 03:22:39",
        "is_over_warehouse": 0,
        "parent_sku": "t_web_03",
        "sale_type": 2,
        "standard_quantity": 3,
        "inventory_pcs_available": 297,
        "inventory_pcs_reserved": 6,
        "inventory_pcs_transport": 0,
        "inventory_pcs_current": 303
      },
      {
        "warehouse_code": "RF_NY_US",
        "product_line_name": "Demo",
        "sku": "t_web_03_2X",
        "inventory_type": 0,
        "inventory_available": 98,
        "inventory_reserved": 2,
        "inventory_transport": 0,
        "inventory_current": 100,
        "updated_at": "2025-05-10 05:11:06",
        "is_over_warehouse": 0,
        "parent_sku": "t_web_03",
        "sale_type": 2,
        "standard_quantity": 2,
        "inventory_pcs_available": 196,
        "inventory_pcs_reserved": 4,
        "inventory_pcs_transport": 0,
        "inventory_pcs_current": 200
      }
    ]
  }
}
上一页
批量查询库龄
下一页
查询库存
Built with