Scenario
This API is only needed if external system store member data and needs to sync it with EZR.
1. Customer sign up in WeChat, EZR will create a member and update data to external system (POS, website, etc.)
2. Customer edits his personal information in WeChat, EZR will update data to external system (POS, website, etc.)
Direction
EZR will call external system
Core Logic
External system need to recognize which scenario is involved:
a. Member creation
If field of “oldcode” is empty, it means this is a member creation process, external system needs to
1) Identify if there is a member with same mobile number locally;
2) If not, external system creates a new member based on EZR’s data and return results
3) If yes, return existed member’s data
b. Member editing
If field of “oldcode” is not empty, external system should modify existed member based on EZR’s data;
Process above is to prevent external system from creating duplicate members.
Request Parameters
Field | Type | Required | Length | Description |
Brand | string | Yes | 1~16 | Brand's name |
ChangeType | string | Yes | 1 | C=creation, U=edition, B=binding |
OldCode | string | Yes | 1~16 | Member's unique code (external system) |
Code | string | Yes | 1~16 | Member's unique code (in EZR) |
NickName | string | 0~12 | Member's nickname | |
MobileNo | string | 0~11 | Member's Mobile number | |
Name | string | 0~12 | Member's name | |
Grade | string | Yes | 1~12 | Member's grade(level) name |
Sex | string | Yes | 1 | Gender |
PassWord | string | 0~64 | Member's password (website/app) | |
Birthday | string | 0~10 | yyyy-MM-dd | |
WxNo | string | 0~32 | Member's WeChat OpenID | |
WxUnionId | string | 0~32 | Member's WeChat UnionID | |
WxCode | string | 0-16 | Member's WeChat card number | |
WeibNo | string | 0~32 | Member's Weibo ID | |
QqNo | string | 0~20 | Member's QQ number | |
TbNo | string | 0~32 | Member's taobao ID | |
string | 0~32 | Member's email | ||
RegShop | string | Yes | 1~16 | Member's registration shop |
RegDate | string | Yes | 10 | Member's registration date: |
RegTime | string | Yes | 19 | Member's registration time |
ServShop | string | 0~16 | Member's service shop | |
ServUser | string | 0~16 | Member's service assistant | |
Province | string | 0~64 | ||
City | string | 0~64 | ||
County | string | 0~64 | ||
TaobaoNick | string | Member's Taobao UserID |
Example Request (JSON)
{
"OldCode": "EZ00001230",
"Code": "0000081",
"NickName": "小桂子",
"MobileNo": "18988888888",
"Name": "刘桂",
"Grade": "普通会员",
"Sex": "1",
"PassWord": "",
"Birthday": "1982-10-17",
"WxNo": "",
"WxUnionId": "",
"WeibNo": "",
"QqNo": "",
"TbNo": "",
"Email": "12345678@qq.com",
"RegShop": "HQS0001",
"RegDate": "2015-05-17",
"Province": "",
"City": "",
"County": ""
}
Example Result by external system (JSON)
{
"Status": true,
"StatusCode": 200,
"Msg": "成功",
"Timestamp": "20150622093101",
"Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E",
"Result": 见业务返回结果示例,
}