返回API列表
异常码自查工具
suning.custom.item.add 产品申请

商户可通过此接口进行新品申请。
1、若商户销售的商品苏宁不存在,商户可以通过此接口申请新产品。
2、商户可输入基本信息、动态参数信息、商品介绍、卖点、售后服务、价格、库存、运费、销售设定等信息进行新品申请。
3、系统成功接收商品申请信息后,返回申请编号、接口接收成功系统时间。
4、商品处理结果可通过获取我的商品库信息/我的商品库信息精确查询/获取我的商品详情信息接口进行查询。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
categoryCodeStringYR6151001苏宁采购目录编码,需填写最底层采购目录编码。可由平台业务-商品服务-获取商品采购目录信息接口获得。
brandCodeStringYA101苏宁品牌编码,注意区分大小写。平台业务-商品服务-获取商品品牌信息接口获得。
productNameStringY商品名称商品名称,可填写中文。系统根据此字段进行重码校验,商品名称不得与苏宁现有的商品名称重复。
sellPointStringN商品卖点商品卖点。
freightTemplateIdStringN2da499d40cda4389817273ab0affdbed商品运费模板编码。可由平台业务-销售准备-运费模板批量查询接口获取。需填写对应商家维护的运维模板编码。每个主商品仅填写一个运费模板。
itemCodeStringN商家商品编码商家商品编码
priceStringY100主商品价格。单位:元。精确到小数点后2位。如含有子商品,此字段无需填写。价格范围:¥0.01-9,999,999,999,999.99
invQtyStringN100 主商品库存。单位:件。如含有子商品,此字段无需填写。库存范围:0-99999 (非海外购商户此字段必填)
alertQtyStringN100主商品库存预警值。如含有子商品,此字段无需填写,范围:0-99999。
introductionStringN5aW95ZWG5ZOB商家商品介绍,UTF-8格式。将html内容的txt文本文件读取为字节数组,然后base64加密,去除空格回车后作为字段,传输时所涉及的图片不得使用外部url。允许写入CSS(禁止引用外部CSS)不支持JS。
afterSaleServiceDecStringN7天内包退换商品售后服务内容。最多可填写200个汉字或字符。
saleSetStringY0商家商品销售设定。1:立即;0:设定日期;2:放入仓库。1表示商品申请处理成功后,系统立即进行上架;0表示商品申请处理成功后,在设定的日期,系统自动上架;2表示商品申请处理成功后,商品状态为待售状态。商户可通过平台业务-商品服务-商品上架接口对待售状态的商品进行上架操作。
saleDateStringN2013-09-15商家设定的销售日期。必须为当天之后的日期!仅在销售设定为0时展示。 格式YYYY-MM-DD
assortCodeStringN11111111店铺商品分类ID,可以通过 店铺-店铺分类查询接口查询,必须使用最底层的店铺分类ID
sourceCountryStringNCN来源地国家代码。国家代码(可去已有接口国家代码查询接口查询国家代码)
supplierImg1UrlStringNhttp://1.jpg...商家商品图片1
supplierImg2UrlStringYhttp://1.jpg...商家商品图片2
supplierImg3UrlStringYhttp://1.jpg...商家商品图片3
supplierImg4UrlStringYhttp://1.jpg...商家商品图片4
supplierImg5UrlStringYhttp://1.jpg...商家商品图片5
supplierImg6UrlStringNhttp://1.jpg...商家商品图片6
supplierImg7UrlStringNhttp://1.jpg...商家商品图片7
supplierImg8UrlStringNhttp://1.jpg...商家商品图片8
supplierImg9UrlStringNhttp://1.jpg...商家商品图片9
supplierImg10UrlStringNhttp://1.jpg...商家商品图片10
img1UrlStringN/商品图片(已作废)
img2UrlStringN/商品图片(已作废)
img3UrlStringN/商品图片(已作废)
img4UrlStringN/商品图片(已作废)
img5UrlStringN/商品图片(已作废)
parsStringN
parValueStringY1参数值。可由平台业务-商品服务-获取商品参数模板接口获得。填写时需注意该参数是否含有单位。单选或多选类型参数值需填写对应的可选值代码。若需填写多个参数,需同参数代码一一对应,用循环节点形式展示。
parCodeStringYG00001参数代码。item节点下填写基本、动态参数代码。childItem节点下填写通用参数。可由平台业务-商品服务-获取商品参数模板接口获得。若需填写多个参数,需同参数值一一对应,用循环节点形式展示。
barpicStringNhttp://1.jpg...条形码资质图图片地址
packingListStringN
packingListNameStringN装箱清单名称装箱清单名称
packingListQtyStringN1装箱清单数值
childItemStringN
itemCodeStringN222子商品商家商品编码
priceStringY100子商品价格
invQtyStringN222子商品库存
aleryQtyStringN222子商品库存预警值
supplierImg1UrlStringNhttp://1.jpg...子商品商家商品图片
parsStringN
parValueStringY1参数值。可由平台业务-商品服务-获取商品参数模板接口获得。填写时需注意该参数是否含有单位。单选或多选类型参数值需填写对应的可选值代码。若需填写多个参数,需同参数代码一一对应,用循环节点形式展示。
parCodeStringYG00001参数代码。item节点下填写基本、动态参数代码。childItem节点下填写通用参数。可由平台业务-商品服务-获取商品参数模板接口获得。若需填写多个参数,需同参数值一一对应,用循环节点形式展示。
barcodeStringN1子码条形码
barpicStringNhttp://1.jpg子码条形码资质图
deductiblePriceChildStringN1抵扣金额
detailModuleStringN
numStringN1模块化详情模块顺序
moduleIdStringN1模块化详情-模块ID
moduleNameStringN售后服务模块化详情模块名称
typeStringN usr_mod模块类型。cat_mod:表示运营配置; usr_mod:表示自定义
contentStringN5aW95ZWG5ZOB模块化详情-模块内容。内容需base64加密。
mobileNewStringN
moduleStringN
moduleStatusStringN1手机新版详情-模块启用标识。0禁用,1启用
couponIdStringN1优惠券id(通过查询接口可得)
tuijianIdStringN1商家推荐id(通过查询接口可得)
imgUrlStringNhttp://1.jpg商品图片模块、自定义模块图片地址(多张图片用;分隔)
moduleNameStringN售后服务手机新版详情模块名称
mobileStringN
summaryStringN1手机详情-摘要(已暂停使用,需要手机详情请填写新版手机详情)
listStringN
picStringNhttp://1.jpg手机详情-图片(已暂停使用,需要手机详情请填写新版手机详情)
textStringN1手机详情-文字(已暂停使用,需要手机详情请填写新版手机详情)
numStringN1手机详情模块顺序(已暂停使用,需要手机详情请填写新版手机详情)
cmTitleStringY商品标题商品标题
verticalPicStringNxx.jpg竖图
sellChannelStringN01销售渠道(01:线上;10:线下;11:线上线下)
priceTypeStringN01价格类型(01:一口价;02:O2O特权定金)
payTemplateStringN1分阶段支付模板
deductiblePriceStringN1抵扣金额
extractModeStringN01,10提取方式(01:快递上门;10:电子凭证)
effectiveDayStringN99有效期(0-999的整数)
bookingShopStringN0预约到店(0:不支持 1:支持)
writeoffPaymentStringN0核销打款(0:不支持 1:支持)
autoRefundStringN0过期自动退款(0:不支持 1:支持)
insaleRefundStringN0售中退款(0:不支持 1:支持)
writeoffShopStringN1核销门店组
videoCodeStringN108625商品视频编码
mainPicVideoCodeStringN108627主图视频编码
响应参数
名称 类型 示例值 描述
applyCodeString100011258申请编码。applyid
applyTimeString1990-07-16 00:00:00申请时间
请求示例
  • XML示例
  • JSON示例
