预下单接口
入参
参数名 | 类型 | 描述 | 必须 |
---|---|---|---|
departureCode | String | 起飞机场三字码 | Y |
arriveCode | String | 到达机场三字码 | Y |
category | int | 是否为往返程(1:单程,2:往返程) | Y |
departureAt | String | 去程/单程出发日期,格式:2017-09-09 | Y |
departureNo | String | 去程/单程航班号 | Y |
departureCabin | String | 去程/单程仓位 | Y |
returnNo | String | 返程航班号(category为2必填) | N |
returnAt | String | 返程出发日期,格式:2017-09-09(category为2必填) | N |
returnCabin | String | 返程仓位(category为2必填) | N |
返参
参数名 | 类型 | 描述 | 必须 |
---|---|---|---|
baggageStr | array | 行李额说明 | N |
bookingTag | String | 预下单编号 | Y |
queryToken | String | 航班查询编号 | Y |
ticketTime | String | 出票时限 | Y |
tgqShowData | TgqShowData | 退改签说明 | Y |
flightInfo | FlightInfo | 航班信息 | Y |
printPrice | String | 票面价 | Y |
ticketPrice | String | 经济舱全价 | Y |
productTag | String | 产品报价tag | Y |
clientSite | String | 代理商域名 | Y |
strategyAmount | int | 策略加价 | Y |
actualAmount | String | 实际收费票价(注:订单实际收费价格以下单后为准) | Y |
FlightInfo
参数名 | 类型 | 描述 | 必须 |
---|---|---|---|
arrDate | String | 到达日期,格式yyyy-MM-dd | Y |
arrTime | String | 到达时间 ,格式HH:mm | Y |
dptAirport | String | 出发机场 | Y |
dptTime | String | 出发时间 ,格式HH:mm | Y |
dpt | String | 出发机场三字码 | 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 | 经停次数 | Y |
actCarrierName | String | 主飞航司名 | N |
flightTimes | String | 飞行时间 | Y |
dptTerminal | String | 出发航站楼 | Y |
actFlightNum | String | 主飞航班号 | N |
carrier | String | 航司code | Y |
arr | String | 到达机场三字码 | Y |
planeCode | String | 飞机型号code | Y |
arrTerminal | String | 到达航站楼 | Y |
arrCity | String | 到达城市 | Y |
dptCity | String | 出发城市 | Y |
dptDate | String | 出发日期,格式yyyy-MM-dd | Y |
TgqShowData
参数名 | 类型 | 描述 | 必须 |
---|---|---|---|
tgqFrom | String | 退改签匹配类型 | Y |
returnRule | String | 退款规则 | Y |
changeRule | String | 改签规则 | Y |
allowChange | boolean | 是否允许改转, true表示允许改签,false表示不允许 | Y |
canCharge | boolean | 是否允许签转,true表示允许签转,false表示不允许 | Y |
canRefund | boolean | 是否允许退票,true表示允许退票,false表示不允许 | Y |
tgqText | String | 退改签规则说明 | Y |
airlineTgq | boolean | 是否执行航司退改签规则 | Y |
signText | String | 签转说明 | Y |
hasTime | boolean | 是否限时退改签,true表示有,false表示没有 | Y |
basePrice | int | 厂商裸票价 | Y |
tgqCabin | String | 退改签舱位 | Y |
viewType | int | 展示类型 | Y |
tgqPercentText | String | 退改签手续费说明 | Y |
returnText | String | 退票手续费说明 | Y |
changeText | String | 改签手续费说明 | Y |
tgqPointCharges | List<TgqPointCharges> | 退改签不同时间点费用说明 | Y |
TgqPointCharges
参数名 | 类型 | 描述 | 必须 |
---|---|---|---|
time | int | 时间点 | Y |
timeText | String | 时间点描述 | Y |
returnFee | int | 退票费用 | Y |
changeFee | int | 改期费用 | Y |
创建订单接口
入参
参数名 | 类型 | 描述 | 必须 |
---|---|---|---|
deptOrder | OrderInfo | 去程订单信息 | Y |
returnOrder | OrderInfo | 返程订单信息(category 为2时必传) | N |
contactName | String | 联系人姓名 | Y |
contactPhone | String | 联系人手机号 | Y |
category | int | 行程类型:1-单程,2-往返(不传则默认为1) | N |
passengers | List<Passenger> | 乘客信息 | Y |
OrderInfo
参数名 | 类型 | 描述 | 必须 |
---|---|---|---|
tgqShowData | TgqShowData | 退改签说明 | Y |
flightInfo | FlightInfo | 航班信息 | Y |
productTag | String | 产品报价tag | Y |
printPrice | String | 票面价 | Y |
ticketPrice | String | 经济舱全价 | Y |
clientSite | String | 代理商域名 | Y |
bookingTag | String | 预下单编号 | Y |
queryToken | String | 航班查询编号 | Y |
remark | String | 备注 | N |
Passenger
参数名 | 类型 | 描述 | 必须 |
---|---|---|---|
gender | int | 0:男,1:女 | Y |
birthday | String | 生日,格式yyyy-MM-dd | Y |
cardType | int | 证件类型,1:身份证,2:护照(目前暂时只支持国内身份证预订) | Y |
cardNo | String | 证件号 | Y |
name | String | 乘客姓名 | Y |
获取订单详情接口
返参
参数名 | 类型 | 描述 | 必须 |
---|---|---|---|
orderId | String | 订单id | Y |
contactName | String | 联系人姓名 | Y |
contactPhone | String | 联系人电话号码 | Y |
category | int | 1:单程2:返程 | Y |
term | long | 订单过期时间戳 | Y |
tof | String | 燃油费 | Y |
cabinType | String | 舱位类型说明 | Y |
orderAmount | String | 机票金额 | Y |
state | String | 订单状态 | 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 | 经停城市 | N |
stopAirport | String | 经停机场 | N |
deptCity | String | 出发城市 | Y |
deptAirport | String | 出发机场 | Y |
deptTerminal | String | 出发航站楼 | Y |
deptAirportCode | String | 出发机场三字码 | Y |
deptDate | String | 出发日期 | Y |
deptTime | String | 出发时间 | 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 | 退改签规则 | Y |
createTime | String | 创建时间 | Y |
获取退票手续及理由接口
返参
参数名 | 类型 | 描述 | 必须 |
---|---|---|---|
code | int | 退票原因id | Y |
msg | String | 退票原因描述 | Y |
will | boolean | 是否自愿,true:自愿,false:非自愿 | Y |
refundPassengerPriceInfoList | List<RefundPassengerPriceInfoList> | 乘客及退票费用信息 | Y |
changeFlightSegmentList | String | 退票原因描述 | Y |
RefundPassengerPriceInfoList
参数名 | 类型 | 描述 | 必须 |
---|---|---|---|
basePassengerPriceInfo | BasePassengerPriceInfo | 乘客票面信息 | Y |
refundFeeInfo | RefundFeeInfo | 退票手续费 | Y |
extraPriceInfo | String | 退票金额说明 | Y |
RefundFeeInfo
参数名 | 类型 | 描述 | 必须 |
---|---|---|---|
refundFee | String | 当前时间点退票扣费 | Y |
nextRefundFee | String | 下一个时间点退票扣费 | Y |
returnRefundFee | String | 当前时间点应退票款 | Y |
nextReturnRefundFee | String | 下一个时间点应退票款 | Y |
BasePassengerPriceInfo
参数名 | 类型 | 描述 | 必须 |
---|---|---|---|
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 |