**接口描述**
中转服务平台对外提供西安机场行李免提订单预订和处理服务,可以用此接口生成订单也可以对已有订单进行修改
**接口地址**
https://ip/api/luggage/saveOrder
**请求参数**
| 字段 |类型 |描述|是否必须|备注|
| --- | --- |---|---|---|
|appCode |String |应用code|是|应用code,中转平台分配|
| timeStamp | String |时间戳|是|时间戳|
| sign | String |签名|是|按签名算法算出|
| runum | String |流水号|否|8位随机字符串|
| airportCode |String | 进港机场 | 是 | 中转机场三字码,如西安:XIY |
| goodsNo | String | 订单服务项编号 | 是 | 201,202,203 |
| goodsName | String | 订单服务项名称 | 是 | 行李免提,代办登机牌,中转引导 |
| orderId | String | 订单ID | 否 | 订单创建时无,其它必须有 |
| orderSource | String | 订单渠道 | 是 | 1:小程序 2:同程 3:携程 4其他 5 航班管家 6 华夏航空 |
| orderType | String | 创建订单方式 | 是 | 1:现场申请 2:提前申请 |
| orderAction | int | 订单动作 | 是 | 1:创建行程 2:退票3:改签 4:旅客取消 |
| flightDate | date | 航班日期 | 是 | 前段航班进港日期,如2019-08-18 |
| flightInNo | String | 进港航班号 | 是 | 如MU2233 |
| flightInTime | datetime | 进港时间 | 是 | 如2019-08-18 21:57:22 |
| flightInTerminal | String | 进港航站楼 | 是 | 如T2 |
| flightInBrdNo | String | 进港航班登机口 | 否 | 如MU |
| flightInAirlinecode|String|进港航空公司代码|是|如MU|
|airportCodeSource|String|前段起飞机场三字码|是|如INC|
|flightOutNo|String|离港航班号|是|如MU2233|
|flightOutTime|datetime|离港时间|是|如2019-08-18 21:57:22|
|flightOutTerminal|String|离港航站楼|是|如T2|
|flightOutAirlinecode|String|离港航空公司代码|是|如MU|
|airportCodeDest|String|后段目的地机场三字码|是|如XNN|
|pssNamecn|String|旅客中文名称|是|旅客中文名,没有中文名则用英文名称|
|pssGender|String|旅客性别|否|F:女姓,M:男姓,U:不详|
|pssPhone|String|旅客手机号|是|AES128加密|
|pssCerttype|Integer|证件类型|是|1身份证,2护照,3军官证,4士兵证,5警官证,6台胞证,港澳通行证,7海员证,8学生证,9户口簿,10其他|
|pssCertno|String|证件号码|是|AES128加密|
|stayLength|Integer|停留时长|否|如75|
|luggageFreeAllowance|BigDecimal|行李免费限额|否|
|pssPnr|String|前段PNR号|否|
|pssPnrb|String|后段PNR号|否|
|remark1|String|保留字段1|否|携程id|
|remark2|String|保留字段2|否|备用|
|remark3|String|保留字段3|否|备用|
请求报文
数据类型Content-Type: Params
```
appCode=""
timeStamp=""
sign=""
runum=""
```
数据类型Content-Type: application/json
```
{
"addDTO": {
"guide": "Y",
"goodsNo": "201",
"goodsName": "行李免提",
"flightInNo": "99999999",
"flightInTime": "2019-11-11 10:50:00",
"flightInTerminal": "T3",
"flightInBrdNo": "14",
"flightInAirlinecode": "MU",
"flightOutNo": "22222222",
"flightOutTime": "2019-11-11 11:45:00",
"flightOutTerminal": "T3",
"flightOutAirlinecode": "",
"pssName": "HON*",
"pssNamecn": "洪*",
"pssGender": "",
"pssPhone": "ZjiVe5ZtqEO1IbszcA5+dQ==",
"pssCerttype": "NI",
"pssCertno": "Nrg4dmtVwN5hRSk4bC89sZeNtyCEpk1DjQoE2n6MHeo",
"airportCodeSource": "NKG",
"airportCodeDest": "XNN",
"airportCode": "XIY",
"stayLength": 144,
"luggageFreeAllowance": 2,
"remark1": "123123",
"remark2": null,
"remark3": null,
"orderType": 2,
"orderSource": 3,
"orderAction": 1,
"pssPnr":"pnr"
}
}
```
响应参数
| 字段 | | 类型 |描述 |备注
| --- | --- | --- | --- |--- | --- |
| code | |String|返回状态|0 - 失败 1 - 成功|
| message| |String|错误说明|请求失败或者发生错误的具体描述
| timeStamp| |datetime|请求时间戳|请求时带的时间戳
| result| |Object||结果集|1:创建行程 2:退票3:改签 4:旅客取消
| | orderAction |int|订单动作|
| | goodsNo |String|订单服务项|
| | orderId |String|订单ID|
| | orderStatus|int|订单状态|
响应格式
```
{
"success": true,
"message": "预约成功",
"code": 1,
"timestamp": 1571625089541,
"result": {
"goodsNo": "201",
"orderId": "656f290e101c4f598ad9bedd4eb148e0",
"orderStatus": 0,
"orderAction": 1,
"stopReason": null
}
}
```
- 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、常见问题