商业地产集团化管理信息项目微信接口解决方案

1、编号：ZSSZ-MY招商商置商业地产集团化管理信息项目微信接口解决方案文档类型：调研纪要创立时间：2013年10月18日最后更新：2013年11月09日目录1、需求概述及分析31)需求概述32)应用现状32、目的和范围41)目的42)范围43、接口方式41)项目唯一标识42)客流/车流数据汇总标准表54、方案签字确认8通过对招商商置蛇口花园城及海上世界项目市场推广部、IT部门的业务调研，明源项目实施小组对微信会员应用需求有了一个基本的了解，在此基础上结合实际情况拟定会员管理系统（科脉）与微信应用（地幔）接口的解决方案。该方案分为三个部分：1、需求概述及分析； 2、解决方案目标范围；3、系统接口

2、标准。 1、 需求概述及分析1) 需求概述通过会员管理系统与微信的接口，实现微信会员享受会员积分等实体会员权益，微信会员与实体会员的身份绑定，并且通过微信端实现积分兑换礼品等。2) 应用现状u 目前花园城的会员体系分为两种实体会员（即线下会员）和微信会员（即线上会员），实体会员由会员管理系统管理，微信会员则与“微生活会员卡”合作。u 实体会员分为三个级别，银卡、金卡、白金卡，分别享受积分、折扣等权益；微信会员只有一个级别，仅能享受促销信息推送、互动交流等权益。目前两种会员体系相互独立、未打通，微信会员无法享受实体会员权益。2、目的和范围 1) 目的实现会员管理系统（科脉）与微信会员（地幔）的集

3、成，实现实体会员与微信会员打通，通过微信端识别会员身份，并能享受实体会员的权益，实现微信端预订积分兑换礼品等。2) 范围 会员管理系统提供会员资料，会员积分记录、消费记录等信息至微信端，以查询会员信息； 微信端提供新增会员信息、预订积分兑换礼品等信息至会员管理系统。3、接口方式 1) POS接口规划序号接口名称提供方接口说明1科脉地幔绑定会员资料2科脉地幔会员查询3地幔科脉新增虚拟会员4地幔科脉礼品兑换注：上述接口均以WebServices方式实现。接口的通讯技术采用web service，函数返回值的数据为XML或JSON格式的字符串，科脉与地幔接口采用JSON。基本原则为谁提供数据谁开发接

4、口函数，谁需要数据谁调用函数。该WEB服务中可以提供一个或多个函数，每个函数都有独立的功能，web service服务可以提供给包括但不限于基于以下开发平台和语言在内的程序使用：.Net、Java、PB、Delphi。2) 接口详细说明科脉与地幔的接口主要涉及与会员卡有关的内容，包括在微信上建立招商的虚拟会员卡，与已有的实体会员卡绑定，查询会员积分，查询会员历史消费情况，积分兑换商品等功能。科脉POS的会员卡系统中，需要做如下调整：l 会员卡资料表增加微信号字段l 增加会员积分微信兑换表a) 会员注册本接口主要用于支持已有微信帐户，但还不是招商花园城的会员，在微信上直接注册成为招商花园城的会员

5、（在招商花园城的会员卡资料表中生成会员资料）接口函数参数：名称字段名字段类型备注微信号wexinIDvarchar(25)手机号phonenumbervarchar(13)验证码verifycodevarchar(6)在微信上验证手机号的有效性校验码signaturevarchar(255)用于验证接口参数的有效性MD5(wexinID+ phonenumber)返回值：名称字段名字段类型备注会员卡号cardnumbervarchar(20)状态successchar(1)1: 成功; -1: 失败错误信息errormsgvarchar(255)b) 微信与会员卡绑定本接口主要用于支持已有微信

6、帐户，并且已是招商花园城的会员，在微信上将微信号与会员卡绑定（写入会员卡表中的微信号字段）接口函数参数：名称字段名字段类型备注微信号wexinIDvarchar(25)手机号phonenumbervarchar(13)会员卡号cardnumbervarchar(20)已经存在的会员卡号验证码verifycodevarchar(6)在微信上验证手机号的有效性校验码signaturevarchar(255)用于验证接口参数的有效性MD5(wexinID+phonenumber+cardnumber)返回值：名称字段名字段类型备注微信号weixinIDvarchar(20)状态successvarc

7、har(20)1: 成功; -1: 失败错误信息errormsgvarchar(255)c) 微信会员信息修改微信用户注册或绑定招商花园城会员卡后，如果手机号发生了变化，可以通过本接口修改手机号。微信用户也可以通过该接口修改或完善个人资料，如姓名，生日，地址等。接口函数参数：名称字段名字段类型备注微信号wexinIDvarchar(25)手机号phonenumbervarchar(13)会员卡号cardnumbervarchar(20)新手机号newphonenumbervarchar(13)验证码verifycodevarchar(6)新手机号的验证码其他信息如果不为空，则修改发生校验码si

