OrderChangeInforming 订单信息变更通知

1 说明

该接口为FR24主动向合作方推送航变或订单信息变化的接口，需要合作方提供供FR24调用的URL。

2 请求参数

名称	类型	必填	描述
authentication	object	是	用户认证信息
traceId	string	是	追溯码
type	string	是	变更类别 orderStatus - 订单状态 ticketNo - 票号或航司大编码推送 scheduleChange - 航班变化 ancillaryOrderStatus - 辅营订单状态 ticketNoUpdate - 票号或大编码二次推送 refund- 退票相关通知 change- 改期相关通知 void- 废票相关通知
orderNo	string	是	FR24订单号当为seatOrderStatus ，推送选座 FR 订单号
partnerOrderNo	string	否	合作方订单号
orderStatus	int	否	订单状态。当type为orderStatus时，该项为必填。 11 - 生单成功 12 - 出票中 13 - 出票完成 14 - 等待确认 15 - 订单已取消 67- 支付成功. 改期 47, 改期待审核 48, 改期待付款 49, 改期付款完成待处理 50, 改期失败 51, 改期驳回 52, 改期待退款. 53, 退款中 54, 退款完成 61, 改期完成退票 72, 待核价 73, 核价完成 25, 退票待审核 26, 暂不能退票 27, 已审核正退票 29, 已退票待退款 30, 退款完成废票 36, 废票待审核 37, 废票驳回 38, 废票完成辅营 101, 已生单未支付 102, 已支付待购买 103, 完成购买 104, 订单取消
tktgAcctInfos	array	否	账号密码信息，用于登录航司官网的账号密码信息，该字段非必传 (如果只有一个账号密码，那么同一账号密码的航段以及乘客都放在相同的列表中)
info	object	是	通知详情

tktgAcctInfos

名称	类型	必填	描述
paxIds	array	是	乘客id集合
segmentIds	array	是	航段id集合
tktgAccount	string	是	用于登录航司官网的出票账号，使用AES加密处理
tktgPassword	string	是	用于登录航司官网的出票密码，使用AES加密处理

info

名称	类型	必填	描述
ticketInfo	array	否	机票信息。当type为ticketNo票号或航司大编码推送时，该项为必填
ticketInfo_V2	array	否	机票信息。当type为ticketNo票号或航司大编码推送时，该项为必填
originInfo	array	否	原始信息。当type为scheduleChange或者ticketNoUpdate时，该项为必填
newInfo	array	否	变更后信息。当type为scheduleChange或者ticketNoUpdate时，该项为必填
ancillary	array	是	辅营信息，当type为ancillaryOrderStatus ，该项为必填
segments	array	否	航段信息。当type为ticketNo票号或航司大编码推送时，该项为必填
passengers	array	否	乘客信息。当type为ticketNo票号或航司大编码推送时，该项为必填
feeInfo	object	是	售后费用信息

ticketInfo

名称	类型	必填	描述
airlinePnr	string	是	航司大编码
gdsPnr	string	否	gds大编码，当来源是gds时才会返回
paxId	string	是	乘客id
ticketNo	array	是	票号
segmentId	string	是	航段id

ticketInfo_V2

备注：目前有两种出票信息传输格式（如下描述），可以联系FR24团队给您配置

“最小颗粒度方案”时，会按照1paxId-1segment-1airlinePnr-1gdsPnr-1ticketNo维度将信息补充到ticketInfo_V2的数据结构中

“航司大编码维度分组方案”时，票面信息补充到数据结构的规则如下

名称	类型	必填	描述
airlinePnr	string	是	航司大编码。如果有多个航司大编码，则每个airlinePnr拆分出来为一个一级节点
gdsPnr	string	否	gds编码，当来源为gds时不为空。且是当前一级节点中airlinePnr所对应的gdsPnr
tktInfo	array	是	票面信息，当前airlinePnr所对应的票面信息

tktInfo

名称	类型	必填	描述
ticketNo	string	是	票号，当前大编码对应的票号。如果对应多个票号，则每个ticketNo拆分出来为一个二级节点
paxId	array	是	乘客id，当前票号对应的所有乘客id。若有多个乘客则用英文逗号","隔开
segmentId	array	是	航段id，当前票号对应的所有航段id。若有多个航段则用英文逗号","隔开

originInfo

名称	类型	必填	描述
segmentId	array	是	发生变化的航段id
Segments	array	是	航段详情

newInfo

