• 开发者平台
  • >
  • 餐饮文档中心

会员详情查询收费

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

授权方式:门店授权

请求描述

HTTP请求方式:POST
HTTP请求头类型:Content-Type=application/json
URI:  /open/v1/crm/getCustomerDetailById

请求参数

1.公共参数

详情可查看【公共说明】中的公共参数模块

2.业务参数

参数名 类型 是否必填 参数描述
customerId Long 顾客ID,通过会员登录接口获取
isNeedCredit Long 是否挂账查询(1:需要,0 不需)

业务示例(JSON)

{
    "customerId": 800000095,
    "isNeedCredit": 1
}

响应参数

参数名 类型 是否必填 参数描述
code Int 返回编码,详见错误码
message String 返回信息
messageUuid String 消息uuid
result CRMCustomerDetailVO 返回响应数据,json对象或数组,可空

CRMCustomerDetailVO

参数名 类型 是否必填 参数描述
brandId Long 品牌ID
memberId Long 顾客标识ID
customerId Long 顾客ID
customerMainId Long 顾客主ID(CustomerMainId 是 顾客的主ID,是微信账号ID、手机号账号ID、支付宝账号ID 合并后的ID,如果没有合并CustomerMainId = CustomerId)
customerName String 顾客昵称
commercialName String 顾客所属门店名称
sex Integer 性别(-1:未知;0:女;1:男;)
levelId Long 等级Id
level Long 等级数1-5
levelName String 等级名称
memo String 备注
interest String 口味喜好
invoiceTitle String 发票抬头
address String 地址
entityCard String 会员卡号(非实体卡)
groupId String 顾客分组
groupName String 分组名称
birthday Long 生日
isDisable Integer 是否停用(1:停用;2:未停用;)
source Integer 顾客来源(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 Long 数据最后修改时间
upgradeTime Long 会员创建时间
openId String 微信openID
synFlag String 同步标识. 32位的唯一值
remainValue BigDecimal 当前虚拟会员储值余额
integral Long 当前积分
cardCount Integer 实体卡数量
coupCount Integer 可用优惠券数量
creditableValue BigDecimal 可挂账总额度
remainCreditValue BigDecimal 可挂账余额
usedCreditValue BigDecimal 已挂账金额
nation String 国家英文名称
country String 国家中文名称
nationalTelCode String 电话国际区码

响应示例(JSON)

{
    "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
    }
}
目录