改期入单和更新通知

  • 用途：当改期状态发生变化通知到此API接口
    供应侧提供接口
    如供应侧系统处理失败，aerohub将重试推送5次，每60秒重试1次
    后续失败需供应侧到管理系统人工处理。
  • 请求方式：POST
  • 接口加密：否

请求参数

参数名称 类型 必填 说明
requestId string ✅ 请求ID；每次调用是唯一的，长度32位
noticeType string ✅ 通知类型；quotation:改期询价，当未通过航班搜索模式提交改期时会收到此通知，供应商仅提供报价， 需要请求改期报价接口，完成报价
confirm:确认改期 （报价完成后，如确认改期，会发送此类型，需向航司提交改期处理）
withdrawn:撤销改期， 锁定前可能会收到此通知
quotation_withdrawn：询价撤销
locked: 改期锁单，通过供应商后台操作锁单或请求锁单接口触发
completed: 改期完成，通过供应商后台完成改期或api接口请求完成改期后触发
rejected：改期拒单， 供应商后台操作拒单或请求拒单api触发
changeOrderNo string ✅ AeroHub的改期单号
purchaseOrderNo string ✅ AeroHub的订单号
change object/change Element ✅ 改期详情；包含类型、乘客、航段信息

object/change Element

参数名称 类型 必填 说明
changeType string ✅ 改期类型；VOLUNTARY:自愿改期
INVOLUNTARY: 非自愿改期
INFORMATION_UPDATER:变更乘客信息
OTHER：其它
changeReason string ✅ 非自愿改期原因；changeType=INVOLUNTARY时传入
FLIGHT_CHANGE:航班变更
FLIGHT_CANCEL:航班取消
OTHER:其它原因
passengers array/passengers Element ✅ 需要变更的乘客
originalSegments array/originalSegments Element ⬜ 需要变更的原始行程；当changeType=VOLUNTARY或INVOLUNTARY时传入
newSegments array/newSegments Element ⬜ 新航段信息；当changeType=VOLUNTARY或INVOLUNTARY时传入
newPassengers array/newPassengers Element ⬜ 变更后的乘客信息；仅changeType=INFORMATION_UPDATER时传入
fees object/fees Element ✅ 供应商测报价信息
noticeType为confirm、completed、locked时有值
array/passengers Element
参数名称 类型 必填 说明
lastName string ✅ 乘客last name；大写
firstName string ✅ 乘客first name；大写
birthday string ⬜ 生日；格式：xxxx-xx-xx
cardNo string ⬜ 证件号
ageType int ✅ 乘客类型；0:成人
1:儿童
2:婴儿
gender string ✅ 乘客性别；F:男, M:女
nationality string ⬜ 国籍二字码；ISO国家二字码
expired string ⬜ 证件过期时间；格式：xxxx-xx-xx
array/originalSegments Element
参数名称 类型 必填 说明
tripType int ✅ 行程类型；1去程 2返程
segmentNumber int ✅ 行程序号；1开始
depAirport string ✅ 到达机场；机场三字码
arrAirport string ✅ 到达机场；机场三字码
flightNumber string ✅ 航班号
depTime string ✅ 出发时间；格式：YYYY-MM-DD HH:MM
arrTime string ✅ 到达时间；格式：YYYY-MM-DD HH:MM
array/newSegments Element
参数名称 类型 必填 说明
tripType int ✅ 行程类型；1去程 2返程
segmentNumber int ✅ 行程序号；1开始
depAirport string ✅ 到达机场；机场三字码
arrAirport string ✅ 到达机场；机场三字码
flightNumber string ✅ 航班号
depTime string ✅ 出发时间；格式：YYYY-MM-DD HH:MM
arrTime string ✅ 到达时间；格式：YYYY-MM-DD HH:MM
array/newPassengers Element
参数名称 类型 必填 说明
lastName string ✅ 乘客last name；大写
firstName string ✅ 乘客first name；大写
birthday string ⬜ 生日；格式：xxxx-xx-xx
cardNo string ⬜ 证件号
ageType int ✅ 乘客类型；0:成人
1:儿童
2:婴儿
gender string ✅ 乘客性别；F:男, M:女
nationality string ⬜ 国籍二字码；ISO国家二字码
expired string ⬜ 证件过期时间；格式：xxxx-xx-xx
object/fees Element
参数名称 类型 必填 说明
amount float ✅ 改期总额；changeFee + fareDifference + taxDifference
changeFee float ✅ 变更费
fareDifference float ✅ 票面仓差
taxDifference float ✅ 税仓差
costDetails object/costDetails Element ✅ 价格明细
object/costDetails Element
参数名称 类型 必填 说明
passengerType int ✅ 乘客类型；0成人 1儿童 2 婴儿
changeFee string ✅ 变更费
fareDifference string ✅ 票面仓差
taxDifference string ✅ 税仓差

请求示例

{
  "requestId": "PcrNq8964iFUkE0CyVV4eDgSFX",
  "noticeType": "quotation",
  "changeOrderNo": "C20250231211625359",
  "purchaseOrderNo": "F2046213614100701358",
  "change": {
    "changeType": "INVOLUNTARY",
    "changeReason": "FLIGHT_CHANGE",
    "passengers": [
      {
        "lastName": "FADHILBAH",
        "firstName": "NUDUL",
        "birthday": "2000-10-14",
        "cardNo": "B6200031",
        "ageType": "0",
        "gender": "F",
        "nationality": "PE",
        "expired": "2030-01-01"
      }
    ],
    "originalSegments": [
      {
        "tripType": "1",
        "segmentNumber": "1",
        "depAirport": "BKK",
        "arrAirport": "HTK",
        "flightNumber": "AK123",
        "depTime": "2026-01-01 10:00",
        "arrTime": "2026-01-01 13:00"
      }
    ],
    "newSegments": [
      {
        "tripType": "1",
        "segmentNumber": "1",
        "depAirport": "BKK",
        "arrAirport": "HTK",
        "flightNumber": "AK123",
        "depTime": "2026-01-01 10:00",
        "arrTime": "2026-01-01 13:00"
      }
    ],
    "newPassengers": [
      {
        "lastName": "FADHILBAH",
        "firstName": "NUDUL",
        "birthday": "2000-10-14",
        "cardNo": "B6200031",
        "ageType": "0",
        "gender": "F",
        "nationality": "PE",
        "expired": "2030-01-01"
      }
    ],
    "fees": {
      "amount": "100",
      "changeFee": "30",
      "fareDifference": "60",
      "taxDifference": "10",
      "costDetails": {
        "passengerType": "0",
        "changeFee": "",
        "fareDifference": "",
        "taxDifference": ""
      }
    }
  }
}

返回参数

参数名称 类型 必填 说明
code int ✅ code值；200，表示系统处理成功， 其他表示处理失败， 返回非200，我们会重试推送5次
aerohub不关心供应侧系统成功/失败， 如果失败需要供应商前往供应商系统手动处理
msg string ✅ 错误信息

返回示例

示例

{
  "code": 200,
  "msg": "Success"
}
Author：AeroHub  Create time：2026-08-14 15:46
Last editor：AeroHub  Update time：2026-09-07 17:30