开发指南
API
官网
API 3.0
API 3.0 > 7.3 会员基础信息 > 7.3.11 会员信息查询集合

7.3.11 会员信息查询集合

开启令牌和权限后可调用。签名方式请查看开发指南
集合会员信息
餐饮

请求地址

请求方式 版本信息 请求地址
POST V3 http://openapi.zvcms.com/v3/crm/customer/gatherCustomerInfo

公共参数

参数 参数类型 是否必填 默认值 描述
openId string 是 密钥Id
grantCode string 是 授权code
token string 是 签名，参考《数字签名sign》
timestamp string 是 当前时间戳
nonce string 是 随机正整数
params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
identifierNumber string 否 根据type字段枚举对应传递
type int 是 识别类型：1=会员码或会员ID，2=手机号，3=会员卡号，4=支付宝userid，5=微信openid，6=微信unionid
multiMark string 否 门店编码
typeCate int 否 1 订单类型：1堂食,3外卖
discountPrice money(元) 否 订单折扣金额

响应参数

参数 参数类型 描述
username string 会员姓名
mobile string 会员手机号
memberLevel int 会员等级
memberLevelName string 会员等级名称
memberLevelExpiredAt string 会员等级过期时间
gender int 性别。0：未知、1：男性、2：女性
customerId string 会员号
cardNo string 会员卡号
cardName string 会员卡名称
isMemberEnterprise int 是否是企业会员 0是 1 否
paidBenefitsCardDetailList array
 ├0 array
  ├paidCardId int 付费权益卡id
  ├cardName string 卡名称
  ├beginAt string(date-time) 时间生效
  ├expiredAt string(date-time) 到期时间
isPassword int 是否设置交易密码开关：1:开启、2:关闭
giftCardList array
 ├0 array
  ├cardNo string 礼品卡卡号
  ├name string 卡名称
  ├thirdCardNo string 礼品卡三方卡号
  ├cardTotal number 卡面总值，金额或者次数
  ├cardType int 礼品卡类型：1:现金卡、2:商品次卡、3:权益卡、4:储值卡
  ├balance number 可用余额（现金卡），或者可用次数（商品次卡）
  ├applicableType int 次卡适用类型：1-适用商品共享次数，2-指定商品指定次数
  ├beginAt string(date-time) 生效时间
  ├cardPrice number 礼品卡售价
  ├cardSource int 卡的来源：0-未知状态，1-购买，2-兑换，3-领取
  ├cardStatus int 礼品卡的状态: 0-未知状态，1-未绑定，2-赠送中，3-已赠送，4-已绑定，5-已过期，6-已回收，7-已用完
  ├endAt string(date-time) 到期时间,永久有效：2100-01-01 00:00:00
  ├todayUsedNum int 今日已使用次数
  ├useTimeScope string 使用时段，json数组格式，[{begin:xx, end:xx}]
  ├useWeeks string 周几可用，多个使用逗号分隔，1-周一，2-周二，3-周三，4-周四，5-周五，6-周六，7-周日
labelList array
 ├0 array
  ├labelName string 标签名
  ├labelLevel int 标签等级,1-标签类型,2-标签名称,3-标签值
