# 查询特价促销接口

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

{
    "promotionId":"8513121636572377191",
    "code":"",
    "tradeType":"",
	"start_create_date":"2021-05-01",
	"end_create_date":"2021-06-01",
	"start_modify_date":"",
	"end_modify_date":""
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
promotionId VARCHAR(32) 特价促销id。promotionId、code如果同时存在,优先级依次降低
code VARCHAR(100) 特价促销编号。promotionId、code如果同时存在,优先级依次降低
tradeType VARCHAR(32) 促销对象。1:标准客户,2:经销商,3:终端门店
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":"4760419503404160006",
      "status":"1",
      "code":"miniprice005",
      "name":"特价促销",
      "createTime":"2021-05-08 10:38:01",
      "modifyTime":"2021-05-12 14:43:54",
      "startTime":"2021-05-07 00:00",
      "endTime":"2022-09-30 23:59",
      "desc":"miniprice005",
      "isEnable":"1",
      "tradeRange":"2",
      "tradeType":"2",
      "applyRangeType":"0",
      "promotionCustomer":[
          {
              "cmName":"南京经销商",
              "cmCode":"CUS000003",
              "cmId":"5257998258449137162",
              "cmSourceCode":""
          }
      ],
      "products":[
          {
              "pdCode":"PD2021060221131",
              "cmMaxNum":"",
              "unitName":"瓶",
              "salePrice":"4",
              "unitId":"6936228840570112101",
              "pdId":"5130759210739014375",
              "pdName":"美年达_葡萄味_500ML",
              "maxNum":"1000"
          }
      ],
      "kaSys":"",
      "perScale":"",
      "customerType":[],
      "customerGradation":[],
      "extField":[],
      "customerDept":[],
      "districtLevel":[],
      "tradingareaNomal":[],
      "uperCustomer":[],
      "tradingareaBig":[],
      "customerLevel":[],
      "trade":"",
      "district":[],
      "dealer":[],
      "customerSource":""
    }
 ]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 促销id
status VARCHAR(32) 状态。0:删除,1:正常
code 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
startTime VARCHAR(32) 开始日期。格式:yyyy-MM-dd HH:mm
endTime VARCHAR(32) 结束日期。格式:yyyy-MM-dd HH:mm
isEnable VARCHAR(32) 促销状态。1:正常,0:已终止
tradeType VARCHAR(32) 促销对象。1:标准客户,2:经销商,3:终端门店
tradeRange VARCHAR (32) 客户范围。1:按客户属性设置范围,2:指定具体客户
applyRangeType VARCHAR (32) 适用范围。0:不限,1:业务员代下单,2:客户自主下单
customerDept List 客户属性-部门列表
customerDept.id VARCHAR(32) 客户属性-部门id
customerDept.code VARCHAR(100) 客户属性-部门编码
customerDept.sourceCode VARCHAR(100) 客户属性-部门第三方系统唯一标识
customerDept.name VARCHAR(100) 客户属性-部门名称
customerLevel List 客户属性-客户等级列表
customerLevel.id VARCHAR(32) 客户属性-客户等级id
customerLevel.sourceCode VARCHAR(100) 客户属性-客户等级第三方系统唯一标识
customerLevel.name VARCHAR(100) 客户属性-客户等级名称
customerType List 客户属性-客户类型列表
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) 客户属性-商圈名称
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
promotionProduct.pdCode VARCHAR(100) 商品编码
promotionProduct.pdSourceCode VARCHAR(100) 商品第三方系统唯一标识
promotionProduct.pdName VARCHAR(100) 商品名称
promotionProduct.unitId VARCHAR(100) 单位id
promotionProduct.unitName VARCHAR(100) 单位名称
promotionProduct.salePrice VARCHAR(100) 特价
promotionProduct.cmMaxNum VARCHAR(100) 单客户限购。为""时不限
promotionProduct.maxNum VARCHAR(100) 活动总量。为""时不限