退出
热词搜索：
API接口目录

拼购业务

拼购商品API
异常码自查工具
suning.integrate.childitem.add LPG规格商品新增
￥免费

商户可通过此接口对主商品中增加全新子商品。
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抵扣金额
pingouPriceStringY2o拼购价。单位：元。精确到小数点后2位。如含有子商品，此字段无需填写。价格范围：￥0.01-9,999,999,999,999.99。拼购价必须小于售价。
响应参数
名称 类型 示例值 描述
applyCodeString100011850申请时产生的申请编号。返回对应子商品申请编号。
applyTimeString2015-12-23 15:18:32接口接收成功后系统时间
priceWarnFlagString11-存在价格预警 0-不存在价格预警
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
  <sn_body>
    <childItem>
      <barpic>http://1.jpg</barpic>
      <alertQty>10</alertQty>
      <parentProductCode>104000339</parentProductCode>
      <deductiblePriceChild>1</deductiblePriceChild>
      <invQty>1</invQty>
      <pingouPrice>2o</pingouPrice>
      <price>110.00</price>
      <supplierImg1Url>http://1.jpg</supplierImg1Url>
      <pars>
        <parValue>24码</parValue>
        <parCode>G00003</parCode>
      </pars>
      <itemCode>120120</itemCode>
      <barcode>1</barcode>
    </childItem>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "childItem": {
        "barpic": "http://1.jpg",
        "alertQty": "10",
        "parentProductCode": "104000339",
        "deductiblePriceChild": "1",
        "invQty": "1",
        "pingouPrice": "2o",
        "price": "110.00",
        "supplierImg1Url": "http://1.jpg",
        "pars": [
          {
            "parValue": "24码",
            "parCode": "G00003"
          }
        ],
        "itemCode": "120120",
        "barcode": "1"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
<sn_responseContent>
  <sn_body>
    <childItem>
      <priceWarnFlag>1</priceWarnFlag>
      <applyCode>100011850</applyCode>
      <applyTime>2015-12-23 15:18:32</applyTime>
    </childItem>
  </sn_body>
</sn_responseContent>

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

  
  	API异常码
  	异常码中文描述
  

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