会员详情查询 - 客如云 API

(下行接口)合作方根据顾客ID查询会员详情（该接口可以查询到会员的余额）

curl --location --request POST 'https://gldopenapi.keruyun.com/open/v1/crm/getCustomerDetailById?appKey=&shopIdenty=&brandId=&version=&timestamp=&sign=' \ --header 'Content-Type: application/json' \ --data-raw '{ "customerId": 800000095, "isNeedCredit": 1 }'

{ "code": 1, "result": { "brandId": 3268, "memberId": 1004940430, "customerId": 888893412828, "customerMainId": 888893412828, "customerName": "杨", "mobile": "18980768844", "tel": "028-9881312321", "sex": 1, "levelId": 9991775, "level": 1, "levelName": "微会员", "memo": "", "interest": "", "address": "", "groupId": 1015323, "groupName": "yuan12311", "birthday": "1999-01-02", "isDisable": 2, "synFlag": "38bde65d406d46d4be98d5a9cbcbf12b", "remainValue": 85, "cardCount": 0, "coupCount": 0 } }

请求参数

Query 参数

appKey

string

必需

开发者申请服务客如云分配的appKey

默认值:

shopIdenty

string

必需

客如云门店id （门店维度接口传递门店ID）

默认值:

brandId

string

必需

客如云品牌id（品牌授权的接口传递品牌ID）

默认值:

version

string

必需

版本,默认2.0（1.0版本仍可用）

默认值:

2.0

timestamp

string

必需

时间戳,单位:秒,时间戳校验签名,开放平台校验签名时用此参数和服务器当前时间戳对比不能大于300秒，我方服务器使用阿里云授时中心

默认值:

sign

string

必需

签名，64位长度的字符串，获取规则详见签名规则

默认值:

Body 参数application/json

customerId

integer

必需

isNeedCredit

integer

必需

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

result

可选

返回响应数据，json对象或数组，可空

One of

CRMCustomerDetailVO

null

brandId

integer

必需

memberId

integer

顾客标识ID

必需

customerId

integer

顾客ID

必需

customerMainId

integer

必需

顾客主ID（CustomerMainId 是顾客的主ID，是微信账号ID、手机号账号ID、支付宝账号ID 合并后的ID，如果没有合并CustomerMainId = CustomerId）

customerName

string

顾客昵称

可选

commercialName

string

顾客所属门店名称

必需

mobile

string

必需

tel

string

必需

sex

integer

必需

性别(-1:未知;0:女;1:男;)

levelId

integer

等级Id

必需

level

integer

等级数1-5

必需

levelName

string

等级名称

必需

memo

string

备注

必需

interest

string

口味喜好

必需

address

string

地址

可选

groupId

integer

顾客分组

必需

groupName

string

分组名称

必需

birthday

string

生日

必需

isDisable

integer

必需

是否停用(1:停用;2:未停用;)

synFlag

string

可选

同步标识. 32位的唯一值

remainValue

number

可选

当前虚拟会员储值余额

cardCount

integer

实体卡数量

必需

coupCount

integer

可用优惠券数量

可选

invoiceTitle

string

发票抬头

可选

entityCard

string

可选

会员卡号(非实体卡)

source

string

必需

顾客来源(1:CALM;2:手机app;3:其他系统倒入;4:微信;5:支付宝;6:商家官网;7:百度;8:后台;9:百度外卖;10:饿了么;11:美图外卖;12:大众点评;13:熟客;14:糯米点菜;15:os mobile;16:开放平台;)

loginType

integer

必需

登录类型(0:手机注册客户;1:微信注册用户;2:座机号;101:微信会员卡卡号;)

loginId

string

必需

手机Id\微信openId

modifyDateTime

integer

数据最后修改时间

必需

upgradeTime

integer

会员创建时间

必需

openId

string

微信openID

必需

integral

string

当前积分

必需

creditableValue

number

可挂账总额度

可选

remainCreditValue

number

可挂账余额

必需

usedCreditValue

number

已挂账金额

可选

nation

string

国家英文名称

可选

country

string

国家中文名称

可选

nationalTelCode

string

电话国际区码

可选

message

string

返回信息

必需

messageUuid

string

消息uuid

必需