帮助中心

1309-第三方新增券库(调用ezr接口新增券库)

2021-10-08

1309-券库新增接口说明:

调用接口新增券库。

  1. 线上退券(IsSingleCoupon、IsRemainValid、NewAddCouponValidDays)配合使用

  2. 线下退券(OfflineIsSingleCoupon、OfflineIsRemainValid、OfflineNewAddCouponValidDays)配合使用

  3. SpecialFieldInfoList是集合对象,存放自定义券库属性

  4. 1=品牌代金券,2=品牌折扣券,3=品牌促销券,4=礼品券,5=邀请券,10=异业券,101=生日

  5. 商品券商品限制(GrpProConType=0、CouponProType、CouponProIsExclude、CouponPro)配合使用

  6. 品类券(GrpProConType=1、ProBDType、IsContainBD、ProdBrandCodes、ProCateType、IsContainCate、ProdCateCodes)配合使用,结合(CouponProType、CouponPro)指定排除商品

  7. EZR商城核销门店范围(ApplyType、Apply)配合使用

  8. 折扣券中CoupValue用小数

请求说明:

HTTP请求方式:POST

返回数据格式:JSON

请求路径:api/ccoup/coupgrpadd

说明:CouponName ,CoupType、CoupValue、CouponPriceLimit、IsCanGiveFriend、IsAllowBuyMore、AllowMaxBuyNum、IsAllowPositive

决定1个券库,券库在初始请求时会进行创建,以后的请求不会再变更。

CouponType等于CX,才验证开始和结束时间

请求参数:




字段类型为空长度描述
Codestring1~20外部的券编号(唯一编号)
CouponNameString1~26券名称
Subtitlestring1~36副标题
Guidestring1~512使用说明
CouponPriceLimitdecimal
使用门槛
CouponTypestring1~2券类型DJ=品牌代金券ZK=品牌折扣券CX=品牌促销券LP=礼品券YQ=邀请券YY=异业券(除此之外可传用户自定义类型,与EZR系统定义保持一致,两位长度的编号)
OutSysstring1~16适用系统( POS之类的)
UseSystemstring1~20使用系统范围:EZR-MALL(线上券), EZR-ALL(通用),传空值则系统前端适用系统为接口传输方
PromotionCodeInt1~24促销编号
PromotionValidTypeint1~11有效类型 (0= 固定时间段,1= 永久)
BegDatestring10有效开始日期(yyyy-MM-dd格式)
EndDatestring10有效结束日期(yyyy-MM-dd格式)
CouponValuedecimal
券面额
ValidityType(弃用)string1~2有效期类型FV=永久有效(异业券不能永久有效),TS=固定时间段
ValidityDays(弃用)int1~11有效期天数
IsCanGiveFriendbool
是否可以转赠
IsAllowMultipleCouponsbool
是否允许多张券(默认false)
AllowMultipleCouponsint
可使用券数量
LimitTypestring1门槛类型(1=订单)可忽略
IsAllowBuyMorebool
是否允许一个订单购买多个
AllowMaxBuyNumint1~11允许一个订单最多购买多少商品
IsAllowPositivebool
是否仅允许正价商品使用
DiscountLimitint1~3折扣限制(0~100)
IsDiscountLimitbool
是否控制折扣
PromotionType(弃用)int1促销类型:(1=打折、2=代金,3=其他)
ApplyTypestringSH商城核销门店范围(SH=门店用户)( Apply不为空时必填)
ApplyList<string>
商城核销门店范围(shopcode)
ApplyIsExcludebool
true排除,false包含,默认false
CouponProTypeint1商品券类型(0=商品券,1= Sku券)
CouponProIsExcludebool
true排除,false包含( CouponPro不为空时必填)配合CouponProType使用
CouponProList<string>
10000sku以内
IsCouponDiscountAmountbool1是否控制折扣券折扣金额(默认false)
CouponDiscountAmountdecimal

折扣券可用折扣金额
IsProint0是否允许导入商品 (0:不允许;1:允许)
IsFreePostInMallbool
是否支持免邮
GrpPlatformstring
投放渠道,默认ezr
IsSingleCouponbool
线上退券(false不支持,true支持,仅在UseSystem为EZR-MALL有效)
IsRemainValidint
退还原券有效期 1保持原有效期 2自补发后X天有效(0-90天有效,0代表当天)
NewAddCouponValidDaysint
IsRemainValid=2,取值作为退券有效期
OfflineIsSingleCouponbool
线下退券(true支持,false不支持)
OfflineIsRemainValidint
退还原券有效期 1保持原有效期 2自补发后X天有效(0-90天有效,0代表当天)
OfflineNewAddCouponValidDaysint
OfflineIsRemainValid=2,取值作为退券有效期
IsCompositedBool
是否多券库叠加使用(默认ture)
GrpProConTypeint
券库关联商品类型 0指定商品  1指定条件
ProBDTypeint
0全部品牌  1部分品牌
IsContainBDstring
1包含(品牌)  0排除(品牌)
ProdBrandCodeslist<string>
品牌Code
ProCateTypeint
0全部分类  1部分分类
IsContainCatestring
1包含(分类)  0排除(分类)
ProdCateCodeslist<string>
分类Code
IsProDiscountLimitbool
商品折扣限制(true有 false无)
ProDiscountLimitint
商品折扣限制
SpecialFieldInfoListList
券库自定义属性集合
AllowMinBuyNumint
允许一个订单最少购买多少商品
IsAllowBuyLessbool
是否限制一个订单最少购买商品数





SpecialFieldInfoList数据结构




FieldCodestring设置的CODE
FieldValuestring可选值




请求参数示例代码(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,

"IsAllowBuyLess":true,

"SpecialFieldInfoList":[{"FieldCode":"code1","FieldValue":"value1"}]

}

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

{

  "Status": true,

  "StatusCode": 200,

  "Msg": "成功",

  "Timestamp": "20150622093101",

  "Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E",

  "Result": 见业务返回结果示例,

}

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

内容,返回券库编号

 

 


7118