名称	类型	必填	描述
segmentIds	string	是	发生变化的航段id
segmentStatus	string	是	变化类型 cancel-取消 change-变化 recover-恢复
segments	array	是	航段详情

ancillary

名称	类型	必填	描述
baggage	array	是	辅营行李信息
seatInfos	array	是	辅营选座信息。

baggage

名称	类型	必填	描述
paxId	int	是	乘客id
segmentId	array	是	航段组合
auxId	string	是	辅营id
baseFare	decimal	是	基础单价
serviceFee	decimal	是	服务费
size	string	否	尺寸，单位CM
weight	int	是	重量，单位KG
piece	int	否	包含辅营个数，单位PC
quantity	int	是	购买件数

seatInfos

名称	类型	必填	描述
paxId	int	是	乘客id，若进行选座，该项为必填项
segmentId	Int	是	航段id，若进行选座，该项为必填项
rowNo	string	是	行座位号如：10
colNo	string	是	列座位列表
selectedSeatNo	string	是	已选座位号如：10E，若进行选座，该项为必填项
seatprice	decimal	是	座位价格，若进行选座，该项为必填项

segments

名称	类型	必填	描述
segmentId	string	是	航段唯一标识
duration	long	是	航段总时长，单位分钟min
carrier	string	是	销售航司。使用IATA航司标准二字代码
flightNo	string	是	航班号，和carrier搭配使用 BA1234，carrier为BA，flightNo为1234
codeShare	boolean	是	航班共享标识 true-代码共享 false-非代码共享
operatingCarrier	string	否	实际承运航司。使用IATA航司标准二字代码
operatingFlightNo	string	否	实际承运航班号
aircraftCode	string	否	机型。使用IATA机型标准三字代码
depAirport	string	是	出发机场。使用IATA机场标准三字代码
depTerminal	string	否	出发航站楼
depTime	string	是	出发时间。YYYY-MM-DDThh:mm，比如2022-10-21T21:23 起飞机场所在地时间
arrAirport	string	是	到达机场。使用IATA机场标准三字代码
arrTerminal	string	否	到达航站楼
arrTime	string	是	到达时间。YYYY-MM-DDThh:mm 到达机场所在地时间
stopAirport	array	否	经停机场。使用IATA机场标准三字标准代码。若无经停则无数据内容
stopDuration	array	否	停留时长。若无经停则无数据内容

passengers

名称	类型	必填	描述
paxId	string	是	乘客id
name	string	是	乘客姓名。姓/名
birthday	string	是	乘客生日。YYYY-MM-DD

feeInfo

名称	类型	必填	描述
currency	string	是	币种
totalAmount	decimal	是	实际不可退回金额 ADTNUMADT(totalFare + totalTax + serviceFee)+CHDNUM CHD(...)+INFNUM * INF(...)
refundAmount	decimal	否	应退采购金额
expiryTime	string	是	核价有效期
refundFee	array	否	退票金额信息当type为refund时，该项会返回
changeFee	array	否	改期金额信息当type为change时，该项会返回
voidFee	array	否	废票金额信息当type为void时，该项会返回

refundFee

名称	类型	必填	描述
paxType	string	是	ADT- 成人 CHD- 儿童 INF- 婴儿
totalFare	decimal	是	总扣除金额。等于误机费+改期费
deductFare	array	否	扣除金额明细
totalTax	decimal	是	总税费
taxBreakdown	array	否	税费明细
serviceFee	decimal	是	服务费

deductFee

名称	类型	必填	描述
fareType	string	是	扣除费类别 noshow – 误机费 changeFee – 改期费
fareAmount	decimal	是	扣除费用

taxBreakdown

名称	类型	必填	描述
taxType	string	是	税费类型行政费/他国政府税/不可退的税
taxAmount	decimal	是	税费

changeFare

名称	类型	必填	描述
fareType	string	是	扣除费类别 baseFareDiff – 票面差 noshow – 误机费 changeFee – 改期费
fareAmount	decimal	是	扣除费用

taxBreakdown

名称	类型	必填	描述
taxType	string	是	税费类型
taxAmount	decimal	是	税费

3 响应参数

名称	类型	必填	描述
authentication	object	是	用户认证信息
traceId	string	是	追溯码
code	string	是	通知推送状态。000000，成功
message	string	是	状态说明
processingTime	long	是	处理时长，ms

4 RQ

4.1 ticketNo/ticketNoUpdate