totalPoints string 所有有效积分
giftBalance string 赠送金额
rechargeBalance string 充值金额
totalGiftAmount string 累计赠送金额
totalRechargeAmount string 累计充值金额
couponsList array
 ├0 array
  ├coupon_id int 优惠券id
  ├start_at string 开始时间
  ├end_at string 结束时间
  ├status int 使用状态。0-未使用；1-已使用
  ├couponId string 券核销码
  ├template array
   ├id int 优惠券模板id【可用于发券，一个券模板id可发放不同数量的券】
   ├type int 优惠券所属平台 1微信 2 口碑
   ├title string 优惠券名称 【优惠券信息主要看 coupon 数组里的券信息】
   ├total int 优惠券总数量 0-不限制
   ├amount string 优惠券金额/折扣
   ├coupon_type int 优惠形式。0-指定金额；1-折扣券
   ├min_amount_use int 最低使用金额， 0 -不限制
   ├number_of_user int 每人限领多少张 0-不限制
   ├goods_range_type int 可使用的商品。0-所有商品；1-指定商品
   ├expire_type int 有效期类型。0-固定日期；1-领到券当日开始N天内生效；2-领到券次日开始N天内生效
   ├start_at int 开始时间
   ├end_at int 结束时间
   ├expire_days int N天内生效的N
   ├status int 状态，是否可用,1可用,0不可用
   ├scene_type int 适用场景。1-外卖；2-堂食；3-外卖+堂食；4-买单；5-外卖+买单；6-堂食+买单；7-通用
   ├only_coupon int 是否只享受优惠券优惠: 0 不是 1是
   ├use_per_person_per_day int 每人每天使用次数: 默认值 0 代表不限制
   ├is_use_time_range int 是否使用 时间段: 0 不使用 1使用
   ├category int 0、现金券/折扣券 2、限制数量免单券 3、erp兑换券(线下用) 4、买M送N券 5、商品券 6、免运费/配送费券 7、免排队券 8、停车券
   ├max_num int 免单最高金额的几件商品
   ├min_num int 免单最低金额的几件商品
   ├min_num_use int 订单满几件商品可用 min_amount_use和min_num_use同时满足表示不限制
   ├multi_range_type int 适用门店。0-所有门店；1-指定门店可用；2-指定门店不可用
   ├shop_ids string 指定的门店ID,json格式
   ├explain_text string 优惠券说明
   ├second_max_num int 买M送N券 - 次高金额的几件商品
   ├goods_range_num int 买M送N券 - 购买数量
   ├coupon_label string 券标签
   ├coupon_title string 优惠券标题
   ├coupon_amount string 优惠说明
   ├all_coupon_amount string 优惠金额
   ├templateCode string 券模板编码
  ├cardId string 券核销码

请求示例

{
    "openId": "6dc05b4ac175cf316d226252b05cf685",
    "grantCode": "782c281f62",
    "timestamp": "1547186244",
    "nonce": "658965",
    "token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "params": {
        "identifierNumber": "qm0000001",
        "type": "1",
        "multiMark": "1001",
        "typeCate": "1",
        "discountPrice": "0.00"
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "username": "",
        "mobile": "",
        "memberLevel": "",
        "memberLevelName": "",
        "memberLevelExpiredAt": "",
        "gender": "",
        "customerId": "",
        "cardNo": "",
        "cardName": "",
        "isMemberEnterprise": "",
        "paidBenefitsCardDetailList": [
            {
                "paidCardId": "",
                "cardName": "",
                "beginAt": "",
                "expiredAt": ""
            }
        ],
        "isPassword": "",
        "giftCardList": [
            {
                "cardNo": "",
                "name": "",
                "thirdCardNo": "",
                "cardTotal": "",
                "cardType": "",
                "balance": "",
                "applicableType": "",
                "beginAt": "",
                "cardPrice": "",
                "cardSource": "",
                "cardStatus": "",
                "endAt": "",
                "todayUsedNum": "",
                "useTimeScope": "",
                "useWeeks": ""
            }
        ],
        "labelList": [
            {
                "labelName": "",
                "labelLevel": ""
            }
        ],
        "totalPoints": "",
        "giftBalance": "",
        "rechargeBalance": "",
        "totalGiftAmount": "",
        "totalRechargeAmount": "",
        "couponsList": [
            {
                "coupon_id": "",
                "start_at": "",
                "end_at": "",
                "status": "",
                "couponId": "",
                "template": {
                    "id": "",
                    "type": "",
                    "title": "",
                    "total": "",
                    "amount": "",
                    "coupon_type": "",
                    "min_amount_use": "",
                    "number_of_user": "",
                    "goods_range_type": "",
                    "expire_type": "",
                    "start_at": "",
                    "end_at": "",
                    "expire_days": "",
                    "status": "",
                    "scene_type": "",
                    "only_coupon": "",
                    "use_per_person_per_day": "",
                    "is_use_time_range": "",
                    "category": "",
                    "max_num": "",
                    "min_num": "",
                    "min_num_use": "",
                    "multi_range_type": "",
                    "shop_ids": "",
                    "explain_text": "",
                    "second_max_num": "",
                    "goods_range_num": "",
                    "coupon_label": "",
                    "coupon_title": "",
                    "coupon_amount": "",
                    "all_coupon_amount": "",
                    "templateCode": ""
                },
                "cardId": ""
            }
        ]
    }
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

免费升级

营销功能、插件持续每月更新开发升级

免费专业培训

每月建站、微信营销、电商等互联网增值培训

7×24小时服务支持

400电话、QQ、微信、在线等多渠道售后支持

 

安徽智迈科技股份有限公司 版权所有 Copyright 2009-2018 皖公网安备 34019202000074号 增值电信业务经营许可证：皖B2-20170075