复制全部代码

<sn_request>
  <sn_body>
    <item>
      <invQty>100</invQty>
      <supplierImg7Url>http://1.jpg...</supplierImg7Url>
      <videoCode>108625</videoCode>
      <detailModule>
        <content>5aW95ZWG5ZOB</content>
        <num>1</num>
        <moduleId>1</moduleId>
        <moduleName>售后服务</moduleName>
        <type> usr_mod</type>
      </detailModule>
      <packingList>
        <packingListQty>1</packingListQty>
        <packingListName>装箱清单名称</packingListName>
      </packingList>
      <writeoffPayment>0</writeoffPayment>
      <payTemplate>1</payTemplate>
      <itemCode>商家商品编码</itemCode>
      <img3Url>/</img3Url>
      <autoRefund>0</autoRefund>
      <deductiblePrice>1</deductiblePrice>
      <supplierImg3Url>http://1.jpg...</supplierImg3Url>
      <writeoffShop>1</writeoffShop>
      <categoryCode>R6151001</categoryCode>
      <priceType>01</priceType>
      <alertQty>100</alertQty>
      <supplierImg2Url>http://1.jpg...</supplierImg2Url>
      <supplierImg8Url>http://1.jpg...</supplierImg8Url>
      <extractMode>01,10</extractMode>
      <cmTitle>商品标题</cmTitle>
      <price>100</price>
      <supplierImg4Url>http://1.jpg...</supplierImg4Url>
      <supplierImg9Url>http://1.jpg...</supplierImg9Url>
      <introduction>5aW95ZWG5ZOB</introduction>
      <mobile>
        <summary>1</summary>
        <list>
          <text>1</text>
          <num>1</num>
          <pic>http://1.jpg</pic>
        </list>
      </mobile>
      <effectiveDay>99</effectiveDay>
      <insaleRefund>0</insaleRefund>
      <freightTemplateId>2da499d40cda4389817273ab0affdbed</freightTemplateId>
      <afterSaleServiceDec>7天内包退换</afterSaleServiceDec>
      <img2Url>/</img2Url>
      <mainPicVideoCode>108627</mainPicVideoCode>
      <assortCode>11111111</assortCode>
      <mobileNew>
        <module>
          <imgUrl>http://1.jpg</imgUrl>
          <moduleName>售后服务</moduleName>
          <moduleStatus>1</moduleStatus>
          <tuijianId>1</tuijianId>
          <couponId>1</couponId>
        </module>
      </mobileNew>
      <sellPoint>商品卖点</sellPoint>
      <sourceCountry>CN</sourceCountry>
      <supplierImg5Url>http://1.jpg...</supplierImg5Url>
      <img1Url>/</img1Url>
      <supplierImg1Url>http://1.jpg...</supplierImg1Url>
      <img5Url>/</img5Url>
      <brandCode>A101</brandCode>
      <supplierImg10Url>http://1.jpg...</supplierImg10Url>
      <verticalPic>xx.jpg</verticalPic>
      <saleDate>2013-09-15</saleDate>
      <supplierImg6Url>http://1.jpg...</supplierImg6Url>
      <sellChannel>01</sellChannel>
      <img4Url>/</img4Url>
      <childItem>
        <barpic>http://1.jpg</barpic>
        <supplierImg1Url>http://1.jpg...</supplierImg1Url>
        <price>100</price>
        <invQty>222</invQty>
        <deductiblePriceChild>1</deductiblePriceChild>
        <barcode>1</barcode>
        <pars>
          <parCode>G00001</parCode>
          <parValue>1</parValue>
        </pars>
        <itemCode>222</itemCode>
        <aleryQty>222</aleryQty>
      </childItem>
      <barpic>http://1.jpg...</barpic>
      <bookingShop>0</bookingShop>
      <saleSet>0</saleSet>
      <pars>
        <parCode>G00001</parCode>
        <parValue>1</parValue>
      </pars>
      <productName>商品名称</productName>
    </item>
  </sn_body>
