1. 简介

2. 库存模块API

2.1. 库存查询接口

按 SKU 列表查询汇总库存。

2.1.1. SERVICE_TYPE

GLINK_QUERY_INVENTORY_NOTIFY

2.1.2. 请求参数

库存查询请求

参数名 类型 列表 必填 备注
partnerId string N N 合作伙伴 ID
customerCode string N Y 货主编码
warehouseCode string N N 仓库编码
skus string Y Y SKU 编码列表，最多 200 个
allStockStatus boolean N N 是否查询所有货物状态；true：查询所有库存状态，false/不传：按默认库存状态口径查询

2.1.3. 请求样例

JSON

{
  "partnerId": "partnerId_example",
  "customerCode": "customerCode_dc6c0ddeec80",
  "warehouseCode": "warehouseCode_2f851a4e9e82",
  "skus": [
    "sku_2d8952660609"
  ],
  "allStockStatus": false
}

2.1.4. 响应参数

参数名 类型 列表 必填 备注
success boolean N Y 是否成功
code string N N 状态码，成功时为 SUCCESS，失败见错误码（如 INTERNAL_ERROR）
message string N N 提示信息
inventoryVOList object Y N 库存明细列表
└ customerCode string N N 货主编码
└ warehouseCode string N N 仓库编码
└ sku string N N SKU 编码
└ name string N N 商品名称
└ barcode string N N 条码
└ total int N N 库存总量
└ available int N N 可用量
└ allocated int N N 占用量
└ duePutawayQty int N N 待上架量（已收货未上架）
└ quarantined int N N 隔离量
└ holdQty int N N 冻结量
└ missingQty int N N 丢失/差异量（映射自库存差异 qty）
└ stockStatus string N N 货物状态；常见值 GOOD（良品）、DAMAGE（残品/破损）

2.1.5. 响应样例

JSON

{
  "success": true,
  "code": "SUCCESS",
  "message": null,
  "inventoryVOList": [
    {
      "customerCode": "customerCode_dc6c0ddeec80",
      "warehouseCode": "warehouseCode_2f851a4e9e82",
      "sku": "sku_2d8952660609",
      "name": null,
      "barcode": null,
      "total": 100,
      "available": 80,
      "allocated": null,
      "duePutawayQty": 5,
      "quarantined": 0,
      "holdQty": null,
      "missingQty": 0,
      "stockStatus": "GOOD"
    }
  ]
}

2.2. SKU状态库存查询接口

按货主、仓库查询 SKU 状态维度库存。

2.2.1. SERVICE_TYPE

GLINK_QUERY_INVENTORY_NEW_NOTIFY

2.2.2. 请求参数

SKU状态库存查询请求

参数名 类型 列表 必填 备注
partnerId string N N 合作伙伴 ID
customerCode string N Y 货主编码
warehouseCode string N Y 仓库编码
stockStatus string N N 商品（货物）状态过滤；常见值 GOOD（良品）、DAMAGE（残品/破损）
skus string Y N SKU 编码列表；与分页二选一：有列表时最多 200 个
page int N N 当 skus 为空时，须与 pageSize 同时传入且均不为 0，用于分页查询
pageSize int N N 同上
ignoreZero boolean N N 是否忽略 0 库存，默认 false

校验说明：skus 非空时按 SKU 列表查询（≤200）；若 skus 为空，则必须提供 page、pageSize 且二者均不为 0。

2.2.3. 请求样例

JSON

{
  "partnerId": "partnerId_example",
  "customerCode": "customerCode_dc6c0ddeec80",
  "warehouseCode": "warehouseCode_2f851a4e9e82",
  "stockStatus": "GOOD",
  "skus": [
    "sku_2d8952660609"
  ],
  "page": 1,
  "pageSize": 50,
  "ignoreZero": false
}

2.2.4. 响应参数

参数名 类型 列表 必填 备注
success boolean N Y 是否成功
code string N N 状态码
message string N N 提示信息，失败时可为错误拼接
inventoryVOList object Y N 明细列表
└ customerCode string N N 货主编码
└ warehouseCode string N N 仓库编码
└ sku string N N SKU 编码
└ skuDescription string N N 商品名称/描述
└ barcode string N N 条码（多个时可拼接）
└ skuStatus string N N 货物状态；常见值 GOOD（良品）、DAMAGE（残品/破损）
└ totalQty double N N 库存总量
└ occupiedQty double N N 占用量（含未分配订单等）
└ salableQty double N N 可销售量
└ duePutawayQty double N N 待上架量
└ unavailableQty double N N 不可用量（含特定库位冻结等，见业务口径）

