# 查询兑货券明细

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

{
    "page_number": 1,
    "page_length": 1000,
    "create_start": "2016-12-09",
    "create_end": "2016-12-09",
    "status": "1"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
page_number INT 当前页数,不传默认为1
page_length INT 每页条数,不传默认为1000
create_start TIMESTAMP 创建时间之后。格式:yyyy-MM-dd
create_end TIMESTAMP 创建时间之前。格式:yyyy-MM-dd
modify_start TIMESTAMP 修改时间之后。格式:yyyy-MM-dd
modify_end TIMESTAMP 修改时间之前。格式:yyyy-MM-dd
status VARCHAR(1) 0:已删除,1:正常

响应示例:

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

数据DATA示例:

[
    {
        "id": "6692513571119135748",
        "status": "1",
        "coupon_no": "00015684", 
        "create_time": "2019-12-05 13:25",
        "modify_time": "2019-12-05 14:25:35.143",
        "effect_date": "2019-11-05~2019-12-25",
        "format_status": "执行中",
        "doorsill_value": "20.00%",
        "recycle_sign_time": "10天",
        "deal_name": "测试协议名称",
        "deal_id": "6692513571119135748",
        "cm_id": "5012103144063463929", 
        "cm_name": "南京雨花二级经销商", 
        "cm_code": "0008106267", 
        "prod_id": "6692513571119135747", 
        "prod_code": "1HBSKLSD", 
        "prod_name": "测试商品1",
        "num": "10箱",
        "price": "25.00",
        "is_used": "已使用",
        "used_time": "2019-12-15 13:25",
        "order_no": "CK0076",
        "order_id": "6692513571119135747",
        "supply_code": "00123", 
        "supply_name": "1ed", 
        "is_back": "已回收", 
        "sign_num": "1箱",
        "sign_time": "2019-12-17 13:25" 
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 兑货券明细id
status VARCHAR(1) 0:已删除,1:正常
coupon_no VARCHAR(32) 兑货券编码
create_time VARCHAR(32) 兑货券生成时间。格式:yyyy-MM-dd HH:mm
modify_time VARCHAR(32) 兑货券更新时间。格式:yyyy-MM-dd HH:mm:ss.us
effect_date VARCHAR(32) 兑货券有效期。格式:yyyy-mm-dd ~ yyyy-mm-dd
format_status VARCHAR(32) 兑货券状态,参考值:“待审批”、“被打回”、“未开始”、“执行中”、“已结束”
doorsill_value VARCHAR(32) 兑货券使用门槛,“不限制”或具体百分比数据
recycle_sign_time VARCHAR(32) 兑货券通路回收时间,“不限制”或具体天数
deal_name VARCHAR(32) 兑货券协议名称
deal_id VARCHAR(32) 兑货券协议id
cm_code VARCHAR(100) 兑货券客户编码
cm_name VARCHAR(100) 兑货券客户名称
cm_id VARCHAR(32) 兑货券客户ID
prod_id VARCHAR(32) 商品ID
prod_code VARCHAR(100) 商品编码
prod_name VARCHAR(100) 商品名称
num VARCHAR(32) 商品数量
price VARCHAR(32) 商品单价
is_used VARCHAR(32) 兑货券使用状态,参考值:“未使用”、“已使用”、“已回收”
used_time VARCHAR(32) 兑货券使用时间。格式:yyyy-MM-dd HH:mm
order_no VARCHAR(32) 订单编码
order_id VARCHAR(32) 订单id
supply_code VARCHAR(32) 供应商编码
supply_name VARCHAR(32) 供应商名称
is_back VARCHAR(32) 兑货券回收状态,参考值:“已回收”、“未回收”
sign_num VARCHAR(32) 回收数量
sign_time VARCHAR(32) 回收时间

# 新增兑货券

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

{
    "coupon_no": "DH20200507000001",
    "deal_name": "2020-05-07-001",
    "cm_id": "6389893435290873348",
    "cm_code": "CM0001",
    "start_date": "2020-01-01",
    "end_date": "2020-12-01",
    "promotion_name": "",
    "recycle_date": "2020-12-01",
    "doorsill_percent": "80",
    "prods": [
        {
            "product_id": "7755038711664976249",
            "product_code": "PD001",
            "unit_name": "箱",
            "num": "10.00000000"
        }
    ]
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
coupon_no VARCHAR(100) 兑货券编码。如果传兑货券编码,则按传入的编码;如果不传,则按照365的兑货券生成规则自动生成
deal_name VARCHAR(100) 兑货券协议名称
cm_id VARCHAR(32) 兑货券客户id,客户id和客户编码必须传一个
cm_code VARCHAR(100) 兑货券客户编码,客户id和客户编码必须传一个
start_date VARCHAR(32) 兑货券有效期开始时间。格式:yyyy-mm-dd
end_date VARCHAR(32) 兑货券有效期结束时间。格式:yyyy-mm-dd
promotion_name VARCHAR(100) 关联促销方案
recycle_date VARCHAR(32) 通路回收时间(兑换后天数)
doorsill_percent VARCHAR(32) 兑货券使用门槛。百分比值,如80%,则传80;如果为空,则为不限制
prods List 列表
prods.product_id VARCHAR(32) 商品id。商品id和商品编码不能同时为空
prods.product_code VARCHAR(100) 商品编码,商品id和商品编码不能同时为空
prods.unit_name VARCHAR(32) 商品单位
prods.num NUMERIC(18,8) 兑换数量

响应示例:

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

数据DATA示例:

[
    {
        "id": "8183666817447601554",
        "code": "DH20200507000001"
    }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 兑货券id
code VARCHAR(100) 兑货券编码

# 审批兑货券

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

{
    "coupon_no": "DH20200507000001",
    "coupon_status": "1",
    "confirm_emp": "张三"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
coupon_no VARCHAR(100) 兑货券编码
coupon_status VARCHAR(32) 审批意见。1:通过,2:打回
confirm_emp VARCHAR(100) 审批人

响应示例:

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

参数说明:

参数 类型 必填 说明
msg_id VARCHAR(32) 消息ID
return_code VARCHAR(32) 响应编码。0:成功,1:失败
return_msg VARCHAR(100) 响应说明