# 1.查詢核銷信息
**接口描述**
根據核銷碼查詢可核銷信息
**接口地址**
https://../tran/writeoff/admin/findWriteOffInfo
**請求類型**
GET
**請求參數**
| 字段 | 描述 | 類型 | 是否必須 |說明 |
| --- | ---| --- |--- |--- |
| writeOffCode | 核銷碼 | String | 是| |
| vendorId | 商戶id | String | 是| |
| tenantId| 租戶id| String | 是 | |
響應參數
| 字段 | | 類型 |描述 |備注
| --- | --- | --- | --- |--- | --- |
| code | |String|返回狀態|200 - 成功 500 - 失敗 106 -核銷碼格式錯誤|
| message| |String|錯誤說明|請求失敗或者發生錯誤的具體描述
| timeStamp| |datetime|時間戳|時間戳
| result| |Object||結果集|1:創建行程 2:退票3:改簽 4:旅客取消
| | goodsNo|String|產品編號|
| | certType|String|證件類型|身份證 ,護照|
| | gender|String|性別|M-男 F-女 U-未知
| | orderId|String|訂單id|
| | businessStatus|int|業務狀態|0-未消費 1-已消費 -99-過期
| | userName|String|旅客姓名|
| | orderState|String|訂單id|訂單狀態 N-待付款 P-已付款 A-已審核/已發貨 F-已完成/已發貨 O-已過期 C-已取消 D-已刪除
| | accountId|String|賬戶id|
| | certNo|String|證件號|
| | phone|String|手機號|
| | orderCode|String|訂單編號|
| | consumerCode|String|消費碼|
| | id|String|子訂單id|
| | beginTime|Date|消費開始時間|2020-07-21 10:00:00
| | endTime|Date|消費結束時間|2020-07-21 10:00:00
| | goodsName|String|產品名稱|
響應格式
```
{
"success": true,
"message": "success",
"code": 200,
"timestamp": 1595299413872,
"result": [
{
"goodsNo": "001",
"certType": "身份證",
"gender": "U",
"orderId": "549dd21cc04b4661b0c4a0ada7d9cc11",
"businessStatus": 0,
"userName": "wwe",
"orderState": "N",
"accountId": "998364b901ae4bb58c8b788a0fb0c7b0",
"certNo": "610322",
"phone": "18302923118",
"orderCode": "2007210957580491001",
"consumerCode": "0072106114",
"id": "60d2122711664bbaa48b09ea79e6fc54",
"beginTime": "2020-07-21 10:00:00",
"endTime": "2020-07-22 12:00:00",
"goodsName": "免住宿"
}
]
}
```
# 2.核銷
**接口描述**
核銷
**接口地址**
https://../tran/writeoff/admin/writeOff
**請求類型**
GET
**請求參數**
| 字段 | 描述 | 類型 | 是否必須 |說明 |
| --- | ---| --- |--- |--- |
| orderId| 訂單id | String | 是| |
| id| 子訂單id | String | 是| |
| vendorId| 商戶id| String | 是 | |
| writeOffCode| 消費碼| String | 是 | |
| username| 登錄名| String | 是 | |
| goodsName| 產品名| String | 是 | |
響應參數
| 字段 | 類型 |描述 |備注
| --- | --- | --- | --- |--- | --- |
| code |String|返回狀態|200 - 成功 500 - 失敗 |
| message|String|錯誤說明|返回描述
| timeStamp |datetime|時間戳|時間戳
| result |String|返回描述||
響應格式
```
{
"success":true,
"message":"success",
"code":200,
"timestamp":1595311935339,
"result":"消費成功"
}
```
# 3.核銷記錄查詢
**接口描述**
核銷記錄查詢
**接口地址**
https://../tran/writeoff/admin/findWriteOffList
**請求類型**
GET
**請求參數**
| 字段 | 描述 | 類型 | 是否必須 |說明 |
| --- | ---| --- |--- |--- |
| consumerCode| 消費碼 | String | 否| |
| pageNum|第幾頁 | int | 是| |
| pageSize| 頁數量| int | 是 | |
| vendorId| 商戶id| String | 是 | |
| businessStatus| 業務狀態| int | 是 | |
|beginTime| 消費開始時間| Date| 否 | |
|endTime| 消費結束時間| Date| 否 | |
響應參數
| 字段 | 類型 |描述 |備注
| --- | --- | --- | --- |--- | --- |
| code |String|返回狀態|200 - 成功 500 - 失敗 |
| message|String|錯誤說明|返回描述
| timeStamp |datetime|時間戳|時間戳
| result |Object|結果集||
| tripPssName |String|旅客姓名||
| goodsName|String|產品名稱||
| consumerCode|String|消費碼||
| dissipateTime|Date|消費時間||
| beginTime|Date|消費開始時間||
| tripInNum|String|進港航班號||
| tripInTime|Date|進港日期||
| tripOutNum|String|離港航班號||
| tripOutTime|Date|離港日期||
| tripPssPhone|String|手機號||
| orderCount|int|產品核銷統計數量||
| total|int|核銷總數||
響應格式
```
{
"success": true,
"message": "success",
"code": 200,
"timestamp": 1595314605655,
"result": {
"orderDetailFindResultDTOS": [{
"tripPssName": "等等",
"goodsName": "免住宿",
"consumerCode": "0072106116",
"dissipateTime": "2020-07-21 14:12:15",
"beginTime": "2020-07-21 10:00:00",
"tripInNum": "as11",
"tripInTime": "2020-07-21 10:00:00",
"tripOutNum": "cv33",
"tripOutTime": "2020-07-22 08:00:00",
"tripPssPhone": "18302923118"
}, {
"tripPssName": "wwe",
"goodsName": "免住宿",
"consumerCode": "0072106114",
"dissipateTime": "2020-07-21 11:22:09",
"beginTime": "2020-07-21 10:00:00",
"tripInNum": "df55",
"tripInTime": "2020-07-21 10:00:00",
"tripOutNum": "sd44",
"tripOutTime": "2020-07-22 12:00:00",
"tripPssPhone": "18302923118"
}],
"orderDetailFindResultDetailDTOS": [{
"goodsName": "免住宿",
"orderCount": 2
}],
"total": 2
}
}
```
- 1、接入指南
- 2、接口列表
- 2.1、中轉服務
- 2.1.1、行李免提訂單生成修改
- 2.1.2、行李免提訂單狀態推送
- 2.1.3、中轉禮包接口
- 2.2、用戶中心
- 2.2.1、服務人員
- 2.2.2、車輛管理
- 2.2.3、商戶管理
- 2.2.4、token相關
- 2.2.5、投訴對接
- 2.2.6、會員相關
- 2.3、消息中心
- 2.3.1、短信消息
- 2.3.2、語音消息
- 2.4、航班中心
- 2.4.1、獲得指定離港航班信息
- 2.4.2、獲得指定進港航班信息
- 2.4.3、獲取離港航班信息列表
- 2.4.4、獲取進港航班信息列表
- 2.4.5、獲取離港目的地列表
- 2.4.6、獲取進港出發地列表
- 2.4.7、獲取熱門城市列表
- 2.4.8、獲得安檢信息列表
- 2.4.9、獲得值機信息列表
- 2.4.10、中轉數據MQ接入
- 2.4.11、數據中心MQ數據(含安檢)
- 2.5、訂單中心
- 2.5.1、核銷接口
- 2.6、對接中心
- 2.6.1大巴對接
- 2.6.2停車對接
- 2.6.3app對接
- 3、常見問題