# 查询互联优惠券

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

{
    "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

响应示例:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据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",
        "is_finish":"N",
        "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"
             }
         ]
    }
]

参数说明:

参数 类型 必填 说明
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:必含全部
is_finish VARCHAR(32) 是否终止。Y:是,N:否
jxsinfos List 列表
jxsinfos.jxs_cus_id VARCHAR(32) 经销商id
jxsinfos.jxs_cus_name VARCHAR(100) 经销商名称
proinfos List 列表
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 List 列表
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) 终端级别名称
cmTypeinfos List 列表
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} 在线调试
请求示例:

{
    "page_number":1,
    "page_length":1000,
    "voucher_id": "6156894207424834980"
}
说明: 本示例仅供参考。

参数说明:

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

响应示例:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "cus_id": "6156894207424834980",
        "cus_code": "7287736961434231483",
        "cus_name": "ddms"
    }
]

参数说明:

参数 类型 必填 说明
cus_id VARCHAR(32) 客户ID
cus_code VARCHAR(100) 客户编码
cus_name VARCHAR(100) 客户名称

# 互联优惠券新增接口

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

{
    "outerId": 7738628803341132971,
    "startDate": "2018-12-07",
    "endDate": "2016-12-09",
    "money": "100",
    "doorsillAmount": "10000",
    "dealerId": "7144075108679848576",
    "dealerSourceCode": "HJZD66009916",
    "dealerCode": "CUS010206",
    "dealerName": "cs",
    "tradeRange": "2",
    "typeId": "8270177375293833270",
    "typeSourceCode": "SC00001",
    "typeCode": "apple",
    "typeName": "E批发",
    "levelId": "8715900737400193117",
    "levelSourceCode": "L0001",
    "levelName": "A",
    "cmId": "7507371038952998233",
    "cmSourceCode": "0002",
    "cmCode": "CUS010206",
    "cmName": "专卖店",
    "num": "100",
    "eachCmNum": "10",
    "costDeptId": "7507371038952998233",
    "costDeptSourceCode": "DEPT0001",
    "costDeptCode": "D001",
    "costDeptName": "部门1",
    "remark": "使用说明",
    "payType": "UNLIMITED",
    "businessFromId": "7507371038952998233",
    "businessFromName": "",
    "comment": "备注",
    "prodMode": "PRODUCT",
    "requiredType": "ANYONE",
    "requiredAllNum": 5,
    "pdTypeId": "75073334438952998233",
    "pdTypeSourceCode": "PDTYPE001",
    "pdTypeName": "商品类型A",
    "pdBrandId": "75073334438952998233",
    "pdBrandName": "品牌1",
    "products": 
    [
        {
            "id": "8001798425988895322",
            "sourceCode": "",
            "code": "",
            "unitId": "8630968290930337166",
            "unitName": "",
            "isRequired": "Y",
            "requiredNum": "10"
        }
    ]   
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
outerId VARCHAR(32) 优惠券码。长度不大于19的正整数
name VARCHAR(200) 优惠券名称
startDate VARCHAR(32) 优惠券开始日期,不能早于当前时间。格式:yyyy-MM-dd
endDate VARCHAR(32) 优惠券截止日期,不能早于开始时间。格式:yyyy-MM-dd
money VARCHAR(32) 面值。最多保留两位小数的正数
doorsillAmount VARCHAR(32) 使用门槛。最多保留两位小数的正数,使用门槛必须大于面值
tradeRange VARCHAR(1) 客户范围。1、指定客户范围 2、指定具体客户
num VARCHAR(32) 单企业优惠券数量。正整数
eachCmNum VARCHAR(32) 单终端限领数量。正整数,单终端限领数量不可大于单企业优惠券数量
remark VARCHAR(200) 使用说明
payType VARCHAR(10) 限定支付方式。UNLIMITED:无限制,ONLINE:在线支付
comment VARCHAR(200) 备注
prodMode VARCHAR(10) 商品范围。ALL:全部商品,PRODUCT:指定商品,PROPERTY:商品属性
requiredType VARCHAR(10) 必含类型。当prodMode=PRODUCT时此字段有值,ANYONE:必含任一,ALL:必含全部
requiredAllNum VARCHAR(10) 必含商品总数量。requiredType=ANYONE时此字段有值,正整数
businessFromId VARCHAR(32) 业务来源ID。
businessFromName VARCHAR(100) 业务来源名称。
costDeptId VARCHAR(32) 费用归属部门ID。costDeptId、costDeptSourceCode、costDeptCode、costDeptName,不能同时为空,如果同时存在,优先级依次降低,单选值
costDeptSourceCode VARCHAR(32) 费用归属部门第三方系统的唯一标识。costDeptId、costDeptSourceCode、costDeptCode、costDeptName,不能同时为空,如果同时存在,优先级依次降低,单选值
costDeptCode VARCHAR(100) 费用归属部门编码。costDeptId、costDeptSourceCode、costDeptCode、costDeptName,不能同时为空,如果同时存在,优先级依次降低,单选值
costDeptName VARCHAR(100) 费用归属部门名称。costDeptId、costDeptSourceCode、costDeptCode、costDeptName,如果同时存在,优先级依次降低,单选值
dealerId VARCHAR(32) 经销商ID。dealerId、dealerSourceCode、dealerCode、dealerName,不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔
dealerSourceCode VARCHAR(32) 经销商第三方系统的唯一标识。dealerId、dealerSourceCode、dealerCode、dealerName,不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔
dealerCode VARCHAR(100) 经销商编码。dealerId、dealerSourceCode、dealerCode、dealerName,不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔
dealerName VARCHAR(100) 经销商名称。dealerId、dealerSourceCode、dealerCode、dealerName,不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔
typeId VARCHAR(32) 终端类型ID。当tradeRange = 1时此字段有值,typeId、typeSourceCode、typeCode、typeName,不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔
typeSourceCode VARCHAR(32) 终端类型第三方系统的唯一标识。当tradeRange = 1时此字段有值,typeId、typeSourceCode、typeCode、typeName,不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔
typeCode VARCHAR(100) 终端类型编码。当tradeRange = 1时此字段有值,typeId、typeSourceCode、typeCode、typeName,不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔
typeName VARCHAR(100) 终端类型名称。当tradeRange = 1时此字段有值,typeId、typeSourceCode、typeCode、typeName,不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔
levelId VARCHAR(32) 终端级别ID。当tradeRange = 1时此字段有值,levelId、levelSourceCode、levelName,不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔
levelSourceCode VARCHAR(32) 终端级别第三方系统的唯一标识。当tradeRange = 1时此字段有值,levelId、levelSourceCode、levelName,不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔
levelName VARCHAR(100) 终端级别名称。当tradeRange = 1时此字段有值,levelId、levelSourceCode、levelName,不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔
cmId VARCHAR(32) 终端ID。当tradeRange = 2时此字段有值,cmId、cmSourceCode、cmCode、cmName,不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔
cmSourceCode VARCHAR(32) 终端第三方系统的唯一标识。当tradeRange = 2时此字段有值,cmId、cmSourceCode、cmCode、cmName,不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔
cmCode VARCHAR(100) 终端商编码。当tradeRange = 2时此字段有值,cmId、cmSourceCode、cmCode、cmName,不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔
cmName VARCHAR(100) 终端名称。当tradeRange = 2时此字段有值,cmId、cmSourceCode、cmCode、cmName,不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔
pdTypeId VARCHAR(32) 商品类型ID。当prodMode=PROPERTY时此字段有值,pdTypeId、pdTypeSourceCode、pdTypeName,商品类型与商品品牌不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔,如果传全部类型只能通过这个字段,并且值为-1
pdTypeSourceCode VARCHAR(32) 商品类型第三方系统的唯一标识。当prodMode=PROPERTY时此字段有值,pdTypeId、pdTypeSourceCode、pdTypeName,商品类型与商品品牌不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔
pdTypeName VARCHAR(100) 商品类型名称。当prodMode=PROPERTY时此字段有值,pdTypeId、pdTypeSourceCode、pdTypeName,商品类型与商品品牌不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔
pdBrandId VARCHAR(32) 商品品牌ID。当prodMode=PROPERTY时此字段有值,pdBrandId、pdBrandName,商品类型与商品品牌不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔
pdBrandName VARCHAR(100) 商品品牌第三方系统的唯一标识。当prodMode=PROPERTY时此字段有值,pdBrandId、pdBrandName,商品类型与商品品牌不能同时为空,如果同时存在,优先级依次降低,多个值用“,”分隔
isAutoIssued VARCHAR(1) 是否自动下发。1 是 0否
products LIST 商品信息。当prodMode=PRODUCT时此字段有值
products.id VARCHAR(32) 商品ID。id,sourceCode,code不能同时为空
products.sourceCode VARCHAR(100) 商品第三方系统的唯一标识。id,sourceCode,code不能同时为空
products.code VARCHAR(100) 商品编码。id,sourceCode,code不能同时为空
products.unitId VARCHAR(32) 商品单位ID。unitId,unitName不能同时为空
products.unitName VARCHAR(100) 商品单位名称。unitId,unitName不能同时为空
products.isRequired VARCHAR(1) 是否必含。Y 是 N 否
products.requiredNum VARCHAR(32) 必含数量。当isRequired=Y有值,正整数

响应示例:

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明:

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