2.2.5. 响应样例

JSON

{
  "success": true,
  "code": "SUCCESS",
  "message": null,
  "inventoryVOList": [
    {
      "customerCode": "customerCode_dc6c0ddeec80",
      "warehouseCode": "warehouseCode_2f851a4e9e82",
      "sku": "sku_2d8952660609",
      "skuDescription": "示例商品",
      "barcode": "6900000000000",
      "skuStatus": "GOOD",
      "totalQty": 100.0,
      "occupiedQty": 20.0,
      "salableQty": 80.0,
      "duePutawayQty": 5.0,
      "unavailableQty": 0.0
    }
  ]
}

2.3. 库位库存查询接口

按货主、仓库及库位/SKU 等条件分页查询库位级库存（对应 OMS queryLocationStockRemote）。

2.3.1. SERVICE_TYPE

GLINK_QUERY_LOCATION_STOCK_NOTIFY

2.3.2. 请求参数

库位库存查询请求

参数名 类型 列表 必填 备注
partnerId string N N 合作伙伴 ID
page int N N 页码，默认 1
pageSize int N N 每页条数，默认 100，最大 200
customerCode string N Y 货主编码
warehouseCode string N Y 仓库编码
allStockStatus boolean N N 是否查询所有货物状态库存；true：查询所有库存状态，false/不传：按默认库存状态口径查询
locations string Y N 库位编码列表
locationTypes string Y N 库位类型列表；常见值：STORAGE（存储库位）、PICKING（拣选库位）、RECEIPT（收货库位）、STAGING（暂存库位）、PACK（包装库位）等
zones string Y N 分区列表
skus string Y N SKU 列表
skuCategories string Y N SKU 品类列表
barCodes string Y N 条码列表

2.3.3. 请求样例

JSON

{
  "partnerId": "partnerId_example",
  "customerCode": "customerCode_dc6c0ddeec80",
  "warehouseCode": "warehouseCode_2f851a4e9e82",
  "allStockStatus": false,
  "locations": ["A010101"],
  "locationTypes": [],
  "zones": [],
  "skus": ["sku_2d8952660609"],
  "skuCategories": [],
  "barCodes": [],
  "page": 1,
  "pageSize": 100
}

2.3.4. 响应参数

参数名 类型 列表 必填 备注
success boolean N Y 是否成功
code string N N 状态码
message string N N 提示信息
total long N N 总记录数
resultList object Y N 当前页明细
└ warehouseCode string N N 仓库编码
└ customerCode string N N 货主编码
└ location string N N 库位编码
└ zone string N N 分区
└ locationType string N N 库位类型；常见值：STORAGE（存储库位）、PICKING（拣选库位）、RECEIPT（收货库位）、STAGING（暂存库位）、PACK（包装库位）等
└ sku string N N SKU 编码
└ skuCategory string N N SKU 品类
└ description string N N 商品描述
└ barCode string N N 条码
└ udf1 string N N 自定义字段 1
└ udf2 string N N 自定义字段 2
└ udf3 string N N 自定义字段 3
└ udf4 string N N 自定义字段 4
└ ownerCode string N N WMS 货主编码
└ ownerDescription string N N 货主描述
└ stockStatus string N N 货物状态；常见值 GOOD（良品）、DAMAGE（残品/破损）
└ qty double N N 库存数量
└ unit string N N 计量单位；常见值 EA（件），具体取值以仓库配置为准
└ altQty string N N 换算数量
└ altUnit string N N 换算单位；具体取值以仓库配置为准
└ availableQty double N N 可用数量
└ partnerId string N N 合作伙伴 ID

2.3.5. 响应样例

JSON

