帮助中心

1301-查询优惠券信息

2021-04-29

接口编号 1301

接口说明

1.第三方根据券码[CouponNo]调用接口查询单张券信息

请求说明

  • HTTP请求方式:POST

  • 返回数据格式:JSON

  • 请求路径:api/ccoup/coupscan

请求参数

字段类型为空长度描述
CouponNostring1-20券号码
Typeint10-线下和通用券,1-查询线上商城券(默认0)

返回参数

字段类型为空长度描述
CouponNostring40券码
OldCodestring20会员线下卡号
CouponTypestring2券类型:DJ=品牌代金券;ZK=品牌折扣券;CX=品牌促销券;LP=礼品券;YQ=邀请券;YY=异业券
CouponNamestring32券名称
BegDatestring
有效开始日期
EndDatestring
有效结束日期
Guidestring1024使用说明
CouponValuedecimal
面额 (折扣券0-1 )
PriceLimitdecimal
使用门槛
PromotionCodestring30若是促销券,指对应的促销代码
IsMorebool
true:可以多张核销;false:单张核销
AllowMultipleCouponsint
可使用张数
IsCouponDiscountAmountbool
是否控制折扣券折扣金额
CouponDiscountAmountdecimal
折扣券可用折扣金额(IsCouponDiscountAmount=true生效)
MaxBuyNumint
允许一个订单最多购买多少商品
IsPositivebool
是否仅允许正价商品使用(false 不允许 true 允许)
CouponPricedecimal
售价
Codestring4券状态码:200:有效;201:验证失败;202:券号不存在;204:已使用过的消费券;205:消费券不在有效期;220:券不可使用(例如:锁定、禁用)
Messagestring64描述
VipIdlong
会员编号
CouponIdlong
券编号
BgColorstring9背景色
CouponGrpIdint
所属券库
ValidityTypestring2有效期类型
DiscountLimitint
折扣限制(0~100)
IsDiscountLimitbool
是否折扣限制
CoupGrpCodestring64券库编号
IsHasConsumeShopsbool
是否指定适用门店(线下)
IsHasCouponsbool
是否限制商品
IsCompositedbool
是否支持叠加
AllowMinBuyNumint
允许一个订单最少购买多少商品
IsAllowBuyLessbool
是否限制一个订单最少购买商品数
CouponPricedecimal

卖券金额


请求参数示例代码(json对象)

{
"CouponNo": "0000123001"
}

系统级返回结果示例(json)

{
"Status": true,
"StatusCode": 200,
"Msg": "成功",
"Timestamp": "20150622093101",
"Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E",
"Result": 见业务返回结果示例,
}

业务返回结果示例(json对象):

{
"CouponNo": "C0011001",
"CouponType": "ZK",
"CouponName": "8折券",
"BegDate": "2017-01-01",
"EndDate": "2018-01-01",
"Guide": "8折券8折券",
"CouponValue": 80.00,
"CouponPrice": 100.00,
"Code": 200,
"Message": "ok",
"CouponGrpCode":"DJ001",
"CouponGrpId":209
}


8283