Order change notification
How to recieve API notifications for involuntary order changes
Tip
First read API concepts.Where supported by the supplier PaxFaB Servicing can send you an API message notifying you of involuntary changes to an order. E.g a segment being rescheduled.
To recieve these messages you must:
- Develop a subscriber service that implements the order change notification API described in the reference docs.
- Deploy with a URL that serves this API and secure it with basic authentication and TLS. Then provide the URL and credentials to us via a support ticket.
Tip
Please provide a second separate URL (or path) if you also wish to recieve messages about test system orders. Note that support for this varies by airline.Example message you could recieve:
{
"sender": { "carrier": { "code": "BA", "name": "British Airways" } },
"recipient": {
"agent": { "agencyId": "Test", "iataNumber": "00000000", "officeId": null }
},
"forwardTimestamp": "2023-09-28T14:27:58.349238327Z",
"bookingReferences": [
{
"bookingReference": "ABCDE",
"type": "ORDER_ID"
},
{
"bookingReference": "ABCDE",
"carrier": {
"code": "BA"
},
"type": "AIRLINE"
}
],
"changeGroups": [
{
"changes": [
{
"type": "DELETE",
"entity": "SEGMENT"
},
{
"type": "DELETE",
"entity": "SEGMENT"
},
{
"type": "DELETE",
"entity": "SEGMENT"
}
]
}
]
}
- Indicates that 3 segments have been deleted from British Airways order ABCDE.
- You would reply with HTTP status 202.
- You should then retrieve the order to find out more.