{
  "success": true,
  "code": "SUCCESS",
  "message": null,
  "total": 1,
  "resultList": [
    {
      "warehouseCode": "warehouseCode_2f851a4e9e82",
      "customerCode": "customerCode_dc6c0ddeec80",
      "location": "A010101",
      "zone": "ZONE01",
      "locationType": "PICKING",
      "sku": "sku_2d8952660609",
      "skuCategory": "CAT01",
      "description": "示例商品",
      "barCode": "6900000000000",
      "udf1": null,
      "udf2": null,
      "udf3": null,
      "udf4": null,
      "ownerCode": "OWNER01",
      "ownerDescription": "示例货主",
      "stockStatus": "GOOD",
      "qty": 50.0,
      "unit": "EA",
      "altQty": null,
      "altUnit": null,
      "availableQty": 45.0,
      "partnerId": "partnerId_example"
    }
  ]
}

2.4. 库存快照查询接口

按业务日期查询仓库库存快照（对应 OMS queryStockSnapRemote，响应 total + resultList）。

2.4.1. SERVICE_TYPE

GLINK_QUERY_STOCK_SNAP_NOTIFY

2.4.2. 请求参数

库存快照查询请求

page 默认 1，pageSize 默认 100，最大 200。

参数名 类型 列表 必填 备注
partnerId string N N 合作伙伴 ID
page int N N 页码，默认 1
pageSize int N N 每页条数，默认 100，最大 200
domainCode string N N 域编码；不传时使用货主关联域
customerCode string N Y 货主编码（模板货主）
whCode string N Y 仓库编码（与 OMS 字段名一致）
eventDate string N Y 业务日期，格式 yyyy-MM-dd
ifPutawayDate boolean N N 是否带上架日期维度

2.4.3. 请求样例

JSON

{
  "partnerId": "partnerId_example",
  "customerCode": "customerCode_dc6c0ddeec80",
  "domainCode": "",
  "whCode": "warehouseCode_2f851a4e9e82",
  "eventDate": "2025-08-21",
  "ifPutawayDate": false,
  "page": 1,
  "pageSize": 100
}

2.4.4. 响应参数

参数名 类型 列表 必填 备注
success boolean N Y 是否成功
code string N N 状态码
message string N N 提示信息
total int N N 总记录数
resultList object Y N 当前页明细
└ warehouseCode string N N 仓库编码
└ ownerCode string N N 货主编码
└ eventDate string N N 业务/事件日期
└ modifyDate string N N 修改时间
└ skuList object Y N SKU 维度明细
  └ skuCode string N N SKU 编码
  └ skuStatus string N N 货物状态；常见值 GOOD（良品）、DAMAGE（残品/破损）
  └ totalQty double N N 总量
  └ allocatedQty double N N 分配量
  └ pickedQty double N N 拣货量
  └ availableQty double N N 可用量
  └ onholdQty double N N 冻结量
  └ sourceDoc string N N 来源单证
  └ arrivalDate string N N 到货日期
  └ snapDate string N N 快照日期
  └ locationCode string N N 库位编码
  └ mfgDate string N N 生产日期
  └ expDate string N N 失效日期
  └ batchNo string N N 批次号
  └ originCountry string N N 原产国
  └ deltaQty double N N 数量变动
  └ deltaOnholdQty double N N 冻结量变动
  └ putawayDateList object Y N 上架日期列表
    └ putawayDate string N N 上架日期
    └ putawayQty double N N 上架数量

2.4.5. 响应样例

JSON

{
  "success": true,
  "code": "SUCCESS",
  "message": null,
  "total": 1,
  "resultList": [
    {
      "warehouseCode": "warehouseCode_2f851a4e9e82",
      "ownerCode": "OWNER01",
      "eventDate": "2025-08-21",
      "modifyDate": "2025-08-21 10:00:00",
      "skuList": [
        {
          "skuCode": "sku_001",
          "skuStatus": "GOOD",
          "totalQty": 10.0,
          "allocatedQty": 2.0,
          "pickedQty": 0.0,
          "availableQty": 8.0,
          "onholdQty": 0.0,
          "sourceDoc": null,
          "arrivalDate": null,
          "snapDate": "2025-08-21",
          "locationCode": "A010101",
          "mfgDate": null,
          "expDate": null,
          "batchNo": null,
          "originCountry": null,
          "deltaQty": null,
          "deltaOnholdQty": null,
          "putawayDateList": []
        }
      ]
    }
  ]
}

2.5. 库存日志查询接口

