API开放平台

TIP

# 商品买赠促销新增修改

请求方式： 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",
    "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",
        "mustIncludeTotalNum":"2",
        "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如果同时存在，优先级依次降低
creatorId VARCHAR(32) 否 提交人id，优先id
creatorCode VARCHAR(100) 否 提交人编码，优先id
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, 若calcType为8，则本参数不能传2
calcMode VARCHAR(32) 否 启用坎级。1：启用，空或者其他：不启用
promotionMode VARCHAR(32) 是 主品范围。1：商品，2:商品类型，3：同价码,4：商品范围
calcType VARCHAR(32) 是 促销子类型。1：主品达到满赠数量送固定数量赠品，2：主品达到满赠金额送固定数量赠品，3：主品达到满赠数量按主品的数量比例送赠品，4：主品达到满赠数量送固定金额的赠品，5：主品达到满赠金额送固定金额的赠品，6：主品达到满赠数量，按主品的数量比例送一定金额的赠品，7：主品达到满赠金额按主品的金额比，8：主品达到满赠数量，按主品的金额比例送赠品。如果promotionType传值为0，则calcType只能传1/2/3；如果promotionType传值为1，则calcType只能传4/5/6/7；如果promotionMode传值为2，则calcType只能传1/2；如果promotionMode传值为4，则calcType只能传1/8。主品范围和促销子类型的具体限制情况请参考“促销规则设置”。
promotionSend VARCHAR(32) 否 满送规则。0：满X送Y，1：每满X送Y。若calcType为1或2或4或5，则本参数必传，若calcType为8，则本参数只能传1
giftMode VARCHAR(32) 是 赠品范围。1：按商品，2：按同价码，3：不限商品。如果promotionType传值为0，calcType传值为1或2，则giftMode只能传1；如果promotionType传值为0，calcType传值为3，则giftMode只能传1/2，不能传3；如果promotionType传值为1，calcType传值为8，则giftMode只能3
giftType VARCHAR(32) 否 赠品赠送方式。1：赠送全部，3：任选其几，4：赠品任选。如果calcType传值为1或2，则本参数必传
giftChooseNum VARCHAR(32) 否 赠品种数。若giftType为3，则本参数必填
unitName VARCHAR(32) 否 单位名称。如果calcType传值为1/3/4/6/8，则本参数必传；如果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) 否 客户属性-商圈名称，多个值用“,”分隔
customerLabelId VARCHAR(32) 否 客户属性-终端标签id，多个值用“,”分隔
customerLabelName VARCHAR(100) 否 客户属性-终端标签名称，多个值用“,”分隔
cityLevelId VARCHAR(32) 否 客户属性-城市等级id，多个值用“,”分隔
cityLevelName VARCHAR(100) 否 客户属性-城市等级名称，多个值用“,”分隔
exts List 否 自定义字段列表
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
tpmActivityId VARCHAR(32) 否 TPM活动方案ID（ID，编码，名称任选其一）
tpmActivityCode VARCHAR(100) 否 TPM活动方案编码（ID，编码，名称任选其一）
tpmActivityName VARCHAR(100) 否 TPM活动方案名称（ID，编码，名称任选其一）
products List 否 列表
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，则本参数必填
products.typeName VARCHAR(32) 否 商品类型名称。如果promotionMode传值为2，则typeName和typeSourceCode必填一个，同时存在时优先级依次降低
products.typeSourceCode VARCHAR(32) 否 商品类型第三方系统的唯一标识。如果promotionMode传值为2，则typeName和typeSourceCode必填一个，同时存在时优先级依次降低
pdgroups List 否 商品范围列表
pdgroups.isMustInclude VARCHAR(32) 是 是否必含 1是 0否。如果promotionMode=4，则返回该字段
pdgroups.includeNum List 否 必含数量集合。几个坎级就有几个值
pdgroups.range List 否 商品属性集合
pdgroups.range.code VARCHAR(32) 是 条件编码
pdgroups.range.typeIds TEXT 否 类型ID，逗号分隔。typeIds，typeSourceCodes，typeNames任传一个 优先级依次降低
pdgroups.range.typeNames TEXT 否 类型名称，逗号分隔
pdgroups.range.typeSourceCodes TEXT 否 类型第三方系统唯一标识，逗号分隔。
pdgroups.range.brandIds TEXT 否 品牌ID，逗号分隔。brandIds，brandNames任传一个 优先级依次降低
pdgroups.range.brandNames TEXT 否 品牌名称，逗号分隔
pdgroups.range.extValues TEXT 否 自定义字段的值，逗号分隔
giftMaxAmount NUMERIC(18,2) 否 赠品活动总额度（金额）
giftCmMaxAmount NUMERIC(18,2) 否 赠品单客户额度（金额）
gifts List 否 列表
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（并且giftType不为4），则本参数必填
gifts.maxNum VARCHAR(32) 否 活动总额度（数量）。如果promotionMode=1/3，calcType=1/2，giftMode=1，ladderGift=0时可以使用此字段。赠品金额额度和数量额度不可同时使用。
gifts.cmMaxNum VARCHAR(32) 否 单客户总额度（数量）。如果promotionMode=1/3，calcType=1/2，giftMode=1，ladderGift=0时可以使用此字段。赠品金额额度和数量额度不可同时使用。
gifts.priceCode VARCHAR (32) 否 同价码。不启用坎级促销使用此字段。如果giftMode传值为2，则本参数必填
step List 列表
step.calcLimit VARCHAR(32) 是 坎级-满送数量。该值必须是大于0的整数
step.num VARCHAR(32) 否 坎级-赠品赠送数量或比例。数量为非零整数，如果是赠品赠送比例则该值在1-100之间，支持小数
step.seq VARCHAR(32) 否 坎级-排序。当坎级促销时，step.seq和stepProduct.seq保持一致，默认从1开始
step.mustIncludeTotalNum VARCHAR(32) 否 坎级-必含总数量。当isMustInclude = 2时传此参数
step.gifts list 否
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（并且giftType不为4），则本参数必填
step.gifts.priceCode VARCHAR (32) 否 同价码。启用坎级促销时使用此字段。如果giftMode传值为2，则本参数必填
stepProduct List 否 列表
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) 否 同价码
stepProduct.typeName VARCHAR(32) 否 商品类型名称。如果promotionMode传值为2并且是必含类型时，typeName和typeSourceCode必填一个，同时存在时优先级依次降低
stepProduct.typeSourceCode VARCHAR(32) 否 商品类型第三方系统的唯一标识。如果promotionMode传值为2并且是必含类型时，typeName和typeSourceCode必填一个，同时存在时优先级依次降低
additionPromotions List 列表
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：赠送全部，3：任选其几。如果calcType传值为1/2，则本参数必填
additionPromotions
.giftChooseNum		 VARCHAR(32) 否 赠品种数。如果giftType传值为3，则本参数必传
additionPromotions
.products		 List 否 主品相关信息列表
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		 List 否 赠品相关详细列表
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		 List 是 坎级相关信息列表
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</span

