企迈云-开放平台

请求地址

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

公共参数

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

请求参数

参数	参数类型	是否必填	描述
bizType	string	是	业务类型，10-餐饮，11-零售，12-平台
id	string	是	券模板ID
filterInvalid	string	否	是否过滤无效的模板（状态不是启用中，或者已经过期），0-不过滤，1-过滤，默认不过滤

响应参数

参数	参数类型	描述
status	bool	成功或失败标识
code	int	成功或失败代码
message	string	描述
data	array
├applyGiveGoodsInfos	array
├applyId	string	赠送适用商品信息列表(商品/商品分类)
├applyName	string	商品名称/商品分类名称
├applyType	string	适用类型：1：商品 2：商品分类
├buyOrGive	string	买或送（该字段页面无需要处理）
├discountAmount	string	商品优惠金额/折扣
├discountType	string	优惠方式，1-面值，2-折扣
├sellerId	string	集团店铺
├sellerType	string	店铺类型，2-餐饮，9-零售
├templateId	string	模板id
├applyGiveGoodsType	string	赠送适用商品类型：1-全部商品，2-指定商品，3-指定不适用商品
├applyGoodsInfos	array
├applyId	string	商品ID/商品分类id
├applyName	string	商品名称/商品分类名称
├applyType	int	适用类型：1：商品 2：商品分类
├ buyOrGive	string	买或送（该字段页面无需要处理）
├discountAmount	string	商品优惠金额/折扣
├discountType	string	优惠方式，1-面值，2-折扣
├sellerType	string	店铺类型，2-餐饮，9-零售
├templateId	string	模板id
├ applyGoodsInfos	array
├sellerId	string	集团店铺
├applyGoodsType	string	适用商品类型：1-全部商品，2-指定商品，3-指定不适用商品
├applySellerId	string	适用店铺id
├applySellerName	string	适用店铺
├applySellerType	int	适用店铺类型，2-餐饮，9-零售
├applyStoreIds	string	适用门店id列表
├applyStoreInfos	array
├id	int	主键id
├sellerId	int	店铺id
├storeId	int	门店ID
├storeName	string	门店名称
├templateId	string	模板ID
├ applyStoreType	int	适用门店：1-所有门店，2-指定门店，3-指定门店不适用
├channel	string	品牌渠道
├createdAt	DateTime	创建时间
├discountAmount	string	优惠金额/折扣
├discountUnit	string	优惠单位：1-元，2-折
├ groupId	int	集团id
├id	string	模板id
├instruction	string	使用说明
├isDiscountShared	string	是否优惠共享：1-是，0-否
├isFixedTimeScope	string	是否指定时段才能使用优惠券，0-否，1-是
├kind	string	属性，1-兑换券，2-领取券，3-权益券
├maxUseCount	string	最大使用数量，开启使用限制，一天最多使用的数量
├name	string	模板名称
├originalTemplateId	string	迁移数据的原始ID
├otherInfos	string	其他信息,券模板图片:imageUrl,账务属性:billingKind,账务金额:billingAmount,是否打用户标签:isMarkTag,用户标签:userTags,赠送设置:isGive,同步到支付宝:syncAlipay,同步到美团:syncMeituan,同步到微信:syncWechat,同步必要字段:syncFields,是否展示二维码:showQrCode
├parkDiscount	string	停车券优惠内容,1-面值，2-折扣
├saleChannelCode	string	销售渠道代码
├sellerType	string	店铺类型，2-餐饮，9-零售
├status	string	状态，0-未启用，1-启用中，2-已失效
├thirdBizCode	string	优惠券编码（三方业务券编码）
├thresholdType	string	使用门槛类型：1、无门槛 2、满 xx 元
├type	string	券类型：1、代金券 2、折扣券 3、商品券 4、买 A 赠 B 券 5、限制数量免单券 6、免运费/配送费券 7、免排队券 8、停车券
├useChannel	string	使用渠道，1-小程序，2-POS机，多个逗号分隔，如1,2
├useCountLimit	string	使用数量限制, 0-不限制，1-限制
├useScene	string	使用场景:1-外卖，2-食堂，3.买单多个逗号分隔，如1,2,3
├useSceneExtend	string	使用场景扩展：1-堂食即时单 2-堂食预约单多个逗号隔开
├useThreshold	string	使用门槛,订单满多少元可用
├useTimeScope	string	使用时段，json数组格式，[{begin:xx, end:xx}]
├useageMemo	string	用途备注
├validBeginDate	string	有效开始日期
├validDays	string	有效天数
├validEndDate	string	有效结束日期
├validMonths	string	有效月数
├validStartDay	string	生效时间，0-当日生效，1-次日生效
├validType	int	有效期类型，1-固定日期，2-获得券当日/次日开始 x 个自然日内有效,3-获得券当日/次日开始 x 个自然月内有效

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "coupn.coupon-template-detail",
    "Params": {
        "bizType": "",
        "id": "",
        "filterInvalid": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "applyGiveGoodsInfos": {
            "applyId": "",
            "applyName": "",
            "applyType": "",
            "buyOrGive": "",
            "discountAmount": "",
            "discountType": "",
            "sellerId": "",
            "sellerType": "",
            "templateId": ""
        },
        "applyGiveGoodsType": "",
        "applyGoodsInfos": {
            "applyId": "",
            "applyName": "",
            "applyType": "",
            " buyOrGive": "",
            "discountAmount": "",
            "discountType": "",
            "sellerType": "",
            "templateId": ""
        },
        " applyGoodsInfos": {
            "sellerId": ""
        },
        "applyGoodsType": "",
        "applySellerId": "",
        "applySellerName": "",
        "applySellerType": "",
        "applyStoreIds": "",
        "applyStoreInfos": {
            "id": "",
            "sellerId": "",
            "storeId": "",
            "storeName": "",
            "templateId": ""
        },
        " applyStoreType": "",
        "channel": "",
        "createdAt": "",
        "discountAmount": "",
        "discountUnit": "",
        " groupId": "",
        "id": "",
        "instruction": "",
        "isDiscountShared": "",
        "isFixedTimeScope": "",
        "kind": "",
        "maxUseCount": "",
        "name": "",
        "originalTemplateId": "",
        "otherInfos": "",
        "parkDiscount": "",
        "saleChannelCode": "",
        "sellerType": "",
        "status": "",
        "thirdBizCode": "",
        "thresholdType": "",
        "type": "",
        "useChannel": "",
        "useCountLimit": "",
        "useScene": "",
        "useSceneExtend": "",
        "useThreshold": "",
        "useTimeScope": "",
        "useageMemo": "",
        "validBeginDate": "",
        "validDays": "",
        "validEndDate": "",
        "validMonths": "",
        "validStartDay": "",
        "validType": ""
    }
}

异常示例

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

错误码

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

2.5.12 查询券模板详情

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

场景描述：查询券模板详情

请求地址

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码