分页查询库存事务日志（对应 OMS queryStockLogRemote）。

2.5.1. SERVICE_TYPE

GLINK_QUERY_STOCK_LOG_NOTIFY

2.5.2. 请求参数

库存日志查询请求

参数名 类型 列表 必填 备注
partnerId string N N 合作伙伴 ID
page int N N 页码，默认 1
pageSize int N N 每页条数，默认 100，最大 200
customerCode string N Y 货主编码
warehouseCode string N Y 仓库编码
location string N N 库位
lpn string N N LPN
skus string Y N SKU 列表
documentNumbers string Y N 单据号列表，非空时最多 200 个
documentType string N N 单据类型；常见值：RECEIPT（入库单）、ORDER（出库单）、ADJUSTMENT（调整单）、MOV（移库单）等
createdTimeFrom string N 条件 创建时间起；与 createdTimeTo 成对出现
createdTimeTo string N 条件 创建时间止；与 createdTimeFrom 成对出现
operateType string N N 操作类型；常见值：RECEIVE（收货）、PUT_AWAY（上架）、MOVEMENT（移库）、ADJUSTMENT（调整）等
operator string N N 操作人

校验说明：documentNumbers 为空时，createdTimeFrom 与 createdTimeTo 均必填；否则报错（documentNumbers or createdTimeFrom and createdTimeTo are required）。

2.5.3. 请求样例

JSON

{
  "partnerId": "partnerId_example",
  "customerCode": "customerCode_dc6c0ddeec80",
  "warehouseCode": "warehouseCode_2f851a4e9e82",
  "location": null,
  "lpn": null,
  "skus": ["sku_001"],
  "documentNumbers": [],
  "documentType": null,
  "createdTimeFrom": "2025-08-01 00:00:00",
  "createdTimeTo": "2025-08-21 23:59:59",
  "operateType": null,
  "operator": null,
  "page": 1,
  "pageSize": 50
}

2.5.4. 响应参数

参数名 类型 列表 必填 备注
success boolean N Y 是否成功
code string N N 状态码
message string N N 提示信息
total int N N 总记录数
resultList object Y N 当前页明细
└ customerCode string N N 货主编码
└ warehouseCode string N N 仓库编码
└ documentNumber string N N 单据号
└ sku string N N SKU
└ udf1 string N N 自定义字段 1
└ udf2 string N N 自定义字段 2
└ udf3 string N N 自定义字段 3
└ udf4 string N N 自定义字段 4
└ customer string N N 客户/货主展示
└ location string N N 库位
└ lpn string N N LPN
└ documentType string N N 单据类型；RECEIPT（入库单）、ORDER（出库单）、ADJUSTMENT（调整单）、MOV（移库单）等
└ operateType string N N 操作类型；常见值 RECEIVE（收货）、PUT_AWAY（上架）、MOVEMENT（移库）、ADJUSTMENT（调整）等
└ operator string N N 操作人
└ qty double N N 数量
└ toQty double N N 变更后数量
└ netAdjustment double N N 净调整
└ availableQty double N N 可用数量
└ toAvailableQty double N N 变更后可用
└ allocatedQty double N N 分配数量
└ toAllocatedQty double N N 变更后分配
└ onHoldQty double N N 冻结数量
└ toOnHoldQty double N N 变更后冻结
└ pickedQty double N N 拣货数量
└ toPickedQty double N N 变更后拣货
└ moveoutQty double N N 移出数量
└ createdDate string N N 创建时间
└ taskNumber string N N 任务号
└ stockStatus string N N 货物状态；常见值 GOOD（良品）、DAMAGE（残品/破损）
└ batchNumber string N N 批次号
└ mfgDate string N N 生产日期
└ expDate string N N 失效日期
└ originCountry string N N 原产国
└ note string N N 备注
└ partnerId string N N 合作伙伴 ID

2.5.5. 响应样例

JSON

