改期-航班搜索-提交改期
- 用途:改期搜索模式-提交改期单
供应侧提供接口
创建改期后,默认为报价完成状态, 不需要处理改期,供应侧需要接收 confirm (1分钟内会推送),在向航司处理改期, 未收到confirm通知则直接忽略 - 请求方式:
POST - 接口地址:
/Reschedule submit - 接口加密:
否
请求参数
| 参数名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| requestId | string |
✅ | 请求ID;每次调用是唯一的,长度32位 |
| purchaseOrderNo | string |
✅ | AeroHub的订单号 |
| changeType | string |
✅ | 改期类型;VOLUNTARY:自愿改期 INVOLUNTARY: 非自愿改期 |
| changeReason | string |
⬜ | 非自愿改期原因;changeType=INVOLUNTARY时有值 FLIGHT_CHANGE:航班变更 FLIGHT_CANCEL:航班取消 |
| passengers | array/passengers Element |
✅ | 需要改期的乘客 |
| fromSegments | array/fromSegments Element |
⬜ | 需要改期的去程航段信息 |
| retSegments | array/retSegments Element |
⬜ | 需要改期的回程航段信息 |
| changeOrderNo | string |
✅ | aerohub改期单号;改期提交成功后供应方需要记录此单号,后续可以此单来操作改期完成或拒单 |
| routingKey | string |
✅ | 需要改期的routingKey;search接口flightList对应的信息 |
| amount | float |
✅ | 总费改期费;changeFee+fareDifference+taxDifference |
| changeFee | float |
✅ | 总变更费 |
| fareDifference | float |
✅ | 总票价仓差费 |
| taxDifference | float |
✅ | 总税仓差费 |
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 |
请求示例
{
"requestId": "string",
"purchaseOrderNo": "string",
"changeOrderNo": "string",
"changeType": "string",
"changeReason": "string",
"passengers": [
{
"ageType": 0,
"gender": "string",
"lastName": "string",
"firstName": "string",
"birthday": "string",
"nationality": "string",
"cardNo": "string",
"expired": "string"
}
],
"routingKey": "string",
"amount": 0,
"changeFee": 0,
"fareDifference": 0,
"taxDifference": 0
}
返回参数
| 参数名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | int |
✅ | code码;200表示提交改期成功,对当前传入的改期价格无异议 201 表示改期变价,需要重新搜索 其它错误信息不限code值,但必须在smg里面指定错误信息 |
| msg | string |
✅ | 消息;用于错误提示,code等于202时必须返回此信息 |
返回示例
成功示例
{
"code": 200,
"msg": "Success"
}
失败返回
{
"code": 202,
"msg": "价格发生变化"
}Author:AeroHub Create time:2026-08-14 15:50
Last editor:AeroHub Update time:2026-09-07 17:30
Last editor:AeroHub Update time:2026-09-07 17:30