預(yù)下單接口
入?yún)?/h5>
| 參數(shù)名 | 類型 | 描述 | 必須 |
|---|---|---|---|
| departureCode | String | 起飛機場三字碼 | Y |
| arriveCode | String | 到達機場三字碼 | Y |
| category | int | 是否為往返程(1:單程,2:往返程) | Y |
| departureAt | String | 去程/單程出發(fā)日期,格式:2017-09-09 | Y |
| departureNo | String | 去程/單程航班號 | Y |
| departureCabin | String | 去程/單程倉位 | Y |
| returnNo | String | 返程航班號(category為2必填) | N |
| returnAt | String | 返程出發(fā)日期,格式:2017-09-09(category為2必填) | N |
| returnCabin | String | 返程倉位(category為2必填) | N |
返參
| 參數(shù)名 | 類型 | 描述 | 必須 |
|---|---|---|---|
| baggageStr | array | 行李額說明 | N |
| bookingTag | String | 預(yù)下單編號 | Y |
| queryToken | String | 航班查詢編號 | Y |
| ticketTime | String | 出票時限 | Y |
| tgqShowData | TgqShowData | 退改簽說明 | Y |
| flightInfo | FlightInfo | 航班信息 | Y |
| printPrice | String | 票面價 | Y |
| ticketPrice | String | 經(jīng)濟艙全價 | Y |
| productTag | String | 產(chǎn)品報價tag | Y |
| clientSite | String | 代理商域名 | Y |
| strategyAmount | int | 策略加價 | Y |
| actualAmount | String | 實際收費票價(注:訂單實際收費價格以下單后為準(zhǔn)) | Y |
FlightInfo
| 參數(shù)名 | 類型 | 描述 | 必須 |
|---|---|---|---|
| arrDate | String | 到達日期,格式y(tǒng)yyy-MM-dd | Y |
| arrTime | String | 到達時間 ,格式HH:mm | Y |
| dptAirport | String | 出發(fā)機場 | Y |
| dptTime | String | 出發(fā)時間 ,格式HH:mm | Y |
| dpt | String | 出發(fā)機場三字碼 | Y |
| cabin | String | 艙位 | Y |
| tof | String | 燃油費用 | Y |
| ctof | String | 兒童燃油費用 | Y |
| ccbcn | String | 嬰兒艙位 | N |
| actCarrier | String | 主飛航司 | N |
| flightNum | String | 航班號 | Y |
| cbcn | String | 兒童艙位 | N |
| arf | String | 基建費用 | Y |
| carrierName | String | 航空公司 | Y |
| arrAirport | String | 到達機場 | Y |
| childCabin | String | 兒童艙位 | N |
| babyCabin | String | 嬰兒艙位 | N |
| stops | int | 經(jīng)停次數(shù) | Y |
| actCarrierName | String | 主飛航司名 | N |
| flightTimes | String | 飛行時間 | Y |
| dptTerminal | String | 出發(fā)航站樓 | Y |
| actFlightNum | String | 主飛航班號 | N |
| carrier | String | 航司code | Y |
| arr | String | 到達機場三字碼 | Y |
| planeCode | String | 飛機型號code | Y |
| arrTerminal | String | 到達航站樓 | Y |
| arrCity | String | 到達城市 | Y |
| dptCity | String | 出發(fā)城市 | Y |
| dptDate | String | 出發(fā)日期,格式y(tǒng)yyy-MM-dd | Y |
TgqShowData
| 參數(shù)名 | 類型 | 描述 | 必須 |
|---|---|---|---|
| tgqFrom | String | 退改簽匹配類型 | Y |
| returnRule | String | 退款規(guī)則 | Y |
| changeRule | String | 改簽規(guī)則 | Y |
| allowChange | boolean | 是否允許改轉(zhuǎn), true表示允許改簽,false表示不允許 | Y |
| canCharge | boolean | 是否允許簽轉(zhuǎn),true表示允許簽轉(zhuǎn),false表示不允許 | Y |
| canRefund | boolean | 是否允許退票,true表示允許退票,false表示不允許 | Y |
| tgqText | String | 退改簽規(guī)則說明 | Y |
| airlineTgq | boolean | 是否執(zhí)行航司退改簽規(guī)則 | Y |
| signText | String | 簽轉(zhuǎn)說明 | Y |
| hasTime | boolean | 是否限時退改簽,true表示有,false表示沒有 | Y |
| basePrice | int | 廠商裸票價 | Y |
| tgqCabin | String | 退改簽艙位 | Y |
| viewType | int | 展示類型 | Y |
| tgqPercentText | String | 退改簽手續(xù)費說明 | Y |
| returnText | String | 退票手續(xù)費說明 | Y |
| changeText | String | 改簽手續(xù)費說明 | Y |
| tgqPointCharges | List<TgqPointCharges> | 退改簽不同時間點費用說明 | Y |
TgqPointCharges
| 參數(shù)名 | 類型 | 描述 | 必須 |
|---|---|---|---|
| time | int | 時間點 | Y |
| timeText | String | 時間點描述 | Y |
| returnFee | int | 退票費用 | Y |
| changeFee | int | 改期費用 | Y |
創(chuàng)建訂單接口
入?yún)?/h6>
| 參數(shù)名 | 類型 | 描述 | 必須 |
|---|---|---|---|
| deptOrder | OrderInfo | 去程訂單信息 | Y |
| returnOrder | OrderInfo | 返程訂單信息(category 為2時必傳) | N |
| contactName | String | 聯(lián)系人姓名 | Y |
| contactPhone | String | 聯(lián)系人手機號 | Y |
| category | int | 行程類型:1-單程,2-往返(不傳則默認為1) | N |
| passengers | List<Passenger> | 乘客信息 | Y |
OrderInfo
| 參數(shù)名 | 類型 | 描述 | 必須 |
|---|---|---|---|
| tgqShowData | TgqShowData | 退改簽說明 | Y |
| flightInfo | FlightInfo | 航班信息 | Y |
| productTag | String | 產(chǎn)品報價tag | Y |
| printPrice | String | 票面價 | Y |
| ticketPrice | String | 經(jīng)濟艙全價 | Y |
| clientSite | String | 代理商域名 | Y |
| bookingTag | String | 預(yù)下單編號 | Y |
| queryToken | String | 航班查詢編號 | Y |
| remark | String | 備注 | N |
Passenger
| 參數(shù)名 | 類型 | 描述 | 必須 |
|---|---|---|---|
| gender | int | 0:男,1:女 | Y |
| birthday | String | 生日,格式y(tǒng)yyy-MM-dd | Y |
| cardType | int | 證件類型,1:身份證,2:護照(目前暫時只支持國內(nèi)身份證預(yù)訂) | Y |
| cardNo | String | 證件號 | Y |
| name | String | 乘客姓名 | Y |
獲取訂單詳情接口
返參
| 參數(shù)名 | 類型 | 描述 | 必須 |
|---|---|---|---|
| orderId | String | 訂單id | Y |
| contactName | String | 聯(lián)系人姓名 | Y |
| contactPhone | String | 聯(lián)系人電話號碼 | Y |
| category | int | 1:單程2:返程 | Y |
| term | long | 訂單過期時間戳 | Y |
| tof | String | 燃油費 | Y |
| cabinType | String | 艙位類型說明 | Y |
| orderAmount | String | 機票金額 | Y |
| state | String | 訂單狀態(tài) | Y |
| refundAdditionAmount | String | 退款額 | N |
| amount | String | 訂單實際支付價格(orderAmount+tof+arf) | Y |
| realCarrier | String | 真實航司code | N |
| flightCom | String | 航空公司名稱 | Y |
| flightRealCom | String | 航空公司的真實名稱(如果是共享航班和 flight_com 不一樣) | N |
| flightNum | String | 航班號 | Y |
| flightRealNum | String | 真實航班號(如果是共享航班和 flight_num 不一樣) | N |
| flightType | String | 飛機型號 | Y |
| flightTimes | String | 飛行時間 | Y |
| cabin | String | 艙位類型 | Y |
| arf | String | 基建費用 | Y |
| stopCity | String | 經(jīng)停城市 | N |
| stopAirport | String | 經(jīng)停機場 | N |
| deptCity | String | 出發(fā)城市 | Y |
| deptAirport | String | 出發(fā)機場 | Y |
| deptTerminal | String | 出發(fā)航站樓 | Y |
| deptAirportCode | String | 出發(fā)機場三字碼 | Y |
| deptDate | String | 出發(fā)日期 | Y |
| deptTime | String | 出發(fā)時間 | Y |
| arrCity | String | 到達城市 | Y |
| arrAirport | String | 到達機場 | Y |
| arrTerminal | String | 到達航站樓 | Y |
| arrAirportCode | String | 到達城市三字碼 | Y |
| arrDate | String | 到達日期 | Y |
| arrTime | String | 到達時間 | Y |
| carrier | String | 航司code | Y |
| passengers | FlightPassenger | 乘客信息 | Y |
| tgqShowData | TgqShowData | 退改簽規(guī)則 | Y |
| createTime | String | 創(chuàng)建時間 | Y |
獲取退票手續(xù)及理由接口
返參
| 參數(shù)名 | 類型 | 描述 | 必須 |
|---|---|---|---|
| code | int | 退票原因id | Y |
| msg | String | 退票原因描述 | Y |
| will | boolean | 是否自愿,true:自愿,false:非自愿 | Y |
| refundPassengerPriceInfoList | List<RefundPassengerPriceInfoList> | 乘客及退票費用信息 | Y |
| changeFlightSegmentList | String | 退票原因描述 | Y |
RefundPassengerPriceInfoList
| 參數(shù)名 | 類型 | 描述 | 必須 |
|---|---|---|---|
| basePassengerPriceInfo | BasePassengerPriceInfo | 乘客票面信息 | Y |
| refundFeeInfo | RefundFeeInfo | 退票手續(xù)費 | Y |
| extraPriceInfo | String | 退票金額說明 | Y |
RefundFeeInfo
| 參數(shù)名 | 類型 | 描述 | 必須 |
|---|---|---|---|
| refundFee | String | 當(dāng)前時間點退票扣費 | Y |
| nextRefundFee | String | 下一個時間點退票扣費 | Y |
| returnRefundFee | String | 當(dāng)前時間點應(yīng)退票款 | Y |
| nextReturnRefundFee | String | 下一個時間點應(yīng)退票款 | Y |
BasePassengerPriceInfo
| 參數(shù)名 | 類型 | 描述 | 必須 |
|---|---|---|---|
| disabled | boolean | true:不可退票,false:可退票 | Y |
| disableReason | String | 不可退票原因 | Y |
| passengerId | String | 乘客id | Y |
| passengerName | boolean | 乘機人姓名 | Y |
| cardNum | String | 證件號 | Y |
| passengerTypeStr | String | 乘客類型 | Y |
| ticketPrice | String | 票面價格 | Y |
| constructionFee | String | 基建 | Y |
| fuelTax | String | 燃油 | Y |