Skip to main content

创建券产品

基本信息

接口名称:创建券产品状  态:已完成
接口路径:POST /paas/micro/ecoupon/_addBrandProductDirect更新时间:2024-06-06 17:47:00
Mock地址:https://apimock.e-buychina.com/mock/617/paas/micro/ecoupon/_addBrandProductDirect

请求参数

Headers:

参数名称参数值是否必填
Content-Typeapplication/json

Body:

参数名称类型必填默认值备注其他信息
uuidstring请求序列号最大长度:50
最小长度:1
Mock:@now('yyyyMMdd')-@string('lower',32)
appIdstring请求AppId最大长度:50
最小长度:1
Mock:@natural
actionstring交易类型最大长度:50
最小长度:1
Mock:_addBrandProductDirect
timestampnumber请求时间戳Mock:@timestamp
signTypestring签名类型最大长度:20
最小长度:1
Mock:sha256
signstring签名值最大长度:500
最小长度:1
Mock:@natural
langstring语言最大长度:50
最小长度:1
Mock:zh_CN
contentobject请求报文
  productNamestring产品名称最大长度:100
最小长度:1
Mock:@string
  productTypestring产品类型最大长度:20
最小长度:1
Mock:@string
  useTimesinteger总可使用次数Mock:@integer
  sendChannelIdinteger制码渠道id(非三方码默认1)Mock:@integer
  totalFaceValuenumber面值(单位分)Mock:@integer
  productConfigobject产品配置JSON字段
    codeTypestring产品下的券类型
  productDescstring产品描述说明最大长度:20
最小长度:1
Mock:1
  ruleConfigobject规则信息
    buyGetConfigobject折抵和sku限制规则
      messageTplstring买赠的产品ID没匹配上时错误自定义提示语
      codeTypestring规则明细类型
      limitMinAmountnumber最低消费金额(单位分)
      listTypestring限制类型(B黑名单|W白名单) ,上传的item是在黑名单还是白名单
      buyNumberarray产品的黑白名单项[[sku,sku]]
        contentarray
          idstring
          namestring
    storeConfigarray门店等黑白限制规则
      messageTplstring错误提示
      listTypestring黑白名单类型
      contentarray
        namestring
        idstring
  brandIdnumber品牌ID

返回数据

参数名称类型必填默认值备注其他信息
uuidstring请求序列号最大长度:50
最小长度:1
Mock:@now('yyyyMMdd')-@string('lower',32)
successboolean交易成功与否Mock:@boolean
actionstring交易类型最大长度:50
最小长度:1
Mock:addEcouponProduct
timestampnumber返回时间戳Mock:@timestamp
errorCodestring错误码最大长度:50
Mock:@word
errorMessagestring错误描述最大长度:50
Mock:@csentence
signTypestring签名类型最大长度:20
Mock:sha256
signstring签名值最大长度:500
Mock:@natural
contentobject返回报文
  productIdinteger券产品idMock:1

备注

productType 券类型

名称 类型值
三方券 thirdCoupon
换购券 exchangeCoupon
代金券 orderVoucher

sendChannelId 取码渠道ID

名称 ID
产品券 1
o2o_236充值接口制码 141
星巴克_第三方批导 159
O2O三方批导码 174
星巴克_立项专属(仅用于建行) 179

ruleConfig.buyGetConfig.codeType 规则类型

名称 类型值
sku 按商品编码,按照商品编码的话,下面的item要加上sku的ID
type 按品类编码
spec 按规格编码

ruleConfig.buyGetConfig.codeGroups
单组黑|白名单
    [[sku,sku]]

买赠规则,买1,2,3 增a,b,c
    [[1,2,3],[a,b,c]]

productConfig.codeType 券码类型

名称 类型值
compound 组合券类型,=后面带卡密
paperCode 纸质券类型,粽子和月饼券
initialCode 常规券类型,常规20位的券

productConfig 规则配置

{
    "codeType": "compound"
}

sceneConfig 规则配置 控制核销场景

{
    "ebuy1d0c0a81a9a4": {
        "usableValue": {
            "all": "全场景"
        },
        "applicationName": "实体门店核销"
    },
    "ebuywha102410076": {
        "usableValue": {
            "TS": "堂食",
            "WM": "外卖"
        },
        "applicationName": "星巴克组合支付"
    }
}

brandId 品牌ID,星巴克固定 674

变更历史

变更日期变更内容
2024-06-06
2024-06-03
2024-06-03
2024-05-30
2024-05-30
2024-05-29
2024-05-24
2024-05-24
2024-04-29
2024-04-28
2024-04-28
2024-04-28
2024-04-28
2024-04-28
2024-04-28
2024-04-28
2024-04-28
2024-04-28
2024-04-28
2024-04-28
2024-04-28
2024-04-28
2024-04-28
2024-04-26
2024-04-26
2024-04-26
2024-04-24
2024-04-24
2024-04-24
2024-04-24
2024-04-24
2024-04-24
2024-04-24
2024-04-24
2024-04-24
2024-04-24
2024-04-24
2024-04-24
2024-04-24
api-id=36408