API接口目录

平台业务

商品API
价格API
库存API
销售准备API
交易API
退货退款API(新)
财务API
店铺API
物流API
促销API
分销API
发票API
招商API
换货API
互动营销API
退货退款API
客服API
平台营销API
风控API
会员通API
账房API
财务记账API
异常码自查工具
suning.custom.culitemcontents.modify 商品内容维护(文化制品类)新
¥免费

商品内容维护(文化制品类)新

公共参数
请求参数
名称 类型 是否必须 示例值 描述
afterSaleServiceDecStringY七天内包退换 商品售后服务内容。最多可填写254个字或字符。
alertQtyStringN5商品库存预警值。单位:件
assortCodeStringN11111111店铺商品分类ID, 可以通过 店铺-店铺分类查询接口查询,必须使用最底层的店铺分类ID
cmTitleStringY商品标题商品标题
detailModuleStringN
contentStringN模块化详情内容模块内容
moduleIdStringN123模块ID
moduleNameStringN模块名称模块名称
numStringN1序号
typeStringN模板类型模块类型。cat_mod:表示运营配置; usr_mod:表示自定义
freightTemplateIdStringY9787511002884商品运费模板编码。可由平台业务-销售准备-运费模板批量查询接口获取。需填写对应商家维护的运维模板id
introductionStringN单一详情单一详情
invQtyStringY10商品库存。单位:件
itemCodeStringY7775商家商品编码
priceStringY20.00商品价格。单位:元。精确到小数点后2位
productCodeStringY105560068苏宁商品编码。可由平台业务-商品服务-获取苏宁产品信息接口获取。
saleDateStringN2014-01-06商家设定的销售日期。必须为当天之后的日期!仅在销售设定为0时展示。 格式YYYY-MM-DD
saleSetStringY0 商家商品销售设定。1:立即;0:设定日期;2:放入仓库。1表示商品申请处理成功后,系统立即进行上架;0表示商品申请处理成功后,在设定的日期,系统自动上架;2表示商品申请处理成功后,商品状态为待售状态。商户可通过平台业务-商品服务-商品上架接口对待售状态的商品进行上架操作
sellPointStringN十万个为什么商品卖点。中文,最多可填写40个汉字。
supplierImgAUrlStringY商家商品图片1地址url商家商品图片1地址url
supplierImgBUrlStringN商家商品图片2地址url商家商品图片2地址url
supplierImgCUrlStringN商家商品图片3地址url商家商品图片3地址url
supplierImgDUrlStringN商家商品图片4地址url商家商品图片4地址url
supplierImgEUrlStringN商家商品图片5地址url商家商品图片5地址url
mainPicVideoCodeStringN主图视频编码主图视频编码
highlightWordoneStringN亮点词1亮点词1
highlightWordtwoStringN亮点词2亮点词2
highlightWordthreeStringN亮点词3亮点词3
响应参数
名称 类型 示例值 描述
applyCodeString100144950申请时产生的申请编号。如申请的商品还有规格,则只返回主商品的申请编号。
applyTimeString2015-01-24 16:41:19 接口接收成功后系统时间,精确到秒。
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <modifyCulitemcontents>
      <sellPoint>十万个为什么</sellPoint>
      <freightTemplateId>9787511002884</freightTemplateId>
      <itemCode>7775</itemCode>
      <saleSet>0</saleSet>
      <assortCode>11111111</assortCode>
      <saleDate>2014-01-06</saleDate>
      <supplierImgEUrl>商家商品图片5地址url</supplierImgEUrl>
      <supplierImgAUrl>商家商品图片1地址url</supplierImgAUrl>
      <supplierImgDUrl>商家商品图片4地址url</supplierImgDUrl>
      <mainPicVideoCode>主图视频编码</mainPicVideoCode>
      <supplierImgBUrl>商家商品图片2地址url</supplierImgBUrl>
      <supplierImgCUrl>商家商品图片3地址url</supplierImgCUrl>
      <alertQty>5</alertQty>
      <productCode>105560068</productCode>
      <cmTitle>商品标题</cmTitle>
      <invQty>10</invQty>
      <price>20.00</price>
      <afterSaleServiceDec>七天内包退换</afterSaleServiceDec>
      <highlightWordtwo>亮点词2</highlightWordtwo>
      <detailModule>
        <num>1</num>
        <moduleName>模块名称</moduleName>
        <moduleId>123</moduleId>
        <type>模板类型</type>
        <content>模块化详情内容</content>
      </detailModule>
      <highlightWordone>亮点词1</highlightWordone>
      <highlightWordthree>亮点词3</highlightWordthree>
      <introduction>单一详情</introduction>
    </modifyCulitemcontents>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "modifyCulitemcontents": {
        "sellPoint": "十万个为什么",
        "freightTemplateId": "9787511002884",
        "itemCode": "7775",
        "saleSet": "0",
        "assortCode": "11111111",
        "saleDate": "2014-01-06",
        "supplierImgEUrl": "商家商品图片5地址url",
        "supplierImgAUrl": "商家商品图片1地址url",
        "supplierImgDUrl": "商家商品图片4地址url",
        "mainPicVideoCode": "主图视频编码",
        "supplierImgBUrl": "商家商品图片2地址url",
        "supplierImgCUrl": "商家商品图片3地址url",
        "alertQty": "5",
        "productCode": "105560068",
        "cmTitle": "商品标题",
        "invQty": "10",
        "price": "20.00",
        "afterSaleServiceDec": "七天内包退换",
        "highlightWordtwo": "亮点词2",
        "detailModule": [
          {
            "num": "1",
            "moduleName": "模块名称",
            "moduleId": "123",
            "type": "模板类型",
            "content": "模块化详情内容"
          }
        ],
        "highlightWordone": "亮点词1",
        "highlightWordthree": "亮点词3",
        "introduction": "单一详情"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <modifyCulitemcontents>
      <applyCode>100144950</applyCode>
      <applyTime>2015-01-24 16:41:19</applyTime>
    </modifyCulitemcontents>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "modifyCulitemcontents": {
        "applyCode": "100144950",
        "applyTime": "2015-01-24 16:41:19"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.custom.modifyculitemcontents.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.custom.modifyculitemcontents.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.mcmp 服务不可用 请联系苏宁技术人员
biz.custom.modifyculitemcontents.invalid-biz:100 当前可申请商品数超出最大数量限制。num1代表该商家可申请的最大商品数(含子码商品),num2代表该商家当前已申请的商品数(含子码商品) 从回收站彻底删除,释放被占用的商品数量。
biz.custom.item.invalid-biz:shelve-pass-limit 您上架的商品数量超过限制
biz.custom.item.invalid-biz:prohibition-publication 限制通过接口批量发布商品 请前往“客户服务--违规管理”查看详情原因,受限解除后可批量发布商品
公共异常码
API工具
FAQ