{
  "success": true,
  "code": "SUCCESS",
  "message": null,
  "total": 1,
  "resultList": [
    {
      "customerCode": "customerCode_dc6c0ddeec80",
      "warehouseCode": "warehouseCode_2f851a4e9e82",
      "documentNumber": "DOC001",
      "sku": "sku_001",
      "udf1": null,
      "udf2": null,
      "udf3": null,
      "udf4": null,
      "customer": null,
      "location": "A010101",
      "lpn": null,
      "documentType": "ADJUSTMENT",
      "operateType": "ADJUSTMENT",
      "operator": "user01",
      "qty": 10.0,
      "toQty": 12.0,
      "netAdjustment": 2.0,
      "availableQty": 8.0,
      "toAvailableQty": 10.0,
      "allocatedQty": 0.0,
      "toAllocatedQty": 0.0,
      "onHoldQty": 0.0,
      "toOnHoldQty": 0.0,
      "pickedQty": 0.0,
      "toPickedQty": 0.0,
      "moveoutQty": 0.0,
      "createdDate": "2025-08-21 10:00:00",
      "taskNumber": null,
      "stockStatus": "GOOD",
      "batchNumber": null,
      "mfgDate": null,
      "expDate": null,
      "originCountry": null,
      "note": null,
      "partnerId": "partnerId_example"
    }
  ]
}

2.6. 库存移动记录查询接口

按确认时间区间等事项查询库存移动/转移记录（对应 OMS queryStockMovementRemote）。请求字段名 confirmTimeForm 与代码一致（历史拼写，非 From）。

2.6.1. SERVICE_TYPE

GLINK_QUERY_STOCK_MOVEMENT_NOTIFY

2.6.2. 请求参数

库存移动查询请求

参数名 类型 列表 必填 备注
partnerId string N N 合作伙伴 ID
page int N N 页码，默认 1
pageSize int N N 每页条数，默认 100，最大 200
customerCode string N Y 货主编码
warehouseCode string N Y 仓库编码
sku string N N SKU
type string N N 移动类型；常见值：MOVELPN（按托盘移库）、MOVESKU（按SKU移库）、MOVELOC（按库位移库）
stockLocationFrom string N N 源库位
stockLocationTo string N N 目标库位
confirmTimeForm string N Y 确认时间起
confirmTimeTo string N Y 确认时间止

2.6.3. 请求样例

JSON

{
  "partnerId": "partnerId_example",
  "customerCode": "customerCode_dc6c0ddeec80",
  "warehouseCode": "warehouseCode_2f851a4e9e82",
  "sku": null,
  "type": null,
  "stockLocationFrom": null,
  "stockLocationTo": null,
  "confirmTimeForm": "2025-08-01 00:00:00",
  "confirmTimeTo": "2025-08-21 23:59:59",
  "page": 1,
  "pageSize": 50
}

2.6.4. 响应参数

参数名 类型 列表 必填 备注
success boolean N Y 是否成功
code string N N 状态码
message string N N 提示信息
total long N N 总记录数
transferInfoList object Y N 转移明细列表
└ sku string N N SKU
└ customerCode string N N 货主编码
└ quantity double N N 数量
└ type string N N 移动类型；常见值：MOVELPN（按托盘移库）、MOVESKU（按SKU移库）、MOVELOC（按库位移库）
└ stockLocationFrom string N N 源库位
└ stockAreaFrom string N N 源库区
└ stockLpnFrom string N N 源 LPN
└ stockLocationTo string N N 目标库位
└ stockAreaTo string N N 目标库区
└ stockLpnTo string N N 目标 LPN
└ status string N N 货物状态；常见值：GOOD（良品）、DAMAGE（残品/破损）
└ confirmTime string N N 确认时间

2.6.5. 响应样例

JSON

{
  "success": true,
  "code": "SUCCESS",
  "message": null,
  "total": 1,
  "transferInfoList": [
    {
      "sku": "sku_001",
      "customerCode": "customerCode_dc6c0ddeec80",
      "quantity": 5.0,
      "type": "MOVE",
      "stockLocationFrom": "A010101",
      "stockAreaFrom": null,
      "stockLpnFrom": null,
      "stockLocationTo": "A020202",
      "stockAreaTo": null,
      "stockLpnTo": null,
      "status": "CLOSED",
      "confirmTime": "2025-08-21 10:00:00"
    }
  ]
}

2.7. 库存调整单查询接口

按调整时间、状态等查询库存调整单（对应 OMS queryStockAdjustmentRemote）。开放 Xing 服务方法名为 searchStockAdjuestment（与代码拼写一致）。

2.7.1. SERVICE_TYPE

