inventory-list

查询库存(terminus.wms.sku.inventory.get)

业务场景：

查询Shippergrid库存信息

系统入参：

参数名称	类型	是否必填	说明
channelCode	String	是	请传入固定参数【SHIPPER_GRID】，参考请求示例

业务入参

WmsSkuInventorySearchRequest

参数名称	类型	是否必填	说明
skuCode	String	否	三方sku编码精确查找。
skuCodes	List	否	三方sku编码精确查找，支持多个sku编码。最多不超过40个
warehouseCode	String	是	仓库编码。
pageNum	Integer	否	页码，默认值为1。
pageSize	Integer	否	页大小，默认返回所有。

请求示例

    public static void main(String[] args) {
        String appKey = "28cd819d0305402bb02e7d01091160c8";
        String secret = "xj1CnrTho1Bc1YSxaZa8ghdqRxwn079prFHqkjGXzdO64TQuy4aIzs06qv5htyXk";
        String url = "https://channelhub-uat.shippergrid.com/terminus/channelhub/api";
        ChannelClient client = new DefaultChannelClient( url, appKey, secret);
        //必填字段
        WmsSkuInventorySearchRequest wmsRequest = new WmsSkuInventorySearchRequest();
        wmsRequest.setChannelCode(OpenChannel.SHIPPER_GRID);
        wmsRequest.setPageNum(1);
        wmsRequest.setPageSize(10);
        wmsRequest.setSkuCode("2504UN0019");
        wmsRequest.setWarehouseCode("SH202408280003");
        WmsSkuInventorySearchResponse channelResult = client.execute(wmsRequest);
        System.out.println(JSON.toJSONString(channelResult));
    }

响应出参

WmsSkuInventorySearchResponse

参数名称	类型	是否必填	说明
totalCount	Integer	是	总数量，默认为 0。
hasNext	Boolean	是	是否有下一页。
skuInventoryList	List	否	商品库存数据列表。

---

SkuInventory

参数名称	类型	是否必填	说明
skuCode	String	是	SKU 编码。
skuName	String	否	商品名称。
warehouseCode	String	否	仓库编码。
warehouseName	String	否	仓库名称。
sellableQty	BigDecimal	否	可售数量。
shippedQty	BigDecimal	否	历史出库数量。
freezeQty	BigDecimal	否	冻结数量。

成功响应示例

{
    "code": 200,
    "hasNext": false,
    "message": "success",
    "requestId": "2025-02-19-17-09-39-536000000-61c7ae9e-0eaf-475a-85a4-17eea2a49457",
    "requestUrl": "https://channelhub-uat.shippergrid.com/terminus/channelhub/api",
    "skuInventoryList": [
        {
            "warehouseCode": "xxx",
            "skuCode": "xxx",
            "skuName": "xxx",
            "freezeQty": 15,
            "sellableQty": 5345,
            "shippedQty": 416,
            "warehouseName": "LinChen家庭仓"
        },
        {
            "freezeQty": 0,
            "sellableQty": 65,
            "shippedQty": 0,
            "warehouseName": "LinChen家庭仓"
        }
    ],
    "success": true,
    "totalCount": 2
}

异常响应示例

{"code":300,"hasNext":false,"headerContent":{"traceId":"2025-05-12-09-38-53-764000000-c6d53f5a-fc1a-4939-a77c-062770ffc775","sign":"901c6eaef528459858a8fc4bf458a22112cb518249b2d2069312c0a57eb6aa7c","methodName":"terminus.wms.sku.inventory.get","appKey":"28cd819d0305402bb02e7d01091160c8","Accept-Language":"zh_CN","version":"1.0.0","channelCode":"SHIPPER_GRID","timestamp":"1747013933791"},"message":"调用T-ERP异常：未获取到该sku库存信息","requestId":"2025-05-12-09-38-53-764000000-c6d53f5a-fc1a-4939-a77c-062770ffc775","requestUrl":"https://channelhub-uat.shippergrid.com/terminus/channelhub/api","success":false,"totalCount":0}