企迈云-开放平台

请求地址

请求方式	版本信息	请求地址
POST	V2	http://openapi.zvcms.com/api/v2

公共参数

参数	参数类型	是否必填	默认值	描述
OpenId	string	是		密钥Id
GrantCode	string	是		授权code
Token	string	是		签名，参考《数字签名sign》
Timestamp	string	是		当前时间戳
Nonce	string	是		随机正整数
Action	string	是	user.coupon-usable-list	接口方法
Params	array	是		业务参数

请求参数

参数	参数类型	是否必填	描述
userId	int	否	用户id
userCode	string	否	会员码, 用户id和会员码必传一个
multiMark	string	是	门店编码
items	array	否
├0	array	否
├tradeMark	string	是	商品标识
├num	int	是	商品数量
├buyRemarks	string	否	商品留言

响应参数

参数	参数类型	描述
beginAt	string	生效时间
cardId	string	券码
couponExplain	string	优惠券说明
couponId	string	优惠券id
couponTemplate	array
├applyGoodsType	integer	适用商品类型：1-全部商品，2-指定商品，3-指定不适用商品
├applyStoreType	integer	功能：适用的门店 1-所有门店，2-指定门店，3-指定门店不适用
├discountGoodsCount	integer	优惠商品数量
├discountAmount	integer	优惠内容(次卡是优惠次数)
├discountUnit	integer	优惠单位 1-元，2-折,3-次
├expireDesc	string	有效期说明
├giveCount	integer	赠送数量
├goodsCategoryIds	array	功能：商品类目限制
├goodsIds	array	功能：适合商品的ID
├id	integer	模板ID
├instruction	string	优惠券描述
├isFixedTimeScope	integer	是否指定时段才能使用优惠券，0-否，1-是
├isNewCustomerShared	integer	是否新用户专享：1-是
├kind	integer	属性，1-兑换券，2-领取券，3-权益券
├maxUseCount	integer	最大使用数量，开启使用限制，一天最多使用的数量
├name	string	模板名称
├otherInfos	object	其他信息:imageUrl：券模板图片\n；billingKind：账务属性1-视为折扣，2-视为业绩，3-视为预存\n；billingAmount：账务金额\n；isMarkTag：是否打用户标签0-否，1-是息\n；userTags：用户标签\n；isGive：赠送设置0-不可赠送，1-可赠送; weChatGiveCouponImage:微信转增图片;zfbGiveCouponImage:支付宝转增图片
├status	integer	状态，0-未启用，1-启用中，2-已失效
├storeIds	array	功能：执行适用门店
├thresholdType	integer	使用门槛类型：1、无门槛 2、满 xx 元 3、满 xx 件 4-满xx千克
├type	integer	券类型：1、代金券 2、折扣券 3、商品券 4、买 A 赠 B 券 5、限制数量免单券 6、免运费/配送费券 7、免排队券 8、停车券, 12 次券
├useChannel	array	使用渠道，1-小程序（线上），2-POS机（线下）,3-windows收银机；4-andriod收银机；5-蜻蜓；6-如意RO，多个逗号分隔，如1,2
├useCountLimit	integer	使用数量限制, 0-不限制，1-限制
├useScene	array	使用场景:1-外卖，2-堂食，3.买单多个逗号分隔，如1,2,3
├useSceneMap	object	使用场景
├useThreshold	number	使用门槛,订单满多少元可用
├useTimeScope	string	使用时段，json数组格式，[{begin:xx, end:xx}]
├validBeginDate	string	有效开始日期
├validDays	integer	有效天数
├validEndDate	string	有效结束日期
├validMonths	integer	有效月数
├validStartDay	integer	生效时间，0-当日生效，1-次日生效
├validType	integer	有效期类型，1-固定日期，2-获得券当日/次日开始 x 个自然日内有效,3-获得券当日/次日开始 x 个自然月内有效,4-发放时指定有效期
├origin_count	int	初始次数(次券使用)
├usable_count	int	可用次数(次券使用)
├memberDiscountSet	int	会员折扣设置： 1-入会员折扣 2-不入会员折扣
customerId	string	客户ID
endAt	string	到期时间
expireDesc	string	有效期说明
imageUrl	string	优惠券图片
sellerName	string	品牌(或店铺)名称
takeAvatar	string	领取用户头像
takeCustomerId	string	领取用户id
takeCustomerUserName	string	领取用户昵称
takeTime	string	领取时间
templateId	string	优惠券规则id
title	string	优惠券名称
useStatus	integer	劵状态:0：未使用/已冲正、1：已核销、2：已冻结、4：转赠中、5：转赠超时、6：已失效、7：已删除/已回收

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "user.coupon-usable-list",
    "Params": {
        "userId": "",
        "userCode": "",
        "multiMark": "",
        "items": [
            {
                "tradeMark": "",
                "num": "",
                "buyRemarks": ""
            }
        ]
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "beginAt": "",
        "cardId": "",
        "couponExplain": "",
        "couponId": "",
        "couponTemplate": {
            "applyGoodsType": "",
            "applyStoreType": "",
            "discountGoodsCount": "",
            "discountAmount": "",
            "discountUnit": "",
            "expireDesc": "",
            "giveCount": "",
            "goodsCategoryIds": "",
            "goodsIds": "",
            "id": "",
            "instruction": "",
            "isFixedTimeScope": "",
            "isNewCustomerShared": "",
            "kind": "",
            "maxUseCount": "",
            "name": "",
            "otherInfos": "",
            "status": "",
            "storeIds": "",
            "thresholdType": "",
            "type": "",
            "useChannel": "",
            "useCountLimit": "",
            "useScene": "",
            "useSceneMap": "",
            "useThreshold": "",
            "useTimeScope": "",
            "validBeginDate": "",
            "validDays": "",
            "validEndDate": "",
            "validMonths": "",
            "validStartDay": "",
            "validType": "",
            "origin_count": "",
            "usable_count": "",
            "memberDiscountSet": ""
        },
        "customerId": "",
        "endAt": "",
        "expireDesc": "",
        "imageUrl": "",
        "sellerName": "",
        "takeAvatar": "",
        "takeCustomerId": "",
        "takeCustomerUserName": "",
        "takeTime": "",
        "templateId": "",
        "title": "",
        "useStatus": ""
    }
}

异常示例

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

错误码

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

7.4.11 可用的优惠券列表(烘焙)

开启令牌和权限后可调用。签名方式请查看开发指南

烘焙业务使用

请求地址

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码