跳到主要内容

查询入库单列表(terminus.wms.inbound.order.get)

业务场景：

查询Shippergrid入库单列表

系统入参：

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

业务入参

WmsInboundOrderListRequest

参数名称类型是否必填说明
thirdInboundOrderCodesList否三方入库单号列表。
updateAtStartLong否按更新时间查询范围的开始时间，毫秒级时间戳。
updateAtEndLong否按更新时间查询范围的结束时间，毫秒级时间戳。
updateAtStart和updateAtEnd同时存在有效
createAtStartLong否按创建时间查询范围的开始时间，毫秒级时间戳。
createAtEndLong否按创建时间查询范围的结束时间，毫秒级时间戳。
createAtStart和createAtEnd同时存在有效
statusString否状态，非必填，多个状态用英文逗号隔开。
pageNumInteger是页码，默认值为1。
pageSizeInteger是页大小，默认值为10。(不能超过50)

请求示例

  public static void main(String[] args) {
        String appKey = "xxx";
        String secret = "xxx";
        String url = "https://channelhub-uat.shippergrid.com/terminus/channelhub/api";
        String token = "xxx";
        ChannelClient client = new DefaultChannelClient( url, appKey, secret,token);
        //必填字段
        WmsInboundOrderListRequest wmsRequest = new WmsInboundOrderListRequest();
        wmsRequest.setChannelCode(OpenChannel.SHIPPER_GRID);
        wmsRequest.setPageNum(1);
        wmsRequest.setPageSize(1);
        WmsInboundOrderListResponse channelResult = client.execute(wmsRequest);
        System.out.println(JSON.toJSONString(channelResult));
    }

响应出参

WmsInboundOrderListResponse

参数名称类型是否必填说明
totalCountInteger否总数量，默认值为0。
hasNextboolean否是否有下一页，默认值为 false。
dataList否入库单列表数据。

DataList

参数名称类型是否必填说明
InboundOrderCodeString否入库单号。
warehouseCodeString否仓库编码。
warehouseNameString否仓库名称。
inboundStatusString否入库状态（DRAFT、AWAITING、SHELVED、CANCELED）。
trackingNumberString否跟踪号。
putAwayTimeLong否入库上架完成时间，毫秒级时间戳。
createTimeLong否创建时间，毫秒级时间戳。
updateTimeLong否更新时间，毫秒级时间戳。
detailsList否上架商品详情。
feeListList否费用信息列表。

ItemList

参数名称类型是否必填说明
boxNoString否箱号。
skuCodeString否SKU 编码。
skuNameCNString是SKU 中文名称。
skuNameEnString是SKU 英文名称。
countInteger否入库单 SKU 数量。
putawayCountInteger否上架数量。
receivedCountInteger否收货数量。
goodCountInteger否良品数量。
defectiveCountInteger否不良品数量。
referenceBoxNoString否箱唛号。
updateTimeLong否更新时间。
productLengthBigDecimal否产品长度，单位：cm。
productWidthBigDecimal否产品宽度，单位：cm。
productHeightBigDecimal否产品高度，单位：cm。
productWeightBigDecimal否产品重量，单位：kg。

Fee

参数名称类型是否必填说明
feeAmountBigDecimal是费用金额（高精度浮点型），示例：2.85。
currencyString否币种，示例：RMB。
serviceNameString否服务项名称。
descriptionString否服务说明。

成功响应示例