# 商品买赠促销终止

请求方式： 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：失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明

# 商品买赠促销审批

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/product/v1/approvalPromotion/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "verifyType":"1",
    "promotionId": "4946850940792367567",
    "code": "",
    "sourceCode": "",
    "approverId":"7383973919713831055",
    "approverCode":"",
    "approverSourceCode":"",
    "reason":""
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
verifyType VARCHAR(32) 否 操作类型：1：审批通过；0：审批打回。默认1
promotionId VARCHAR(32) 否 买赠促销id。promotionId、code、sourceCode不能同时为空，同时存在时，优先级依次是promotionId、sourceCode、code
code VARCHAR(100) 否 买赠促销编号。promotionId、code、sourceCode不能同时为空，同时存在时，优先级依次是promotionId、sourceCode、code
sourceCode VARCHAR(100) 否 促销方案第三方编码。promotionId、code、sourceCode不能同时为空，同时存在时，优先级依次是promotionId、sourceCode、code
approverId VARCHAR(32) 否 审批人id。approverId、approverCode、approverSourceCode不能同时为空，同时存在时，优先级依次是approverId、approverSourceCode、approverCode
approverCode VARCHAR(100) 否 审批人账号。approverId、approverCode、approverSourceCode不能同时为空，同时存在时，优先级依次是approverId、approverSourceCode、approverCode
approverSourceCode VARCHAR(100) 否 审批人第三方编码。approverId、approverCode、approverSourceCode不能同时为空，同时存在时，优先级依次是approverId、approverSourceCode、approverCode
reason VARCHAR(1000) 否 审批意见

