product-list

查询商品列表(terminus.wms.sku.search)

业务场景：

查询Shippergrid商品列表

系统入参：

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

业务入参：

参数名称	类型	是否必填	说明
pageNum	Integer	是	页码
pageSize	Integer	是	页大小
skuCode	String	否	sku编码查询
startTime	Long	否	更新开始时间毫秒级时间戳（用于增量轮询平台有更新的sku）
endTime	Long	否	更新结束时间毫秒级时间戳 startTime和endTime必须同时存在才有效

请求示例

    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);
        WmsSkuSearchRequest wmsSkuCreateRequest = new WmsSkuSearchRequest();
        wmsSkuCreateRequest.setChannelCode(OpenChannel.SHIPPER_GRID);
        wmsSkuCreateRequest.setPageNum(1);
        wmsSkuCreateRequest.setPageSize(10);
        WmsSkuSearchResponse channelResult = client.execute(wmsSkuCreateRequest);
        System.out.println(JSON.toJSONString(channelResult));

    }

成功响应示例

{
    "code": 200,
    "hasNext": false,
    "headerContent": {
        "traceId": "2024-06-13-20-11-06-483000000-3fef47c4-1a4e-40fb-a3c8-9d1b0940ba08",
        "tenantId": "1",
        "sign": "b8e101a9b34c056167e96fe2dc05dedb8f24670b69ebc3c8a0cac478deae6c22",
        "methodName": "terminus.wms.sku.search",
        "appKey": "A77378825A3547F9B68FC2840A8BC893",
        "appSecret": "89687EB619B64BCDA06BBEDAC63CBACC",
        "Accept-Language": "zh_CN",
        "version": "1.0.0",
        "channelCode": "GOODCANG",
        "timestamp": "1718280666499"
    },
    "items": [
        {
            "catIdLevel3": 601473,
            "catLang": "en",
            "goodsProperty": "GENERAL_GOODS",
            "goodsType": "PACKAGE",
            "imageLink": [
                "https://uat-oms.eminxing.com/api/v1/rfs/view?path=https%3A%2F%2Foms.goodcang.com%2F123456789&download=0"
            ],
            "itemBrand": "苹果笔记本",
            "remark": "备注",
            "returnAuth": false,
            "skuCode": "MILLGRID003",
            "skuDeclaredNameCn": "数据线",
            "skuHeight": 70,
            "skuLength": 70,
            "skuLink": "https://oms.goodcang.com/123456789",
            "skuModel": "无",
            "skuStatus": "DRAFT",
            "skuUnit": "个/只/件/支/枝/把",
            "skuWeight": 1000.5,
            "skuWidth": 70,
            "thirdSkuMapping": []
        }
    ],
    "message": "success",
    "params": {
        "pageSize": "10",
        "startTime": "null",
        "endTime": "null",
        "pageNum": "1",
        "skuCode": "millgrid003"
    },
    "platformList": [
        {
            "ptRequest": "{\"apiName\":\"/public_open/product/get_product_sku_list\",\"page\":1,\"pageSize\":10,\"productSku\":\"millgrid003\",\"responseClass\":\"com.goodcang.open.response.GoodCangSkuSearchResponse\"}",
            "ptRequestMethod": "/public_open/product/get_product_sku_list",
            "ptResponse": "{\"ask\":\"Success\",\"count\":1,\"data\":[{\"batchInfo\":{\"validityPeriodInfo\":{\"expirationEnabled\":false,\"inboundThreshold\":0,\"outboundThreshold\":0,\"shelfLifeDays\":0,\"warningDays\":0}},\"batteryInfo\":{},\"branded\":1,\"catIdLevel2\":601473,\"catLang\":\"en\",\"containBattery\":0,\"exportCountry\":[{\"countryCode\":\"CN\",\"declaredValue\":10}],\"imageLink\":[\"https://uat-oms.eminxing.com/api/v1/rfs/view?path=https%3A%2F%2Foms.goodcang.com%2F123456789&download=0\"],\"importCountry\":[{\"countryCode\":\"US\",\"declaredValue\":10}],\"productBrand\":\"苹果笔记本\",\"productDeclaredNameCn\":\"数据线\",\"productHeight\":70,\"productLength\":70,\"productLink\":\"https://oms.goodcang.com/123456789\",\"productModel\":\"无\",\"productSku\":\"MILLGRID003\",\"productStatus\":\"D\",\"productWeight\":1000.5,\"productWidth\":70,\"referenceNo\":\"\",\"remark\":\"备注\",\"returnAuth\":0,\"skuWrapperType\":1,\"thirdpartySkuMapping\":[],\"typeOfGoods\":0,\"unit\":\"个/只/件/支/枝/把\"}],\"message\":\"Success\",\"success\":true}"
        }
    ],
    "requestId": "2024-06-13-20-11-06-483000000-3fef47c4-1a4e-40fb-a3c8-9d1b0940ba08",
    "requestUrl": "http://channelhub-runtime-e121f79543.project-1424-dev.svc.cluster.local:8080/terminus/channelhub/api",
    "success": true,
    "totalCount": 1
}

返回参数说明

参数名	类型	说明
success	boolean	true为成功
message	string	提示信息
totalCount	Integer	数量
items	List	返回sku数据
hasNext	Boolean	是否存在下一页

ItemList

参数名称	类型	是否必填	说明
skuStatus	Enum	是	DRAFT(0, "草稿"), AUDITING(1, "审核中"), REJECT(2, "驳回"), ENABLE(3, "启用"), DISABLE(4, "禁用");
skuCode	String	是	sku编码
skuNameCN	String	是	sku中文名称
skuNameEn	String	是	sku英文名称
skuWeight	BigDecimal	是	sku重量 (单位：kg) 最多保留3位小数必填
skuLength	BigDecimal	是	sku长度(单位：cm) 最多两位小数必填
skuWidth	BigDecimal	是	sku宽度(单位：cm)最多两位小数必填
skuHeight	BigDecimal	是	sku高度(单位：cm) 最多两位小数必填
catIdLevel3	Long	是	平台类目id（3级）必填
isAutoSubmitAudit	Boolean	否	是否自动提交审核默认否
skuDeclaredNameCn	String	是	中文申报品名必填
remark	String	否	备注

异常响应示例

{
    "code":500,
    "message":"unknow error",
    "success":false
}

查询商品列表(terminus.wms.sku.search)​

查询商品列表(terminus.wms.sku.search)