API接口目录

苏宁小店业务

门店API
商品API
店铺分类API
配送范围API
促销API
订单API
取消退款API
异常码自查工具
suning.store.commodityedit.create 新建修改编辑商品信息
¥免费

提供商品新增、修改和编辑功能。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
operTypeStringY00(00:新建 01:审核不通过时修改 02:编辑)操作类型
applyCodeStringN1be9df8f-94fb-43f9-962c-125bfc621a6e申请编码
productCodeStringNxxx苏宁商品编码
storeCodeStringNxxx苏宁门店编码
appStoreCodeStringNxx商家门店编码
categoryCodeStringYxx四级类目编码
productNameStringYxxx商品名称
brandCodeStringNxxx商品品牌
cmBarcodeStringNxx商品条码
brgewStringNxx毛重
supplierCmCodeStringNxxx商家商品编码
advertiseStringNxxx广告词
picUrlStringYhttp://xx/xx/xx/xx/x1.jpg(逗号隔开共5张)商品图片
classifyCodeStringYxxx一级店内分类编码
secondClassifyCodeStringNxxx二级店内分类编码
sellPriceStringYxxx价格
packingPriceStringNxxx餐盒费
qtyStringYxxx库存
deliveryAttrStringN01(01-常温 02-恒温 03-冷藏 04-冷冻)配送属性
purchaseMinStringY1起购量
serviceTimeStringN1-24服务时长
immediateAppointStringN01(01:支持 02:不支持)立即预约
immediateAppointTimeStringNxxx立即预约时长
sellStatusStringY1(1:上架 2:下架)上下架状态
sellHoursTypeStringY01售卖方式
standardInfoStringN
standardNameStringN尺寸规格名
standardCodeStringNxxx规格编码
isMultiStringN0(0:否 1:是)是否支持消费者多选
choiceInfoStringN
choiceNameStringN大杯选项名称
choiceCodeStringNxxx选项编码
choicePriceStringN1加价金额
attrInfoStringN
attrNameStringN温度属性名称
attrCodeStringNxxx属性编码
attrIsMultiStringN0(0:否 1:是)是否支持多选
attrChoiceInfoStringN
attrChoiceNameStringN加冰选项名称
attrChoiceCodeStringNxxx选项编码
响应参数
名称 类型 示例值 描述
returnFlagStringY(Y成功;N失败;)结果
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <createCommodityedit>
      <sellPrice>xxx</sellPrice>
      <sellStatus>1(1:上架   2:下架)</sellStatus>
      <advertise>xxx</advertise>
      <brgew>xx</brgew>
      <secondClassifyCode>xxx</secondClassifyCode>
      <sellHoursType>01</sellHoursType>
      <standardInfo>
        <choiceInfo>
          <choicePrice>1</choicePrice>
          <choiceCode>xxx</choiceCode>
          <choiceName>大杯</choiceName>
        </choiceInfo>
        <isMulti>0(0:否   1:是)</isMulti>
        <standardName>尺寸</standardName>
        <standardCode>xxx</standardCode>
      </standardInfo>
      <classifyCode>xxx</classifyCode>
      <brandCode>xxx</brandCode>
      <serviceTime>1-24</serviceTime>
      <deliveryAttr>01(01-常温 02-恒温 03-冷藏 04-冷冻)</deliveryAttr>
      <operType>00(00:新建 01:审核不通过时修改 02:编辑)</operType>
      <picUrl>http://xx/xx/xx/xx/x1.jpg(逗号隔开共5张)</picUrl>
      <immediateAppoint>01(01:支持  02:不支持)</immediateAppoint>
      <productCode>xxx</productCode>
      <purchaseMin>1</purchaseMin>
      <attrInfo>
        <attrIsMulti>0(0:否   1:是)</attrIsMulti>
        <attrChoiceInfo>
          <attrChoiceName>加冰</attrChoiceName>
          <attrChoiceCode>xxx</attrChoiceCode>
        </attrChoiceInfo>
        <attrName>温度</attrName>
        <attrCode>xxx</attrCode>
      </attrInfo>
      <categoryCode>xx</categoryCode>
      <qty>xxx</qty>
      <appStoreCode>xx</appStoreCode>
      <supplierCmCode>xxx</supplierCmCode>
      <cmBarcode>xx</cmBarcode>
      <applyCode>1be9df8f-94fb-43f9-962c-125bfc621a6e</applyCode>
      <immediateAppointTime>xxx</immediateAppointTime>
      <productName>xxx</productName>
      <packingPrice>xxx</packingPrice>
      <storeCode>xxx</storeCode>
    </createCommodityedit>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "createCommodityedit": {
        "sellStatus": "1(1:上架   2:下架)",
        "sellPrice": "xxx",
        "advertise": "xxx",
        "brgew": "xx",
        "sellHoursType": "01",
        "secondClassifyCode": "xxx",
        "standardInfo": [
          {
            "choiceInfo": [
              {
                "choicePrice": "1",
                "choiceCode": "xxx",
                "choiceName": "大杯"
              }
            ],
            "isMulti": "0(0:否   1:是)",
            "standardCode": "xxx",
            "standardName": "尺寸"
          }
        ],
        "classifyCode": "xxx",
        "brandCode": "xxx",
        "serviceTime": "1-24",
        "deliveryAttr": "01(01-常温 02-恒温 03-冷藏 04-冷冻)",
        "operType": "00(00:新建 01:审核不通过时修改 02:编辑)",
        "picUrl": "http://xx/xx/xx/xx/x1.jpg(逗号隔开共5张)",
        "immediateAppoint": "01(01:支持  02:不支持)",
        "productCode": "xxx",
        "purchaseMin": "1",
        "attrInfo": [
          {
            "attrIsMulti": "0(0:否   1:是)",
            "attrName": "温度",
            "attrChoiceInfo": [
              {
                "attrChoiceName": "加冰",
                "attrChoiceCode": "xxx"
              }
            ],
            "attrCode": "xxx"
          }
        ],
        "categoryCode": "xx",
        "qty": "xxx",
        "appStoreCode": "xx",
        "supplierCmCode": "xxx",
        "cmBarcode": "xx",
        "applyCode": "1be9df8f-94fb-43f9-962c-125bfc621a6e",
        "immediateAppointTime": "xxx",
        "productName": "xxx",
        "storeCode": "xxx",
        "packingPrice": "xxx"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <createCommodityedit>
      <returnFlag>Y(Y成功;N失败;)</returnFlag>
    </createCommodityedit>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "createCommodityedit": {
        "returnFlag": "Y(Y成功;N失败;)"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.store.createcommodityedit.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.mcmp 服务不可用 请联系苏宁技术人员
biz.store.createcommodityedit.invalid-biz:100 该服务商品已经发布,请走编辑场景
biz.store.createcommodityedit.invalid-biz:101 该服务商品已发布正在审核中,请耐心等待
biz.store.createcommodityedit.invalid-biz:102 服务商家通子码类目,商品编码不能为空!
biz.store.createcommodityedit.invalid-biz:103 商家编码不能为空!
biz.store.createcommodityedit.invalid-biz:104 门店编码信息有误!
biz.store.createcommodityedit.invalid-biz:105 类目编码不能为空!
biz.store.createcommodityedit.invalid-biz:106 商品名称不能为空!
biz.store.createcommodityedit.invalid-biz:107 商家编码输入有误!
biz.store.createcommodityedit.invalid-biz:108 商品名称字段超长!
biz.store.createcommodityedit.invalid-biz:109 品牌编码不存在!
biz.store.createcommodityedit.invalid-biz:110 商品修改场景,申请编码不能为空!
biz.store.createcommodityedit.invalid-biz:111 商家编码与申请编码的关系不存在!
biz.store.createcommodityedit.invalid-biz:112 商品类目不存在或不是四级类目!
biz.store.createcommodityedit.invalid-biz:113 没有类目授权!
biz.store.createcommodityedit.invalid-biz:114 店铺编码和商家编码关系不存在!
biz.store.createcommodityedit.invalid-biz:115 该类目类型配置的字段列表为空!
biz.store.createcommodityedit.invalid-biz:116 基本参数必填,不能为空!
biz.store.createcommodityedit.invalid-biz:117 不存在的商品编码!
biz.store.createcommodityedit.invalid-biz:118 商家商品编码字段超长!
biz.store.createcommodityedit.invalid-biz:119 广告词字段超长!
biz.store.createcommodityedit.invalid-biz:120 配送属性字段值不在可选值范围!
biz.store.createcommodityedit.invalid-biz:121 最小购买量字段不能为空!
biz.store.createcommodityedit.invalid-biz:122 最小购买量字段输入不合法!
biz.store.createcommodityedit.invalid-biz:123 服务时长字段不能为空!
biz.store.createcommodityedit.invalid-biz:124 服务时长字段值不在可选值范围!
biz.store.createcommodityedit.invalid-biz:125 立即预约字段不能为空!
biz.store.createcommodityedit.invalid-biz:126 立即预约字段值不在可选值范围!
biz.store.createcommodityedit.invalid-biz:127 预约时间字段不能为空!
biz.store.createcommodityedit.invalid-biz:128 预约时间字段值不在可选值范围!
biz.store.createcommodityedit.invalid-biz:129 上下架状态字段不能为空!
biz.store.createcommodityedit.invalid-biz:130 上下架状态字段值不在可选值范围!
biz.store.createcommodityedit.invalid-biz:131 商品条码只能输入数字、大写字母,最多18位
biz.store.createcommodityedit.invalid-biz:132 毛重字段不能为空!
biz.store.createcommodityedit.invalid-biz:133 毛重字段输入不合法!
biz.store.createcommodityedit.invalid-biz:134 商品图片字段不能为空!
biz.store.createcommodityedit.invalid-biz:135 商品图片字段输入不合法!
biz.store.createcommodityedit.invalid-biz:136 图片域名不正确!
biz.store.createcommodityedit.invalid-biz:137 图片URL不存在!
biz.store.createcommodityedit.invalid-biz:138 一级店内分类字段不能为空!
biz.store.createcommodityedit.invalid-biz:139 售价字段不能为空!
biz.store.createcommodityedit.invalid-biz:140 售价字段输入不合法!
biz.store.createcommodityedit.invalid-biz:141 包装费字段不能为空!
biz.store.createcommodityedit.invalid-biz:142 包装费字段输入不合法!
biz.store.createcommodityedit.invalid-biz:143 库存字段不能为空!
biz.store.createcommodityedit.invalid-biz:144 库存字段输入不合法!
biz.store.createcommodityedit.invalid-biz:145 规格最多5个!
biz.store.createcommodityedit.invalid-biz:146 规格名字段不能为空!
biz.store.createcommodityedit.invalid-biz:147 是否支持消费者多选字段不能为空!
biz.store.createcommodityedit.invalid-biz:148 规格名字段超长!
biz.store.createcommodityedit.invalid-biz:149 是否支持消费者多选字段值不在可选值范围!
biz.store.createcommodityedit.invalid-biz:150 规格明细最多6个!
biz.store.createcommodityedit.invalid-biz:151 规格选项名字段不能为空!
biz.store.createcommodityedit.invalid-biz:152 加价金额字段不能为空!
biz.store.createcommodityedit.invalid-biz:153 规格选项名字段超长
biz.store.createcommodityedit.invalid-biz:154 加价金额字段输入不合法!
biz.store.createcommodityedit.invalid-biz:155 规格选项字段不能为空!
biz.store.createcommodityedit.invalid-biz:156 属性最多5个!
biz.store.createcommodityedit.invalid-biz:157 属性名字段不能为空!
biz.store.createcommodityedit.invalid-biz:158 是否支持消费者多选字段不能为空!
biz.store.createcommodityedit.invalid-biz:159 属性名字段超长!
biz.store.createcommodityedit.invalid-biz:160 是否支持消费者多选字段值不在可选值范围!
biz.store.createcommodityedit.invalid-biz:161 属性明细最多6个!
biz.store.createcommodityedit.invalid-biz:162 属性选项名字段不能为空!
biz.store.createcommodityedit.invalid-biz:163 属性选项名字段超长!
biz.store.createcommodityedit.invalid-biz:164 属性选项字段不能为空!
biz.store.createcommodityedit.invalid-biz:165 商品名称或广告词含有敏感词!
biz.store.createcommodityedit.invalid-biz:166 报价单收费项内容长度不得大于50!
biz.store.createcommodityedit.invalid-biz:167 报价单价格不合法
biz.store.createcommodityedit.invalid-biz:168 报价单价格字段不能为空!
biz.store.createcommodityedit.invalid-biz:169 通子码商品子码节点不能为空!
biz.store.createcommodityedit.invalid-biz:170 子码商品编码不合法!
biz.store.createcommodityedit.invalid-biz:171 子码条码长度不得超过20!
biz.store.createcommodityedit.invalid-biz:172 子码商家商品编码长度不得超过40!
biz.store.createcommodityedit.invalid-biz:173 服务时长字段值不在可选值范围!
biz.store.createcommodityedit.invalid-biz:174 子码主商品标识长度不得超过2!
biz.store.createcommodityedit.invalid-biz:175 子码售价字段不能为空!
biz.store.createcommodityedit.invalid-biz:176 子码售价字段输入不合法!
biz.store.createcommodityedit.invalid-biz:177 子码销售状态不合法!
biz.store.createcommodityedit.invalid-biz:178 操作类型不合法!
公共异常码
API工具
FAQ