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