可使用优惠券列表（读-4.5）
<p><strong>简要描述：</strong> </p>
<ul>
<li>可使用优惠券列表</li>
</ul>
<p><strong>作者：</strong> </p>
<ul>
<li>付琦</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>/xtwl_read_interface/cmd</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">custId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>客户id</td>
</tr>
<tr>
<td style="text-align: left;">price</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>订单价格</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>1外卖 2团购 4跑腿取送件 5代购 6拼团、7砍价</td>
</tr>
<tr>
<td style="text-align: left;">shopId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>商家id（外卖、团购必传）</td>
</tr>
<tr>
<td style="text-align: left;"><strong>actlist</strong></td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">List<Integer></td>
<td>这单参与的活动的type（外卖必传）</td>
</tr>
<tr>
<td style="text-align: left;">longitude</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>收货地址经度（外卖非店自取时必传）</td>
</tr>
<tr>
<td style="text-align: left;">latitude</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>收货地址纬度（外卖非店自取时必传）</td>
</tr>
<tr>
<td style="text-align: left;">userPhone</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>用户手机（选择收获地址里的手机号）</td>
</tr>
<tr>
<td style="text-align: left;">goodsId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>商品id（拼团、砍价必传）</td>
</tr>
<tr>
<td style="text-align: left;">deliveryType</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>传3代表到店自取 <strong>4到店消费</strong>（外卖、拼团到店自取时传，其他配送方式接口都自行判断，传了也不会用）</td>
</tr>
</tbody>
</table>
<p><strong>请求示例</strong></p>
<pre><code>{
"modular": "runOrder",
"param": {
"authKey": "5C42473DD62B46A7E053C208A8C08B5B",
"dtype": "2",
"secretKey": "70F92A9749575CF01C11B6BBD66308BE",
"timeStamp": "1516780235381",
"userKey": "760BCDB3B1D64F9FE053161EA8C0AB91",
"uuid": "4cdb83916aca4dc5a0b672c00ede891a",
"custId": "44CFF4486FD84E7F8D09DCAEDAEAB268",
"price": "217.35",
"type": "1",
"shopId": "761EA8FA28DB6A1DE053161EA8C01BB0",
"actlist":[1,2]
},
"requestname": "appQueryAvailableCouponList",
"version": "1.0"
}</code></pre>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">resultcode/resultdesc</td>
<td style="text-align: left;">String</td>
<td>0成功/其它返回错误信息（您已经评价过了，不许重复评价）</td>
</tr>
<tr>
<td style="text-align: left;">available</td>
<td style="text-align: left;">string</td>
<td>是否可用 1可用 0不可用</td>
</tr>
<tr>
<td style="text-align: left;">userGetId</td>
<td style="text-align: left;">string</td>
<td>用户领取id（提交订单里的selectedCouponId取这个）</td>
</tr>
<tr>
<td style="text-align: left;">couponId</td>
<td style="text-align: left;">string</td>
<td>券id</td>
</tr>
<tr>
<td style="text-align: left;">couponName</td>
<td style="text-align: left;">string</td>
<td>券名</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">string</td>
<td>券额</td>
</tr>
<tr>
<td style="text-align: left;">thresholdAmount</td>
<td style="text-align: left;">string</td>
<td>使用限额</td>
</tr>
<tr>
<td style="text-align: left;">timeDesc</td>
<td style="text-align: left;">string</td>
<td>使用日期描述</td>
</tr>
<tr>
<td style="text-align: left;">limitPhone</td>
<td style="text-align: left;">string</td>
<td>手机号限制</td>
</tr>
<tr>
<td style="text-align: left;">limitCategory</td>
<td style="text-align: left;">string</td>
<td>品类限制</td>
</tr>
<tr>
<td style="text-align: left;">unavailableReasons</td>
<td style="text-align: left;">string</td>
<td>不可用原因</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>{
"result": {
"count": 7,
"list": [
{
"available": "1",
"couponId": "D8452FD49A7C4531AAD8F80077CA610B",
"couponName": "优惠券",
"amount": 500,
"thresholdAmount": 1000,
"timeDesc": "限2018-09-26开始10天内使用"
},
{
"available": "1",
"couponId": "CA453091A78E4C6188AFE235EEE26330",
"couponName": "1不限额 平台 满减",
"amount": 500,
"thresholdAmount": 0,
"timeDesc": "限2018-09-26开始365天内使用"
},
{
"available": "1",
"couponId": "CA453091A78E4C6188AFE235EEE26330",
"couponName": "1不限额 平台 满减",
"amount": 500,
"thresholdAmount": 0,
"timeDesc": "限2018-09-27开始365天内使用"
},
{
"available": "1",
"couponId": "AC3EB96E2ADC453889A9DD1246F4B314",
"couponName": "1外卖不限额商家",
"amount": 500,
"thresholdAmount": 0,
"timeDesc": "限2018-09-26开始300天内使用"
},
{
"available": "1",
"couponId": "AC3EB96E2ADC453889A9DD1246F4B314",
"couponName": "1外卖不限额商家",
"amount": 500,
"thresholdAmount": 0,
"timeDesc": "限2018-09-26开始300天内使用"
},
{
"available": "0",
"couponId": "2EFBFB5ABADC4151A49043815FB60D44",
"couponName": "势不可挡",
"amount": 1000,
"thresholdAmount": 0,
"startTime": "Monday, September 24, 2018 8:40:04 AM CST",
"endTime": "Sunday, September 1, 2019 8:40:07 AM CST",
"timeDesc": "限2018-09-24 08:40:04至2019-09-01 08:40:07期间使用",
"limitCategory": "限品类: 夜宵、晚餐",
"unavailableReasons": ["限品类: 夜宵、晚餐"]
},
{
"available": "0",
"couponId": "D47EBC61548444E685D0433711B375EC",
"couponName": "食不可挡",
"amount": 500,
"thresholdAmount": 0,
"startTime": "Tuesday, September 18, 2018 8:54:07 AM CST",
"endTime": "Sunday, September 1, 2019 8:54:12 AM CST",
"timeDesc": "限2018-09-18 08:54:07至2019-09-01 08:54:12期间使用",
"limitCategory": "限品类: 晚餐",
"unavailableReasons": ["限品类: 晚餐"]
}
]
},
"resultcode": "0",
"resultdesc": "success"
}
</code></pre>
<p><strong>返回参数说明</strong> </p>
<p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/20888f83275e1c1146309b7715171520?showdoc=.jpg" alt="" /></p>
<p><strong>备注</strong> </p>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>