{
    "authentication": {
        "sign": "",
        "timeStamp": ""
    },
    "traceId": "",
    "type": "ticketNo/ticketNoUpdate",
    "orderNo": "",
    "partnerOrderNo": "",
    "tktgAcctInfos": [
        {
            "paxIds": [
                "1",
                "2",
                "3"
            ],
            "segmentIds": [
                "1bd336d0305b04f9d59e9a2d1895034c^fa065c2163cad50864545390110db6dc"
            ],
            "tktgAccount": "gPfsfRe4nblhspmnjIqPqfFYhLbQ9ZcwJB2I+WeEqI9=",
            "tktgPassword": "d+jAvoQDto/DRk2rzVCO/g=="
        },
        {
            "paxIds": [
                "1",
                "2",
                "3"
            ],
            "segmentIds": [
                "fd9a04f5f1615f03b1131bd617a5091c"
            ],
            "tktgAccount": "sakdjhshdasadsadssadsakjhdksjhja5485sads-=sds",
            "tktgPassword": "hsabdw98sd2n+----=xsdssf"
        }
    ],
    "info": {
        "ticketInfo": [
            {
                "paxId": "1",
                "airlinePnr": [
                    "ASDDSA",
                    "ASDDSA"
                ],
                "gdsPnr": [
                    "WWEWEW",
                    "WWEWEW"
                ],
                "ticketNo": [
                    "GTREDS",
                    "ASWSAS^ASWSAS^SSWSWS^EWEWER"
                ],
                "segmentIds": [
                    "1ajshbbgxisnwwqw",
                    "2poppojkjnbjasdj^3uiutgbchdbwjuiu"
                ]
            },
            {
                "paxId": "2",
                "airlinePnr": [
                    "ASDSDS",
                    "AJHKGH"
                ],
                "gdsPnr": [
                    "RERERE",
                    "RERERE"
                ],
                "ticketNo": [
                    "ASWERT",
                    "QUIOPO"
                ],
                "segmentIds": [
                    "1ajshbbgxisnwwqw",
                    "2poppojkjnbjasdj^3uiutgbchdbwjuiu"
                ]
            }
        ],
        "ticketInfo_V2": [
            {
                "airlinePnr": "ASD111",
                "gdsPnr": "WWEWEW",
                "tktInfo": [
                    "ticketNo": "a12345",
                    "paxId": [
                        "1",
                        "2"
                    ],
                    "segmentIds": [
                        "1ajshbbgxisnwwqw",
                        "2poppojkjnbjasdj"
                    ]
                ]
            },
            {
                "airlinePnr": "ASD222",
                "gdsPnr": "WWOWWO",
                "tktInfo": [
                    "ticketNo": "b12345",
                    "paxId": [
                        "1",
                        "2"
                    ],
                    "segmentIds": [
                        "3uiutgbchdbwjuiu"
                    ]
                ]
            }
        ]

        "segments": [
            {
                "segmentId": "1ajshbbgxisnwwqw",
                "duration": 182,
                "carrier": "LH",
                "flightNo": "7965",
                "codeShare": false,
                "operatingCarrier": null,
                "operatingFlightNo": null,
                "aircraftCode": "333",
                "depAirport": "SHA",
                "depTerminal": null,
                "depTime": "2023-04-20T17:10",
                "arrAirport": "HKG",
                "arrTerminal": null,
                "arrTime": "2023-04-20T20:12",
                "stopAirport": null,
                "stopDuration": null
            },
            {
                "segmentId": "2poppojkjnbjasdj",
                "duration": 243,
                "carrier": "ZH",
                "flightNo": "4668",
                "codeShare": false,
                "operatingCarrier": null,
                "operatingFlightNo": null,
                "aircraftCode": "333",
                "depAirport": "PVG",
                "depTerminal": null,
                "depTime": "2023-04-20T10:10",
                "arrAirport": "HKG",
                "arrTerminal": null,
                "arrTime": "2023-04-20T14:13",
                "stopAirport": null,
                "stopDuration": null
            },
            {
                "segmentId": "3uiutgbchdbwjuiu",
                "duration": 288,
                "carrier": "ZH",
                "flightNo": "4668",
                "codeShare": false,
                "operatingCarrier": null,
                "operatingFlightNo": null,
                "aircraftCode": "333",
                "depAirport": "PVG",
                "depTerminal": null,
                "depTime": "2023-04-20T10:10",
                "arrAirport": "HKG",
                "arrTerminal": null,
                "arrTime": "2023-04-20T14:13",
                "stopAirport": null,
                "stopDuration": null
            }
        ],
        "passengers": [
            {
                "paxId": "1",
                "name": "ZHANG/SAN",
                "birthday": "1989-11-12"
            },
            {
                "paxId": "2",
                "name": "LI/SI",
                "birthday": "1994-05-06"
            }
        ]
    }
}

