商業(yè)地產(chǎn)集團化管理信息項目微信接口解決方案

1、編號：ZSSZ-MY招商商置商業(yè)地產(chǎn)集團化管理信息項目微信接口解決方案文檔類型：調(diào)研紀要創(chuàng)立時間：2013年10月18日最后更新：2013年11月09日目錄1、需求概述及分析31)需求概述32)應用現(xiàn)狀32、目的和范圍41)目的42)范圍43、接口方式41)項目唯一標識42)客流/車流數(shù)據(jù)匯總標準表54、方案簽字確認8通過對招商商置蛇口花園城及海上世界項目市場推廣部、IT部門的業(yè)務調(diào)研，明源項目實施小組對微信會員應用需求有了一個基本的了解，在此基礎上結(jié)合實際情況擬定會員管理系統(tǒng)（科脈）與微信應用（地幔）接口的解決方案。該方案分為三個部分：1、需求概述及分析； 2、解決方案目標范圍；3、系統(tǒng)接口

2、標準。 1、 需求概述及分析1) 需求概述通過會員管理系統(tǒng)與微信的接口，實現(xiàn)微信會員享受會員積分等實體會員權(quán)益，微信會員與實體會員的身份綁定，并且通過微信端實現(xiàn)積分兌換禮品等。2) 應用現(xiàn)狀u 目前花園城的會員體系分為兩種實體會員（即線下會員）和微信會員（即線上會員），實體會員由會員管理系統(tǒng)管理，微信會員則與“微生活會員卡”合作。u 實體會員分為三個級別，銀卡、金卡、白金卡，分別享受積分、折扣等權(quán)益；微信會員只有一個級別，僅能享受促銷信息推送、互動交流等權(quán)益。目前兩種會員體系相互獨立、未打通，微信會員無法享受實體會員權(quán)益。2、目的和范圍 1) 目的實現(xiàn)會員管理系統(tǒng)（科脈）與微信會員（地幔）的集

3、成，實現(xiàn)實體會員與微信會員打通，通過微信端識別會員身份，并能享受實體會員的權(quán)益，實現(xiàn)微信端預訂積分兌換禮品等。2) 范圍 會員管理系統(tǒng)提供會員資料，會員積分記錄、消費記錄等信息至微信端，以查詢會員信息； 微信端提供新增會員信息、預訂積分兌換禮品等信息至會員管理系統(tǒng)。3、接口方式 1) POS接口規(guī)劃序號接口名稱提供方接口說明1科脈地幔綁定會員資料2科脈地幔會員查詢3地?？泼}新增虛擬會員4地?？泼}禮品兌換注：上述接口均以WebServices方式實現(xiàn)。接口的通訊技術采用web service，函數(shù)返回值的數(shù)據(jù)為XML或JSON格式的字符串，科脈與地幔接口采用JSON。基本原則為誰提供數(shù)據(jù)誰開發(fā)接

4、口函數(shù)，誰需要數(shù)據(jù)誰調(diào)用函數(shù)。該WEB服務中可以提供一個或多個函數(shù)，每個函數(shù)都有獨立的功能，web service服務可以提供給包括但不限于基于以下開發(fā)平臺和語言在內(nèi)的程序使用：.Net、Java、PB、Delphi。2) 接口詳細說明科脈與地幔的接口主要涉及與會員卡有關的內(nèi)容，包括在微信上建立招商的虛擬會員卡，與已有的實體會員卡綁定，查詢會員積分，查詢會員歷史消費情況，積分兌換商品等功能。科脈POS的會員卡系統(tǒng)中，需要做如下調(diào)整：l 會員卡資料表增加微信號字段l 增加會員積分微信兌換表a) 會員注冊本接口主要用于支持已有微信帳戶，但還不是招商花園城的會員，在微信上直接注冊成為招商花園城的會員

5、（在招商花園城的會員卡資料表中生成會員資料）接口函數(shù)參數(shù)：名稱字段名字段類型備注微信號wexinIDvarchar(25)手機號phonenumbervarchar(13)驗證碼verifycodevarchar(6)在微信上驗證手機號的有效性校驗碼signaturevarchar(255)用于驗證接口參數(shù)的有效性MD5(wexinID+ phonenumber)返回值：名稱字段名字段類型備注會員卡號cardnumbervarchar(20)狀態(tài)successchar(1)1: 成功; -1: 失敗錯誤信息errormsgvarchar(255)b) 微信與會員卡綁定本接口主要用于支持已有微信

6、帳戶，并且已是招商花園城的會員，在微信上將微信號與會員卡綁定（寫入會員卡表中的微信號字段）接口函數(shù)參數(shù)：名稱字段名字段類型備注微信號wexinIDvarchar(25)手機號phonenumbervarchar(13)會員卡號cardnumbervarchar(20)已經(jīng)存在的會員卡號驗證碼verifycodevarchar(6)在微信上驗證手機號的有效性校驗碼signaturevarchar(255)用于驗證接口參數(shù)的有效性MD5(wexinID+phonenumber+cardnumber)返回值：名稱字段名字段類型備注微信號weixinIDvarchar(20)狀態(tài)successvarc

