# 查询互联优惠券

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


{
    "page_number":1,
    "page_length":1000,
    "creatTime": "2017-05-01~2020-05-01",
    "modifyTime": "2017-05-01~2020-05-01"
}
    

请求信息

参数 类型 必填 说明
page_number int 页码默认1,每页默认1000条
page_length int 每页记录条数,默认最大是1000条,可以根据业务数据的大小自行优化调整
creatTime VARCHAR(100) 创建时间范围:yyyy-mm-dd~yyyy-mm-dd
modifyTime VARCHAR(100) 更新时间范围:yyyy-mm-dd~yyyy-mm-dd

返回结果:

{
	"msg_id": "X000001",
	"return_code": "0",
	"return_msg": "",
	"response_data": "[{
	"id": "6156894207424834980",
	"cm_level": "7287736961434231483",
    "cm_type": "6336719646058063235",
    "dept_name": "ddms",
    "doorsill_amount": "20.00",
    "each_cm_num": "1",
    "is_issue": "N",
    "money": "10.00",
    "name": "2",
    "pay_type": "UNLIMITED",
    "prod_mode": "PRODUCT",
    "remark": "备注",
    "required_allnum": "0",
    "total_num": "1",
    "trade_range": "1",
    "use_date": "2021-04-21 00:00:00~2021-04-30 23:59:59",
    "voucher_no": "6156894207424834980",
    "prod_type":"6622726814584160731",
    "prod_brand":"1",
    "required_type":"ANYONE",
     "jxsinfos": [
        {
            "jxs_cus_id": "5257998258449137162",
            "jxs_cus_name": "老杜的下级经销商"
        },
        ......
    ],
     "proinfos": [
        {
            "brand": "三只松鼠",
            "class_name": "薯片类型",
            "is_required": "Y",
            "pro_code": "spjg004",
            "pro_id": "5257998258449137162",
            "pro_name": "三只松鼠腰果坚果450g",
            "required_num": "0",
            "unit_name": "包"
        },
        ......
    ],
     "cmTypeinfos":[
         {
         "cm_type_id":"5257998258449137162",
         "cm_type_name":"KA"
         },
		......
     ],
	  "cmLevelinfos":[
         {
         "cm_level_id":"5257998258449137162",
         "cm_level_name":"KA"
         },
		......
     ],
      "prodTypeinfos":[
         {
         "prod_type_id":"5257998258449137162",
         "prod_brand_name":"KA"
         },
		......
     ],
	  "prodBrandinfos":[
         {
         "prod_brand_id":"5257998258449137162",
         "prod_brand_name":"KA"
         },
		......
     ]
	}]"
}

响应信息

参数 类型 必填 说明
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码:0成功 1失败
return_msg VARCHAR(100) 响应说明
response_data VARCHAR(32) 响应数据体[{......}]
id VARCHAR(32) 互联优惠券ID
cm_level VARCHAR(4000) 客户级别
cm_type VARCHAR(4000) 客户类型
dept_name VARCHAR(100) 费用所属部门名称
doorsill_amount VARCHAR(100) 使用门槛金额
each_cm_num VARCHAR(100) 单店发放张数
is_issue VARCHAR(100) 是否下发:Y:已下发,N:未下发,Z:下发中
money VARCHAR(100) 面值
name VARCHAR(100) 互联优惠券名称
pay_type VARCHAR(100) 支付方式:UNLIMITED:无限制,ONLINE:在线支付
prod_mode VARCHAR(100) 商品选择方式:ALL:全部商品,PRODUCT:指定商品,PROPERTY:商品属性
remark VARCHAR(100) 使用说明
required_allnum VARCHAR(100) 必含商品总数量
total_num VARCHAR(100) 优惠券总个数
trade_range VARCHAR(100) 客户范围:1、指定客户范围 2、指定具体客户
use_date VARCHAR(100) 使用时间范围:2021-04-21 00:00:00~2021-04-30 23:59:59
voucher_no VARCHAR(100) 优惠券号
prod_type VARCHAR(4000) 商品类型:值为-1表明选择的是全部类型
prod_brand VARCHAR(4000) 商品品牌
required_type VARCHAR(32) 必含方式:ANYONE:必含任一,ALL:必含全部
jxsinfos[].jxs_cus_id VARCHAR(32) 经销商id
jxsinfos[].jxs_cus_name VARCHAR(100) 经销商名称
proinfos[].pro_id varchar(32) 商品id
proinfos[].brand varchar(100) 品牌
proinfos[].class_name VARCHAR(100) 商品类型名称
proinfos[].is_required varchar(32) 是否必含:Y:是,N:否
proinfos[].pro_code varchar(100) 商品编码
proinfos[].pro_name varchar(100) 商品名称
proinfos[].required_num varchar(100) 必含数量
proinfos[].unit_name varchar(100) 单位名称
cmTypeinfos[].cm_type_id varchar(32) 终端类型id
cmTypeinfos[].cm_type_name varchar(100) 终端类型名称
cmLevelinfos[].cm_level_id varchar(32) 终端级别id
cmLevelinfos[].cm_level_name varchar(100) 终端级别名称
prodTypeinfos[].prod_type_id varchar(32) 商品类别id
prodTypeinfos[].prod_type_name varchar(100) 商品类别名称
prodBrandinfos[].prod_brand_id varchar(32) 商品品牌id
prodBrandinfos[].prod_brand_name varchar(100) 商品品牌名称

# 查询互联优惠券客户

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

{
    "page_number":1,
    "page_length":1000,
    "voucher_id": "6156894207424834980"
}
    

请求信息

参数 类型 必填 说明
page_number int 页码默认1,每页默认1000条
page_length int 每页记录条数,默认最大是1000条,可以根据业务数据的大小自行优化调整
voucher_id VARCHAR(32) 优惠券id

返回结果:

{
	"msg_id": "X000001",
	"return_code": "0",
	"return_msg": "",
	"response_data": "[{
	"cus_id": "6156894207424834980",
	"cus_code": "7287736961434231483",
    "cus_name": "ddms"
	}]"
}

响应信息

参数 类型 必填 说明
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码:0成功 1失败
return_msg VARCHAR(100) 响应说明
response_data VARCHAR(32) 响应数据体[{......}]
cus_id VARCHAR(32) 客户ID
cus_code VARCHAR(100) 客户编码
cus_name VARCHAR(100) 客户名称