返回API列表
异常码自查工具
suning.custom.childitem.add 规格商品新增

商户可通过此接口对主商品中增加全新子商品。
1、商户输入主商品编码、子商品基本信息、动态参数信息、价格、库存进行子商品新增的申请。
2、系统成功接收商品申请信息后,返回申请编号、接口接收成功系统时间。
3、子商品新增处理结果可通过获取我的商品库信息/我的商品库信息精确查询/获取我的商品详情信息接口进行查询。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
parentProductCodeStringY104000339苏宁商品编码。由平台业务-商品服务-获取我的商品库信息接口获取,仅可填写主商品编码。
itemCodeStringN120120商户子商品对应的商户商品编码。
barcodeStringN1子商品的国标码。
barpicStringNhttp://1.jpg条形码图片地址
invQtyStringN1子商品库存。单位:件。库存范围:0-99999(非海外购商户此字段必填)
alertQtyStringN10子商品的库存预警值。 范围:0-99999
priceStringN110.00子商品价格。单位:元。精确到小数点后2位。如无子商品,此字段无需填写。价格范围:¥0.01-9,999,999,999,999.99
supplierImg1UrlStringNhttp://1.jpg商家子商品图片地址url
parsStringN
parCodeStringNG00003子商品的参数代码,通用参数代码。可由平台业务-商品服务-获取商品参数模板接口获取。需同参数值一一对应,若需填写多个参数,用循环节点形式展示。
parValueStringN24码子商品的参数值,通用参数值。可由平台业务-商品服务-获取商品参数模板接口获得。需同参数代码一一对应,若需填写多个参数,用循环节点形式展示。如无子商品,则无需填写此字段。通用参数中,如需填写可自定义的尺码参数时,参数值必须带上单位,例如38码
deductiblePriceChildStringN1抵扣金额
响应参数
名称 类型 示例值 描述
applyCodeString100011850申请时产生的申请编号。返回对应子商品申请编号。
applyTimeString2015-12-23 15:18:32接口接收成功后系统时间
请求示例
  • XML示例
  • JSON示例
复制全部代码

<sn_request>
  <sn_body>
    <childItem>
      <barpic>http://1.jpg</barpic>
      <supplierImg1Url>http://1.jpg</supplierImg1Url>
      <price>110.00</price>
      <invQty>1</invQty>
      <deductiblePriceChild>1</deductiblePriceChild>
      <parentProductCode>104000339</parentProductCode>
      <barcode>1</barcode>
      <alertQty>10</alertQty>
      <pars>
        <parCode>G00003</parCode>
        <parValue>24码</parValue>
      </pars>
      <itemCode>120120</itemCode>
    </childItem>
  </sn_body>
</sn_request>

			
								

{
  "sn_request": {
    "sn_body": {
      "childItem": {
        "barpic": "http://1.jpg",
        "price": "110.00",
        "supplierImg1Url": "http://1.jpg",
        "invQty": "1",
        "deductiblePriceChild": "1",
        "parentProductCode": "104000339",
        "alertQty": "10",
        "barcode": "1",
        "pars": [
          {
            "parCode": "G00003",
            "parValue": "24码"
          }
        ],
        "itemCode": "120120"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码

<sn_responseContent>
  <sn_body>
    <childItem>
      <applyTime>2015-12-23 15:18:32</applyTime>
      <applyCode>100011850</applyCode>
    </childItem>
  </sn_body>
</sn_responseContent>

			
                                

{
  "sn_responseContent": {
    "sn_body": {
      "childItem": {
        "applyTime": "2015-12-23 15:18:32",
        "applyCode": "100011850"
      }
    }
  }
}
			
                                
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
} 								  
                           		
业务异常码
异常码 错误描述 解决方案
biz.custom.addchilditem.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.mcmp 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ

Q:Q、如何判断某个商品是否含有子商品?

A:A:若商品有多个尺码、多种颜色,则该商品含有子商品。例如iphone5s,有黑色、白色、金色,iphone5s为主商品,iphone5s(黑色)、iphone5s(白色)、iphone5s(金色)则分别为子商品。

Q:苏宁商品编码(productCode)、商家商品编码(itemCode)之间的关系和区别

A:1)苏宁商品编码(productCode)是商家在进行产品申请时,由苏宁系统生成的,商家商品编码(itemCode)是商户在产品申请、商品内容维护时,手工填写,并可进行修改; 2)苏宁商品编码(productCode)与商家商品编码(itemCode)一一对应,若商家申请的商品,无子商品,则一个商家商品编码(itemCode)对应一个苏宁商品编码(productCode);若商家申请的商品有子商品,则此商品本身对应一个苏宁主商品编码(productCode),每个子商品的商家商品编码(itemCode)一一对应一个苏宁子商品编码(productCode)。

Q:子商品新增要多久才会产生申请结果?

A:子商品新增一般24小时之内处理完毕。可通过平台业务-商品API-获取我的商品库信息查询结果。