# 商品买赠促销新增修改

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/product/v1/addOrModifyPromotion/{openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:


{
    "name": "主品达到满赠数量,送固定数量赠品", 
    "code": "cuxiao-1117",
    "desc": "满10赠1份赠品",
    "startDate": "2019-07-01",
    "endDate": "2020-07-31",
    "tradeType": "3",
    "cusRangeType": "2",
    "applyRangeType": "0",
    "overType":"1",
    "estimateSalesAmount": "10000",
    "promotionType": "0",
    "isMustInclude": "1",
    "calcMode": "0",
    "promotionMode":"1",
    "calcType": "1",
    "giftMode": "1",
    "unitName": "箱",
    "promotionSend": "0",
    "giftType": "3",
    "giftChooseNum":"1", 
    "deptName": "零售部",
    "typeName": "南京,建邺",
    "customerLevelName": "A,B",
    "ladderGift": "0",
    "products": [{
        "code": "102",
        "mustInclude": "1",
        "mustNum": "2"
        },
        {
        "code": "103",
         "mustInclude": "1",
         "mustNum": "3"
    }],
    "gifts": [{
        "code": "wq_guozhi_001",
        "unitName": "瓶",
        "price":"7",
        "num": "1"
        },{
        "code": "wq_guozhi_002",
        "unitName": "瓶",
        "price":"7",
        "num": "2"
    }],
    "step": [{
        "calcLimit": "10",
        "num":"2",
        "seq":"1",
        "gifts": [{
                "code": "wq_guozhi_001",
                "unitName": "瓶",
                "price":"7",
                "num": "1"
                },{
                "code": "wq_guozhi_002",
                "unitName": "瓶",
                "price":"7",
                "num": "2"
            }]
    }],
    "additionPromotions":[
        {
            "promotionMode":"1",
            "giftMode": "1",
            "giftType": "3",
            "giftChooseNum":"1", 
            "products": [
                {
                    "id": "",
                    "code": "102"
                },
                {
                    "id": "",
                    "code": "103"
                }
            ],
            "gifts": [{
                "code": "wq_guozhi_001",
                "unitName": "瓶",
                "price":"7",
                "num": "1"
                },{
                "code": "wq_guozhi_002",
                "unitName": "瓶",
                "price":"7",
                "num": "2"
            }],
            "step": [{
                "calcLimit": "10",
                "num":"2",
                "seq":"1"
            }]
        }
    ]
}

请求信息

参数 类型 必填 说明
name VARCHAR(100) 促销方案名称
code VARCHAR(100) 促销方案编号,新增操作时code不能为空。促销方案编号、促销方案第三方编码、促销id不能同时为空。promotionId、sourceCode、code如果同时存在,优先级依次降低
sourceCode VARCHAR(100) 促销方案第三方编码。促销方案编号、促销方案第三方编码、促销id不能同时为空。promotionId、sourceCode、code如果同时存在,优先级依次降低
promotionId VARCHAR(32) 促销id。促销方案编号、促销方案第三方编码、促销id不能同时为空。promotionId、sourceCode、code如果同时存在,优先级依次降低
desc VARCHAR(4000) 促销说明
startDate VARCHAR(32) 开始日期,格式必须是yyyy-MM-dd
endDate VARCHAR(32) 结束日期,格式必须是yyyy-MM-dd
tradeType VARCHAR(32) 促销对象,取值范围:1:标准客户;2:经销商;3:终端门店
cusRangeType VARCHAR (32) 客户范围,取值范围:2:按客户属性设置范围;1: 指定具体客户
applyRangeType VARCHAR (32) 适用范围,默认值为0。取值范围:0:不限;1:业务员代下单;2:客户自主下单
overType VARCHAR(32) 叠加促销。取值范围:1:是;不传:否。若promotionType为1,则本参数不传
estimateSalesAmount VARCHAR(100) 预计销售额
promotionType VARCHAR(32) 促销类型,取值范围:0:按数量;1:按金额
isMustInclude VARCHAR(32) 是否必含。取值范围:0:无必含;2:必含任一;1:必含全部。若calcType为3或6或7,则本参数不得传1或2
calcMode VARCHAR(32) 启用坎级。取值范围:1:启用;空或者其他:不启用
promotionMode VARCHAR(32) 主品范围。取值范围:1:商品;3:同价码
calcType VARCHAR(32) 促销子类型 1 主品达到满赠数量,送固定数量赠品 2 主品达到满赠金额,送固定数量赠品 3 主品达到满赠数量,按主品的数量比例送赠品 4 主品达到满赠数量,送固定金额的赠品 5 主品达到满赠金额,送固定金额的赠品 6 主品达到满赠数量,按主品的数量比例送赠品 7 主品达到满赠金额,按主品的金额比 promotionType传0 promotionType只能传 1 2 3 promotionType传1 promotionType只能传 4 5 6 7
promotionSend VARCHAR(32) 满送规则。取值范围:0:满X送Y;1:每满X送Y;若calcType为1或2或4或5,则本参数必传
giftMode VARCHAR(32) 赠品范围。取值范围:1:按商品;2:按同价码;3:不限商品;若promotionType为0,calcType为1或2,则giftMode只能传1;若promotionType为0,calcType为3,则giftMode只能传1或2,不能传3
giftType VARCHAR(32) 赠品赠送方式。取值范围:1:赠送全部;2:任一赠品;3:任选其几;若calcType为1或2,则本参数必传
giftChooseNum VARCHAR(32) 赠品种数。若giftType为3,则本参数必填
unitName VARCHAR(32) 单位名称。若calcType为1或3或4或6,则本参数必传;若isMustInclude为1或2,则本参数必传
ownerDeptId VARCHAR(32) 所属部门id。ownerDeptId、ownerDeptSource、CodeownerDeptCode、ownerDeptName不能同时为空,如果同时存在,优先级依次降低
ownerDeptName VARCHAR(100) 所属部门名称。ownerDeptId、ownerDeptSource、CodeownerDeptCode、ownerDeptName不能同时为空,如果同时存在,优先级依次降低
ownerDeptCode VARCHAR(100) 所属部门编码。ownerDeptId、ownerDeptSource、CodeownerDeptCode、ownerDeptName不能同时为空,如果同时存在,优先级依次降低
ownerDeptSourceCode VARCHAR(100) 所属部门第三方系统的唯一标识。ownerDeptId、ownerDeptSource、CodeownerDeptCode、ownerDeptName不能同时为空,如果同时存在,优先级依次降低
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、cmSourceCode、 cmCode、cmName不能同时为空,如果同时存在,优先级依次降低
cmCode VARCHAR(4000) 指定客户 经销商编码,多个用英文逗号分隔。cusRangeType为1时,cmId、cmSourceCode、 cmCode、cmName不能同时为空,如果同时存在,优先级依次降低
cmName VARCHAR(4000) 指定客户 经销商名称,多个用英文逗号分隔。cusRangeType为1时,cmId、cmSourceCode、 cmCode、cmName不能同时为空,如果同时存在,优先级依次降低
cmSourceCode VARCHAR(4000) 指定客户 经销商第三方系统的唯一标识,多个用英文逗号分隔。cusRangeType为1时,cmId、cmSourceCode、 cmCode、cmName不能同时为空,如果同时存在,优先级依次降低
mustAllAddition VARCHAR(32) 附加促销案同时满足:1:是;0:否;默认0
ladderGift VARCHAR(32) 是否启用坎级促销:1:是;0:否;默认0
products[].id VARCHAR(32) 主品id。id、source_code、code不能同时为空,如果同时存在,优先级依次降低
products[].code VARCHAR(100) 主品编码。id、source_code、code不能同时为空,如果同时存在,优先级依次降低
products[].sourceCode VARCHAR (100) 主品第三方系统的唯一标识。id、source_code、code不能同时为空,如果同时存在,优先级依次降低
products[].mustInclude VARCHAR (32) 是否必含,取值范围:0:非必含; 1: 必含
products[].mustNum VARCHAR(32) 必含数量
products[].priceCode VARCHAR(32) 主品同价码。若传入promotionMode为3,则本参数必填
gifts[].id VARCHAR(32) 不启用坎级促销使用此字段,赠品id。id、source_code、code不能同时为空,如果同时存在,优先级依次降低
gifts[].code VARCHAR(100) 不启用坎级促销使用此字段,赠品编码。id、source_code、code不能同时为空,如果同时存在,优先级依次降低
gifts[].sourceCode VARCHAR (100) 不启用坎级促销使用此字段,赠品第三方系统的唯一标识。id、source_code、code不能同时为空,如果同时存在,优先级依次降低
gifts[].unitId VARCHAR(32) 不启用坎级促销使用此字段,赠品单位id,若calcType传1或2,unitId和unitName不能同时为空
gifts[].unitName VARCHAR(100) 不启用坎级促销使用此字段,赠品单位名称,若calcType传1或2,unitId和unitName不能同时为空
gifts[].price VARCHAR (32) 不启用坎级促销使用此字段,价格,整数位不大于7位
gifts[].num VARCHAR(32) 不启用坎级促销使用此字段,数量,若calcType传1或2,则本参数必填
gifts[].priceCode VARCHAR (32) 不启用坎级促销使用此字段,同价码,若giftMode为2,则本参数必填
step[].calcLimit VARCHAR(32) 坎级 满送数量 必须大于0整数
step[].num VARCHAR(32) 坎级 赠品赠送数量或比例 数量为非零整数 比例 1-100 之间 支持小数
step[].seq VARCHAR(32) 坎级 排序。当坎级促销时,step[].seq和stepProduct[].seq保持一致,默认从1开始
step[].gifts[].id VARCHAR(32) 启用坎级促销使用此字段,赠品id。id、source_code、code不能同时为空,如果同时存在,优先级依次降低
step[].gifts[].code VARCHAR(100) 启用坎级促销使用此字段,赠品编码。id、source_code、code不能同时为空,如果同时存在,优先级依次降低
step[].gifts[].sourceCode VARCHAR (100) 启用坎级促销使用此字段,赠品第三方系统的唯一标识。id、source_code、code不能同时为空,如果同时存在,优先级依次降低
step[].gifts[].unitId VARCHAR(32) 启用坎级促销使用此字段,赠品单位id,若calcType传1或2,unitId和unitName不能同时为空
step[].gifts[].unitName VARCHAR(100) 启用坎级促销使用此字段,赠品单位名称,若calcType传1或2,unitId和unitName不能同时为空
step[].gifts[].price VARCHAR (32) 启用坎级促销使用此字段,价格,整数位不大于7位
step[].gifts[].num VARCHAR(32) 启用坎级促销使用此字段,数量,若calcType传1或2,则本参数必填
step[].gifts[].priceCode VARCHAR (32) 启用坎级促销使用此字段,同价码,若giftMode为2,则本参数必填
stepProduct 若calcMode传1,isMustInclude传1或者2,则本参数必填
stepProduct[].id VARCHAR(32) 坎级主品id。id、source_code、code不能同时为空,如果同时存在,优先级依次降低
stepProduct[].code VARCHAR(100) 坎级主品编码。id、source_code、code不能同时为空,如果同时存在,优先级依次降低
stepProduct[].sourceCode VARCHAR (100) 坎级主品第三方系统的唯一标识。id、source_code、code不能同时为空,如果同时存在,优先级依次降低
stepProduct[].mustNum VARCHAR(32) 必含数量
stepProduct[].seq VARCHAR(32) 坎级 排序。当坎级促销时,stepProduct[].seq和step[].seq保持一致,默认从1开始
stepProduct[].priceCode VARCHAR (32) 同价码
additionPromotions[].promotionMode VARCHAR(32) 主品范围:1:商品;3:同价码
additionPromotions[].giftMode VARCHAR(32) 赠品范围 1:按商品, 2:按同价码,3:不限商品;主促销promotionType 为0 calcType 为 1 2 giftMode 只能传1 主促销promotionType 为0 calcType 为 3 giftMode 只能传1 2 不能传3
additionPromotions[].giftType VARCHAR(32) 赠品赠送方式 1 赠送全部 2 任一赠品 3 任选其几 calcType 为 1 2 必传
additionPromotions[].giftChooseNum VARCHAR(32) 赠品种数 giftType 为 3 必传
additionPromotions[].products[].id VARCHAR(32) 主品id。id、source_code、code不能同时为空,如果同时存在,优先级依次降低
additionPromotions[].products[].code VARCHAR(100) 主品编码。id、source_code、code不能同时为空,如果同时存在,优先级依次降低
additionPromotions[].products[].sourceCode VARCHAR (100) 主品第三方系统的唯一标识。id、source_code、code不能同时为空,如果同时存在,优先级依次降低
additionPromotions[].products[].priceCode VARCHAR(32) 主品同价码,若promotionMode为3,则本参数必填
additionPromotions[].gifts[].id VARCHAR(32) 赠品id。id、source_code、code不能同时为空,如果同时存在,优先级依次降低
additionPromotions[].gifts[].code VARCHAR(100) 赠品编码。id、source_code、code不能同时为空,如果同时存在,优先级依次降低
additionPromotions[].gifts[].sourceCode VARCHAR (100) 赠品第三方系统的唯一标识。id、source_code、code不能同时为空,如果同时存在,优先级依次降低
additionPromotions[].gifts[].unitId VARCHAR(32) 赠品单位id。若主促销calcType传1或2,unitId和unitName不能同时为空
additionPromotions[].gifts[].unitName VARCHAR(100) 赠品单位名称。若主促销calcType传1或2,unitId和unitName不能同时为空
additionPromotions[].gifts[].price VARCHAR (32) 价格 整数位不大于7位
additionPromotions[].gifts[].num VARCHAR(32) 数量。若主促销calcType传1或2,则本参数必填
additionPromotions[].gifts[].priceCode VARCHAR (32) 同价码。若giftMode为2,则本参数必填
additionPromotions[].step[].calcLimit VARCHAR(32) 坎级 满送数量 必须大于0整数
additionPromotions[].step[].num VARCHAR(32) 坎级 赠品赠送数量或比例 数量为非零整数 比例 1-100 之间 支持小数
additionPromotions[].step[].seq VARCHAR(32) 坎级 排序 默认从1开始

返回结果:

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

响应信息

参数 类型 说明
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/stopPromotion/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:

{
    "promotionId": "5932650281301050831"
}

请求信息

参数 类型 必填 说明
promotionId VARCHAR(32) 买赠促销id promotionId code sourceCode 传一个 不做正确性校验 当promotionId、sourceCode、code都传时,优先级依次是promotionId、sourceCode、code
code VARCHAR(100) 买赠促销编号 promotionId code sourceCode 传一个 不做正确性校验 当promotionId、sourceCode、code都传时,优先级依次是promotionId、sourceCode、code
sourceCode VARCHAR(100) 促销方案第三方编码 promotionId code sourceCode 传一个 不做正确性校验 当promotionId、sourceCode、code都传时,优先级依次是promotionId、sourceCode、code

返回结果:

{
    "msg_id": "PRD00001",
    "return_code": 100605,
    "return_msg": "买赠促销ID、编号不能同时为空!"
}

响应信息

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

# 按具体客户设置的促销案移除客户

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/product/v1/deletePromotionCustomer/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:

{
    "promotionId": "5932650281301050831",
    "cmId": "8590918626089497578"
}

请求信息

参数 类型 必填 说明
promotionId VARCHAR(32) 买赠促销id。promotionId、sourceCode、code不能同时为空,如果同时存在,优先级依次降低
code VARCHAR(100) 买赠促销编号。promotionId、sourceCode、code不能同时为空,如果同时存在,优先级依次降低
sourceCode VARCHAR(100) 促销方案第三方编码。promotionId、sourceCode、code不能同时为空,如果同时存在,优先级依次降低
cmId VARCHAR(2000) 指定客户 经销商id,多个用英文逗号分隔。cmId、cmSourceCode、cmCode、cmName不能同时为空,如果同时存在,优先级依次降低
cmCode VARCHAR(4000) 指定客户 经销商编码,多个用英文逗号分隔。cmId、cmSourceCode、cmCode、cmName不能同时为空,如果同时存在,优先级依次降低
cmName VARCHAR(4000) 指定客户 经销商名称,多个用英文逗号分隔。cmId、cmSourceCode、cmCode、cmName不能同时为空,如果同时存在,优先级依次降低
cmSourceCode VARCHAR(4000) 指定客户 经销商第三方系统的唯一标识,多个用英文逗号分隔。cmId、cmSourceCode、cmCode、cmName不能同时为空,如果同时存在,优先级依次降低

返回结果:

{
    "msg_id": "PRD00001",
    "return_code": 100605,
    "return_msg": "买赠促销ID、编号不能同时为空!"
}

响应信息

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

# 查询买赠促销接口

请求方式:** POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/product/v1/queryPromotion/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:


{
    "promotionId":"8513121636572377191",
    "code":"",
    "sourceCode":"",
    "tradeType":"",
    "ownerDeptIds":"",
	"start_create_date":"2021-03-29",
	"end_create_date":"2021-03-29",
	"start_modify_date":"2021-03-29",
	"end_modify_date":"2021-03-29"
}

请求信息

参数 类型 必填 说明
promotionId VARCHAR(32) 买赠促销id。promotionId、sourceCode、code如果同时存在,优先级依次降低
code VARCHAR(100) 买赠促销编号。promotionId、sourceCode、code如果同时存在,优先级依次降低
sourceCode VARCHAR(100) 促销方案第三方编码。promotionId、sourceCode、code如果同时存在,优先级依次降低
tradeType VARCHAR(32) 促销对象 1 标准客户 2 经销商 3 终端门店
ownerDeptIds VARCHAR(100) 部门id(查询时不级联下级部门),多个用英文逗号分隔
start_create_date TIMESTAMP 创建时间开始,格式:“yyyy-MM-dd”
end_create_date TIMESTAMP 创建时间结束,格式:“yyyy-MM-dd”
start_modify_date TIMESTAMP 修改时间开始,格式:“yyyy-MM-dd”
end_modify_date TIMESTAMP 修改时间结束,格式:“yyyy-MM-dd”
page_number INT 页码默认1
page_length INT 每页记录条数,page_length为空时不分页

返回结果:

{
    "return_code":"0",
    "return_msg":null,
    "msg_id":null,
    "response_data":
    [
        {
            "id":"8513121636572377191",
            "status":"1",
            "code":"base02",
            "sourceCode":"",
            "name":"base02",
            "desc":"base02",
            "createTime":"2021-03-30 14:53:17",
            "modifyTime":"2021-04-01 09:25:28",
            "startDate":"2021-04-03",
            "endDate":"2021-04-03",
            "promotionStatus":"TODO",
            "tradeType":"3",
            "cusRangeType":"2",
            "applyRangeType":"0",
            "overType":"",
            "estimateSalesAmount":"",
            "promotionType":"0",
            "isMustInclude":"0",
            "calcMode":"0",
            "calcType":"1",
            "promotionMode":"1",
            "promotionSend":"0",
            "giftMode":"1",
            "giftType":"1",
            "giftChooseNum":null,
            "unitName":"箱",
            "customerDept":[
                {
                    "sourceCode":null,
                    "code":"",
                    "name":"领导层",
                    "id":"6831472257980005622"
                }
            ],
            "dealer":[
                {
                    "sourceCode":null,
                    "code":"CUS000002",
                    "name":"直营经销商",
                    "id":"8078723553496786531"
                }
            ],
            "district":[
                {
                    "sourceCode":null,
                    "code":null,
                    "name":"北京",
                    "id":"21"
                }
            ],
            "districtLevel":[
                {
                    "code":"01",
                    "name":"商圈等级01",
                    "id":"7262791226267413030"
                }
            ],
            "extField":[
                {
                    "extKey":"exdf_315220",
                    "extName":"NPOS客户",
                    "extValue":"否"
                }
            ],
            "ownerDeptCode":"",
            "ownerDeptId":"6831472257980005622",
            "ownerDeptName":"领导层",
            "ownerDeptSourceCode":"",
            "trade":"",
            "perScale":"",
            "kaSys":"乐购,麦德龙",
            "promotionCustomer":[],
            "promotionProduct":[
                {
                    "pdCode":"10002",
                    "priceCode":null,
                    "pdSourceCode":null,
                    "mustNum":0,
                    "mustInclude":"0",
                    "pdId":"7407531258183844770"
                }
            ],
            "promotionProductType":[],
            "promotionStep":[
                {
                    "calcGiftRatio":null,
                    "giftCount":"1",
                    "calcGiftAmount":null,
                    "calcLimit":"2",
                    "promotionGift":[
                        {
                            "pdCode":"12428312",
                            "priceCode":null,
                            "unitName":"EA",
                            "pdSourceCode":null,
                            "price":1,
                            "num":1,
                            "unitId":9169148270007998246,
                            "pdId":"6764860176378859575"
                        }
                     ]
                }
            ],
            "tradingareaBig":[
                {
                    "name":"大商圈01",
                    "id":"6272513770095625958"
                }
            ],
            "tradingareaNomal":[
                {
                    "name":"商圈01",
                    "id":"8967982663644204305"
                }
            ],
            "uperCustomer":[],
            "hasAddition":"0",
            "mustAllAddition":"0",
            "additionPromotions":[]
        }
    ]
}

响应信息

参数 类型 必填 说明
msg_id String 消息ID
return_code int 响应编码:0成功 1失败
return_msg String 响应说明
response_data 响应数据体[{......}]
id VARCHAR(32) 促销id
status VARCHAR(32) 状态 0 删除 1 正常
code VARCHAR(100) 促销方案编号
sourceCode VARCHAR(100) 促销方案第三方编码
name VARCHAR(100) 促销方案名称
desc VARCHAR(4000) 促销说明
createTime VARCHAR(32) 创建时间 格式:yyyy-MM-dd HH:mm:ss
modifyTime VARCHAR(32) 修改时间 格式:yyyy-MM-dd HH:mm:ss
startDate VARCHAR(32) 开始日期 格式:yyyy-MM-dd
endDate VARCHAR(32) 结束日期 格式:yyyy-MM-dd
promotionStatus VARCHAR(32) 促销状态 TODO 未开始 DOING 进行中 OVER 已过期 STOP 已终止
tradeType VARCHAR(32) 促销对象 1标准客户 2 经销商 3 终端门店
cusRangeType VARCHAR (32) 客户范围 2 按客户属性设置范围 1 指定具体客户
applyRangeType VARCHAR (32) 适用范围 0 不限 1 业务员代下单 2 客户自主下单
overType VARCHAR(32) 叠加促销 1 是 其他 否
estimateSalesAmount VARCHAR(100) 预计销售额
promotionType VARCHAR(32) 促销类型 0 按数量 1 按金额
isMustInclude VARCHAR(32) 是否必含 0 无必含 2必含任一 1必含全部
calcMode VARCHAR(32) 启用坎级 1 启用 空或者其他 不启用
promotionMode VARCHAR(32) 主品范围 1 商品 2:商品类型 3 同价码
calcType VARCHAR(32) 促销子类型 1 主品达到满赠数量,送固定数量赠品 2 主品达到满赠金额,送固定数量赠品 3 主品达到满赠数量,按主品的数量比例送赠品 4 主品达到满赠数量,送固定金额的赠品 5 主品达到满赠金额,送固定金额的赠品 6 主品达到满赠数量,按主品的数量比例送赠品 7 主品达到满赠金额,按主品的金额比
promotionSend VARCHAR(32) 满送规则 0:满X送Y,1:每满X送Y
giftMode VARCHAR(32) 赠品范围 1:按商品, 2:按同价码,3:不限商品
giftType VARCHAR(32) 赠品赠送方式 1 赠送全部 2 任一赠品 3 任选其几
giftChooseNum VARCHAR(32) 赠品种数
unitName VARCHAR(32) 单位名称
ownerDeptId VARCHAR(32) 所属部门id
ownerDeptName VARCHAR(100) 所属部门名称
ownerDeptCode VARCHAR(100) 所属部门编码
ownerDeptSourceCode VARCHAR(100) 所属部门第三方系统的唯一标识
hasAddition VARCHAR(32) 是否有附加促销
mustAllAddition VARCHAR(32) 附加促销案同时满足:1:是;0:否
ladderGift VARCHAR(32) 是否启用坎级促销:1:是;0:否
customerDept[].id VARCHAR(32) 客户属性 部门id
customerDept[].code VARCHAR(100) 客户属性 部门编码
customerDept[].sourceCode VARCHAR(100) 客户属性 部门第三方系统唯一标识
customerDept[].name VARCHAR(100) 客户属性 部门名称
customerLevel[].id VARCHAR(32) 客户属性 客户等级id
customerLevel[].sourceCode VARCHAR(100) 客户属性 客户等级第三方系统唯一标识
customerLevel[].name VARCHAR(100) 客户属性 客户等级名称
customerType[].id VARCHAR(32) 客户属性 客户类型id
customerType[].code VARCHAR(100) 客户属性 客户类型编码
customerType[].sourceCode VARCHAR(100) 客户属性 客户类型第三方系统唯一标识
customerType[].name VARCHAR(100) 客户属性 客户类型名称
customerGradation[].id VARCHAR(32) 客户属性 客户层次id
customerGradation[].code VARCHAR(100) 客户属性 客户层次编码
customerGradation[].sourceCode VARCHAR(100) 客户属性 客户层次第三方系统唯一标识
customerGradation[].name VARCHAR(100) 客户属性 客户层次名称
customerGradation[].parentId VARCHAR(32) 客户属性 客户层次上级id
customerGradation[].parentCode VARCHAR(100) 客户属性 客户层次上级编码
customerGradation[].parentSourceCode VARCHAR(100) 客户属性 客户层次上级第三方系统唯一标识
customerGradation[].parentName VARCHAR(100) 客户属性 客户层次上级名称
district[].id VARCHAR(32) 客户属性 销售区域id
district[].code VARCHAR(100) 客户属性 销售区域编码
district[].sourceCode VARCHAR(100) 客户属性 销售区域第三方系统唯一标识
district[].name VARCHAR(100) 客户属性 销售区域名称
districtLevel[].id VARCHAR(32) 客户属性 销售区域等级id
districtLevel[].code VARCHAR(100) 客户属性 销售区域等级编码
districtLevel[].name VARCHAR(100) 客户属性 销售区域等级名称
uperCustomer[].Id VARCHAR(32) 客户属性 上级客户id
uperCustomer[].code VARCHAR(100) 客户属性 上级客户编码
uperCustomer[].sourceCode VARCHAR(100) 客户属性 上级客户第三方系统唯一标识
uperCustomer[].name VARCHAR(100) 客户属性 上级客户名称
dealer[].id VARCHAR(32) 客户属性 经销商id
dealer[].code VARCHAR(100) 客户属性 经销商编码
dealer[].sourceCode VARCHAR(100) 客户属性 经销商第三方系统唯一标识
dealer[].name VARCHAR(100) 客户属性 经销商名称
tradingareaBig[].id VARCHAR(32) 客户属性 大商圈id
tradingareaBig[].name VARCHAR(100) 客户属性 大商圈名称
tradingareaNomal[].id VARCHAR(32) 客户属性 商圈id
tradingareaNomal[].name VARCHAR(100) 客户属性 商圈名称
kaSys VARCHAR(100) 客户属性 ka系统名称 多个逗号隔开
perScale VARCHAR(100) 客户属性 人员规模 多个逗号隔开
customerSource VARCHAR(100) 客户属性 来源名称 多个逗号隔开
trade VARCHAR(100) 客户属性 行业名称 多个逗号隔开
extField[].extKey VARCHAR(32) 客户属性 自定义字段编码
extField[].extName VARCHAR(100) 客户属性 自定义字段名称
extField[].extValue VARCHAR(100) 客户属性 自定义字段值 多个逗号隔开
promotionCustomer[].cmId VARCHAR(32) 指定具体客户 客户id
promotionCustomer[].cmCode VARCHAR(100) 指定具体客户 客户编码
promotionCustomer[].cmSourceCode VARCHAR(100) 指定具体客户 客户第三方系统唯一标识
promotionCustomer[].cmName VARCHAR(100) 指定具体客户 客户名称
promotionProduct[].pdId VARCHAR(32) 主品 promotionMode=1 商品id
promotionProduct[].pdCode VARCHAR(100) 主品 promotionMode=1 商品编码
promotionProduct[].pdSourceCode VARCHAR(100) 主品 promotionMode=1 商品第三方系统唯一标识
promotionProduct[].priceCode VARCHAR(100) 主品 promotionMode=3 商品同价码
promotionProduct[].mustInclude VARCHAR(100) 主品 是否必含 0 非必含 1 必含
promotionProduct[].mustNum VARCHAR(100) 主品 必含数量
promotionProductType[].classId VARCHAR(32) 主品 promotionMode=2 商品类型id
promotionProductType[].className VARCHAR(100) 主品 promotionMode=2 商品类型编码
promotionProductType[].sourceCode VARCHAR(100) 主品 promotionMode=2 商品类型第三方系统唯一标识
promotionGift[].pdId VARCHAR(32) 坎级 赠品 商品id(ladderGift=0使用)
promotionGift[].pdCode VARCHAR(100) 坎级 赠品 商品编码(ladderGift=0使用)
promotionGift[].pdSourceCode VARCHAR(100) 坎级 赠品 promotionMode=1 商品第三方系统唯一标识(ladderGift=0使用)
promotionGift[].priceCode VARCHAR(100) 坎级 赠品 商品同价码(ladderGift=0使用)
promotionGift[].unitId VARCHAR(32) 坎级 赠品 单位id(ladderGift=0使用)
promotionGift[].unitName VARCHAR(100) 坎级 赠品 单位名称(ladderGift=0使用)
promotionGift[].price VARCHAR(100) 坎级 赠品 单价(ladderGift=0使用)
promotionGift[].num VARCHAR(100) 坎级 赠品 数量(ladderGift=0使用)
promotionStep[].stepLimit VARCHAR(100) 坎级 满送数量
promotionStep[].giftCount VARCHAR(100) 坎级 赠品赠送数量
promotionStep[].giftRatio VARCHAR(100) 坎级 赠品赠送比例
promotionStep[].giftAmount VARCHAR(100) 坎级 赠品赠送金额
promotionStep[].stepProduct[].stepDetailId VARCHAR(100) 坎级 必含id
promotionStep[].stepProduct[].pdId VARCHAR(32) 坎级 必含商品id
promotionStep[].stepProduct[].pdCode VARCHAR(100) 坎级 必含商品编码
promotionStep[].stepProduct[].pdSourceCode VARCHAR(100) 坎级 必含商品第三方唯一标识
promotionStep[].stepProduct[].priceCode VARCHAR(100) 坎级 必含商品同价码
promotionStep[].stepProduct[].class_id VARCHAR(32) 坎级 必含商品类型id
promotionStep[].stepProduct[].className VARCHAR(100) 坎级 必含商品类型名称
promotionStep[].stepProduct[].mustNum VARCHAR(100) 坎级 必含数量
promotionStep[].promotionGift[].pdId VARCHAR(32) 坎级 赠品 商品id(ladderGift=1使用)
promotionStep[].promotionGift[].pdCode VARCHAR(100) 坎级 赠品 商品编码(ladderGift=1使用)
promotionStep[].promotionGift[].pdSourceCode VARCHAR(100) 坎级 赠品 promotionMode=1 商品第三方系统唯一标识(ladderGift=1使用)
promotionStep[].promotionGift[].priceCode VARCHAR(100) 坎级 赠品 商品同价码(ladderGift=1使用)
promotionStep[].promotionGift[].unitId VARCHAR(32) 坎级 赠品 单位id(ladderGift=1使用)
promotionStep[].promotionGift[].unitName VARCHAR(100) 坎级 赠品 单位名称(ladderGift=1使用)
promotionStep[].promotionGift[].price VARCHAR(100) 坎级 赠品 单价(ladderGift=1使用)
promotionStep[].promotionGift[].num VARCHAR(100) 坎级 赠品 数量(ladderGift=1使用)
additionPromotions[].promotionMode VARCHAR(32) 主品范围 1 商品 3 同价码
additionPromotions[].giftMode VARCHAR(32) 赠品范围 1:按商品, 2:按同价码,3:不限商品
additionPromotions[].giftType VARCHAR(32) 赠品赠送方式 1 赠送全部 2 任一赠品 3 任选其几
additionPromotions[].giftChooseNum VARCHAR(32) 赠品种数
additionPromotions[].description VARCHAR(100) 促销描述
additionPromotions[].sequ VARCHAR(100) 顺序号
additionPromotions[].promotionProduct[].pdId VARCHAR(32) 主品 promotionMode=1 商品id
additionPromotions[].promotionProduct[].pdCode VARCHAR(100) 主品 promotionMode=1 商品编码
additionPromotions[].promotionProduct[].pdSourceCode VARCHAR(100) 主品 promotionMode=1 商品第三方系统唯一标识
additionPromotions[].promotionProduct[].priceCode VARCHAR(100) 主品 promotionMode=3 商品同价码
additionPromotions[].promotionStep[].stepLimit VARCHAR(100) 坎级 满送数量
additionPromotions[].promotionStep[].giftCount VARCHAR(100) 坎级 赠品赠送数量
additionPromotions[].promotionStep[].giftRatio VARCHAR(100) 坎级 赠品赠送比例
additionPromotions[].promotionStep[].giftAmount VARCHAR(100) 坎级 赠品赠送金额
additionPromotions[].promotionStep[].promotionGift[].pdId VARCHAR(32) 坎级 赠品 商品id
additionPromotions[].promotionStep[].promotionGift[].pdCode VARCHAR(100) 坎级 赠品 商品编码
additionPromotions[].promotionStep[].promotionGift[].pdSourceCode VARCHAR(100) 坎级 赠品 promotionMode=1 商品第三方系统唯一标识
additionPromotions[].promotionStep[].promotionGift[].priceCode VARCHAR(100) 坎级 赠品 商品同价码
additionPromotions[].promotionStep[].promotionGift[].unitId VARCHAR(32) 坎级 赠品 单位id
additionPromotions[].promotionStep[].promotionGift[].unitName VARCHAR(100) 坎级 赠品 单位名称
additionPromotions[].promotionStep[].promotionGift[].price VARCHAR(100) 坎级 赠品 单价
additionPromotions[].promotionStep[].promotionGift[].num VARCHAR(100) 坎级 赠品 数量