# 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、常见问题