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

电商能力输出业务

商品API
商品API
价格API
订单API
营销API
基础数据API
物流API
促销API
同城帮定制API
优惠券定制业务API
会员API
客服沟通咨询API
三方库存API
账单API
异常码自查工具
suning.online.receivefreecoupon.create 免费领券接口
￥免费

免费领券接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
couponGetSourceStringY1001领券渠道 （1001：四级页-PC 1002：四级页-WAP 1003：四级页-APP 1101：购物车页-PC 1102：购物车页-WAP 1103：购物车页-APP）
operateTypeStringY2操作类型 （1：查询 2：发放）
couponAmountStringN5券面值
activityIdStringY201806280000391246活动编码
activitySecretKeyStringYpuV2Lfm46us2NGVVFELKoOKe活动秘钥
memberNoStringY6001858356对接平台会员编号
chanIdStringY01操作渠道（01:PC，02:APP，03:WAP）
cityStringY北京市城市（苏宁城市名）
shopCodeStringN7611店铺编码
响应参数
名称 类型 示例值 描述
couponNameString满减券规则名称
couponRulesShowMsgString满50减5券规则展示信息
couponRuleCodeString11券使用规则Id
rewardsPreferentialString满50减5奖励优惠说明
couponTypeString10001券类型 （ 10001 云券 10002 限品类云券 10004 易券 10005 限品类易券 10009 无敌券 ）
couponNoString234534wew3ehh券号
couponAmountString5券面值
couponBalanceString5券余额
isNextCouponString1下次是否可领 （1：是 2：否）
couponStartTimeString2018-09-09 12:12:12券有效期开始日期
couponEndTimeString2019-01-02 12:12:12券有效期结束日期
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <createReceivefreecoupon>
      <activitySecretKey>puV2Lfm46us2NGVVFELKoOKe</activitySecretKey>
      <shopCode>7611</shopCode>
      <activityId>201806280000391246</activityId>
      <memberNo>6001858356</memberNo>
      <couponAmount>5</couponAmount>
      <city>北京市</city>
      <operateType>2</operateType>
      <chanId>01</chanId>
      <couponGetSource>1001</couponGetSource>
    </createReceivefreecoupon>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "createReceivefreecoupon": {
        "activitySecretKey": "puV2Lfm46us2NGVVFELKoOKe",
        "shopCode": "7611",
        "activityId": "201806280000391246",
        "memberNo": "6001858356",
        "couponAmount": "5",
        "city": "北京市",
        "operateType": "2",
        "chanId": "01",
        "couponGetSource": "1001"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_body>
    <createReceivefreecoupon>
      <couponEndTime>2019-01-02 12:12:12</couponEndTime>
      <couponBalance>5</couponBalance>
      <couponAmount>5</couponAmount>
      <couponName>满减</couponName>
      <couponRulesShowMsg>满50减5</couponRulesShowMsg>
      <isNextCoupon>1</isNextCoupon>
      <couponType>10001</couponType>
      <couponStartTime>2018-09-09 12:12:12</couponStartTime>
      <couponRuleCode>11</couponRuleCode>
      <couponNo>234534wew3ehh</couponNo>
      <rewardsPreferential>满50减5</rewardsPreferential>
    </createReceivefreecoupon>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "createReceivefreecoupon": {
        "couponEndTime": "2019-01-02 12:12:12",
        "couponBalance": "5",
        "couponAmount": "5",
        "couponName": "满减",
        "couponRulesShowMsg": "满50减5",
        "isNextCoupon": "1",
        "couponType": "10001",
        "couponStartTime": "2018-09-09 12:12:12",
        "couponRuleCode": "11",
        "couponNo": "234534wew3ehh",
        "rewardsPreferential": "满50减5"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.online.createreceivefreecoupon.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.online.createreceivefreecoupon.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.online.createreceivefreecoupon.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.online.createreceivefreecoupon.enumeration-error:* 参数的可选值错误 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.pangu 服务不可用 请联系苏宁技术人员
biz.online.createreceivefreecoupon.invalid-biz:101 请求参数JSON转换异常 请检查请求参数是否符合json格式
biz.online.createreceivefreecoupon.invalid-biz:102 会员编号转换异常，会员编号：* 请检查请求参数是否正确
biz.online.createreceivefreecoupon.invalid-biz:103 未查询到平台账号 请确认平台账号是否正确
biz.online.createreceivefreecoupon.invalid-biz:104 内部调用失败，错误码：*，错误描述：* 请参照具体错误信息修改或联系技术人员
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