2018 年有赞接口更新（ 1 月）

2018 年有赞接口更新（1 月）

前言

2018 年 1 月有 7 项接口及消息推送优化：

• 新增|订单备注消息
• 新增|客户消息
• 新增|自定义会员价查询接口和消息
• 新增|退款列表
• 新增|规格查询接口
• 优化|规则卡接口
• 优化|优惠券码接口
  
  

详细内容

• 新增订单备注消息
  背景：
  第三方合作伙伴需要实时接收订单备注信息，根据订单备注调整货物、发货门店或收货地址。
  使用场景：
  买家在有赞店铺买水果，付款完成后，发现有的水果需要进一步处理，买家联系客服处理。客服在店铺后台对该笔订单增加交易备注，比如菠萝需要削皮。有赞推送备注消息至三方系统，系统更新订单信息，并将信息更新至门店系统。门店店员在门店系统接单，根据订单信息备货，联系物流人员发货。
  使用说明：
  1）商家后台开启「订单备注事件数据变更推送」
  2）开发者控制台设置好推送网址以及勾选「订单备注事件」
  以上设置好后，如果订单备注有变更，有赞会推送订单备注消息至三方系统
  推送的详细内容参考订单备注事件
• 新增客户消息
  背景：
  第三方合作伙伴需要实时接收客户创建、更新消息，同步至系统，保证有赞与门店客户数据一致。
  使用场景：
  买家关注微信公众号，从自定义菜单进入有赞微商城，购买商品成功，有赞自动创建买家帐号，推送至三方系统。
  使用说明：
  1）商家后台开启「客户消息事件数据变更推送」
  file:///Users/maye_shaw/Documents/pasted-image.png?lastModify=1518332305
  2）开发者控制台设置好推送网址以及勾选「客户消息事件」
  file:///Users/maye_shaw/Desktop/%E9%A6%96%E9%A1%B5%E5%92%8C%E6%A1%88%E4%BE%8B/pasted-image.png?lastModify=1518332305
  以上设置好后，如果客户信息变更，有赞会推送客户消息至三方系统
  推送的详细内容参考客户消息事件
• 新增自定义会员价查询接口和消息
  背景：
  App开店商家需要将自定义的会员价展示在商品列表及商品详情页，以刺激买家购买会员卡。
  使用场景：
  商家在有赞店铺后台设置商品自定义会员价，有赞推送至三方系统，三方系统获取商品ID，调用自定义会员价接口，获取商品自定义会员价详情，展示在App。买家在 App 购买商品，查看商品原价及会员价，先购买会员卡，再按会员价购买商品。
  使用说明：
  1）商家后台开启「自定义会员价状态事件数据变更推送」
  2）开发者控制台设置好推送网址以及勾选「自定义会员价状态事件」
  以上设置好后，如果商品自定义会员价有变更，有赞会推送消息至三方系统，三方系统调用接口获取详情。
  推送的详细内容参考自定义会员价事件
  接口的详细内容参考youzan.ump.memberprice.query
• 新增退款列表
  背景：
  第三方合作伙伴需要拉取退款信息，以同步至系统，保证有赞与门店退款数据一致。
  使用场景：
  买家在有赞店铺申请退款，三方系统定时拉取退款信息，客服处理退款。
  使用说明：
  参考youzan.trade.refund.search
• 新增规格查询接口
  背景：
  第三方合作伙伴需要通过规格 ID 查询规格信息，以做展示。
  使用场景：
  买家在第三方合作伙伴自开发的小程序里，查看商品详情，点击具体的规格，加入购物车。三方系统通过规格 ID 查询价格等规格信息并前端展示。买家确认规格信息无误，提交订单，付款购买成功。
  使用说明：
  参考youzan.item.sku.get
• 优化规则卡接口
  背景：
  第三方合作伙伴需要创建规则卡、查询规则卡、更新规则卡，以保证三方系统数据与有赞店铺会员卡数据一致。
  使用场景：
  买家在门店办规则卡即满足条件可自动升级的会员卡，手机扫描领卡二维码，填写会员信息，领取会员卡，有赞推送消息至三方系统，三方系统保存会员及会员卡信息。买家在门店消费，对收银员出示有赞会员卡二维码，收银员扫描会员卡，扫描商品二维码及付款码，三方系统生成门店折扣订单。
  使用说明：
  增加了 card_type、GrantCondition、level 三个字段，分别对应卡的类型（无门槛卡、规则卡）、卡的升级条件（满足多少笔订单，满足多少订单金额，满足多少积分）、卡的等级。
  主要涉及接口如下：
  
  
  • youzan.scrm.card.create
  • youzan.scrm.card.get
  • youzan.scrm.card.update
  • youzan.scrm.card.list
  • youzan.scrm.customer.card.list
    
    
  接口的详细内容参考会员卡API
• 优化优惠券码接口
  背景：
  第三方合作伙伴需要创建优惠券码、查询优惠券码、更新优惠券码，以保证三方系统优惠券码数据与有赞店铺数据一致。
  使用场景：
  买家在 App 的用户中心查看优惠券，点击立即了使用，进入有赞店铺，用优惠券消费。买家在门店消费，出示优惠券二维码，收银员扫描二维码，扫描商品，扫描付款码，三方系统生成门店折扣订单。
  使用说明：
  主要涉及接口如下：
  
  
  • 新增优惠码查询接口 youzan.ump.promocode.detail.get
  • 新增买家端查询优惠码接口 youzan.ump.promocode.buyer.search
  • 新增买家端查询优惠券接口 youzan.ump.promocard.buyer.search
  • 通过核销码查询优惠券码接口 youzan.ump.coupon.consume.get 增加具体核销金额字段
    
    
  接口的详细内容参考优惠券码API
  
  

名词解释

第三方合作伙伴：与有赞打通，一起为商家提供系统服务的服务商。

三方系统：第三方合作伙伴与有赞直接有数据交互的系统。

门店系统：门店的收银系统、POS 系统等。

有赞开放平台技术支持团队

2018 年 1 月 8 日