查询库存 - OPEN-API-客户对接【外】

请求参数

Header 参数

x-api-key

string

必需

示例值:

abc123(认证信息)

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

skus

array[string]

产品SKU信息

必需

示例

{
  "skus": [
    "string"
  ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://hwc-open-api.yqn.com/v1/inventory/getInventory' \
--header 'x-api-key: abc123(认证信息)' \
--header 'Content-Type: application/json' \
--data-raw '{
    "skus": [
        "string"
    ]
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

返回状态 200表示成功

message

string

返回信息

必需

data

array [object {17}]

返回数据

必需

warehouseCode

string

仓库CODE

可选

lineName

string

项目名称

可选

sku

string

产品SKU

可选

inventoryType

integer

可选

库存类型 0:可售库存 1:不可售库存

inventoryAvailable

integer

可用库存

可选

inventoryReserved

integer

预留库存

可选

inventoryTransport

string

在途库存

可选

inventoryCurrent

string

当前总库存

可选

updatedAt

string

最近更新时间

可选

isOverWarehouse

integer

是否越库0否 1是

可选

parentErpSku

string

父SKU

可选

saleType

integer

可选

销售类型（SKU形态）。0：单一产品；1：套装产品；2：箱产品；

standardQuantity

integer

箱套标准件数

可选

inventoryPcsCurrent

integer

箱套当前总库存

可选

inventoryPcsAvailable

integer

箱套可用库存

可选

inventoryPcsReserved

integer

箱套预留库存

可选

inventoryPcsTransport

integer

箱套在途库存

可选

示例

{
  "statusCode": 200,
  "status": 0,
  "code": 200,
  "message": "查询库存成功",
  "data": [
    {
      "warehouseCode": "COPE_CA_US",
      "lineName": "Default",
      "sku": "hp_sea3",
      "inventoryType": 0,
      "inventoryAvailable": 68,
      "inventoryReserved": 14,
      "inventoryTransport": 103,
      "inventoryCurrent": 82,
      "updatedAt": "2025-04-29 07:07:51",
      "isOverWarehouse": 0,
      "parentErpSku": "hp_sea3",
      "saleType": 0,
      "standardQuantity": 1,
      "inventoryPcsAvailable": 68,
      "inventoryPcsReserved": 14,
      "inventoryPcsTransport": 103,
      "inventoryPcsCurrent": 82
    },
    {
      "warehouseCode": "COPE_CA_US",
      "lineName": "Default",
      "sku": "hp_sea3",
      "inventoryType": 1,
      "inventoryAvailable": 0,
      "inventoryReserved": 0,
      "inventoryTransport": 0,
      "inventoryCurrent": 0,
      "updatedAt": "2025-04-25 09:01:38",
      "isOverWarehouse": 0,
      "parentErpSku": "hp_sea3",
      "saleType": 0,
      "standardQuantity": 1,
      "inventoryPcsAvailable": 0,
      "inventoryPcsReserved": 0,
      "inventoryPcsTransport": 0,
      "inventoryPcsCurrent": 0
    },
    {
      "warehouseCode": "RF_NY_US",
      "lineName": "Default",
      "sku": "hp_sea3",
      "inventoryType": 0,
      "inventoryAvailable": 0,
      "inventoryReserved": 0,
      "inventoryTransport": 4,
      "inventoryCurrent": 0,
      "updatedAt": "2025-04-27 07:24:45",
      "isOverWarehouse": 0,
      "parentErpSku": "hp_sea3",
      "saleType": 0,
      "standardQuantity": 1,
      "inventoryPcsAvailable": 0,
      "inventoryPcsReserved": 0,
      "inventoryPcsTransport": 4,
      "inventoryPcsCurrent": 0
    },
    {
      "warehouseCode": "COPE_CA_US",
      "lineName": "Default",
      "sku": "hp_sea3_2X",
      "inventoryType": 0,
      "inventoryAvailable": 86,
      "inventoryReserved": 16,
      "inventoryTransport": 100,
      "inventoryCurrent": 102,
      "updatedAt": "2025-05-13 09:24:44",
      "isOverWarehouse": 0,
      "parentErpSku": "hp_sea3",
      "saleType": 2,
      "standardQuantity": 2,
      "inventoryPcsAvailable": 172,
      "inventoryPcsReserved": 32,
      "inventoryPcsTransport": 200,
      "inventoryPcsCurrent": 204
    },
    {
      "warehouseCode": "RF_NY_US",
      "lineName": "Default",
      "sku": "hp_sea3_2X",
      "inventoryType": 0,
      "inventoryAvailable": 0,
      "inventoryReserved": 0,
      "inventoryTransport": 3,
      "inventoryCurrent": 0,
      "updatedAt": "2025-04-27 07:24:45",
      "isOverWarehouse": 0,
      "parentErpSku": "hp_sea3",
      "saleType": 2,
      "standardQuantity": 2,
      "inventoryPcsAvailable": 0,
      "inventoryPcsReserved": 0,
      "inventoryPcsTransport": 6,
      "inventoryPcsCurrent": 0
    },
    {
      "warehouseCode": "COPE_CA_US",
      "lineName": "Default",
      "sku": "hp_sea3_3X",
      "inventoryType": 0,
      "inventoryAvailable": 89,
      "inventoryReserved": 19,
      "inventoryTransport": 102,
      "inventoryCurrent": 108,
      "updatedAt": "2025-05-06 06:04:51",
      "isOverWarehouse": 0,
      "parentErpSku": "hp_sea3",
      "saleType": 2,
      "standardQuantity": 3,
      "inventoryPcsAvailable": 267,
      "inventoryPcsReserved": 57,
      "inventoryPcsTransport": 306,
      "inventoryPcsCurrent": 324
    },
    {
      "warehouseCode": "COPE_CA_US",
      "lineName": "Default",
      "sku": "hp_sea3_3X",
      "inventoryType": 1,
      "inventoryAvailable": 0,
      "inventoryReserved": 2,
      "inventoryTransport": 1,
      "inventoryCurrent": 2,
      "updatedAt": "2025-04-27 13:53:55",
      "isOverWarehouse": 0,
      "parentErpSku": "hp_sea3",
      "saleType": 2,
      "standardQuantity": 3,
      "inventoryPcsAvailable": 0,
      "inventoryPcsReserved": 6,
      "inventoryPcsTransport": 3,
      "inventoryPcsCurrent": 6
    },
    {
      "warehouseCode": "RF_NY_US",
      "lineName": "Default",
      "sku": "hp_sea3_3X",
      "inventoryType": 0,
      "inventoryAvailable": 0,
      "inventoryReserved": 0,
      "inventoryTransport": 2,
      "inventoryCurrent": 0,
      "updatedAt": "2025-04-27 07:24:45",
      "isOverWarehouse": 0,
      "parentErpSku": "hp_sea3",
      "saleType": 2,
      "standardQuantity": 3,
      "inventoryPcsAvailable": 0,
      "inventoryPcsReserved": 0,
      "inventoryPcsTransport": 6,
      "inventoryPcsCurrent": 0
    }
  ]
}