API接口目录
suning.integrate.culitem.add 乐拼购产品申请(文化制品类)
¥免费

产品申请(文化制品类)新

公共参数
请求参数
名称 类型 是否必须 示例值 描述
afterSaleServiceDecStringY七天内包退换商品售后服务内容,最多可填写200个汉字或字符。
alertQtyStringN10商品库存预警值 ,范围:0-99999
assortCodeStringN11111店铺商品分类ID,可以通过 店铺-店铺分类查询接口查询,必须使用最底层的店铺分类ID
auditFlagStringNXX:表示审核。商品系统中已存在此商品,继续发布新商品,需要审核。
brandCodeStringY000C苏宁出版社编码。可由平台业务-商品服务-获取商品品牌信息(文化制品类)接口获得。注意区分大小写。
categoryCodeStringYR00001 苏宁采购目录编码。可由平台业务-商品服务-获取商品采购目录信息接口获得。需填写最底层采购目录编码。
cmTitleStringY111商品标题
detailModuleStringN
contentStringN模块化详情内容模块内容
moduleIdStringN123模块ID
moduleNameStringN模块名称模块名称
numStringN1序号
typeStringNcat_mod模块类型。cat_mod:表示运营配置; usr_mod:表示自定义
introductionStringN111商家商品介绍,UTF-8格式。将html内容的txt文本文件读取为字节数组,然后base64加密,去除空格回车后作为字段,传输时所涉及的图片不得使用外部url。允许写入CSS(禁止引用外部CSS)不支持JS。
invQtyStringN100商品库存。单位:件,范围:0-99999
itemCodeStringN12233供应商商品编码
parsStringN
parCodeStringN111申请参数编码,基本、动态参数编码。可由平台业务-商品服务-获取商品参数模板接口获得。若需填写多个参数,需同参数值一一对应,用循环节点形式展示。
parValueStringN1111.申请参数值。填写时需注意该参数是否含有单位。单选或多选类型参数值需填写对应的可选值编码。若需填写多个参数,需同参数编码一一对应,用循环节点形式展示。商品名称参数请按照:品牌+类目+型号组合命名。
priceStringY20.00商品价格。单位:元。精确到小数点后2位
productNameStringY平凡的世界商品名称,最多可填写60个字符。重码校验逻辑:期刊杂志类通过商品名称进行重码校验;中文图书、进口图书、音像制品通过ISBN号进行重码校验。
saleCatalogCodeStringN262676苏宁销售目录编码。可由平台业务-商品服务-获取商品销售目录信息(文化制品类)接口获得。需填写最底层销售目录
saleDateStringN2014-01-06商家设定的销售日期。仅在销售设定为0时展示。 格式YYYY-MM-DD
saleSetStringY0商家商品销售设定。1:立即;0:设定日期;2:放入仓库。1表示商品申请处理成功后,系统立即进行上架;0表示商品申请处理成功后,在设定的日期,系统自动上架;2表示商品申请处理成功后,商品状态为待售状态。商户可通过平台业务-商品服务-商品上架接口对待售状态的商品进行上架操作。
sellPointStringN好品质商品卖点,最多可填写60个字符。
supplierImgAUrlStringY11商家商品图片1地址url。规格限制:尺寸≥400*400,建议800*800,大小≤2M
supplierImgBUrlStringN11商家商品图片2地址url。规格限制:尺寸≥400*400,建议800*800,大小≤2M
supplierImgCUrlStringN11商家商品图片3地址url。规格限制:尺寸≥400*400,建议800*800,大小≤2M
supplierImgDUrlStringN111商家商品图片4地址url。规格限制:尺寸≥400*400,建议800*800,大小≤2M
supplierImgEUrlStringN111商家商品图片5地址url。规格限制:尺寸≥400*400,建议800*800,大小≤2M
pingouPriceStringY20.00拼购价
purchaseMinStringN5拼购最小起订量(1~99之间的一个数字)
peopleNumStringY2成团人数
purchaseMaxStringN10拼购最小起订量(1~99之间的一个数字)
响应参数
名称 类型 示例值 描述
applyCodeString111申请时产生的申请编号。如申请的商品还有规格,则只返回主商品的申请编号
applyTimeString111接口接收成功后系统时间
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <addCulitem>
      <sellPoint>好品质</sellPoint>
      <pars>
        <parValue>111</parValue>
        <parCode>111</parCode>
      </pars>
      <itemCode>12233</itemCode>
      <saleSet>0</saleSet>
      <assortCode>11111</assortCode>
      <saleDate>2014-01-06</saleDate>
      <supplierImgEUrl>111</supplierImgEUrl>
      <productName>平凡的世界</productName>
      <supplierImgAUrl>11</supplierImgAUrl>
      <saleCatalogCode>262676</saleCatalogCode>
      <supplierImgCUrl>11</supplierImgCUrl>
      <auditFlag>X</auditFlag>
      <cmTitle>111</cmTitle>
      <pingouPrice>20.00</pingouPrice>
      <price>20.00</price>
      <afterSaleServiceDec>七天内包退换</afterSaleServiceDec>
      <detailModule>
        <num>1</num>
        <moduleName>模块名称</moduleName>
        <moduleId>123</moduleId>
        <type>cat_mod</type>
        <content>模块化详情内容</content>
      </detailModule>
      <purchaseMax>10</purchaseMax>
      <introduction>111</introduction>
      <brandCode>000C</brandCode>
      <categoryCode>R00001</categoryCode>
      <peopleNum>2</peopleNum>
      <supplierImgDUrl>111</supplierImgDUrl>
      <purchaseMin>5</purchaseMin>
      <supplierImgBUrl>11</supplierImgBUrl>
      <alertQty>10</alertQty>
      <invQty>100</invQty>
    </addCulitem>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "addCulitem": {
        "sellPoint": "好品质",
        "pars": [
          {
            "parValue": "111",
            "parCode": "111"
          }
        ],
        "itemCode": "12233",
        "saleSet": "0",
        "assortCode": "11111",
        "saleDate": "2014-01-06",
        "supplierImgEUrl": "111",
        "productName": "平凡的世界",
        "supplierImgAUrl": "11",
        "saleCatalogCode": "262676",
        "supplierImgCUrl": "11",
        "auditFlag": "X",
        "cmTitle": "111",
        "pingouPrice": "20.00",
        "price": "20.00",
        "afterSaleServiceDec": "七天内包退换",
        "detailModule": [
          {
            "num": "1",
            "moduleName": "模块名称",
            "moduleId": "123",
            "type": "cat_mod",
            "content": "模块化详情内容"
          }
        ],
        "purchaseMax": "10",
        "introduction": "111",
        "brandCode": "000C",
        "categoryCode": "R00001",
        "peopleNum": "2",
        "supplierImgDUrl": "111",
        "purchaseMin": "5",
        "supplierImgBUrl": "11",
        "alertQty": "10",
        "invQty": "100"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <addCulitem>
      <applyCode>111</applyCode>
      <applyTime>111</applyTime>
    </addCulitem>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "addCulitem": {
        "applyCode": "111",
        "applyTime": "111"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.integrate.addculitem.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.integrate.addculitem.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.integrate.addculitem.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.mcmp 服务不可用 请联系苏宁技术人员
biz.custom.item.invalid-biz:pingou minimum Order Quantity Must Be Between 1-99! 乐拼购最小起订量必须在1~99之间 乐拼购最小起订量,输入1~99整数
biz.custom.item.invalid-biz:shelve-pass-limit 您上架的商品数量超过限制
biz.custom.item.invalid-biz:purchaseMax1 最大购买数量必须1-99的正整数 最大购买数量必须1-99的正整数
biz.custom.item.invalid-biz:purchaseMax2 最大购买数量需大于等于最小购买数量 最大购买数量需大于等于最小购买数量
biz.custom.item.invalid-biz:purchaseMax3 最大购买数量需为最小购买数量的整数倍 最大购买数量需为最小购买数量的整数倍
biz.custom.item.invalid-biz:purchaseMax4 最大购买数量不为空时,最小购买数量必填 填写最小购买数量
biz.custom.item.invalid-biz.check-hit:supplierImgAUrl 第1张主图图片被稽查命中
biz.custom.item.invalid-biz.check-hit:supplierImgBUrl 第2张主图图片被稽查命中
biz.custom.item.invalid-biz.check-hit:supplierImgCUrl 第3张主图图片被稽查命中
biz.custom.item.invalid-biz.check-hit:supplierImgDUrl 第4张主图图片被稽查命中
biz.custom.item.invalid-biz.check-hit:supplierImgEUrl 第5张主图图片被稽查命中
biz.custom.item.invalid-biz:categoryNotActive 您选择的商品类目“类目名称”,已被苏宁禁用 请更换或申请其他类目
biz.custom.item.invalid-biz:prohibition-publication 限制通过接口批量发布商品 请前往“客户服务--违规管理”查看详情原因,受限解除后可批量发布商品
公共异常码
API工具
FAQ