API接口目录

苏宁小店业务

门店API
商品API
店铺分类API
配送范围API
促销API
订单API
取消退款API
异常码自查工具
suning.store.ssprice.create 身边苏宁限时打折创建和修改活动
¥免费

身边苏宁限时打折创建和修改活动

公共参数
请求参数
名称 类型 是否必须 示例值 描述
storeCodeStringNS03017113苏宁门店编码
activityCodeStringN操作类型为修改时,必输活动编码
operationTypeStringY操作类型1=新增 2=修改
activityNameStringN操作类型为新增时,必填活动名称
startTimeStringN操作类型为新增时,必填活动开始时间
endTimeStringN操作类型为新增时,必填活动结束时间
activityChannelStringY32,36,132=身边苏宁APP 36=身边苏宁WAP 1=身边苏宁小程序,只能全选,不能修改
priceTypeStringY3=折扣;默认值3优惠方式
appStoreCodeStringN1111111商家自定义门店编码
productListStringN
productCodeStringN1111111111商品编码
productDiscountStringN1~9.99折扣值
productOperateTypeStringN1=新增 2=修改 3=删除商品操作类型
响应参数
名称 类型 示例值 描述
returnFlagStringY:成功 N:失败返回结果
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <createSsprice>
      <activityCode>操作类型为修改时,必输</activityCode>
      <activityChannel>32,36,1</activityChannel>
      <activityName>操作类型为新增时,必填</activityName>
      <priceType>3=折扣;默认值3</priceType>
      <operationType>操作类型</operationType>
      <startTime>操作类型为新增时,必填</startTime>
      <endTime>操作类型为新增时,必填</endTime>
      <appStoreCode>1111111</appStoreCode>
      <productList>
        <productCode>1111111111</productCode>
        <productDiscount>1~9.99</productDiscount>
        <productOperateType>1=新增 2=修改 3=删除</productOperateType>
      </productList>
      <storeCode>S03017113</storeCode>
    </createSsprice>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "createSsprice": {
        "activityCode": "操作类型为修改时,必输",
        "activityChannel": "32,36,1",
        "activityName": "操作类型为新增时,必填",
        "priceType": "3=折扣;默认值3",
        "operationType": "操作类型",
        "startTime": "操作类型为新增时,必填",
        "endTime": "操作类型为新增时,必填",
        "appStoreCode": "1111111",
        "productList": [
          {
            "productCode": "1111111111",
            "productDiscount": "1~9.99",
            "productOperateType": "1=新增 2=修改 3=删除"
          }
        ],
        "storeCode": "S03017113"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <createSsprice>
      <returnFlag>Y:成功 N:失败</returnFlag>
    </createSsprice>
  </sn_body>
</sn_responseContent>

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

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.store.createssprice.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.mpms 服务不可用 请联系苏宁技术人员
biz.store.createssprice.invalid-biz:100 获取不到门店信息 请检查此参数的值
biz.store.createssprice.invalid-biz:101 参数必填 请检查此参数的值
biz.store.createssprice.invalid-biz:102 让价类型输入错误 请检查此参数的值
biz.store.createssprice.invalid-biz:103 操作类型错误 请检查此参数的值
biz.store.createssprice.invalid-biz:104 活动名称长度不能超过32 请检查此参数的值
biz.store.createssprice.invalid-biz:105 时间格式不合法 请检查此参数的值
biz.store.createssprice.invalid-biz:106 活动开始时间必须小于结束时间 请检查此参数的值
biz.store.createssprice.invalid-biz:107 活动渠道必填 请检查此参数的值
biz.store.createssprice.invalid-biz:108 渠道输入错误 请检查此参数的值
biz.store.createssprice.invalid-biz:109 活动编码不能为空 请检查此参数的值
biz.store.createssprice.invalid-biz:110 商品列表不能为空 请检查此参数的值
biz.store.createssprice.invalid-biz:111 商品数量不能超过200款 请检查此参数的值
biz.store.createssprice.invalid-biz:112 折扣值输入有误,折扣范围为1~9.99 请检查此参数的值
biz.store.createssprice.invalid-biz:113 商品操作类型错误,应输入新增:1 请检查此参数的值
biz.store.createssprice.invalid-biz:114 请正确填写苏宁商品编码 请检查此参数的值
biz.store.createssprice.invalid-biz:115 商品编码不存在 请检查此参数的值
biz.store.createssprice.invalid-biz:116 商品价格为空,无法维护促销活动 请检查此参数的值
biz.store.createssprice.invalid-biz:117 创建失败,您创建的活动中的所有商品正在参与其它活动 请检查此参数的值
biz.store.createssprice.invalid-biz:118 活动开始时间或结束时间不能早于当前时间 请检查此参数的值
biz.store.createssprice.invalid-biz:119 活动时间最长跨度180天 请检查此参数的值
biz.store.createssprice.invalid-biz:120 该活动不存在 请检查此参数的值
biz.store.createssprice.invalid-biz:121 该活动状态不可以修改 请检查此参数的值
biz.store.createssprice.invalid-biz:122 进行中的活动状态不能更改开始时间 请检查此参数的值
biz.store.createssprice.invalid-biz:123 活动时间最长跨度180天 请检查此参数的值
biz.store.createssprice.invalid-biz:124 活动开始时间不能早于当前时间 请检查此参数的值
biz.store.createssprice.invalid-biz:125 活动结束时间不能早于当前时间 请检查此参数的值
biz.store.createssprice.invalid-biz:126 商品操作类型输入有误 请检查此参数的值
biz.store.createssprice.invalid-biz:127 请正确填写苏宁商品编码 请检查此参数的值
biz.store.createssprice.invalid-biz:128 折扣值输入有误,折扣范围为1~9.99 请检查此参数的值
biz.store.createssprice.invalid-biz:129 该活动中已经存在该商品,不能新增 请检查此参数的值
biz.store.createssprice.invalid-biz:130 该活动中不存在该商品,不能修改 请检查此参数的值
biz.store.createssprice.invalid-biz:131 该活动中不存在该商品,不能删除 请检查此参数的值
biz.store.createssprice.invalid-biz:132 商品促销价没有做修改 请检查此参数的值
biz.store.createssprice.invalid-biz:133 商品不能全部被删除 请检查此参数的值
biz.store.createssprice.invalid-biz:134 活动没有任何修改 请检查此参数的值
biz.store.createssprice.invalid-biz:135 创建失败,您修改的商品在同时段有参与其它活动 请检查此参数的值
biz.store.createssprice.invalid-biz:136 修改失败,商品全部互斥,请检查活动时间 请检查此参数的值
biz.store.createssprice.invalid-biz:137 PC端创建的活动不能被修改 请检查此参数的值
公共异常码
API工具
FAQ