GLINK_QUERY_STOCK_ADJUSTMENT_NOTIFY

2.7.2. 请求参数

库存调整查询请求

必填时间：adjustTimeForm、adjustTimeTo，格式 yyyy-MM-dd HH:mm:ss。若填写 confirmTimeForm、confirmTimeTo（非空字符串），格式须同上。

参数名 类型 列表 必填 备注
partnerId string N N 合作伙伴 ID
page int N N 页码，默认 1
pageSize int N N 每页条数，默认 100，最大 200
customerCode string N Y 货主编码
warehouseCode string N Y 仓库编码
adjustNumbers string N N 调整单号/条件
sku string N N SKU
type string N N 调整单类型；常见值：CYCLE_COUNT（循环盘点）、VARIANCE_ADJUSTMENT（差异调整）、RECEIPT_ADJUSTMENT（入库调整）等
status string N N 调整单状态；常见值：NEW（新建）、CONFIRM（已确认）
adjustTimeForm string N Y 调整时间起
adjustTimeTo string N Y 调整时间止
confirmTimeForm string N N 确认时间起
confirmTimeTo string N N 确认时间止

2.7.3. 请求样例

JSON

{
  "partnerId": "partnerId_example",
  "customerCode": "customerCode_dc6c0ddeec80",
  "warehouseCode": "warehouseCode_2f851a4e9e82",
  "adjustNumbers": null,
  "sku": null,
  "type": null,
  "status": null,
  "adjustTimeForm": "2025-08-01 00:00:00",
  "adjustTimeTo": "2025-08-21 23:59:59",
  "confirmTimeForm": null,
  "confirmTimeTo": null,
  "page": 1,
  "pageSize": 50
}

2.7.4. 响应参数

参数名 类型 列表 必填 备注
success boolean N Y 是否成功
code string N N 状态码
message string N N 提示信息
total long N N 总记录数
adjustInfoList object Y N 调整单列表
└ adjustNumbers string N N 调整单号
└ customerCode string N N 货主编码
└ type string N N 调整单类型；常见值：CYCLE_COUNT（循环盘点）、VARIANCE_ADJUSTMENT（差异调整）、RECEIPT_ADJUSTMENT（入库调整）等
└ status string N N 调整单状态；常见值：NEW（新建）、CONFIRM（已确认）
└ adjustReason string N N 调整原因
└ adjustTime string N N 调整时间
└ confirmTime string N N 确认时间
└ remark string N N 备注
└ adjustLineItems object Y N 明细行
  └ sku string N N SKU
  └ quantity double N N 数量
  └ freezeQuantity double N N 冻结数量
  └ adjustQuantityType string N N 调整数量类型；常见值：ADJUST_AVAILABLE_QTY（调整可用库存）、ADJUST_HOLD_QTY（调整冻结库存）、ADJUST_QUARANTINE_QTY（调整隔离库存）
  └ adjustType string N N 明细调整操作类型；常见值：ADD（增加）、REDUCE（减少）、TOTAL（总量调整）
  └ adjustQuantity double N N 调整数量
  └ status string N N 明细货物状态；GOOD（良品）、DAMAGE（残品/破损）
  └ stockLocation string N N 库位
  └ stockArea string N N 库区
  └ stockLpn string N N LPN
└ refNumber string N N 参考号
└ partnerId string N N 合作伙伴 ID

2.7.5. 响应样例

JSON

{
  "success": true,
  "code": "SUCCESS",
  "message": null,
  "total": 1,
  "adjustInfoList": [
    {
      "adjustNumbers": "ADJ001",
      "customerCode": "customerCode_dc6c0ddeec80",
      "type": "COUNT",
      "status": "CLOSED",
      "adjustReason": "盘点",
      "adjustTime": "2025-08-21 09:00:00",
      "confirmTime": "2025-08-21 10:00:00",
      "remark": null,
      "refNumber": null,
      "partnerId": "partnerId_example",
      "adjustLineItems": [
        {
          "sku": "sku_001",
          "quantity": 10.0,
          "freezeQuantity": 0.0,
          "adjustQuantityType": null,
          "adjustType": null,
          "adjustQuantity": 2.0,
          "status": null,
          "stockLocation": "A010101",
          "stockArea": null,
          "stockLpn": null
        }
      ]
    }
  ]
}

