退出
热词搜索：
API接口目录

平台业务

商品API
价格API
库存API
销售准备API
交易API
退货退款API（新）
财务API
店铺API
物流API
促销API
分销API
发票API
招商API
换货API
互动营销API
退货退款API
客服API
平台营销API
风控API
会员通API
账房API
财务记账API
异常码自查工具
suning.custom.shopcoupon.add 店铺优惠券活动新增
￥免费

通过此接口可店铺优惠券活动新增

公共参数
请求参数
名称 类型 是否必须 示例值 描述
activityNameStringN0元购活动名称。不超过32个字符
startTimeStringN2015-06-18 20:26:47活动开始时间。即返券开始时间，不得早于系统当前时间
endTimeStringN2015-07-18 20:26:47活动结束时间。即返券结束时间，不得早于开始时间，时间跨度180天
activityPatternStringN1活动方式。1：顾客领取
showRegionStringN1展示区域。1：四级和聚合页展示
activityTimesLimitStringN100发行量。券张数，1~999999999
assignedRoleStringN0领券对象。选项：0不限、1仅限苏宁员工
rewardAmountStringN100券面额。1~1000的整数
couponTypeStringN1券类型。1：店铺易券
baseAmountStringN100使用金额。券类型1：订单满X元使用，X为1~999999999（9个9）之间的金额；
peopleActivityTimesLimitStringN1每人限领。0代表不限、1、2、3、4、5
effectStartTimeStringN2015-07-18券生效日期。精确到天；
effectEndTimeStringN2015-08-18券失效日期。精确到天
channelInfoStringN3用券渠道。1代表PC，2代表移动端，3PC和移动端
productRangeStringN1商品活动范围类型。1全店铺；2部分商品，最少添加1个商品（SKU），最多添加500个商品（SKU）；3全店铺排除部分商品
productListStringN
productCodeStringN1111111111苏宁商品编码。当商品活动范围类型=2与3时，苏宁商品编码必填。
响应参数
名称 类型 示例值 描述
activityCodeString42342342促销活动ID。活动ID
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <addShopCoupon>
      <activityPattern>1</activityPattern>
      <channelInfo>3</channelInfo>
      <couponType>1</couponType>
      <productList>
        <productCode>1111111111</productCode>
      </productList>
      <showRegion>1</showRegion>
      <effectEndTime>2015-08-18</effectEndTime>
      <endTime>2015-07-18 20:26:47</endTime>
      <assignedRole>0</assignedRole>
      <startTime>2015-06-18 20:26:47</startTime>
      <baseAmount>100</baseAmount>
      <rewardAmount>100</rewardAmount>
      <effectStartTime>2015-07-18</effectStartTime>
      <activityName>0元购</activityName>
      <activityTimesLimit>100</activityTimesLimit>
      <peopleActivityTimesLimit>1</peopleActivityTimesLimit>
      <productRange>1</productRange>
    </addShopCoupon>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "addShopCoupon": {
        "activityPattern": "1",
        "channelInfo": "3",
        "couponType": "1",
        "productList": {
          "productCode": "1111111111"
        },
        "showRegion": "1",
        "effectEndTime": "2015-08-18",
        "endTime": "2015-07-18 20:26:47",
        "assignedRole": "0",
        "startTime": "2015-06-18 20:26:47",
        "baseAmount": "100",
        "rewardAmount": "100",
        "effectStartTime": "2015-07-18",
        "peopleActivityTimesLimit": "1",
        "activityTimesLimit": "100",
        "activityName": "0元购",
        "productRange": "1"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_body>
    <addShopCoupon>
      <activityCode>42342342</activityCode>
    </addShopCoupon>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "addShopCoupon": {
        "activityCode": "42342342"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.custom.addshopcoupon.missing-parameter:* 缺少必填参数,*表示字段名 请输入正确参数。
isp.sys.service.unavailable.mpms 服务不可用（系统异常） 请联系苏宁技术人员。
biz.custom.addshopcoupon.format-error:* 格式错误,*表示字段名 请输入正确参数1。
biz..addshopcoupon.enumeration-error:* 可选值错误,*表示字段名 请输入正确参数。
biz..addshopcoupon.format-error:* 格式错误,*表示字段名 请输入正确参数。
biz..addshopcoupon.missing-parameter:* 缺少必填参数,*表示字段名 请输入正确参数。
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ

Q：店铺优惠券活动新增接口如何使用？

A：通过此接口可店铺优惠券活动新增