Coupon - 友好速搭 -- 使用手册

友好速搭

开放 API
使用说明 获取授权 全部 API 特殊 API 开放功能

Coupon

CouponGroup

CouponGroup 为网站的优惠券信息

CouponGroup 相关API

GET /coupon_groups获取优惠券列表GET /coupon_groups/:id获取优惠券列表PUT /coupon_groups/:id/deliver获取优惠券列表

CouponGroup 属性

    • id
    •   { "id": 1234 }
      
      Integer 类型,优惠券分组的ID。
    • name
    •   { "name" : "周年庆优惠券" }
      
      String 类型,优惠券的名称。
    • prefix
    •   { "prefix" : "ABCD"}
      
      String 类型,复用性优惠券的编码。
    • enable_mobile_regist
    •   { "active_amount" : 400}
      
      Integer 类型,优惠券的使用条件,订单满多少才可以使用。
    • discount_amount
    •   { "discount_amount" : 80}
      
      Integer 类型,优惠券的折扣,或者使用金额。
    • quantity_provided
    •   { "quantity_provided" : 1000 }
      
      Integer 类型,优惠券最大使用张数。
    • ctype
    • { "ctype" : "normal" }
      
      String 类型,优惠券的类型 normal:普通券,single:复用券。
    • atype
    • { "atype" : "single" }
      
      String 类型,优惠券顾客使用方式 single:每个顾客只允许使用一张,normal:每个顾客允许使用多张。
    • utype
    • { "utype" : "amount" }
      
      String 类型,优惠券的优惠方式 amount:金额 percentage: 折扣。
    • expired_at
    •   { "expired_at" : "http://standard.v.youhaosuda.com" }
      
      DateTime 类型,优惠券的过期时间。
    • no_expires
    •   { "no_expires" : true }
      
      Bool 类型,优惠券是否永久有效 true:永久有效 false: 有使用期限。
    • quantity_type
    •   { "quantity_type" : true }
      
      Bool 类型,优惠券是否不限制使用张数,只作用在复用型优惠券上,true表示不显示使用张数,false表示限制使用张数(此时配合quantity_provided来获取使用张数限制)。
    • used_amount
    •   { "used_amount" : 10}
      
      Number 类型,已经被使用(被领取、被使用)的优惠券数据。

GET /coupon_groups

获取优惠券列表

    • 获取优惠券列表
    • GET /coupon_groups
    • HTTP/1.1 200 OK

      {
      "coupon_groups": [
          {
              "active_amount": 0, 
              "actived_at": "2016-10-09T20:13:00.000+08:00", 
              "atype": "single", 
              "ctype": "normal", 
              "dealing": false, 
              "discount_amount": 1000, 
              "discount_percentage": null, 
              "expired_at": null, 
              "id": 1593, 
              "is_saved": true, 
              "name": "fvafew", 
              "no_expires": true, 
              "prefix": "", 
              "quantity_provided": 100, 
              "status": "actived", 
              "utype": "amount"
          }
      ]
      }
      

GET /coupon_groups/:id

获取单张优惠券信息

    • 获取单张优惠券信息
    • GET /coupon_groups/1593
    • HTTP/1.1 200 OK

      {
      "coupon_group": {
          "active_amount": 0, 
          "actived_at": "2016-10-09T20:13:00.000+08:00", 
          "atype": "single", 
          "ctype": "normal", 
          "dealing": false, 
          "discount_amount": 1000, 
          "discount_percentage": null, 
          "expired_at": null, 
          "id": 1593, 
          "is_saved": true, 
          "name": "fvafew", 
          "no_expires": true, 
          "prefix": "", 
          "quantity_provided": 100, 
          "status": "actived", 
          "utype": "amount"
      }
      }
      

PUT /coupon_groups/:id/deliver

派发优惠券

    • customer_ids
    • 必须,需要分配优惠券的顾客ID,Array类型
    • 派发优惠券
    • PUT /coupon_groups/1593/deliver
      {
          "customer_ids": [1,2]
      }
      
    • {}
      
以上内容仍未解决您的问题? 联系在线客服
友好速搭,让商业更简单
0元开始
联系客服
电话咨询
服务热线
0755-83051027
获取报价
QQ咨询
微信咨询
微信二维码
在线咨询

在线获取方案和报价,专人快速响应

所选城市 *

您的称呼 *

联系电话 *

网站类型 *

请选择
展示官网 电商网站 微信商城 小程序 其他类型

您希望我们为您提供哪些服务?(可多选)

B2C商城 跨境解决方案 B2B2C平台电商 网站备案 自营电商培训
获取报价

提交成功

你好, XXX女士/先生 ,你的需求已提交成功,后续会有专门的客户经理与你电话联系。谢谢!