product-create

商品创建接口(terminus.wms.sku.create)

业务场景：

使用该接口可创建ShipperGrid供应商商品，支持批量及修改功能

系统入参：

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

业务入参：

参数名称	类型	是否必填	说明
skuCreateList	List	是	新增或修改sku数据集合

WmsSkuCreate

参数名称	类型	是否必填	说明
skuCode	String	是	SKU编码（外部,调用方传入 确保在该外部系统中唯一）如果skuCode在存在则更新
skuNameCN	String	是	sku中文名称
skuNameEn	String	是	sku英文名称
skuWeight	BigDecimal	是	sku重量 (单位：kg) 最多保留3位小数必填
skuLength	BigDecimal	是	sku长度(单位：cm) 最多两位小数必填
skuWidth	BigDecimal	是	sku宽度(单位：cm)最多两位小数 必填
skuHeight	BigDecimal	是	sku高度(单位：cm) 最多两位小数必填
skuAmt	BigDecimal	是	商品金额 （保留2为小数，单位：美元）
catIdLevel3	Long	否	平台类目ID(叶子节点)
isAutoSubmitAudit	Boolean	否	是否自动提交审核 默认否
skuDeclaredNameCn	String	否	中文申报品名 必填
skuDeclaredNameEn	String	否	英文申报名称 必填
imageLink	List	是	商品图片集合 最多10张 至少上传一张 第一张为主图
saleAttr	String	是	规格，例如：XXL,RED
remark	String	否	备注

请求示例

 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);
        WmsSkuCreateRequest request = new WmsSkuCreateRequest();
        //必填字段
        request.setChannelCode(OpenChannel.SHIPPER_GRID);
        WmsSkuCreateRequest.WmsSkuCreate wmsSkuCreateRequest = new WmsSkuCreateRequest.WmsSkuCreate();
        //必填字段
        wmsSkuCreateRequest.setOptEnum(WmsSkuCreateRequest.OptEnum.CREATE);
        wmsSkuCreateRequest.setSkuCode("2504UN0017TEST001");
        wmsSkuCreateRequest.setSkuNameCN("电脑");
        wmsSkuCreateRequest.setSkuNameEn("computer");
        wmsSkuCreateRequest.setSkuWeight(new BigDecimal(1.0));
        wmsSkuCreateRequest.setSkuLength(new BigDecimal(70));
        wmsSkuCreateRequest.setSkuWidth(new BigDecimal(70));
        wmsSkuCreateRequest.setSkuHeight(new BigDecimal(70));
        wmsSkuCreateRequest.setGoodsProperty(WmsSkuCreateRequest.GoodsAttributeEnum.GENERAL_GOODS);
        wmsSkuCreateRequest.setImageLink(Collections.singletonList("https://mg-static.erda.cloud/trantor2/portal/millgrid/24afff29-7f58-4ffe-84dd-cc83fab38201/2c4783516d25aa7da5b3f3e8b7195e45.jpeg"));
        wmsSkuCreateRequest.setSaleAttr("XXL,M");
        //非必填字段
        wmsSkuCreateRequest.setSkuAmt(new BigDecimal("1.1"));
        wmsSkuCreateRequest.setSkuUnit("PCS");
        wmsSkuCreateRequest.setImageLink(Collections.singletonList("https://test.millgrid.cn/millgrid/product_main/1e06aead-d467-4f50-bfe8-e4c330ce18b7/2febbe9b-d6e7-442a-8592-d71c044488ba (1).jpg".replace(" ", "%20")));
        wmsSkuCreateRequest.setRemark("备注");
        wmsSkuCreateRequest.setIsAutoSubmitAudit(true);
        List<WmsSkuCreateRequest.WmsSkuCreate> skuCreateList = new LinkedList<>();
        skuCreateList.add(wmsSkuCreateRequest);
        request.setSkuCreateList(skuCreateList);
        WmsSkuCreateResponse channelResult = client.execute(request);
        System.out.println(JSON.toJSONString(channelResult));
    }

响应出参

参数名称	类型	是否必填	说明
successItemList	List	否	调用成功数据集合
errorItemList	List	否	调用失败数据集合

成功响应示例

{
    "code": 200,
    "errorSkuList": [
        {
            "errorMsg": "sku规格必填",
            "skuCode": "2504UN0017TEST001"
        }
    ],
      "successSkuList": [
        {
            "skuCode": "2504UN0017TEST001"
        }
    ],
    "headerContent": {
        "traceId": "2025-05-07-17-08-06-92000000-586394ef-9c33-43db-8e72-765a2141bbf0",
        "sign": "4155d88d0a692911c5da092f1bfc35bcc33dff8fd1037c83a014905ac03190db",
        "methodName": "terminus.wms.sku.create",
        "appKey": "28cd819d0305402bb02e7d01091160c8",
        "Accept-Language": "zh_CN",
        "version": "1.0.0",
        "channelCode": "SHIPPER_GRID",
        "timestamp": "1746608886119"
    },
    "message": "success",
    "requestId": "2025-05-07-17-08-06-92000000-586394ef-9c33-43db-8e72-765a2141bbf0",
    "requestUrl": "https://channelhub-uat.shippergrid.com/terminus/channelhub/api",
    "success": true,
    "successSkuList": []
}

异常响应示例

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