4.2 scheduleChange

{
    "authentication": {
        "sign": "",
        "timeStamp": ""
    },
    "traceId": "",
    "type": "scheduleChange",
    "orderNo": "",
    "partnerOrderNo": "",
    "info": {
        "originInfo": [
            {
                "segmentId": "1ujhujhuijhuiknb",
                "duration": 140,
                "carrier": "LH",
                "flightNo": "2046",
                "codeShare": false,
                "operatingCarrier": null,
                "operatingFlightNo": null,
                "aircraftCode": "333",
                "depAirport": "SHA",
                "depTerminal": null,
                "depTime": "2023-04-25T06:35",
                "arrAirport": "HKG",
                "arrTerminal": null,
                "arrTime": "2023-04-25T08:55",
                "stopAirport": null,
                "stopDuration": null
            },
            {
                "segmentId": "2poiujhjklmnjk8o",
                "duration": 247,
                "carrier": "LH",
                "flightNo": "8725",
                "codeShare": false,
                "operatingCarrier": null,
                "operatingFlightNo": null,
                "aircraftCode": "333",
                "depAirport": "HKG",
                "depTerminal": null,
                "depTime": "2023-04-28T05:50",
                "arrAirport": "SHA",
                "arrTerminal": null,
                "arrTime": "2023-04-28T09:57",
                "stopAirport": null,
                "stopDuration": null
            },
            {
                "segmentId": "3yuiokjhnmlppupo",
                "duration": 192,
                "carrier": "ZH",
                "flightNo": "9050",
                "codeShare": false,
                "operatingCarrier": null,
                "operatingFlightNo": null,
                "aircraftCode": "333",
                "depAirport": "HKG",
                "depTerminal": null,
                "depTime": "2023-04-26T07:35",
                "arrAirport": "SIN",
                "arrTerminal": null,
                "arrTime": "2023-04-26T10:47",
                "stopAirport": null,
                "stopDuration": null
            },
            {
                "segmentId": "4uiyhjuiknbgtfgy",
                "duration": 249,
                "carrier": "LH",
                "flightNo": "7504",
                "codeShare": false,
                "operatingCarrier": null,
                "operatingFlightNo": null,
                "aircraftCode": "333",
                "depAirport": "XSP",
                "depTerminal": null,
                "depTime": "2023-04-27T00:20",
                "arrAirport": "HKG",
                "arrTerminal": null,
                "arrTime": "2023-04-27T04:29",
                "stopAirport": null,
                "stopDuration": null
            },
            {
                "segmentId": "5bfghsbhjungbgdd",
                "duration": 154,
                "carrier": "LH",
                "flightNo": "756",
                "codeShare": false,
                "operatingCarrier": null,
                "operatingFlightNo": null,
                "aircraftCode": "333",
                "depAirport": "HKG",
                "depTerminal": null,
                "depTime": "2023-04-28T08:40",
                "arrAirport": "SIN",
                "arrTerminal": null,
                "arrTime": "2023-04-28T11:14",
                "stopAirport": null,
                "stopDuration": null
            }
        ],
        "newInfo": [
            {
                "segmentIds": "1ujhujhuijhuiknb",
                "segmentStatus": "change",
                "segments": [
                    {
                        "segmentId": "5ujhujhuijhuiknb",
                        "duration": 140,
                        "carrier": "LH",
                        "flightNo": "2048",
                        "codeShare": false,
                        "operatingCarrier": null,
                        "operatingFlightNo": null,
                        "aircraftCode": "333",
                        "depAirport": "SHA",
                        "depTerminal": null,
                        "depTime": "2023-04-25T07:35",
                        "arrAirport": "WHU",
                        "arrTerminal": null,
                        "arrTime": "2023-04-25T09:55",
                        "stopAirport": null,
                        "stopDuration": null
                    },
                    {
                        "segmentId": "6poiujhjklmnjk8o",
                        "duration": 127,
                        "carrier": "LH",
                        "flightNo": "8725",
                        "codeShare": false,
                        "operatingCarrier": null,
                        "operatingFlightNo": null,
                        "aircraftCode": "333",
                        "depAirport": "WHU",
                        "depTerminal": null,
                        "depTime": "2023-04-25T10:50",
                        "arrAirport": "HKG",
                        "arrTerminal": null,
                        "arrTime": "2023-04-25T12:57",
                        "stopAirport": null,
                        "stopDuration": null
                    }
                ]
            },
            {
                "segmentIds": "2poiujhjklmnjk8o^3yuiokjhnmlppupo",
                "segmentStatus": "change",
                "segments": [
                    {
                        "segmentId": "7hghdch7hfj4hovf",
                        "duration": 247,
                        "carrier": "LH",
                        "flightNo": "8725",
                        "codeShare": false,
                        "operatingCarrier": null,
                        "operatingFlightNo": null,
                        "aircraftCode": "333",
                        "depAirport": "HKG",
                        "depTerminal": null,
                        "depTime": "2023-04-28T06:50",
                        "arrAirport": "SHA",
                        "arrTerminal": null,
                        "arrTime": "2023-04-28T10:57",
                        "stopAirport": null,
                        "stopDuration": null
                    }
                ]
            },
            {
                "segmentIds": "4thgjlkjhyupoikj",
                "changeType": "cancel",
                "segments": [
                    {
                        "segmentId": "4thgjlkjhyupoikj",
                        "duration": 249,
                        "carrier": "LH",
                        "flightNo": "7504",
                        "codeShare": false,
                        "operatingCarrier": null,
                        "operatingFlightNo": null,
                        "aircraftCode": "333",
                        "depAirport": "XSP",
                        "depTerminal": null,
                        "depTime": "2023-04-27T00:20",
                        "arrAirport": "HKG",
                        "arrTerminal": null,
                        "arrTime": "2023-04-27T04:29",
                        "stopAirport": null,
                        "stopDuration": null
                    }
                ]
            },
            {
                "segmentIds": "5bfghsbhjungbgdd",
                "segmentStatus": "recover",
                "segments": [
                    {
                        "segmentId": "5bfghsbhjungbgdd",
                        "duration": 154,
                        "carrier": "LH",
                        "flightNo": "756",
                        "codeShare": false,
                        "operatingCarrier": null,
                        "operatingFlightNo": null,
                        "aircraftCode": "333",
                        "depAirport": "HKG",
                        "depTerminal": null,
                        "depTime": "2023-04-28T08:40",
                        "arrAirport": "SIN",
                        "arrTerminal": null,
                        "arrTime": "2023-04-28T11:14",
                        "stopAirport": null,
                        "stopDuration": null
                    }
                ]
            }
        ]
    }
}

