请选择 进入手机版 | 继续访问电脑版

有赞新零售社区

发帖
有赞云历史板块»2018 年有赞接口更新( 1 月)

2018 年有赞接口更新( 1 月)

有赞-白及 2018-02-11 4476 浏览 0 评论 | [显示全部楼层] [打印]
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
  • 新增退款列表
    背景:
    第三方合作伙伴需要拉取退款信息,以同步至系统,保证有赞与门店退款数据一致。
    使用场景:
    买家在有赞店铺申请退款,三方系统定时拉取退款信息,客服处理退款。
    使用说明:
  • 新增规格查询接口
    背景:
    第三方合作伙伴需要通过规格 ID 查询规格信息,以做展示。
    使用场景:
    买家在第三方合作伙伴自开发的小程序里,查看商品详情,点击具体的规格,加入购物车。三方系统通过规格 ID 查询价格等规格信息并前端展示。买家确认规格信息无误,提交订单,付款购买成功。
    使用说明:
  • 优化规则卡接口
    背景:
    第三方合作伙伴需要创建规则卡、查询规则卡、更新规则卡,以保证三方系统数据与有赞店铺会员卡数据一致。
    使用场景:
    买家在门店办规则卡即满足条件可自动升级的会员卡,手机扫描领卡二维码,填写会员信息,领取会员卡,有赞推送消息至三方系统,三方系统保存会员及会员卡信息。买家在门店消费,对收银员出示有赞会员卡二维码,收银员扫描会员卡,扫描商品二维码及付款码,三方系统生成门店折扣订单。
    使用说明:
    增加了 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 日      
                                                                                                                                                                  


2018 年有赞接口更新(1 月).pdf

1.28 MB , 下载次数: 154

    您需要登录后才可以回帖 登录 | 立即注册

    本版积分规则

    复制链接
    新浪微博
    QQ空间
    微信扫码
    • 回复

    • 评分

    客服工作时间是9:00-18:00,客服妹子当前不在线,若不能及时回复请谅解。试试右上角的搜索吧,论坛有丰富的经验贴、公告贴,相信一定能够帮到您~

    复制成功