商品买赠促销新增修改

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


{
    "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",
    "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"
    }],
    "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) 促销方案编号 promotionId code sourceCode 传一个 新增必传 当promotionId、sourceCode、code都传时,优先级依次是promotionId、sourceCode、code
sourceCode VARCHAR(100) 促销方案第三方编码 promotionId code sourceCode 传一个 当promotionId、sourceCode、code都传时,优先级依次是promotionId、sourceCode、code
promotionId VARCHAR(32) 促销id 修改 promotionId code sourceCode 传一个 当promotionId、sourceCode、code都传时,优先级依次是promotionId、sourceCode、code
desc VARCHAR(100) 促销说明
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 不限 1 业务员代下单 2 客户自主下单 不传默认0
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 ownerDeptName ownerDeptCode ownerDeptSourceCode 必传一个
ownerDeptName VARCHAR(100) 所属部门名称 ownerDeptId ownerDeptName ownerDeptCode ownerDeptSourceCode 必传一个
ownerDeptCode VARCHAR(100) 所属部门编码 ownerDeptId ownerDeptName ownerDeptCode ownerDeptSourceCode 必传一个
ownerDeptSourceCode VARCHAR(100) 所属部门第三方系统的唯一标识 ownerDeptId ownerDeptName ownerDeptCode ownerDeptSourceCode 必传一个
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必传一个
mustAllAddition VARCHAR(32) 附加促销案同时满足:1:是;0:否;默认0
products[].id VARCHAR(32) 主品id id code source_code 传一个
products[].code VARCHAR(100) 主品编码 id code source_code传一个
products[].sourceCode VARCHAR (100) 主品第三方系统的唯一标识 id code source_code 传一个
products[].mustInclude VARCHAR (32) 是否必含 0 非必含 1 必含
products[].mustNum VARCHAR(32) 必含数量
products[].priceCode VARCHAR(32) 主品同价码 promotionMode为3 必传
gifts[].id VARCHAR(32) 赠品id id code source_code 传一个
gifts[].code VARCHAR(100) 赠品编码 id code source_code传一个
gifts[].sourceCode VARCHAR (100) 赠品第三方系统的唯一标识 id code source_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) 坎级 排序 当坎级促销时 seq 和stepProduct[].seq 一致 默认从1开始
stepProduct calcMode传1 isMustInclude传1或者2 必传
stepProduct[].id VARCHAR(32) 坎级主品id id code source_code 传一个
stepProduct[].code VARCHAR(100) 坎级主品编码 id code source_code传一个
stepProduct[].sourceCode VARCHAR (100) 坎级主品第三方系统的唯一标识 id code source_code 传一个
stepProduct[].mustNum VARCHAR(32) 必含数量
stepProduct[].seq VARCHAR(32) 坎级 排序 当坎级促销时 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 code source_code 传一个
additionPromotions[].products[].code VARCHAR(100) 主品编码 id code source_code传一个
additionPromotions[].products[].sourceCode VARCHAR (100) 主品第三方系统的唯一标识 id code source_code 传一个
additionPromotions[].products[].priceCode VARCHAR(32) 主品同价码 promotionMode为3 必传
additionPromotions[].gifts[].id VARCHAR(32) 赠品id id code source_code 传一个
additionPromotions[].gifts[].code VARCHAR(100) 赠品编码 id code source_code传一个
additionPromotions[].gifts[].sourceCode VARCHAR (100) 赠品第三方系统的唯一标识 id code source_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-失败, 其他参照附件错误码
return_msg String 响应说明
return_data String 促销id

商品买赠促销终止

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

{
    "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-失败, 其他参照附件错误码
return_msg String 响应说明

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

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

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

请求信息

参数 类型 必填 说明
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
cmId VARCHAR(2000) 指定客户 经销商id 多个逗号分隔 cmId cmCode cmName cmSourceCode必传一个
cmCode VARCHAR(4000) 指定客户 经销商编码 多个逗号分隔 cmId cmCode cmName cmSourceCode必传一个
cmName VARCHAR(4000) 指定客户 经销商名称 多个逗号分隔 cmId cmCode cmName cmSourceCode必传一个
cmSourceCode VARCHAR(4000) 指定客户 经销商第三方系统的唯一标识 多个逗号分隔 cmId cmCode cmName cmSourceCode必传一个

返回结果:

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

响应信息

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