4.3 orderStatus

{
    "authentication": {
        "sign": "",
        "timestamp": ""
    },
    "traceId": "",
    "type": "orderStatus",
    "orderNo": "",
    "partnerOrderNo": "",
    "orderStatus": 12
}

4.4 改期核价完成

{
    "authentication": {
        "sign": "",
        "timeStamp": ""
    },
    "traceId": "",
    "type": "change/refund/void",
    "orderNo": "",
    "partnerOrderNo": "",
    "orderStatus": "",
    "info": {
        "feeInfo": {
            "currency": "",
            "totalAmount": "ADTNUM*ADT(totalFare + totalTax + serviceFee)+CHDNUM* CHD(...)+INFNUM * INF(...)",
            "refundAmount": 111.20,
            "changeFee": [
                {
                    "paxType": "",
                    "totalFare": "票面差+误机费+改期费",
                    "deductFare": [
                        {
                            "faretype": "票面差/误机费/改期费",
                            "fareAmount": 12.30
                        }
                    ],
                    "totalTax": 12.00,
                    "taxBreakdown": [
                        {
                            "taxType": "",
                            "taxAmount": 12.00
                        }
                    ],
                    "serviceFee": 10.00
                }
            ]
        }
    }
}

5 RS

{
    "authentication": {
        "sign": "",
        "timestamp": ""
    },
    "traceId": "",
    "code": "000000",
    "message": "success",
    "processingTime": 160
}

OrderChangeInforming 订单信息变更通知

1 说明#

2 请求参数#

3 响应参数#

4 RQ#

4.1 ticketNo/ticketNoUpdate#

4.2 scheduleChange#

4.3 orderStatus#

4.4 改期核价完成#

5 RS#