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)返回值：名稱字段名字段類