7、har(20)1: 成功; -1: 失敗錯誤信息errormsgvarchar(255)c) 微信會員信息修改微信用戶注冊或綁定招商花園城會員卡后，如果手機號發(fā)生了變化，可以通過本接口修改手機號。微信用戶也可以通過該接口修改或完善個人資料，如姓名，生日，地址等。接口函數(shù)參數(shù)：名稱字段名字段類型備注微信號wexinIDvarchar(25)手機號phonenumbervarchar(13)會員卡號cardnumbervarchar(20)新手機號newphonenumbervarchar(13)驗證碼verifycodevarchar(6)新手機號的驗證碼其他信息如果不為空，則修改發(fā)生校驗碼si

8、gnaturevarchar(255)用于驗證接口參數(shù)的有效性MD5(wexinID+newphonenumber+cardnumber)返回值：名稱字段名字段類型備注微信號weixinIDvarchar(20)狀態(tài)successvarchar(20)1: 成功; -1: 失敗錯誤信息errormsgvarchar(255)d) 會員卡基本信息查詢本接口用于查詢會員卡基本信息。接口函數(shù)參數(shù)：名稱字段名字段類型備注微信號wexinIDvarchar(25)手機號phonenumbervarchar(13)會員卡號cardnumbervarchar(20)校驗碼signaturevarchar(2

9、55)用于驗證接口參數(shù)的有效性MD5(wexinID+phonenumber+cardnumber)返回值：名稱字段名字段類型備注卡類型typeint會員卡類型01：普通卡，02：銀卡，03：金卡積分pointint當前積分狀態(tài)successvarchar(20)1: 成功; -1: 失敗錯誤信息errormsgvarchar(255)e) 禮品兌換列表及庫存本接口用于會員在微信上查詢禮品可兌換列表。接口函數(shù)參數(shù)：名稱字段名字段類型備注微信號wexinIDvarchar(25)可以不填寫會員卡類型type可能會根據(jù)不同卡的類型返回可兌換禮品校驗碼signaturevarchar(255)用于驗

10、證接口參數(shù)的有效性MD5(wexinID+phonenumber+cardnumber)返回值：名稱字段名字段類型備注禮品giftjson結(jié)構(gòu)體，包含禮品名稱，貨號，剩余庫存，所需積分。狀態(tài)successvarchar(20)1: 成功; -1: 失敗錯誤信息errormsgvarchar(255)f) 會員卡積分兌換申請本接口用于會員在微信上申請用積分兌換商品。兌換申請?zhí)峤缓?，是否需要立即扣減積分，需要確認。（確認結(jié)果：不立即扣減積分及庫存，但是會鎖定積分及庫存，會員持兌換碼線下兌換成功后扣減積分和庫存）兌換申請?zhí)峤缓螅绻蛻舨坏降昀飪稉Q，該申請是否過一段時間就取消，需要確認。（確認結(jié)果：

11、兌換碼有有效期限制，為可變參數(shù)，待定為7天，當有效期過后，該兌換碼失效，積分和庫存解除鎖定）接口函數(shù)參數(shù)：名稱字段名字段類型備注微信號wexinIDvarchar(25)手機號phonenumbervarchar(13)會員卡號cardnumbervarchar(20)積分poingint本次兌換需要扣減的積分貨號plucodevarchar(20)兌換商品的貨號校驗碼signaturevarchar(255)用于驗證接口參數(shù)的有效性MD5(wexinID+phonenumber+cardnumber)返回值：名稱字段名字段類型備注兌換碼redeemcodeint本次兌換請求產(chǎn)生的兌換碼，顧客

12、憑此碼到店內(nèi)領取商品狀態(tài)successvarchar(20)1: 成功; -1: 失敗錯誤信息errormsgvarchar(255)g) 會員卡積分兌換取消本接口用于會員在微信上取消已經(jīng)申請的兌換號。接口函數(shù)參數(shù)：名稱字段名字段類型備注微信號wexinIDvarchar(25)手機號phonenumbervarchar(13)會員卡號cardnumbervarchar(20)兌換號redeemcodeint本次兌換需要扣減的積分校驗碼signaturevarchar(255)用于驗證接口參數(shù)的有效性MD5(wexinID+phonenumber+cardnumber)返回值：名稱字段名字段類

13、型備注兌換碼redeemcodeint狀態(tài)successvarchar(20)1: 成功; -1: 失敗錯誤信息errormsgvarchar(255)h) 會員卡積分兌換歷史查詢本接口用于會員在微信上查詢積分兌換的歷史情況。接口函數(shù)參數(shù)：名稱字段名字段類型備注微信號wexinIDvarchar(25)手機號phonenumbervarchar(13)會員卡號cardnumbervarchar(20)開始時間fromdatetimeyyyy/mm/dd結(jié)束時間todatetimeyyyy/mm/dd校驗碼signaturevarchar(255)用于驗證接口參數(shù)的有效性MD5(wexinID+

14、phonenumber+cardnumber)返回值：名稱字段名字段類型備注歷史情況historyint可以是一個結(jié)構(gòu)體，里面有查詢時間范圍內(nèi)的兌換碼兌換情況狀態(tài)successvarchar(20)1: 成功; -1: 失敗錯誤信息errormsgvarchar(255)i) 會員卡消費歷史情況查詢本接口用于會員在微信上查詢歷史消費情況。接口函數(shù)參數(shù)：名稱字段名字段類型備注微信號wexinIDvarchar(25)手機號phonenumbervarchar(13)會員卡號cardnumbervarchar(20)開始時間fromdatetimeyyyy/mm/dd結(jié)束時間todatetimeyyyy/mm/dd校驗碼signaturevarchar(255)用于驗證接口參數(shù)的有效性MD5(wexinID+phonenumber+cardnumber)返回值：名稱字段名字段類