**接口描述** 中轉服務平臺對外提供西安機場行李免提訂單預訂和處理服務，可以用此接口生成訂單也可以對已有訂單進行修改 **接口地址** 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 } } ```