# 商品满折满减促销新增修改

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/product/v1/addOrModifyFullDiscount/{openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体:

{
  "title": "商品达到满折满减",
  "code": "cuxiao-1101",
  "description": "以下商品满10件打8折",
  "startDate": "2020-11-24",
  "endDate": "2020-12-24",
  "tradeType": "3",
  "tradeRange": "2",
  "applyRangeType": "0",
  "maxSaleAmount": "1",
  "promotionType": "2",
  "calcUnitName": "箱",
  "calcType": "1",
  "deptName": "财务部3,营销一部",
  "customerLevelId": "8715900737400193117,6512588339505979227",
  "cmId": "7536574795612874580",
  "productTypes": [
    {
      "id": "6676783261756264839",
      "sourceCode": ""
    },
    {
      "id": "6676783261756264839",
      "sourceCode": ""
    }
  ],
  "promotionStep": [
    {
      "stepLimit": "10",
      "discountAmount": "5",
      "discountRatio": ""
    }
  ]
}

请求信息

参数 类型 必 填 说明
title VARCHAR(100) 促销主题
code VARCHAR(100) 促销方案编号,新增操作时code不能为空。促销id,促销方案第三方编码,促销方案编号不能同时为空,fullDiscountId、sourceCode、code如果同时存在,优先级依次降低
sourceCode VARCHAR(100) 促销方案第三方编码。促销id,促销方案第三方编码,促销方案编号不能同时为空,fullDiscountId、sourceCode、code如果同时存在,优先级依次降低
fullDiscountId VARCHAR(32) 促销id,促销方案第三方编码,促销方案编号不能同时为空,fullDiscountId、sourceCode、code如果同时存在,优先级依次降低
description VARCHAR(100) 促销说明
startDate VARCHAR(32) 开始日期 格式必须是yyyy-MM-dd
endDate VARCHAR(32) 结束日期 格式必须是yyyy-MM-dd
tradeType VARCHAR(32) 促销对象 1:标准客户 2 :经销商 3: 终端门店
tradeRange VARCHAR (32) 客户范围 1:指定客户范围 2:指定具体客户
applyRangeType VARCHAR (32) 适用范围 0 不限 1 业务员代下单 2 客户自主下单 不传默认0
maxSaleAmount VARCHAR(100) 累计促销额度
promotionType VARCHAR(32) 促销类型 1:按数量;2:按金额
calcType VARCHAR(32) 促销规则 1:满折;2:满减
fullMinusRule VARCHAR(32) 满减规则 0阶梯满减;1循环满减(当calcType=2才能启用) 不传默认0
calcUnitName VARCHAR(32) 商品统计单位 promotionType=1时必传
productType VARCHAR(32) 1:按商品,2:按商品类型
deptId VARCHAR(32) 客户属性 部门id 多个逗号分隔
deptName VARCHAR(100) 客户属性 部门名称,多个用英文逗号分隔
deptCode VARCHAR(100) 客户属性 部门编码,多个用英文逗号分隔
deptSourceCode VARCHAR(100) 客户属性 部门第三方系统的唯一标识,多个用英文逗号分隔
customerLevelId VARCHAR(32) 客户属性 客户级别id,多个用英文逗号分隔
customerLevelSourceCode VARCHAR(100) 客户属性 客户级别第三方系统的唯一标识,多个用英文逗号分隔
customerLevelName VARCHAR(100) 客户属性 客户级别名称,多个用英文逗号分隔
districtLevelId VARCHAR(32) 客户属性 销售区域级别id,多个用英文逗号分隔
districtLevelCode VARCHAR(100) 客户属性 销售区域级别编码,多个用英文逗号分隔
districtLevelName VARCHAR(100) 客户属性 销售区域级别名称,多个用英文逗号分隔
typeId VARCHAR(32) 客户属性 类型id,多个用英文逗号分隔
typeCode VARCHAR(100) 客户属性 类型编码,多个用英文逗号分隔
typeName VARCHAR(100) 客户属性 类型名称,多个用英文逗号分隔
typeSourceCode VARCHAR(100) 客户属性 类型第三方系统的唯一标识,多个用英文逗号分隔
districtId VARCHAR(32) 客户属性 销售区域id,多个用英文逗号分隔
districtCode VARCHAR(100) 客户属性 销售区域编码,多个用英文逗号分隔
districtName VARCHAR(100) 客户属性 销售区域名称,多个用英文逗号分隔
districtSourceCode VARCHAR(100) 客户属性 销售区域第三方系统的唯一标识,多个用英文逗号分隔
uperCusId VARCHAR(32) 客户属性 上级客户id,多个用英文逗号分隔
uperCusCode VARCHAR(100) 客户属性 上级客户编码,多个用英文逗号分隔
uperCusName VARCHAR(100) 客户属性 上级客户名称,多个用英文逗号分隔
uperCusSourceCode VARCHAR(100) 客户属性 上级客户第三方系统的唯一标识,多个用英文逗号分隔
kasysId VARCHAR(32) 客户属性 ka系统id,多个用英文逗号分隔
kasysName VARCHAR(100) 客户属性 ka系统名称,多个用英文逗号分隔
dealerId VARCHAR(32) 客户属性 经销商id,多个用英文逗号分隔
dealerCode VARCHAR(100) 客户属性 经销商编码,多个用英文逗号分隔
dealerName VARCHAR(100) 客户属性 经销商名称,多个用英文逗号分隔
dealerSourceCode VARCHAR(100) 客户属性 经销商第三方系统的唯一标识,多个用英文逗号分隔
gradationId VARCHAR(32) 客户属性 客户层次id,多个用英文逗号分隔
gradationCode VARCHAR(100) 客户属性 客户层次编码,多个用英文逗号分隔
gradationName VARCHAR(100) 客户属性 客户层次名称,多个用英文逗号分隔
perScaleId VARCHAR(32) 客户属性 人员规模id,多个用英文逗号分隔
perScaleName VARCHAR(100) 客户属性 人员规模名称,多个用英文逗号分隔
cusSourceId VARCHAR(32) 客户属性 来源id,多个用英文逗号分隔
cusSourceName VARCHAR(100) 客户属性 来源名称,多个用英文逗号分隔
tradeId VARCHAR(32) 客户属性 行业id,多个用英文逗号分隔
tradeName VARCHAR(100) 客户属性 行业名称,多个用英文逗号分隔
tradingareaBigId VARCHAR(32) 客户属性 大商圈id,多个用英文逗号分隔
tradingareaBigName VARCHAR(100) 客户属性 大商圈名称,多个用英文逗号分隔
tradingareaNomalId VARCHAR(32) 客户属性 商圈id,多个用英文逗号分隔
tradingareaNomalName VARCHAR(100) 客户属性 商圈名称,多个用英文逗号分隔
exts[].cmExtKey VARCHAR(100) 自定义字段key
exts[].cmExtValue VARCHAR(4000) 自定义字段value,多个用英文逗号分隔
cmId VARCHAR(2000) 指定客户 经销商id,多个用英文逗号分隔。tradeRange为1时,cmId、cmSourceCode、 cmCode、cmName不能同时为空,如果同时存在,优先级依次降低
cmCode VARCHAR(4000) 指定客户 经销商编码,多个用英文逗号分隔。tradeRange为1时,cmId、cmSourceCode、 cmCode、cmName不能同时为空,如果同时存在,优先级依次降低
cmName VARCHAR(4000) 指定客户 经销商名称,多个用英文逗号分隔。tradeRange为1时,cmId、cmSourceCode、 cmCode、cmName不能同时为空,如果同时存在,优先级依次降低
cmSourceCode VARCHAR(4000) 指定客户 经销商第三方系统的唯一标识,多个用英文逗号分隔。tradeRange为1时,cmId、cmSourceCode、 cmCode、cmName不能同时为空,如果同时存在,优先级依次降低
products[].id VARCHAR(32) 商品id,id、code、sourceCode不能同时为空
products[].code VARCHAR(100) 商品编码,id、code、sourceCode不能同时为空
products[].sourceCode VARCHAR (100) 商品第三方系统的唯一标识,id、code、sourceCode不能同时为空
productTypes[].id VARCHAR(32) 商品类型id,商品类型id和商品类型第三方系统的唯一标识不能同时为空
productTypes[].sourceCode VARCHAR (100) 商品类型第三方系统的唯一标识,商品类型id和商品类型第三方系统的唯一标识不能同时为空个
promotionStep[].stepLimit VARCHAR(32) 坎级起始值
promotionStep[].discountAmount VARCHAR(32) 坎级的满减数量,满减时使用且必传
promotionStep[].discountRatio VARCHAR(32) 坎级的折扣,满折时使用且必传

返回结果:

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": "",
    "return_data": "{id:5932650281301050811}"
}

响应信息

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
return_data String 促销id

# 商品满折满减促销终止

请求方式: POST(HTTPS请求地址: https://openapi.waiqin365.com/api/product/v1/stopFullDiscount/{ openid }/{ timestamp }/{ digest }/{ msg_id } 请求包体:

{
    "fullDiscountId": "5932650281301050831"
}

请求信息

参数 类型 必填 说明
fullDiscountId VARCHAR(32) 满折满减促销id,fullDiscountId、sourceCode、code不能同时为空,如果同时存在,优先级依次降低
code VARCHAR(100) 满折满减促销编号,fullDiscountId、sourceCode、code不能同时为空,如果同时存在,优先级依次降低
sourceCode VARCHAR(100) 促销方案第三方编码,fullDiscountId、sourceCode、code不能同时为空,如果同时存在,优先级依次降低

返回结果:

{
    "msg_id": "PRD00002",
    "return_code": 100205,
    "return_msg": "满折满减促销ID、编号不能同时为空!"
}

响应信息

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他详见附录错误码说明 (opens new window)
return_msg String 响应说明