8、gnaturevarchar(255)用于验证接口参数的有效性MD5(wexinID+newphonenumber+cardnumber)返回值：名称字段名字段类型备注微信号weixinIDvarchar(20)状态successvarchar(20)1: 成功; -1: 失败错误信息errormsgvarchar(255)d) 会员卡基本信息查询本接口用于查询会员卡基本信息。接口函数参数：名称字段名字段类型备注微信号wexinIDvarchar(25)手机号phonenumbervarchar(13)会员卡号cardnumbervarchar(20)校验码signaturevarchar(2

9、55)用于验证接口参数的有效性MD5(wexinID+phonenumber+cardnumber)返回值：名称字段名字段类型备注卡类型typeint会员卡类型01：普通卡，02：银卡，03：金卡积分pointint当前积分状态successvarchar(20)1: 成功; -1: 失败错误信息errormsgvarchar(255)e) 礼品兑换列表及库存本接口用于会员在微信上查询礼品可兑换列表。接口函数参数：名称字段名字段类型备注微信号wexinIDvarchar(25)可以不填写会员卡类型type可能会根据不同卡的类型返回可兑换礼品校验码signaturevarchar(255)用于验

10、证接口参数的有效性MD5(wexinID+phonenumber+cardnumber)返回值：名称字段名字段类型备注礼品giftjson结构体，包含礼品名称，货号，剩余库存，所需积分。状态successvarchar(20)1: 成功; -1: 失败错误信息errormsgvarchar(255)f) 会员卡积分兑换申请本接口用于会员在微信上申请用积分兑换商品。兑换申请提交后，是否需要立即扣减积分，需要确认。（确认结果：不立即扣减积分及库存，但是会锁定积分及库存，会员持兑换码线下兑换成功后扣减积分和库存）兑换申请提交后，如果客户不到店里兑换，该申请是否过一段时间就取消，需要确认。（确认结果：

11、兑换码有有效期限制，为可变参数，待定为7天，当有效期过后，该兑换码失效，积分和库存解除锁定）接口函数参数：名称字段名字段类型备注微信号wexinIDvarchar(25)手机号phonenumbervarchar(13)会员卡号cardnumbervarchar(20)积分poingint本次兑换需要扣减的积分货号plucodevarchar(20)兑换商品的货号校验码signaturevarchar(255)用于验证接口参数的有效性MD5(wexinID+phonenumber+cardnumber)返回值：名称字段名字段类型备注兑换码redeemcodeint本次兑换请求产生的兑换码，顾客

12、凭此码到店内领取商品状态successvarchar(20)1: 成功; -1: 失败错误信息errormsgvarchar(255)g) 会员卡积分兑换取消本接口用于会员在微信上取消已经申请的兑换号。接口函数参数：名称字段名字段类型备注微信号wexinIDvarchar(25)手机号phonenumbervarchar(13)会员卡号cardnumbervarchar(20)兑换号redeemcodeint本次兑换需要扣减的积分校验码signaturevarchar(255)用于验证接口参数的有效性MD5(wexinID+phonenumber+cardnumber)返回值：名称字段名字段类

13、型备注兑换码redeemcodeint状态successvarchar(20)1: 成功; -1: 失败错误信息errormsgvarchar(255)h) 会员卡积分兑换历史查询本接口用于会员在微信上查询积分兑换的历史情况。接口函数参数：名称字段名字段类型备注微信号wexinIDvarchar(25)手机号phonenumbervarchar(13)会员卡号cardnumbervarchar(20)开始时间fromdatetimeyyyy/mm/dd结束时间todatetimeyyyy/mm/dd校验码signaturevarchar(255)用于验证接口参数的有效性MD5(wexinID+

14、phonenumber+cardnumber)返回值：名称字段名字段类型备注历史情况historyint可以是一个结构体，里面有查询时间范围内的兑换码兑换情况状态successvarchar(20)1: 成功; -1: 失败错误信息errormsgvarchar(255)i) 会员卡消费历史情况查询本接口用于会员在微信上查询历史消费情况。接口函数参数：名称字段名字段类型备注微信号wexinIDvarchar(25)手机号phonenumbervarchar(13)会员卡号cardnumbervarchar(20)开始时间fromdatetimeyyyy/mm/dd结束时间todatetimeyyyy/mm/dd校验码signaturevarchar(255)用于验证接口参数的有效性MD5(wexinID+phonenumber+cardnumber)返回值：名称字段名字段类