有赞云开发者大赛 - 会员全渠道打通场景文档
目标场景
大型品牌商家，往往会在官网、天猫、京东等多个线上渠道经营，同时线下也有自己的门店。商家自己维护了一套会员系统，各渠道都打通了会员数据。商家在接入有赞商城时，希望用户在有赞商城也能享有之前的会员身份。
业务流程
会员创建
备注：
- 会员是客户的一种身份，是客户的一个子集
- 对于微商城，客户领取权益卡或获得等级将成为会员
会员更新
技术方案
会员创建
1. 实现创建会员扩展点，用户在有赞成为会员时，调用有赞云 ISV 应用创建会员扩展点实现。
2. 有赞云 ISV 应用根据有赞会员系统传过来的会员信息（手机号）调用商家会员校验接口判断该用户是否存在商家系统中。
3. 若商家系统中的会员是微信帐号体系，那么可以根据 2 中返回的手机号调用 youzan.user.weixin.openid.get，根据手机号获取用户 open_id 和 union_id ，然后调用商家会员校验接口判断该用户是否存在商家系统中。
4. 如果会员存在则直接返回成功给会员系统，不存在则去调用商家创建接口进行会员创建操作，并返回创建结果到有赞商城。
会员信息获取
1. 实现获取会员信息扩展点，用户访问商品详情时会读取会员信息，调用有赞云 ISV 应用获取会员信息扩展点实现
2. 有赞云 ISV 应用根据有赞会员系统传过来的的会员 Id 去数据库中查询相应的商家会员编号
3. 有赞云 ISV 应用通过商家会员编号去调用商家系统获取会员信息接口获取会员信息
4. 有赞云 ISV 应用组装会员信息返回有赞会员系统
会员信息更新
1. 实现 修改会员扩展点，有赞会员在修改会员信息时，调用有赞云 ISV 应用修改会员扩展点实现
2. 有赞云 ISV 应用根据有赞会员系统传过来的的会员 Id 去数据库中查询相应的商家会员编号
3. 有赞云 ISV 应用通过商家会员编号去调用商家系统更新会员信息接口更新会员信息
4. 有赞云 ISV 应用组装是否修改成功内容返回给有赞会员系统
涉及扩展点 /API
| 扩展点 /API 名称 | 应用场景 |
|---|---|
| 创建客户扩展点 | 当有赞商城增加新客户时，在商家系统创建客户 |
| 创建会员扩展点 | 当有赞商城增加新会员时，在商家系统创建会员 |
| 修改客户扩展点 | 当有赞商城客户信息更新时，在商家系统更新客户 |
| 修改会员扩展点 | 当有赞商城会员信息更新时，在商家系统更新会员 |
| 客户会员信息查询扩展点 | 从商家系统获取客户 / 会员信息，用于有赞商城展示 |
| 获取会员等级扩展点 | 从商家系统获取会员等级，不返回具体权益信息，仅用于商城页面展示等级值 |
| 获取可用会员等级列表扩展点 | 系统获取会员等级，返回具体权益，用户可在商城使用会员等级，例如下单计算优惠 |
| youzan.user.weixin.openid.get | 根据手机号获取 openid 和 unionid |
备注：
- 有赞系统中，会员是客户的一个子集，若开发者要实现客户的扩展点，需要同时实现会员的扩展点
- 如果一位用户先成为客户，后面又成为会员，则会先调用创建客户扩展点，再调用成为会员扩展点