</sn_request>

			
								

{
  "sn_request": {
    "sn_body": {
      "item": {
        "invQty": "100",
        "supplierImg7Url": "http://1.jpg...",
        "videoCode": "108625",
        "detailModule": [
          {
            "content": "5aW95ZWG5ZOB",
            "num": "1",
            "moduleId": "1",
            "moduleName": "售后服务",
            "type": " usr_mod"
          }
        ],
        "packingList": [
          {
            "packingListQty": "1",
            "packingListName": "装箱清单名称"
          }
        ],
        "writeoffPayment": "0",
        "payTemplate": "1",
        "itemCode": "商家商品编码",
        "img3Url": "/",
        "autoRefund": "0",
        "deductiblePrice": "1",
        "supplierImg3Url": "http://1.jpg...",
        "writeoffShop": "1",
        "priceType": "01",
        "categoryCode": "R6151001",
        "alertQty": "100",
        "supplierImg2Url": "http://1.jpg...",
        "supplierImg8Url": "http://1.jpg...",
        "extractMode": "01,10",
        "cmTitle": "商品标题",
        "price": "100",
        "supplierImg4Url": "http://1.jpg...",
        "supplierImg9Url": "http://1.jpg...",
        "introduction": "5aW95ZWG5ZOB",
        "mobile": {
          "summary": "1",
          "list": [
            {
              "num": "1",
              "text": "1",
              "pic": "http://1.jpg"
            }
          ]
        },
        "effectiveDay": "99",
        "insaleRefund": "0",
        "freightTemplateId": "2da499d40cda4389817273ab0affdbed",
        "afterSaleServiceDec": "7天内包退换",
        "img2Url": "/",
        "mainPicVideoCode": "108627",
        "assortCode": "11111111",
        "mobileNew": {
          "module": [
            {
              "imgUrl": "http://1.jpg",
              "moduleName": "售后服务",
              "moduleStatus": "1",
              "couponId": "1",
              "tuijianId": "1"
            }
          ]
        },
        "sellPoint": "商品卖点",
        "sourceCountry": "CN",
        "supplierImg5Url": "http://1.jpg...",
        "img1Url": "/",
        "supplierImg1Url": "http://1.jpg...",
        "img5Url": "/",
        "brandCode": "A101",
        "supplierImg10Url": "http://1.jpg...",
        "verticalPic": "xx.jpg",
        "saleDate": "2013-09-15",
        "supplierImg6Url": "http://1.jpg...",
        "sellChannel": "01",
        "img4Url": "/",
        "childItem": [
          {
            "barpic": "http://1.jpg",
            "price": "100",
            "supplierImg1Url": "http://1.jpg...",
            "invQty": "222",
            "deductiblePriceChild": "1",
            "barcode": "1",
            "pars": [
              {
                "parCode": "G00001",
                "parValue": "1"
              }
            ],
            "aleryQty": "222",
            "itemCode": "222"
          }
        ],
        "barpic": "http://1.jpg...",
        "bookingShop": "0",
        "saleSet": "0",
        "productName": "商品名称",
        "pars": [
          {
            "parCode": "G00001",
            "parValue": "1"
          }
        ]
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码

<sn_responseContent>
  <sn_body>
    <itemContents>
      <applyTime>1990-07-16 00:00:00</applyTime>
      <applyCode>100011258</applyCode>
    </itemContents>
  </sn_body>
</sn_responseContent>

			
                                

{
  "sn_responseContent": {
    "sn_body": {
      "itemContents": {
        "applyTime": "1990-07-16 00:00:00",
        "applyCode": "100011258"
      }
    }
  }
}
			
                                
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
} 								  
                           		
业务异常码
异常码 错误描述 解决方案
biz.custom.additem.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.custom.additem.enumeration-error:* 参数的可选值错误 请检查此参数的值,*号表示参数字段名
biz.custom.additem.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.mcmp 服务不可用 请联系苏宁技术人员
biz.custom.additem.invalid-biz:100 商家撤场
biz.custom.additem.invalid-biz:101 处罚中不允许发布新商品
biz.custom.additem.invalid-biz:102 国家省份城市错误
biz.custom.additem.invalid-biz:103 海外购来源地错误
biz.custom.additem.invalid-biz:104 运费模板错误
biz.custom.additem.invalid-biz:105 报文格式 通子码错误
biz.custom.additem.invalid-biz:106 发货清单不能为空;发货清单不能超过20个项目;发货清单名称必填,不能超过60个字符,且不能包含字符、或x;发货清单数目必须为不大于13位的正整数
biz.custom.additem.invalid-biz:107 电脑端详情必填,且长度不能超过100000
biz.custom.additem.invalid-biz:108 电脑端详情中包含iframe或frames或frameset或 frame标签
biz.custom.additem.invalid-biz:109 电脑端详情中包含javascript或script或object或 link标签
biz.custom.additem.invalid-biz:110 电脑端详情中包含外部图片
biz.custom.additem.invalid-biz:111 电脑端详情中包含外部链接
biz.custom.additem.invalid-biz:112 商品卖点必填,且长度不能超过60或者160
biz.custom.additem.invalid-biz:113 售后服务必填,且长度不能超过254
biz.custom.additem.invalid-biz:114 商品标题必填,且长度不能超过60
biz.custom.additem.invalid-biz:115 商家商品编码长度超过30
biz.custom.additem.invalid-biz:116
biz.custom.additem.invalid-biz:117
biz.custom.additem.invalid-biz:118 价格校验错误
biz.custom.additem.invalid-biz:119 商品类目未绑定销售范围;商品类目为空
biz.custom.additem.invalid-biz:120 没有类目或品牌授权,无权操作该商品;品牌为空
biz.custom.additem.invalid-biz:121 商家编码为空
biz.custom.additem.invalid-biz:122 商品名称为空
biz.custom.additem.invalid-biz:123 商品名称长度超过60
biz.custom.additem.invalid-biz:124 商品名称已存在
biz.custom.additem.invalid-biz:125 商品名称排重系统异常
biz.custom.additem.invalid-biz:126 资质参数必填项校验
biz.custom.additem.invalid-biz:127 3C认证不存在,请填写有效的证书编号和生产企业
biz.custom.additem.invalid-biz:128 子码数量大于1000
biz.custom.additem.invalid-biz:129 手机详情校验-摘要大于140
biz.custom.additem.invalid-biz:130 手机详情校验-num不为数字,或者重复
biz.custom.additem.invalid-biz:131 手机详情校验-裁剪适配手机地址异常
biz.custom.additem.invalid-biz:132 手机详情校验-图片总大小超过1536KB
biz.custom.additem.invalid-biz:133 手机详情校验-文本总长度不超过5000
biz.custom.additem.invalid-biz:134 手机详情校验-图片和文字都为空 或者 图片和文字都不为空
biz.custom.additem.invalid-biz:135 手机详情校验-手机图片不为此商家的;手机图片宽度在480-640px之间
biz.custom.additem.invalid-biz:136 手机详情校验-文本长度不超过500
biz.custom.additem.invalid-biz:137 手机新版详情校验-模块名称不能空
biz.custom.additem.invalid-biz:138 手机新版详情校验-模块启用标识不能为空
biz.custom.additem.invalid-biz:139 手机新版详情校验-模块启用至少3个
biz.custom.additem.invalid-biz:140 手机新版详情校验-模块名称错误
biz.custom.additem.invalid-biz:141 手机新版详情校验-模块名称重复
biz.custom.additem.invalid-biz:142 手机新版详情校验-商品图片模块图片不能超过20个
biz.custom.additem.invalid-biz:143 手机新版详情校验-优惠券id不为此商家的
biz.custom.additem.invalid-biz:144 手机新版详情校验-本店推荐id不为此商家的
biz.custom.additem.invalid-biz:145 手机新版详情校验-自定义模块图片不能超过2个
biz.custom.additem.invalid-biz:146 手机新版详情校验-模块数量不为7个
biz.custom.additem.invalid-biz:147 手机新版详情校验-商品图片模块图片后缀不能为gif
biz.custom.additem.invalid-biz:148 手机新版详情校验-商品图片模块图片不为此商家的
biz.custom.additem.invalid-biz:149 手机新版详情校验-商品图片模块图片宽度大于750
biz.custom.additem.invalid-biz:150 手机新版详情校验-自定义模块图片后缀不能为gif
biz.custom.additem.invalid-biz:151 手机新版详情校验-自定义模块图片不为此商家的
biz.custom.additem.invalid-biz:152 手机新版详情校验-自定义模块图片宽度大于750
biz.custom.additem.invalid-biz:153 模块化详情校验-num不为数字,或者重复
biz.custom.additem.invalid-biz:154 模块化详情校验-内容base64加密
biz.custom.additem.invalid-biz:155 模块化详情校验-自定义模块个数大于10个
biz.custom.additem.invalid-biz:156 模块化详情校验-自定义 id必为空,名称和内容必填
biz.custom.additem.invalid-biz:157 模块化详情校验-既不是运营模块,也不是自定义模块
biz.custom.additem.invalid-biz:158 模块化详情校验-不允许自定义顺序;运营模板中必填的模块未填写值;所填运营模块id不在模板当中
biz.custom.additem.invalid-biz:159 单一商品条形码验重
biz.custom.additem.invalid-biz:160 单一商品条形码资质图必填
biz.custom.additem.invalid-biz:161 单一商品条形码资质图大于3
biz.custom.additem.invalid-biz:162 单一商品条形码资质图不是此商家的
biz.custom.additem.invalid-biz:163 单一商品条形码资质图小于500kb校验
biz.custom.additem.invalid-biz:164 单一商品条形码资质图规格800*800以上校验
biz.custom.additem.invalid-biz:165 子码条形码必填
biz.custom.additem.invalid-biz:166 子码条形码不规范
biz.custom.additem.invalid-biz:167 子码条形码重复
biz.custom.additem.invalid-biz:168 子码资质图必填
biz.custom.additem.invalid-biz:169 子码资质图不是该商家的
biz.custom.additem.invalid-biz:170 子码资质图小于500kb校验
biz.custom.additem.invalid-biz:171 子码资质图规格800*800以上校验
biz.custom.additem.invalid-biz:172 子码无特性节点;子码特性节点数量不对
biz.custom.additem.invalid-biz:173 子码特性值不能有,
biz.custom.additem.invalid-biz:174 基本参数,动态参数有误
biz.custom.additem.invalid-biz:175 子码色卡图为空或者不为此商家;子码色卡图规格800*800以上
biz.custom.additem.invalid-biz:176 含有敏感词
biz.custom.additem.invalid-biz:177 主图中间不能有空跳过的
biz.custom.additem.invalid-biz:178 主图重复
biz.custom.additem.invalid-biz:179 主图图片不为此商家的;主图规格800*800以上校验
biz.custom.additem.invalid-biz:180 子码自定义特性值不能包含空格与|,且长度不能超过30;子码选项特性值不匹配;子码特性组合重复
biz.custom.additem.invalid-biz:181 商品竖图不为此商家的;商品竖图800*1200以上校验,商品竖图小于2M
biz.custom.additem.invalid-biz:182 当前可申请商品数超出最大数量限制。num1代表该商家可申请的最大商品数(含子码商品),num2代表该商家当前已申请的商品数(含子码商品) 从回收站彻底删除,释放被占用的商品数量。
公共异常码
API工具
FAQ

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

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-获取我的商品库信息查询结果。

Q:产品申请时含有子商品的商品,价格、库存如何维护?

A:若商品含有子商品,价格、库存维护到子商品(childitem)节点下。主商品(item)节点下无需维护价格、库存。