交易列表
# 交易列表
### 请求地址
| HTTP Method | Path |
| :- | :-|
| GET | /api/v1/trade |
### 请求参数
| 参数名称 | 类型 | 必填 | 描述 |
| :- | :-| :- | :- |
| pageIndex | int | 是 | 当前页码,从1开始 |
| pageSize | int | 是 | 每页数量,10-100 |
| beginDate | datetime | 否 | 下单开始日期 |
| endDate | datetime | 否 | 下单结束日期 |
| useDate | datetime | 否 | 出行日期 |
| status | int | 是 | 订单状态 0-全部 待付款-1 已支付-2 已完成-3 已取消-4 |
### 请求Body
无
### 响应Body,Data部分
| 参数名称 | 类型 | 描述 |
| :- | :-| :- |
| total | int | 总数 |
| list | *TradeDetail*[] | 交易列表 |
*TradeDetail*
| 参数名称 | 类型 | 描述 |
| :- | :-| :- |
| tradeId | int | 交易单id |
| tradeNo | string | 交易编号 |
| buyerName | string | 联系人 |
| buyerPhone | string | 联系人电话 |
| buyerEmail | string | 联系人邮箱 |
| buyerMessage | string | 下单备注 |
| payment | decimal | 实付金额 |
| totalPrice | decimal | 产品总价 |
| discountFee | decimal | 优惠金额 |
| totalExpressFee | decimal | 总快递费用 |
| channelTid | string | 来源单号 |
| status | int | 状态 交易单状态。可选值: 1(已确认);2(未付款);3(待处理);4(处理中);5(待使用);6(退款中);7(交易关闭);8(退款成功) |
| endTime | datetime | 完结时间 |
| orders | *TradeOrder*[] | 交易订单列表 |
*TradeOrder*
| 参数名称 | 类型 | 描述 |
| :- | :-| :- |
| orderId | int | 订单id |
| orderNo | string | 订单编号 |
| goodsId | int | 产品id |
| goodsSkuId| int | 产品skuid |
| goodsName | string | 产品名称 |
| skuName | string | 产品sku名称 |
| totalPrice | decimal | 产品总额 |
| num | int | 购买数量 |
| price | decimal | 产品单价 |
| discountFee | decimal | 优惠金额 |
| payoutDiffAmt | decimal | 预约补差总金额 |
| status | int | 订单状态 0-待付款 1 待处理,2 已确认,3.已取消,4.已退款 |
| channelOid | string | 渠道来源单号 |
| endTime | datetime | 订单完结时间 |
| isOrderInfo | int | 是否预售 0-默认(预订) 1-预售 |
| expressFee | decimal | 电商邮费 |
| orderCustomerInfos | *OrderCustomerInfo*[] | 出行人信息 |
### 业务错误码
无
### 请求示例
``` http
GET http://test.openapi.huitravel.com/api/v1/trade?pageIndex=1&pageSize=10&status=0 HTTP/1.1
accessKeyId: 7568512625
signatureNonce: 0.7497815693494778
timestamp: 2020-11-27T09:51:49Z
signature: edd1526d4a4d7b26213ba648c1d42a8e8d1f5d38
...
```
``` json
HTTP/1.1 200 OK
{
"requestId": "991b6cc7-34b1-474a-a789-c574f14fb546",
"data": {
"list": [{
"tradeNo": "T201125173137119",
"buyerName": "test",
"buyerPhone": "12345678",
"buyerEmail": "",
"buyerMessage": "test order",
"payment": 0.00,
"totalPrice": 0.00,
"discountFee": 0.00,
"totalExpressFee": 0.00,
"channelTid": "",
"status": 3,
"endTime": "1753-01-01 00:00:00",
"orders": [{
"orderCustomerInfos": [],
"orderNo": "2011251731370001",
"goodsId": 51,
"goodsSkuId": 98,
"goodsName": "澄江抚仙湖样样好生态农庄",
"skuName": "澄江抚仙湖样样好生态农庄1号",
"totalPrice": 0.01,
"num": 1,
"price": 0.01,
"discountFee": 0.00,
"payoutDiffAmt": 0.00,
"status": 1,
"channelOid": "",
"endTime": "2000-01-01 00:00:00",
"isOrderInfo": 1,
"expressFee": 0.00
}
]
}
],
"total": 12
}
}
```