2.8. 明细库存查询接口（WMS明细库存）

2.8.1. SERVICE_TYPE

GLINK_QUERY_STOCK_DETAIL_NOTIFY

2.8.2. 请求参数

明细库存查询请求

参数名 类型 列表 必填 备注
partnerId string N N 合作伙伴 ID（当前本地实现不参与查询条件）
customerCode string N Y 货主编码；不能为空，服务会据此查询域编码并获取WMS货主编码
warehouseCode string N Y 仓库编码；不能为空
sku string Y N SKU编码列表；最多100个；为空时按分页条件查询
page int N N 页码；未传时服务默认赋值为1
pageSize int N N 每页记录数；未传时服务默认赋值为100；最大200

2.8.3. 请求样例

JSON

{
  "partnerId": "partnerId_example",
  "customerCode": "CUSTOMER001",
  "warehouseCode": "WH001",
  "sku": [
    "SKU001"
  ],
  "page": 1,
  "pageSize": 100
}

2.8.4. 响应参数

参数名 类型 列表 必填 备注
success boolean N Y 操作的处理结果；成功查询时为true
code string N N 操作状态码；成功路径仅设置 success 与数据字段，失败时返回代码中设置的错误码或错误消息
message string N N 提示信息
total int N N 总记录数；取自WMS明细库存查询结果
resultList object Y N 当前页明细库存列表；无数据时当前代码不赋值，可能不返回该字段
└ sku string N N SKU编码
└ skuDescription string N N SKU名称
└ location string N N 库位
└ locationType string N N 库位类型；常见值：STORAGE（存储库位）、PICKING（拣选库位）、RECEIPT（收货库位）、STAGING（暂存库位）、PACK（包装库位）等
└ zone string N N 库区
└ lpn string N N LPN
└ owner string N N 货主
└ status string N N 货物状态；常见值 GOOD（良品）、DAMAGE（残品/破损）
└ qty int N N 数量
└ unit string N N 单位；常见值 EA（件），具体取值以仓库配置为准
└ altQty double N N 折算数量
└ altUnit string N N 折算单位；具体取值以仓库配置为准
└ allocatedQty int N N 已分配量；老文档说明库内待出库订单不会增加已分配量
└ pickedQty int N N 已拣货量
└ availableQty int N N 可用量；老文档说明库内待出库订单不会扣减可用量
└ onholdQty int N N 冻结量
└ moveoutQty int N N 移出量
└ arrivalDate string N N 到达日期（明细收货时间）
└ warehouseArrivalDate string N N 到达仓库日期
└ receiptDate string N N 入库单最后收货日期
└ putawayCompletedDate string N N 上架完成日期
└ asnNo string N N 收货单号
└ orderNo string N N 订单号
└ batchNo string N N 批次号
└ mfgDate string N N 生产日期
└ expDate string N N 到期日期
└ coo string N N 生产国家
└ category string N N 商品类别
└ brand string N N 品牌

2.8.5. 响应样例

JSON

{
  "success": true,
  "total": 1,
  "resultList": [
    {
      "sku": "SKU001",
      "skuDescription": "示例商品",
      "location": "A010101",
      "locationType": "PICKING",
      "zone": "ZONE01",
      "lpn": "LPN001",
      "owner": "OWNER001",
      "status": "GOOD",
      "qty": 100,
      "unit": "EA",
      "altQty": 100.0,
      "altUnit": "EA",
      "allocatedQty": 10,
      "pickedQty": 5,
      "availableQty": 85,
      "onholdQty": 0,
      "moveoutQty": 0,
      "arrivalDate": "2026-06-01 10:00:00",
      "warehouseArrivalDate": "2026-06-01 12:00:00",
      "receiptDate": "2026-06-02 09:00:00",
      "putawayCompletedDate": "2026-06-02 15:00:00",
      "asnNo": "ASN001",
      "orderNo": "ORDER001",
      "batchNo": "BATCH001",
      "mfgDate": "2026-01-01",
      "expDate": "2027-01-01",
      "coo": "CN",
      "category": "GENERAL",
      "brand": "BEST"
    }
  ]
}
© Copyright QianYi Team 2025 All Rights Reserved            Updated 2026-06-22 11:07:34

results matching ""

    No results matching ""