API接口目录

苏宁小店业务

门店API
商品API
店铺分类API
配送范围API
促销API
订单API
取消退款API
异常码自查工具
suning.store.ssshopcoupon.add 身边苏宁店铺优惠券创建活动
¥免费

身边苏宁店铺优惠券创建活动

公共参数
请求参数
名称 类型 是否必须 示例值 描述
shopCodeStringNS03017113苏宁门店编码
appStoreCodeStringN1111111商家自定义门店编码
activityNameStringY618大促发券活动活动名称
showRegionStringY1,81:商品详情页;8=店铺页,逗号隔开
activityStartTimeStringY到分,2018-01-01 00:00活动开始时间
activityEndTimeStringY到分 2018-01-01 00:00活动结束时间
circulationStringY正整数:1~999999999发行量
grantCountEverydayStringN正整数每天发放张数
voucheObjectStringY1:不限领券对象
denominationStringY正整数 1~3000券面额
couponTypeStringY1:店铺易券券类型
baseQuantifierTypeStringY1:满
baseAmountStringY正整数1~999999999使用门槛
limitCollarCountStringY0:不限 1:一张 2:二张 3:三张 4:四张 5:五张每人限领
limitCollarEveyDayStringY0:不限 1:一张 2:二张 3:三张 4:四张 5:五张每人每天限领
validityTypeStringY 1:固定时间 2:动态时间券有效期类型
effectiveStartTimeStringY到分 2018-01-01 00:00券有效期开始时间
effectiveEndTimeStringY到分钟2018-01-01 00:00券有效期结束时间
dynamicTimeStringN整数:0~90动态时间
dynamicDistanceTimeDelayStringN整数:0~90动态延迟天数
useChannelStrStringY多个以逗号隔开 55,56,57使用渠道 55=身边苏宁 APP 56=身边苏宁WAP 57=身边苏宁小程序
响应参数
名称 类型 示例值 描述
returnFlagStringY:成功 N:失败处理结果
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <addSsshopcoupon>
      <shopCode>S03017113</shopCode>
      <limitCollarEveyDay>0:不限  1:一张 2:二张 3:三张 4:四张 5:五张</limitCollarEveyDay>
      <grantCountEveryday>正整数</grantCountEveryday>
      <activityName>618大促发券活动</activityName>
      <effectiveEndTime>到分钟2018-01-01 00:00</effectiveEndTime>
      <activityStartTime>到分,2018-01-01 00:00</activityStartTime>
      <voucheObject>1:不限</voucheObject>
      <appStoreCode>1111111</appStoreCode>
      <baseAmount>正整数1~999999999</baseAmount>
      <showRegion>1,8</showRegion>
      <denomination>正整数 1~3000</denomination>
      <effectiveStartTime>到分 2018-01-01 00:00</effectiveStartTime>
      <useChannelStr>多个以逗号隔开 55,56,57</useChannelStr>
      <dynamicDistanceTimeDelay>整数:0~90</dynamicDistanceTimeDelay>
      <validityType> 1:固定时间 2:动态时间</validityType>
      <activityEndTime>到分 2018-01-01 00:00</activityEndTime>
      <baseQuantifierType>1:满</baseQuantifierType>
      <couponType>1:店铺易券</couponType>
      <circulation>正整数:1~999999999</circulation>
      <dynamicTime>整数:0~90</dynamicTime>
      <limitCollarCount>0:不限  1:一张 2:二张 3:三张 4:四张 5:五张</limitCollarCount>
    </addSsshopcoupon>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "addSsshopcoupon": {
        "shopCode": "S03017113",
        "limitCollarEveyDay": "0:不限  1:一张 2:二张 3:三张 4:四张 5:五张",
        "grantCountEveryday": "正整数",
        "activityName": "618大促发券活动",
        "effectiveEndTime": "到分钟2018-01-01 00:00",
        "activityStartTime": "到分,2018-01-01 00:00",
        "voucheObject": "1:不限",
        "appStoreCode": "1111111",
        "baseAmount": "正整数1~999999999",
        "showRegion": "1,8",
        "denomination": "正整数 1~3000",
        "effectiveStartTime": "到分 2018-01-01 00:00",
        "useChannelStr": "多个以逗号隔开 55,56,57",
        "dynamicDistanceTimeDelay": "整数:0~90",
        "validityType": " 1:固定时间 2:动态时间",
        "activityEndTime": "到分 2018-01-01 00:00",
        "baseQuantifierType": "1:满",
        "couponType": "1:店铺易券",
        "circulation": "正整数:1~999999999",
        "dynamicTime": "整数:0~90",
        "limitCollarCount": "0:不限  1:一张 2:二张 3:三张 4:四张 5:五张"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <addSsshopcoupon>
      <returnFlag>Y:成功 N:失败</returnFlag>
    </addSsshopcoupon>
  </sn_body>
</sn_responseContent>

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

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.store.addssshopcoupon.enumeration-error:* 参数的可选值错误 请检查此参数的值,*号表示参数字段名
biz.store.addssshopcoupon.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.mpms 服务不可用 请联系苏宁技术人员
biz.store.addssshopcoupon.invalid-biz:100 使用渠道不能为空 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:101 活动名称不能超过32个字符 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:102 展示区域参数必填 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:103 展示区域:商品详情页必选 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:104 活动开始时间格式不正确 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:105 活动结束时间格式不正确 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:106 活动结束时间需在当前时间之后 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:107 活动结束时间不在活动开始时间之前 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:108 活动时间最长跨度180天 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:109 发行量必须是小于999999999的正整数 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:110 每天发放张数必须是小于999999999的正整数 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:111 每天发放张数≤发行量 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:112 领券对象参数错误 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:113 券面额请输入1-3000之间的数字 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:114 请正确输入券类型 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:115 请正确输入奖励类型 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:116 请填写使用门槛 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:117 每人每天限领≤每人限领 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:118 每人每天限领≤每天发放张数 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:119 每人每天限领≤每人限领 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:120 请正确选择券有效时间类型 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:121 券有效开始时间格式不正确 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:122 券有效期开始时间需要在当前系统时间之后 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:123 券有效结束时间格式不正确 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:124 券有效结束时间需在券有效开始时间之后 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:125 券有效期最长跨度90天 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:126 活动结束时间不能大于券结束时间 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:127 动态时间不能为空 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:128 动态延迟天数不能为空 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:129 动态时间只能在1-90天之间 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:130 动态延迟天数只能在1-90天之间 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:131 用券渠道不合法 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:132 券面额最高为限制金额的80% 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:133 门店信息不存在 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:134 每人限领不能为空 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:135 每人每天限领不能为空 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:136 券面额不能为空 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:137 发行量不能为空 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:138 活动名称不能为空 请检查此参数的值
biz.store.addssshopcoupon.invalid-biz:139 展示区域输入有误 请检查此参数的值
公共异常码
API工具
FAQ