响应示例：

{
    "msg_id": "PRD00001",
    "return_code": 100605,
    "return_msg": ""
}

参数说明：

参数 类型 说明
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 } 在线调试
请求示例：

{
    "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 } 在线调试
请求示例：


{
    "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": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据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":"箱",
       "tpmActivityId": "00",
       "tpmActivityName": "",
       "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":[]
    }
]

参数说明：

参数 类型 必填 说明
id VARCHAR(32) 否 促销id
status VARCHAR(32) 否 状态。0：删除，1：正常
code VARCHAR(100) 否 促销方案编号
sourceCode VARCHAR(100) 否 促销方案第三方编码
name VARCHAR(100) 否 促销方案名称
desc VARCHAR(4000) 否 促销说明
creatorCode VARCHAR(32) 否 创建人编码
creatorName VARCHAR(32) 否 创建人名称
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：已终止
approvalStatus VARCHAR(32) 否 审批状态。0：待审批，1：已审批，2：已打回
approvalReason VARCHAR(32) 否 审批原因
approvalTime VARCHAR(32) 否 审批时间。格式：yyyy-MM-dd HH:mm:ss
approverCode VARCHAR(32) 否 审批人编码
approverName VARCHAR(32) 否 审批人名称
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：同价码 4：商品范围
calcType VARCHAR(32) 否 促销子类型。1：主品达到满赠数量送固定数量赠品，2：主品达到满赠金额送固定数量赠品，3：主品达到满赠数量按主品的数量比例送赠品，4：主品达到满赠数量送固定金额的赠品，5：主品达到满赠金额送固定金额的赠品，6：主品达到满赠数量，按主品的数量比例送一定金额的赠品，7：主品达到满赠金额按主品的金额比，8：主品达到满赠数量按主品的金额比例送赠品
promotionSend VARCHAR(32) 否 满送规则。0：满X送Y，1：每满X送Y
giftMode VARCHAR(32) 否 赠品范围。1：按商品，2：按同价码，3：不限商品
giftType VARCHAR(32) 否 赠品赠送方式。1：赠送全部，2：任一赠品，3：任选其几，4：赠品任选
giftChooseNum VARCHAR(32) 否 赠品种数
unitName VARCHAR(32) 否 单位名称
tpmActivityId VARCHAR(32) 否 TPM活动方案ID
tpmActivityName VARCHAR(200) 否 TPM活动方案名称
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：否
giftMaxAmount NUMERIC(18,2) 否 赠品活动总额度（金额）
giftCmMaxAmount NUMERIC(18,2) 否 赠品单客户额度（金额）
customerDept List 否 客户属性-中部门信息列表
customerDept.id VARCHAR(32) 否 客户属性-部门id
customerDept.code VARCHAR(100) 否 客户属性-部门编码
customerDept.sourceCode VARCHAR(100) 否 客户属性-部门第三方系统唯一标识
customerDept.name VARCHAR(100) 否 客户属性-部门名称
customerLevel.id VARCHAR(32) 否 客户属性-客户等级id
customerLevel List 否 客户属性-中客户等级信息列表
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 List 否 客户属性-中客户层次信息列表
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 List 否 客户属性-中销售区域信息列表
district.id VARCHAR(32) 否 客户属性-销售区域id
district.code VARCHAR(100) 否 客户属性-销售区域编码
district.sourceCode VARCHAR(100) 否 客户属性-销售区域第三方系统唯一标识
district.name VARCHAR(100) 否 客户属性-销售区域名称
districtLevel List 否 客户属性-中销售区域等级列表
districtLevel.id VARCHAR(32) 否 客户属性-销售区域等级id
districtLevel.code VARCHAR(100) 否 客户属性-销售区域等级编码
districtLevel.name VARCHAR(100) 否 客户属性-销售区域等级名称
uperCustomer List 否 客户属性-中上级客户列表
uperCustomer.Id VARCHAR(32) 否 客户属性-上级客户id
uperCustomer.code VARCHAR(100) 否 客户属性-上级客户编码
uperCustomer.sourceCode VARCHAR(100) 否 客户属性-上级客户第三方系统唯一标识
uperCustomer.name VARCHAR(100) 否 客户属性-上级客户名称
dealer List 否 客户属性-中经销商信息列表
dealer.id VARCHAR(32) 否 客户属性-经销商id
dealer.code VARCHAR(100) 否 客户属性-经销商编码
dealer.sourceCode VARCHAR(100) 否 客户属性-经销商第三方系统唯一标识
dealer.name VARCHAR(100) 否 客户属性-经销商名称
tradingareaBig List 否 客户属性-中大商圈列表
tradingareaBig.id VARCHAR(32) 否 客户属性-大商圈id
tradingareaBig.name VARCHAR(100) 否 客户属性-大商圈名称
tradingareaNomal List 否 客户属性-中商圈列表
tradingareaNomal.id VARCHAR(32) 否 客户属性-商圈id
tradingareaNomal.name VARCHAR(100) 否 客户属性-商圈名称
customerLabel List 否 客户属性-终端标签
customerLabel.id VARCHAR(32) 否 客户属性-标签id
customerLabel.name VARCHAR(100) 否 客户属性-标签名称
cityLevel List 否 客户属性-城市等级列表
cityLevel.id VARCHAR(32) 否 客户属性-城市等级id
cityLevel.name VARCHAR(100) 否 客户属性-城市等级名称
kaSys VARCHAR(100) 否 客户属性-ka系统名称，多个值用“,”隔开
perScale VARCHAR(100) 否 客户属性-人员规模，多个值用“,”隔开
customerSource VARCHAR(100) 否 客户属性-来源名称，多个值用“,”隔开
trade VARCHAR(100) 否 客户属性-行业名称，多个值用“,”隔开
extField List 否 客户属性-中自定义字段列表
extField.extKey VARCHAR(32) 否 客户属性-自定义字段编码
extField.extName VARCHAR(100) 否 客户属性-自定义字段名称
extField.extValue VARCHAR(100) 否 客户属性-自定义字段值，多个值用“,”隔开
promotionCustomer List 否 指定具体客户信息列表
promotionCustomer.cmId VARCHAR(32) 否 指定具体客户-客户id
promotionCustomer.cmCode VARCHAR(100) 否 指定具体客户-客户编码
promotionCustomer.cmSourceCode VARCHAR(100) 否 指定具体客户-客户第三方系统唯一标识
promotionCustomer.cmName VARCHAR(100) 否 指定具体客户-客户名称
promotionProduct List 否 主品列表
promotionProduct.pdId VARCHAR(32) 否 主品-商品id。如果promotionMode=1，则返回该字段
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 List 否 商品类型列表
promotionProductType.classId VARCHAR(32) 否 主品-商品类型id。如果promotionMode=2，则返回该字段
promotionProductType.className VARCHAR(100) 否 主品-商品类型编码。如果promotionMode=2，则返回该字段
promotionProductType.sourceCode VARCHAR(100) 否 主品-商品类型第三方系统唯一标识。如果promotionMode=2，则返回该字段
promotionPdgroup List 否 商品范围列表
promotionPdgroup.id VARCHAR(32) 是 组ID。如果promotionMode=4，则返回该字段
promotionPdgroup.isMustInclude VARCHAR(32) 是 是否必含 1是 0否。如果promotionMode=4，则返回该字段
promotionPdgroup.includeNum List 否 必含数量集合。如果promotionMode=4，则返回该字段
promotionPdgroup.range VARCHAR(32) 否 商品属性集合
promotionPdgroup.range.detail_id VARCHAR(32) 是 具体属性主键ID
promotionPdgroup.range.code VARCHAR(32) 是 条件编码
promotionPdgroup.range.name VARCHAR(32) 是 条件名称
promotionPdgroup.range.selected_value TEXT 是 选择的ID，逗号分隔
promotionPdgroup.range.selected_text TEXT 否 选择的名称，逗号分隔
promotionPdgroup.range.is_inner TEXT 否 是否内置，1是 0否
promotionGift List 否 赠品信息列表
promotionGift.pdId VARCHAR(32) 否 赠品-商品id。如果ladderGift=0，则返回该字段
promotionGift.pdCode VARCHAR(100) 否 赠品-商品编码。如果ladderGift=0，则返回该字段
promotionGift.pdSourceCode VARCHAR(100) 否 赠品-商品第三方系统唯一标识。如果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，则返回该字段
promotionGift.maxNum VARCHAR(32) 否 活动总额度（数量）。
promotionGift.cmMaxNum VARCHAR(32) 否 单客户总额度（数量）。
promotionStep List 否 坎级相关信息列表
promotionStep.stepLimit VARCHAR(100) 否 坎级-满送数量
promotionStep.giftCount VARCHAR(100) 否 坎级-赠品赠送数量
promotionStep.giftRatio VARCHAR(100) 否 坎级-赠品赠送比例
promotionStep.giftAmount VARCHAR(100) 否 坎级-赠品赠送金额
promotionStep
.stepProduct		 List 否 坎级中商品相关信息列表
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		 List 否 坎级中赠品相关信息列表
promotionStep
.promotionGift
.pdId		 VARCHAR(32) 否 坎级-赠品-商品id。如果ladderGift=1，则返回该字段
promotionStep
.promotionGift
.pdCode		 VARCHAR(100) 否 坎级-赠品-商品编码。如果ladderGift=1，则返回该字段
promotionStep
.promotionGift
.pdSourceCode		 VARCHAR(100) 否 坎级-赠品-商品第三方系统唯一标识。如果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 List 列表
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		 List 否 列表
additionPromotions
.promotionProduct
.pdId		 VARCHAR(32) 否 主品-商品id。当promotionMode=1时返回
additionPromotions
.promotionProduct
.pdCode		 VARCHAR(100) 否 主品-商品编码。当promotionMode=1时返回
additionPromotions
.promotionProduct
.pdSourceCode		 VARCHAR(100) 否 主品-商品第三方系统唯一标识。当promotionMode=1时返回
additionPromotions
.promotionProduct
.priceCode		 VARCHAR(100) 否 主品-商品同价码。当promotionMode=3时返回
additionPromotions
.promotionStep		 List 否 列表
additionPromotions
.promotionStep
.stepLimit		 VARCHAR(100) 否 坎级-满送数量
additionPromotions
.promotionStep
.giftCount		 VARCHAR(100) 否 坎级-赠品赠送数量
additionPromotions
.promotionStep
.giftRatio		 VARCHAR(100) 否 坎级-赠品赠送比例
additionPromotions
.promotionStep
.giftAmount		 VARCHAR(100) 否 坎级-赠品赠送金额
additionPromotions
.promotionStep
.promotionGift		 List 否 列表
additionPromotions
.promotionStep
.promotionGift
.pdId		 VARCHAR(32) 否 坎级-赠品-商品id
additionPromotions
.promotionStep
.promotionGift
.pdCode		 VARCHAR(100) 否 坎级-赠品-商品编码
additionPromotions
.promotionStep
.promotionGift
.pdSourceCode		 VARCHAR(100) 否 坎级-赠品-商品第三方系统唯一标识
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) 否 坎级-赠品-数量

# 修改执行中买赠的终止日期

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/product/v1/updatePromotionEndDate/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "promotionId": "8932736196522704228",
    "code":"202211220002",
    "sourceCode":"",
    "endDate":"2024-06-13"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
promotionId VARCHAR(32) 否 买赠促销id。促销方案编号、促销方案第三方编码、促销id不能同时为空。promotionId、sourceCode、code如果同时存在，优先级依次降低
code VARCHAR(100) 否 买赠促销编号。促销方案编号、促销方案第三方编码、促销id不能同时为空。promotionId、sourceCode、code如果同时存在，优先级依次降低
sourceCode VARCHAR(100) 否 促销方案第三方编码。促销方案编号、促销方案第三方编码、促销id不能同时为空。promotionId、sourceCode、code如果同时存在，优先级依次降低
endDate VARCHAR(2000) 是 截至日期，格式为 yyyy-MM-dd，截止日期不可早于当前日期

响应示例：

{
    "msg_id": "KAIKAI123456",
    "return_code": "0",
    "return_msg": null
}

参数说明：

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

← 商品满折满减促销接口 →