API接口目录

苏宁有货业务

有货买家商品API
有货买家价格库存API
有货买家订单API
有货买家物流API
有货买家售后API
有货买家其他API
有货卖家商品API
家乐福供货平台API
异常码自查工具
suning.sngoods.productcontents.add 商品内容维护
¥免费

对于苏宁已存在的商品,商户可通过此接口进行商品内容维护。
1、通过输入苏宁商品编码、商品介绍、卖点、售后、价格、库存、运费、销售设定等商品信息维护商品内容。若含有子商品,则该主商品下的所有子商品信息必须维护,若提供的子商品中存在商户不操作的商品,可将对应子商品的库存设置为0
2、系统成功接收商品申请信息后,返回申请编号、接口接收成功系统时间。
3、商品处理结果可通过获取我的商品库信息/我的商品库信息精确查询/获取我的商品详情信息接口进行查询。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
sellPointStringN商品卖点商品卖点。最多可填写40个汉字或字符。
introductionStringN5aW95ZWG5ZOB商家商品介绍,UTF-8格式。将html内容的txt文本文件读取为字节数组,然后base64加密,去除空格回车后作为字段,传输时所涉及的图片不得使用外部url。允许写入CSS(禁止引用外部CSS)不支持JS。
imgUrlStringNhttp://1.jpg商品图片模块、自定义模块图片地址
saleSetStringY0商家商品销售设定。1:立即;0:设定日期;2:放入仓库。1表示商品申请处理成功后,系统立即进行上架;0表示商品申请处理成功后,在设定的日期,系统自动上架;2表示商品申请处理成功后,商品状态为待售状态。商户可通过平台业务-商品服务-商品上架接口对待售状态的商品进行上架操作。
saleDateStringN2013-09-15商家设定的销售日期。必须为当天之后的日期!仅在销售设定为0时展示。 格式YYYY-MM-DD
productCodeStringY102652866苏宁商品编码。可由平台业务-商品服务-获取我的商品库信息接口获取,只可填写主商品编码
itemCodeStringN789123主商品商家商品编码。
priceStringN5.00主商品价格。单位:元。精确到小数点后2位。如含有子商品,此字段无需填写。价格范围:0.01-9,999,999,999,999.99
invQtyStringN10主商品库存。单位:件。如含有子商品,此字段无需填写。库存范围:0-99999(非海外购商户此字段必填)
alertQtyStringN5主商品库存预警值。如含有子商品,此字段无需填写。范围:0-99999
sourceCountryStringNCN来源地国家代码。国家代码(可去已有接口国家代码查询接口查询国家代码)
detailModuleStringN
numStringN1模块化详情模块顺序
moduleIdStringN1模块化详情-模块ID
moduleNameStringN售后服务模块化详情模块名称
typeStringNusr_mod模块类型。cat_mod:表示运营配置; usr_mod:表示自定义
contentStringN5aW95ZWG5ZOB模块化详情-模块内容。内容需base64加密。
cmTitleStringY商品标题商品标题
supplierImg1UrlStringYhttp://1.jpg...商家商品图片1
supplierImg2UrlStringNhttp://1.jpg...商家商品图片2
supplierImg3UrlStringNhttp://1.jpg...商家商品图片3
supplierImg4UrlStringNhttp://1.jpg...商家商品图片4
supplierImg5UrlStringNhttp://1.jpg...商家商品图片5
supplierImg6UrlStringNhttp://1.jpg...商家商品图片6
supplierImg7UrlStringNhttp://1.jpg...商家商品图片7
supplierImg8UrlStringNhttp://1.jpg...商家商品图片8
supplierImg9UrlStringNhttp://1.jpg...商家商品图片9
privateFlagStringY1:私密商品 0:普通商品私密商品标识
supplierImg10UrlStringNhttp://1.jpg...商家商品图片10
childItemStringN
productCodeStringY104007723子商品的苏宁商品编码。可由平台业务-商品服务-获取我的商品库信息接口获取,仅可填写子商品编码。如无子商品,则无需填写此字段。单次最多维护100个子商品。
itemCodeStringN561子商品的商家商品编码。可由平台业务-商品服务-获取我的商品库信息接口获取,如修改此字段,子商品-苏宁商品编码字段必填。如无子商品,则无需填写此字段。
priceStringN100.00子商品价格。单位:元。精确到小数点后2位。如无子商品,此字段无需填写。价格范围:0.01-9999999999999.99
invQtyStringN5子商品库存。单位:件。如无子商品,此字段无需填写。库存范围:0-999999
alertQtyStringN5子商品库存预警值。如无子商品,则无需填写此字段
supplierImg1UrlStringYhttp://1.jpg子商品商家商品图片
suggestedRetailPriceStringY100子商品建议零售价。单位:元。精确到小数点后2位。价格范围:¥0.01-9,999,999,999,999.99,且不得低于售价
minNumStringY111最小起订量
suggestedRetailPriceStringY100.00主商品建议零售价。单位:元。精确到小数点后2位。如含有子商品,此字段无需填写。价格范围:¥0.01-9,999,999,999,999.99,且不得低于售价
highlightWordoneStringN123亮点词1
highlightWordtwoStringN亮点词2亮点词2
highlightWordthreeStringN亮点词3亮点词3
响应参数
名称 类型 示例值 描述
applyCodeString100011258申请编码。applyid
applyTimeString1990-07-16 00:00:00申请时间
priceWarnFlagString11-存在价格预警 0-不存在价格预警
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <productcontents>
      <sourceCountry>CN</sourceCountry>
      <childItem>
        <alertQty>5</alertQty>
        <productCode>104007723</productCode>
        <invQty>5</invQty>
        <price>100.00</price>
        <supplierImg1Url>http://1.jpg</supplierImg1Url>
        <itemCode>561</itemCode>
        <suggestedRetailPrice>100</suggestedRetailPrice>
      </childItem>
      <sellPoint>商品卖点</sellPoint>
      <itemCode>789123</itemCode>
      <saleSet>0</saleSet>
      <supplierImg7Url>http://1.jpg...</supplierImg7Url>
      <supplierImg9Url>http://1.jpg...</supplierImg9Url>
      <saleDate>2013-09-15</saleDate>
      <cmTitle>商品标题</cmTitle>
      <supplierImg5Url>http://1.jpg...</supplierImg5Url>
      <price>5.00</price>
      <supplierImg1Url>http://1.jpg...</supplierImg1Url>
      <suggestedRetailPrice>100.00</suggestedRetailPrice>
      <supplierImg3Url>http://1.jpg...</supplierImg3Url>
      <highlightWordtwo>亮点词2</highlightWordtwo>
      <detailModule>
        <num>1</num>
        <moduleName>售后服务</moduleName>
        <moduleId>1</moduleId>
        <type>usr_mod</type>
        <content>5aW95ZWG5ZOB</content>
      </detailModule>
      <highlightWordthree>亮点词3</highlightWordthree>
      <introduction>5aW95ZWG5ZOB</introduction>
      <supplierImg8Url>http://1.jpg...</supplierImg8Url>
      <minNum>111</minNum>
      <imgUrl>http://1.jpg</imgUrl>
      <supplierImg2Url>http://1.jpg...</supplierImg2Url>
      <privateFlag>1:私密商品 0:普通商品</privateFlag>
      <alertQty>5</alertQty>
      <productCode>102652866</productCode>
      <invQty>10</invQty>
      <supplierImg6Url>http://1.jpg...</supplierImg6Url>
      <supplierImg4Url>http://1.jpg...</supplierImg4Url>
      <supplierImg10Url>http://1.jpg...</supplierImg10Url>
      <highlightWordone>123</highlightWordone>
    </productcontents>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "productcontents": {
        "sourceCountry": "CN",
        "childItem": [
          {
            "alertQty": "5",
            "productCode": "104007723",
            "invQty": "5",
            "price": "100.00",
            "supplierImg1Url": "http://1.jpg",
            "itemCode": "561",
            "suggestedRetailPrice": "100"
          }
        ],
        "sellPoint": "商品卖点",
        "itemCode": "789123",
        "saleSet": "0",
        "supplierImg7Url": "http://1.jpg...",
        "supplierImg9Url": "http://1.jpg...",
        "saleDate": "2013-09-15",
        "cmTitle": "商品标题",
        "supplierImg5Url": "http://1.jpg...",
        "price": "5.00",
        "supplierImg1Url": "http://1.jpg...",
        "suggestedRetailPrice": "100.00",
        "supplierImg3Url": "http://1.jpg...",
        "highlightWordtwo": "亮点词2",
        "detailModule": [
          {
            "num": "1",
            "moduleName": "售后服务",
            "moduleId": "1",
            "type": "usr_mod",
            "content": "5aW95ZWG5ZOB"
          }
        ],
        "highlightWordthree": "亮点词3",
        "introduction": "5aW95ZWG5ZOB",
        "supplierImg8Url": "http://1.jpg...",
        "minNum": "111",
        "imgUrl": "http://1.jpg",
        "supplierImg2Url": "http://1.jpg...",
        "privateFlag": "1:私密商品 0:普通商品",
        "alertQty": "5",
        "productCode": "102652866",
        "invQty": "10",
        "supplierImg6Url": "http://1.jpg...",
        "supplierImg4Url": "http://1.jpg...",
        "supplierImg10Url": "http://1.jpg...",
        "highlightWordone": "123"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <productcontents>
      <priceWarnFlag>1</priceWarnFlag>
      <applyCode>100011258</applyCode>
      <applyTime>1990-07-16 00:00:00</applyTime>
    </productcontents>
  </sn_body>
</sn_responseContent>

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

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.sngoods.addproductcontents.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.sngoods.addproductcontents.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.sngoods.addproductcontents.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.sngoods.addproductcontents.enumeration-error:* 参数的可选值错误 请检查此参数的值,*号表示参数字段名
biz.custom.additemcontents.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.custom.additemcontents.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.custom.additemcontents.enumeration-error:* 参数的可选值错误 请检查此参数的值,*号表示参数字段名
biz.custom.additemcontents.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.mcmp 服务不可用 请联系苏宁技术人员
biz.custom.additemcontents.invalid-biz:100 商家撤场
biz.custom.additemcontents.invalid-biz:101 商家处罚
biz.custom.additemcontents.invalid-biz:102 国内 国外操作权限
biz.custom.additemcontents.invalid-biz:103 海外购来源地国家错误
biz.custom.additemcontents.invalid-biz:105 报文格式 通子码校验
biz.custom.additemcontents.invalid-biz:106 发货清单不能为空;发货清单不能超过20个项目;发货清单名称必填,不能超过60个字符,且不能包含字符、或x;发货清单数目必须为不大于13位的正整数
biz.custom.additemcontents.invalid-biz:107 电脑端详情长度不能超过100000
biz.custom.additemcontents.invalid-biz:108 电脑端详情中包含iframe或frames或frameset或 frame标签
biz.custom.additemcontents.invalid-biz:109 电脑端详情中包含javascript或script或object或 link标签
biz.custom.additemcontents.invalid-biz:110 电脑端详情中包含外部图片
biz.custom.additemcontents.invalid-biz:111 电脑端详情中包含外部链接
biz.custom.additemcontents.invalid-biz:112 卖点长度不能超过60或者160
biz.custom.additemcontents.invalid-biz:113 售后服务长度不能超过254
biz.custom.additemcontents.invalid-biz:114 商品标题长度不能超过60
biz.custom.additemcontents.invalid-biz:115 单一,通码 商家商品编码大于30个字符
biz.custom.additemcontents.invalid-biz:116 子码 商家商品编码超过30个字符
biz.custom.additemcontents.invalid-biz:117 设定销售情况下,销售日期为空;销售日期填写不规范;销售日期格式化时间错误或者时间早于当天
biz.custom.additemcontents.invalid-biz:118 价格校验出错
biz.custom.additemcontents.invalid-biz:119 类目关联销售范围;类目权限校验
biz.custom.additemcontents.invalid-biz:120 品牌权限校验
biz.custom.additemcontents.invalid-biz:121 商品已经存在 未删除;此商家此商品名称已经存在
biz.custom.additemcontents.invalid-biz:122 商品已经存在 商家删除
biz.custom.additemcontents.invalid-biz:123 商品已经存在 违规删除
biz.custom.additemcontents.invalid-biz:124 商品已经存在 类目删除
biz.custom.additemcontents.invalid-biz:125 商品已经存在 品牌删除
biz.custom.additemcontents.invalid-biz:126 此通码商品无子商品;子商品编码不能为空;填写的子商品编码不为此通码商品的
biz.custom.additemcontents.invalid-biz:127 库存为空;库存填写不规范
biz.custom.additemcontents.invalid-biz:128 库存预警值填写不规范
biz.custom.additemcontents.invalid-biz:129 手机详情校验-摘要大于140
biz.custom.additemcontents.invalid-biz:130 手机详情校验-num不为数字,或者重复
biz.custom.additemcontents.invalid-biz:131 手机详情校验-裁剪适配手机地址异常
biz.custom.additemcontents.invalid-biz:132 手机详情校验-图片总大小超过1536KB
biz.custom.additemcontents.invalid-biz:133 手机详情校验-文本总长度不超过5000
biz.custom.additemcontents.invalid-biz:134 图片和文字都为空 或者 图片和文字都不为空
biz.custom.additemcontents.invalid-biz:135 手机图片不为此商家的;手机图片宽度在480-640px之间
biz.custom.additemcontents.invalid-biz:136 手机详情校验-文本长度不超过500
biz.custom.additemcontents.invalid-biz:137 手机新版详情校验-模块名称不能空
biz.custom.additemcontents.invalid-biz:138 手机新版详情校验-模块启用标识不能为空
biz.custom.additemcontents.invalid-biz:139 手机新版详情校验-模块启用至少3个
biz.custom.additemcontents.invalid-biz:140 手机新版详情校验-模块名称错误
biz.custom.additemcontents.invalid-biz:141 手机新版详情校验-模块名称重复
biz.custom.additemcontents.invalid-biz:142 商品图片模块图片不能超过20个
biz.custom.additemcontents.invalid-biz:143 手机新版详情校验-优惠券id不为此商家的
biz.custom.additemcontents.invalid-biz:144 手机新版详情校验-本店推荐id不为此商家的
biz.custom.additemcontents.invalid-biz:145 手机新版详情校验-自定义模块图片不能超过2个
biz.custom.additemcontents.invalid-biz:146 手机新版详情校验-模块数量不为7个
biz.custom.additemcontents.invalid-biz:147 手机新版详情校验-商品图片模块图片后缀不能为gif
biz.custom.additemcontents.invalid-biz:148 手机新版详情校验-商品图片模块图片不为此商家的
biz.custom.additemcontents.invalid-biz:149 手机新版详情校验-商品图片模块图片宽度大于750
biz.custom.additemcontents.invalid-biz:150 手机新版详情校验-自定义模块图片后缀不能为gif
biz.custom.additemcontents.invalid-biz:151 手机新版详情校验-自定义模块图片不为此商家的
biz.custom.additemcontents.invalid-biz:152 手机新版详情校验-自定义模块图片宽度大于750
biz.custom.additemcontents.invalid-biz:153 模块化详情校验-num不为数字,或者重复
biz.custom.additemcontents.invalid-biz:154 模块化详情校验-内容base64加密
biz.custom.additemcontents.invalid-biz:155 模块化详情校验-自定义模块个数大于10个
biz.custom.additemcontents.invalid-biz:156 模块化详情校验-自定义 id必为空,名称和内容必填
biz.custom.additemcontents.invalid-biz:157 模块化详情校验-既不是运营模块,也不是自定义模块
biz.custom.additemcontents.invalid-biz:158 模块化详情校验-不允许自定义顺序;运营模板中必填的模块未填写值;所填运营模块id不在模板当中
biz.custom.additemcontents.invalid-biz:159 子码色卡图第一张为空 ;子码色卡图不为此商家的;子码色卡图规格800*800以上校验
biz.custom.additemcontents.invalid-biz:160 含有敏感词
biz.custom.additemcontents.invalid-biz:161 主图中间不能有空跳过的
biz.custom.additemcontents.invalid-biz:162 主图重复
biz.custom.additemcontents.invalid-biz:163 主图图片不为此商家的;主图规格800*800以上校验
biz.custom.additemcontents.invalid-biz:164 o2o商家撤场
biz.custom.item.invalid-biz:shelve-pass-limit 您上架的商品数量超过限制
biz.sngoods.addproductcontents.invalid-biz:100 私密标识为空
biz.sngoods.addproductcontents.invalid-biz:101 私密标识格式不正确,1:私密商品 0:普通商品
biz.sngoods.addproductcontents.invalid-biz:102 商品起购数量为空
biz.sngoods.addproductcontents.invalid-biz:103 商品起购数量不正确,商品起购数量请输入1~99999999间的数字
biz.sngoods.addproductcontents.invalid-biz:104 单一商品建议零售价校验错误,建议零售价维护不正确,价格必须是¥0.01-9,999,999,999,999.99!
biz.sngoods.addproductcontents.invalid-biz:105 单一商品建议零售价不得低于售价
biz.sngoods.addproductcontents.invalid-biz:106 子商品建议零售价校验错误,建议零售价维护不正确,价格必须是¥0.01-9,999,999,999,999.99!
biz.sngoods.addproductcontents.invalid-biz:107 子商品建议零售价不得低于售价
公共异常码
API工具
FAQ