调用接口新增券库。
线上退券(IsSingleCoupon、IsRemainValid、NewAddCouponValidDays)配合使用
线下退券(OfflineIsSingleCoupon、OfflineIsRemainValid、OfflineNewAddCouponValidDays)配合使用
SpecialFieldInfoList是集合对象,存放自定义券库属性
1=品牌代金券,2=品牌折扣券,3=品牌促销券,4=礼品券,5=邀请券,10=异业券,101=生日
商品券商品限制(GrpProConType=0、CouponProType、CouponProIsExclude、CouponPro)配合使用
品类券(GrpProConType=1、ProBDType、IsContainBD、ProdBrandCodes、ProCateType、IsContainCate、ProdCateCodes)配合使用,结合(CouponProType、CouponPro)指定排除商品
EZR商城核销门店范围(ApplyType、Apply)配合使用
折扣券中CoupValue用小数
请求说明:
HTTP请求方式:POST
返回数据格式:JSON
请求路径:api/ccoup/coupgrpadd
说明:CouponName ,CoupType、CoupValue、CouponPriceLimit、IsCanGiveFriend、IsAllowBuyMore、AllowMaxBuyNum、IsAllowPositive
决定1个券库,券库在初始请求时会进行创建,以后的请求不会再变更。
CouponType等于CX,才验证开始和结束时间
请求参数:
字段 | 类型 | 为空 | 长度 | 描述 |
---|---|---|---|---|
Code | string | 否 | 1~20 | 外部的券编号(唯一编号) |
CouponName | String | 否 | 1~26 | 券名称 |
Subtitle | string | 是 | 1~36 | 副标题 |
Guide | string | 是 | 1~512 | 使用说明 |
CouponPriceLimit | decimal | 是 | 使用门槛 | |
CouponType | string | 是 | 1~2 | 券类型DJ=品牌代金券ZK=品牌折扣券CX=品牌促销券LP=礼品券YQ=邀请券YY=异业券(除此之外可传用户自定义类型,与EZR系统定义保持一致,两位长度的编号) |
OutSys | string | 是 | 1~16 | 适用系统( POS之类的) |
UseSystem | string | 否 | 1~20 | 使用系统范围:EZR-MALL(线上券), EZR-ALL(通用),传空值则系统前端适用系统为接口传输方 |
PromotionCode | Int | 是 | 1~24 | 促销编号 |
PromotionValidType | int | 是 | 1~11 | 有效类型 (0= 固定时间段,1= 永久) |
BegDate | string | 是 | 10 | 有效开始日期(yyyy-MM-dd格式) |
EndDate | string | 是 | 10 | 有效结束日期(yyyy-MM-dd格式) |
CouponValue | decimal | 是 | 券面额 | |
ValidityType(弃用) | string | 是 | 1~2 | 有效期类型FV=永久有效(异业券不能永久有效),TS=固定时间段 |
ValidityDays(弃用) | int | 是 | 1~11 | 有效期天数 |
IsCanGiveFriend | bool | 是 | 是否可以转赠 | |
IsAllowMultipleCoupons | bool | 是 | 是否允许多张券(默认false) | |
AllowMultipleCoupons | int | 是 | 可使用券数量 | |
LimitType | string | 是 | 1 | 门槛类型(1=订单)可忽略 |
IsAllowBuyMore | bool | 是 | 是否允许一个订单购买多个 | |
AllowMaxBuyNum | int | 是 | 1~11 | 允许一个订单最多购买多少商品 |
IsAllowPositive | bool | 是 | 是否仅允许正价商品使用 | |
DiscountLimit | int | 是 | 1~3 | 折扣限制(0~100) |
IsDiscountLimit | bool | 是 | 是否控制折扣 | |
PromotionType(弃用) | int | 否 | 1 | 促销类型:(1=打折、2=代金,3=其他) |
ApplyType | string | 是 | SH | 商城核销门店范围(SH=门店用户)( Apply不为空时必填) |
Apply | List<string> | 是 | 商城核销门店范围(shopcode) | |
ApplyIsExclude | bool | 是 | true排除,false包含,默认false | |
CouponProType | int | 是 | 1 | 商品券类型(0=商品券,1= Sku券) |
CouponProIsExclude | bool | 是 | true排除,false包含( CouponPro不为空时必填)配合CouponProType使用 | |
CouponPro | List<string> | 是 | 10000sku以内 | |
IsCouponDiscountAmount | bool | 是 | 1 | 是否控制折扣券折扣金额(默认false) |
CouponDiscountAmount | decimal | 折扣券可用折扣金额 | ||
IsPro | int | 是 | 0 | 是否允许导入商品 (0:不允许;1:允许) |
IsFreePostInMall | bool | 是 | 是否支持免邮 | |
GrpPlatform | string | 是 | 投放渠道,默认ezr | |
IsSingleCoupon | bool | 是 | 线上退券(false不支持,true支持,仅在UseSystem为EZR-MALL有效) | |
IsRemainValid | int | 是 | 退还原券有效期 1保持原有效期 2自补发后X天有效(0-90天有效,0代表当天) | |
NewAddCouponValidDays | int | 是 | IsRemainValid=2,取值作为退券有效期 | |
OfflineIsSingleCoupon | bool | 否 | 线下退券(true支持,false不支持) | |
OfflineIsRemainValid | int | 否 | 退还原券有效期 1保持原有效期 2自补发后X天有效(0-90天有效,0代表当天) | |
OfflineNewAddCouponValidDays | int | 是 | OfflineIsRemainValid=2,取值作为退券有效期 | |
IsComposited | Bool | 是 | 是否多券库叠加使用(默认ture) | |
GrpProConType | int | 是 | 券库关联商品类型 0指定商品 1指定条件 | |
ProBDType | int | 是 | 0全部品牌 1部分品牌 | |
IsContainBD | string | 是 | 1包含(品牌) 0排除(品牌) | |
ProdBrandCodes | list<string> | 是 | 品牌Code | |
ProCateType | int | 是 | 0全部分类 1部分分类 | |
IsContainCate | string | 是 | 1包含(分类) 0排除(分类) | |
ProdCateCodes | list<string> | 是 | 分类Code | |
IsProDiscountLimit | bool | 是 | 商品折扣限制(true有 false无) | |
ProDiscountLimit | int | 是 | 商品折扣限制 | |
SpecialFieldInfoList | List | 是 | 券库自定义属性集合 | |
AllowMinBuyNum | int | 否 | 允许一个订单最少购买多少商品 | |
IsAllowBuyLess | bool | 否 | 是否限制一个订单最少购买商品数 |
SpecialFieldInfoList数据结构
FieldCode | string | 设置的CODE |
---|---|---|
FieldValue | string | 可选值 |
请求参数示例代码(json对象):
{
"Code": "3535344RTHH6",
"CouponName": "价值10元代金券",
"Subtitle": "价值10元代金券",
"Guide": "价值10元代金券",
"CouponPriceLimit": 0,
"CouponType": "DJ",
"OutSys": "POS",
"PromotionCode": 123456,
"PromotionValidType": 0,
"BegDate": "2017-05-11",
"EndDate": "2017-05-18",
"CouponValue": 10,
"ValidityType": "CM",
"ValidityDays": 1000,
"IsCanGiveFriend": true,
"IsAllowMultipleCoupons": true,
"AllowMultipleCoupons":10,
"LimitType": 1,
"IsAllowBuyMore": true,
"AllowMaxBuyNum": 1,
"IsAllowPositive": true,
"DiscountLimit":76,
"IsDiscountLimit":false,
"PromotionType": 1,
"ApplyType": "SH",
"ApplyIsExclude": true,
"Apply": [
"7307",
"HQ01S002"
],
"CouponProType": 1,
"CouponProIsExclude": true,
"IsCouponDiscountAmount": true,
"CouponDiscountAmount": 75,
"CouponPro": [
"001001"
],
"IsComposited":false,
"IsSingleCoupon":false,
"IsRemainValid":0,
"NewAddCouponValidDays":"0,
"GrpProConType":0,
"ProBDType":0,
"IsContainBD":"0",
"ProdBrandCodes":[],
"ProCateType":0,
"IsContainCate":"0",
"ProdCateCodes":[],
"AllowMinBuyNum":10,
"SpecialFieldInfoList":[{"FieldCode":"code1","FieldValue":"value1"}]
}
系统级返回结果示例(json):
{
"Status": true,
"StatusCode": 200,
"Msg": "成功",
"Timestamp": "20150622093101",
"Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E",
"Result": 见业务返回结果示例,
}
业务返回结果示例(json):
内容,返回券库编号