文档中心 > 店铺动态卡片-开发指引

店铺动态卡片-开发指引

拼团购

更新时间：2023/07/06 访问次数：7259

拼团购是个性化定制平台为淘宝和天猫商家提供的营销场景交易玩法，适用于消费者自主发起的小团（例如：3或5人成团），借助消费者个人社交关系分享，让拼团者都能以优惠的价格购买。成团以参与人数为条件（例如：设置成团目标数为5，必须有5人参团才拼团成功）。允许任意用户开团，但同一用户不能重复开团。


一、流程说明


1.商家通过服务商提供的商家端应用创建团购活动

2.用户在小程序端可以选择开团，或者加入某个团中

3.在设置的成团有效期内，若团人数达到预期，则拼团成功，若团人数未达预期，则根据商家设置的规则，可以对已参团的用户自动关单，商家也可以选择对已参团的用户继续完成交易，选择发货。


二、应用开发

1. 服务端侧开发


相关后端接口简介。


1） 创建团购活动


taobao.opentrade.group.sync

接口创建团购活动，对于未开始的团购活动也可调用该接口更新团购活动信息，对于已开始的团购活动则不允许进行更新。


2） 查询团购活动


taobao.opentrade.group.activtiy.query

查询商品已参与的团购活动。


3） 用户开团


taobao.opentrade.group.open

可以让用户创建一个团，创建成功返回group_id。


4） 用户参团


taobao.opentrade.group.join

组团购场景下，用户参团。


5） 查询商品组团详情


taobao.opentrade.group.query

查询与商品关联的所有团的详情。


6） 查询团详情


taobao.opentrade.group.detail

根据group_id查询对应团的详情。


7） 查询参团用户信息


taobao.opentrade.group.member.info

获取用户参团后的信息，包括用户是否付款。


8） 获取订单列表


taobao.opentrade.group.order

根据group_id获取该团的订单列表。


9） 绑定商品


taobao.opentrade.tools.items.bind

交易开放商品绑定。


10）商品解绑


taobao.opentrade.tools.items.unbind

交易开放商品解绑。


11）查询已绑定的商品


taobao.opentrade.tools.items.query

交易开放获取商品绑定信息。


2. 小程序侧开发


用户开团，或者用户参团后都需要从小程序跳转到订单页，使用my.tb.confirmCustomOrder进行下单，下单时需要在customization字段中传入groupId，否则不支持改价。


代码示例

my.tb.confirmCustomOrder({  
    data:{  
       'itemId':globalData.itemId,  
       'skuId':globalData.skuId,  
       'quantity':1,  
       'customization':{  
           'groupId': this.data.groupId //用户开团成功后返回的groupId  
       }  
    },  
    success:function(res){  
      console.log({content:JSON.stringify(res)})  
    },  
    error:function(res){ 
      my.alert({content: JSON.stringify(res)}) 
    } 
})


例如一件商品原价为10元，设置团购价为6元。若正确下单，则购买时商品单价为团购价，即设置的6元。


82.png


若下单时没有传groupId，则购买时为商品原价，即10元。


83.png


当用户参与一个已过期的团时，会提示用户该团已过期，请重新下单。


84.png


3. 应用测试


在应用开发阶段可以使用平台提供的测试商品进行测试。


1.png


三、注意事项


1.商家需要先在个性化定制平台导入商品，才能为商品创建团购活动

2.成团有效期最长不能超过24小时

3.团购活动中设置的优惠价不能低于店铺配置的最低折扣，若店铺未配置最低折扣，则默认最低折扣为7折。例如，一件商品为10元，店铺的最低折扣为7折，那么团购活动这是的优惠价不能低于10 * 0.7，也就是7元。

4.拼团成功与否在于成团期限内，成功参团并付款的人数是否超过设置的目标数。例如，商家创建了一个团购活动，配置的成团有效期为6小时，成团目标数为5人。若6小时之内，有5人及以上的用户参团并且付款，则拼团成功。假设有10个用户参团了，但是只有4个用户付款，那么拼团失败。假设在一个小时后，就有5个用户参团并且付款，拼团成功，因为该团未过期，其他用户可以继续参加该团。

5. 对于拼团失败，有两种处理方式，一是自动关单退款，二是继续交易。对于前者，当团过期之后，已付款用户自动退款，未付款用户自动关闭交易。对于后者将会解除hold单状态，商家可以进行发货。


四、商家履约

1. 未成团


用户成功下单之后，商家可以在卖家后台看到这笔订单处于hold单状态，不能发货。


86.png


用户参团成功，但是未付款，当团过期之后，系统会自动关闭订单。


87.png


当团过期之后，如拼团失败且商家设置拼团失败关单，对于已付款的用户，系统会自动退款，消费者侧退款详情如下图。


88.png


未成团造成的系统关单不影响店铺退款率。


2. 已成团


成团之后，所有团员的订单解除hold状态，商家可以在卖家后台正常处理这些订单。


FAQ

关于此文档暂时还没有FAQ
有用(0) 我要提问
返回
顶部
阿里巴巴集团 | 淘宝网 | 天猫 | 聚划算 | 全球速卖通 | 阿里巴巴国际交易市场 | 1688 | 阿里妈妈 | 阿里旅行·去啊 | 阿里云计算 | YunOS | 阿里通信 | 万网 | 高德 | 优视 | 友盟 | 酷盘 | 虾米 | 天天动听 | 来往 | 钉钉 | 11Main | 支付宝
关于淘宝 合作伙伴 营销中心 联系客服 开放平台 诚征英才 联系我们 网站地图 法律声明 © 2016 Taobao.com 版权所有
网络文化经营许可证：文网文[2010]040号 | 增值电信业务经营许可证：浙B2-20080224-1 | 信息网络传播视听节目许可证：1109364号