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

请求方式: 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) 促销方案编号 fullDiscountId code sourceCode 传一个 新增必传 当fullDiscountId、sourceCode、code都传时,优先级依次是fullDiscountId、sourceCode、code
sourceCode VARCHAR(100) 促销方案第三方编码 fullDiscountId code sourceCode 传一个 当fullDiscountId、sourceCode、code都传时,优先级依次是fullDiscountId、sourceCode、code
fullDiscountId VARCHAR(32) 促销id 修改 fullDiscountId code sourceCode 传一个 当fullDiscountId、sourceCode、code都传时,优先级依次是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:满减
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 多个逗号分隔 cusRangeType 为1 cmId cmCode cmName cmSourceCode必传一个
cmCode VARCHAR(4000) 指定客户 经销商编码 多个逗号分隔 cusRangeType 为1 cmId cmCode cmName cmSourceCode必传一个
cmName VARCHAR(4000) 指定客户 经销商名称 多个逗号分隔 cusRangeType 为1 cmId cmCode cmName cmSourceCode必传一个
cmSourceCode VARCHAR(4000) 指定客户 经销商第三方系统的唯一标识 多个逗号分隔 cusRangeType 为1 cmId cmCode cmName cmSourceCode必传一个
products[].id VARCHAR(32) 商品id code sourceCode传一个
products[].code VARCHAR(100) 商品编码 id code sourceCode传一个
products[].sourceCode VARCHAR (100) 商品第三方系统的唯一标识 id code sourceCode传一个
productTypes[].id VARCHAR(32) 商品类型id 其中id sourceCode传一个
productTypes[].sourceCode VARCHAR (100) 商品类型第三方系统的唯一标识 id sourceCode传一个
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-失败, 其他参照附件错误码
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 code sourceCode 传一个 不做正确性校验 当fullDiscountId、sourceCode、code都传时,优先级依次是fullDiscountId、sourceCode、code
code VARCHAR(100) 满折满减促销编号 fullDiscountId code sourceCode 传一个 不做正确性校验 当fullDiscountId、sourceCode、code都传时,优先级依次是fullDiscountId、sourceCode、code
sourceCode VARCHAR(100) 促销方案第三方编码 fullDiscountId code sourceCode 传一个 不做正确性校验 当fullDiscountId、sourceCode、code都传时,优先级依次是fullDiscountId、sourceCode、code

返回结果:

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

响应信息

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他参照附件错误码
return_msg String 响应说明