{
    "code": 200,
    "data": [
        {
            "details": [
                {
                    "boxNo": "1",
                    "count": 400,
                    "defectiveCount": 0,
                    "goodCount": 400,
                    "productHeight": 2.00,
                    "productLength": 10.00,
                    "productWeight": 200.00,
                    "productWidth": 2.00,
                    "putawayCount": 400,
                    "receivedCount": 400,
                    "referenceBoxNo": "X202501150003",
                    "skuCode": "2411DO0043",
                    "skuNameCN": "Crying plush toy mice 002",
                    "skuNameEn": "Crying plush toy mice 002_Black",
                    "updateTime": 1739414179000
                },
                {
                    "boxNo": "2",
                    "count": 400,
                    "defectiveCount": 0,
                    "goodCount": 0,
                    "productHeight": 2.00,
                    "productLength": 10.00,
                    "productWeight": 200.00,
                    "productWidth": 2.00,
                    "putawayCount": 0,
                    "receivedCount": 0,
                    "referenceBoxNo": "X202501150004",
                    "skuCode": "2411DO0043",
                    "skuNameCN": "Crying plush toy mice 002",
                    "skuNameEn": "Crying plush toy mice 002_Black",
                    "updateTime": 1736925613000
                }
            ],
            "feeList": [],
            "inboundOrderCode": "WR202501150000036",
            "inboundStatus": "SHELVED",
            "trackingNumber": "111",
            "updateTime": 1739414179000,
            "warehouseCode": "SH202408280001",
            "warehouseName": "Bing家庭仓"
        },
        {
            "details": [
                {
                    "boxNo": "1",
                    "count": 1000,
                    "defectiveCount": 0,
                    "goodCount": 1000,
                    "productHeight": 2.00,
                    "productLength": 10.00,
                    "productWeight": 200.00,
                    "productWidth": 2.00,
                    "putawayCount": 1000,
                    "receivedCount": 1000,
                    "referenceBoxNo": "XM0008765456767",
                    "skuCode": "2411DO0043",
                    "skuNameCN": "Crying plush toy mice 002",
                    "skuNameEn": "Crying plush toy mice 002_Black",
                    "updateTime": 1738896634000
                }
            ],
            "feeList": [],
            "inboundOrderCode": "WR202502070000001",
            "inboundStatus": "SHELVED",
            "trackingNumber": "908765456780998766",
            "updateTime": 1738896634000,
            "warehouseCode": "CODE2024122602492610001",
            "warehouseName": "LinChen家庭仓"
        },
        {
            "details": [
                {
                    "boxNo": "1",
                    "count": 300,
                    "defectiveCount": 0,
                    "goodCount": 0,
                    "productHeight": 2.00,
                    "productLength": 10.00,
                    "productWeight": 200.00,
                    "productWidth": 2.00,
                    "putawayCount": 0,
                    "receivedCount": 0,
                    "referenceBoxNo": "X202501160006",
                    "skuCode": "2411DO0043",
                    "skuNameCN": "Crying plush toy mice 002",
                    "skuNameEn": "Crying plush toy mice 002_Black",
                    "updateTime": 1737080226000
                }
            ],
            "feeList": [],
            "inboundOrderCode": "WR202501170000001",
            "inboundStatus": "AWAITING",
            "trackingNumber": "123",
            "updateTime": 1737080229000,
            "warehouseCode": "SH202408280001",
            "warehouseName": "Bing家庭仓"
        },
        {
            "details": [
                {
                    "boxNo": "1",
                    "count": 300,
                    "defectiveCount": 0,
                    "goodCount": 300,
                    "productHeight": 2.00,
                    "productLength": 10.00,
                    "productWeight": 200.00,
                    "productWidth": 2.00,
                    "putawayCount": 300,
                    "receivedCount": 300,
                    "referenceBoxNo": "X202501160012",
                    "skuCode": "2411DO0043",
                    "skuNameCN": "Crying plush toy mice 002",
                    "skuNameEn": "Crying plush toy mice 002_Black",
                    "updateTime": 1737032073000
                }
            ],
            "feeList": [],
            "inboundOrderCode": "WR202501160000012",
            "inboundStatus": "SHELVED",
            "updateTime": 1737032073000,
            "warehouseCode": "SH202408280001",
            "warehouseName": "Bing家庭仓"
        },
        {
            "details": [
                {
                    "boxNo": "1",
                    "count": 300,
                    "defectiveCount": 0,
                    "goodCount": 300,
                    "productHeight": 2.00,
                    "productLength": 10.00,
                    "productWeight": 200.00,
                    "productWidth": 2.00,
                    "putawayCount": 300,
                    "receivedCount": 300,
                    "referenceBoxNo": "X202501160011",
                    "skuCode": "2411DO0043",
                    "skuNameCN": "Crying plush toy mice 002",
                    "skuNameEn": "Crying plush toy mice 002_Black",
                    "updateTime": 1737030176000
                }
            ],
            "feeList": [],
            "inboundOrderCode": "WR202501160000011",
            "inboundStatus": "SHELVED",
            "updateTime": 1737030451000,
            "warehouseCode": "SH202408280001",
            "warehouseName": "Bing家庭仓"
        }
    ],
    "hasNext": true,
    "headerContent": {
        "traceId": "2025-02-20-16-41-37-240000000-90495ac0-5ff0-4163-bc82-dbc0ae5e11dc",
        "tenantId": "1",
        "sign": "cd30cbddd0080d5d5bbae800340285ab439c53c7528eadacd1b6d94489a6b3d9",
        "methodName": "terminus.wms.inbound.order.list",
        "appKey": "004d5865ecb848199ac5d792f88da96a",
        "Accept-Language": "zh_CN",
        "accessToken": "eyJhbGciOiJIUzUxMiJ9.eyJtZXJjaGFudElkIjoiQnV5ZXIwMDAxNzg3MyIsInNjb3BlIjoid21zLHRyYWNraW5nLHRva2VucyIsInN1YiI6IjAwNGQ1ODY1ZWNiODQ4MTk5YWM1ZDc5MmY4OGRhOTZhIiwiaWF0IjoxNzM5OTU2MDg0LCJleHAiOjE3NDc3MzIwODR9.OXUDNBAFWD8_W_9Z87pvAPo-_JA9IX6fD2uCXSnnLdXhVi4WZZ4kOTAx-8lQ8k4GjCW1KDZRho6C9VbDJr8OhA",
        "version": "1.0.0",
        "channelCode": "MILLGRID",
        "timestamp": "1740040897261"
    },
    "message": "success",
    "params": {
        "createAtEnd": "null",
        "updateAtEnd": "null",
        "pageSize": "5",
        "updateAtStart": "null",
        "pageNum": "1",
        "thirdInboundOrderCodes": "null",
        "createAtStart": "null",
        "status": "null"
    },
    "requestId": "2025-02-20-16-41-37-240000000-90495ac0-5ff0-4163-bc82-dbc0ae5e11dc",
    "requestUrl": "https://channelhub-uat.shippergrid.com/terminus/channelhub/api",
    "success": true,
    "totalCount": 38
}

异常响应示例

{
    "code":300,
    "data":null,
    "message":"系统异常",
    "success":false
}