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

特卖业务

特卖商品API
特卖交易API
特卖库存API
异常码自查工具
suning.saleoff.item.add 联营特卖发布新商品
￥免费

联营特卖发布新商品

公共参数
请求参数
名称 类型 是否必须 示例值 描述
barpicStringNhttp://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg条形码资质图
brandCodeStringYA101品牌编码
categoryCodeStringYR6101011类目编码
childItemStringN
barcodeStringN11子商品条形码
barpicXStringNhttp://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg条形码资质图
itemCodeXStringN子商品商家商品编码子商品商家商品编码
parsXStringN
parCodeXStringNG00001子商品特性参数代码
parValueXStringN红色子商品特性参数值
priceXStringN1.11子商品挂牌价
supplierImgAUrlStringNhttp://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg子商品商家商品图片
cmTitleStringY商品标题商品标题
detailModuleStringN
contentStringN模块化详情内容模块化详情内容
moduleIdStringNR2701001_1模块化ID
moduleNameStringN优惠信息模块化名称
numStringN1模块化顺序
typeStringNcat_mod模块化类型
introductionStringN电脑详情电脑详情
itemCodeStringN商家商品编码商家商品编码
ltpicStringYhttp://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg特卖列表图片
packingListStringN
packingListNameStringN电脑装箱清单名单
packingListQtyStringN1装箱清单名单数量
parsStringN
parCodeStringYcm_model参数编码，基本、动态参数代码
parValueStringN1参数值，基本、动态参数值。
priceStringN100.11挂牌价
productNameStringY商品名称商品名称
sellPointStringY卖点卖点
supplierImg1UrlStringYhttp://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg商家商品图片1
supplierImg2UrlStringYhttp://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg商家商品图片2
supplierImg3UrlStringNhttp://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg商家商品图片3
supplierImg4UrlStringYhttp://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg商家商品图片4
supplierImg5UrlStringYhttp://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg商家商品图片5
activityPicStringNhttp://1.jpg白底图图片地址
videoCodeStringN108625商品视频编码
mainPicVideoCodeStringN108625主图视频编码
响应参数
名称 类型 示例值 描述
applyCodeString1000000申请时产生的申请编号
applyTimeString2016-11-08 00:00:00接口接收成功后系统时间
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
  <sn_body>
    <addItem>
      <childItem>
        <barpicX>http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg</barpicX>
        <priceX>1.11</priceX>
        <itemCodeX>子商品商家商品编码</itemCodeX>
        <barcode>11</barcode>
        <supplierImgAUrl>http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg</supplierImgAUrl>
        <parsX>
          <parCodeX>G00001</parCodeX>
          <parValueX>红色</parValueX>
        </parsX>
      </childItem>
      <sellPoint>卖点</sellPoint>
      <videoCode>108625</videoCode>
      <pars>
        <parValue>1</parValue>
        <parCode>cm_model</parCode>
      </pars>
      <itemCode>商家商品编码</itemCode>
      <activityPic>http://1.jpg</activityPic>
      <ltpic>http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg</ltpic>
      <categoryCode>R6101011</categoryCode>
      <productName>商品名称</productName>
      <packingList>
        <packingListName>电脑</packingListName>
        <packingListQty>1</packingListQty>
      </packingList>
      <mainPicVideoCode>108625</mainPicVideoCode>
      <barpic>http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg</barpic>
      <supplierImg2Url>http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg</supplierImg2Url>
      <cmTitle>商品标题</cmTitle>
      <supplierImg5Url>http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg</supplierImg5Url>
      <price>100.11</price>
      <supplierImg1Url>http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg</supplierImg1Url>
      <supplierImg3Url>http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg</supplierImg3Url>
      <supplierImg4Url>http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg</supplierImg4Url>
      <detailModule>
        <num>1</num>
        <moduleName>优惠信息</moduleName>
        <moduleId>R2701001_1</moduleId>
        <type>cat_mod</type>
        <content>模块化详情内容</content>
      </detailModule>
      <introduction>电脑详情</introduction>
      <brandCode>A101</brandCode>
    </addItem>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "addItem": {
        "childItem": [
          {
            "barpicX": "http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg",
            "priceX": "1.11",
            "itemCodeX": "子商品商家商品编码",
            "barcode": "11",
            "supplierImgAUrl": "http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg",
            "parsX": [
              {
                "parCodeX": "G00001",
                "parValueX": "红色"
              }
            ]
          }
        ],
        "sellPoint": "卖点",
        "videoCode": "108625",
        "pars": [
          {
            "parValue": "1",
            "parCode": "cm_model"
          }
        ],
        "itemCode": "商家商品编码",
        "activityPic": "http://1.jpg",
        "ltpic": "http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg",
        "categoryCode": "R6101011",
        "productName": "商品名称",
        "packingList": [
          {
            "packingListName": "电脑",
            "packingListQty": "1"
          }
        ],
        "mainPicVideoCode": "108625",
        "barpic": "http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg",
        "supplierImg2Url": "http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg",
        "cmTitle": "商品标题",
        "supplierImg5Url": "http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg",
        "price": "100.11",
        "supplierImg1Url": "http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg",
        "supplierImg3Url": "http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg",
        "supplierImg4Url": "http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg",
        "detailModule": [
          {
            "num": "1",
            "moduleName": "优惠信息",
            "moduleId": "R2701001_1",
            "type": "cat_mod",
            "content": "模块化详情内容"
          }
        ],
        "introduction": "电脑详情",
        "brandCode": "A101"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
<sn_responseContent>
  <sn_body>
    <addItem>
      <applyCode>1000000</applyCode>
      <applyTime>2016-11-08 00:00:00</applyTime>
    </addItem>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "addItem": {
        "applyCode": "1000000",
        "applyTime": "2016-11-08 00:00:00"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.saleoff.additem.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.saleoff.additem.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.mcmp 服务不可用 请联系苏宁技术人员
biz.custom.item.invalid-biz:categoryNotActive 您选择的商品类目“类目名称”，已被苏宁禁用 请更换或申请其他类目
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