机票预定

  • 接口:
  • Method: POST
  • 接口说明: 机票预订
  • 文档末尾有文档版本记录
请求参数
字段名称 字段类型 字段描述 是否必填
source String 商旅平台 是
flightBookRequest FlightBookRequest 机票预定信息 是
FlightBookRequest:
字段名称 字段类型 字段描述 是否必填
passengerList List<Integer> 出行人列表，云简的员工Id 是
doucumentNum String 申请单号 否
flightNumber String 航班号 是
departureTime String 出发时间，yyyy-MM-dd HH:mm 是
cabin String 舱位等级，标准值列表-附录6：飞机舱位 是
示例
{
  "source": "ctrip",
  "flightBookRequest": {
    "passengerList": [
      145666
    ],
    "doucumentNum": "REQ0000000001",
    "flightNumber": "CA1234",
    "departureTime": "2023-08-23 12:00",
    "cabin": "3"
  }
}
返回参数
字段名称 字段类型 字段描述
resCode Integer 响应状态码
resMsg String 响应信息
data BookResult 响应数据
BookResult
字段名称 字段类型 字段描述
bookStatus Boolean 预定结果，预定失败为false
flightBookOrderInfo FlightOrderInfo 预定成功后的订单展示
FlightOrderInfo
字段名称 字段类型 字段描述
source String 商旅平台
source_type String 订单类型
order_id String 订单号，渠道内唯一
document_num String 云简申请单号
amount BigDecimal 订单总价，实际金额
price BigDecimal 原始价格
service_price BigDecimal 服务费
coupon BigDecimal 购买优惠券金额
deduction_coupon BigDecimal 优惠券抵扣金额
person_pay BigDecimal 个人实际支付金额
company_pay BigDecimal 公司实际支付金额
currency String 币种，默认CNY
other_price List<BasePrice> 其他费用
scene_code String 场景代码
scene_name String 场景名称
order_datetime Long 预定时间，13位时间戳
start_datetime Long 出发时间，13位时间戳
end_datetime Long 到达时间，13位时间戳
order_date_time String 预定时间，当地时间，yyyy-MM-dd HH:mm:ss
start_date_time String 出发时间，当地时间，yyyy-MM-dd HH:mm:ss
end_date_time String 到达时间，当地时间，yyyy-MM-dd HH:mm:ss
seller_invoice_title String 开票方的发票抬头
oil_fee BigDecimal 总燃油费
airport_fee BigDecimal 总基建费
taxation BigDecimal 国际机票为总税费，国内机票为总机建费+总燃油费
change_price BigDecimal 总改签手续费，航司收
refund_price BigDecimal 总退票手续费，航司收
change_service_price BigDecimal 总改签服务费，商旅平台收
refund_service_price BigDecimal 总退票服务费，商旅平台收
send_ticket_price BigDecimal 总送票费
insurance_price BigDecimal 总保险费
示例
{
 "resCode": 200000,
 "resMsg": "success",
 "data": {
 "bookStatus":true,
 "flightBookOrderInfo":{
  "source": "ctrip",
  "source_type": "flight",
  "order_id": "F202308230001",
  "document_num": "REQ0000000001",
  "amount": 1280.00,
  "price": 1180.00,
  "service_price": 30.00,
  "company_pay": 1280.00,
  "person_pay": 0.00,
  "currency": "CNY",
  "start_date_time": "2023-08-23 12:00:00",
  "end_date_time": "2023-08-23 14:30:00",
  "oil_fee": 70.00,
  "airport_fee": 50.00,
  "taxation": 120.00
 }
 }
}
文档版本记录
版本号 编写日期 更改内容
V1.0 2023.10.07 初稿
V1.1 2026.06.15 根据common-charlie补充FlightOrderInfo返回字段

results matching ""

    No results matching ""