Introduction

The OrderChange-Confirm Change Booking Webservice provides IATA Accredited Travel Agents etc, new retailers and Service Providers the ability to pay for changing/upgrading the confirmed flights present in the booking as per IATA NDC schema standards.

The service accepts payment (card or cash aka BSP settlement) and reissues eTickets
 

OrderChange - Confirm Change Booking Webservice

This service is used to pay for changing/upgrading the confirmed flights in booking. The service accepts the payment and reissue eTickets for all passengers in the booking. Once the eTickets are successfully re-issued the service returns eTicket details in the response.

Interface Design

This web service is called with the following inputs:

1. OrderID (Booking reference or PNR reference)
2. ResponseID/OfferID/OfferItemID returned in the preceding OrderReshopRS(Reprice)
3. OrderItemID that is going to change.
4. Passenger details
5. Payment details (Card or Cash)
6. Payer details

The output data this service returns include:

1. Booking reference (PNR)
2. Passenger details
   • Passenger Type Code (PTC)
   • First name
   • Last name
   • Middle name
   • Title
   • Date of birth, if it is present in the booking
   • FQTV details, if it is present in the booking
   • On Business details, if present in the booking
   • Gender, if it is present in the booking 
   • Immigration details 
   • Contact detail
     • Phone contact along with country code/ area code 
     • Address contact including country code
3. Total Order Price – This is the sum of fare and tax for all passengers in the booking along with seat price for all passengers in the booking.
4. Return tax breakdown along with nature code and description.
5. Return OrderItem per passenger with base, tax & service details.
6. Flight segment details.
7. Flight list along with associated flight segment references.
8. Origin and destination list.
9. Reissued eTicket details per passenger.
10. Associated or Disassociated EMD details per passenger.
11. Manage my booking link
12. Payment information with masked payment card details.
13. Payer’s contact details, if payer is not a passenger.
14. Error message along with the list of applicable payment cards if
    • If the requested card is not applicable to the customer’s billing country and agent location
    • If the requested card surcharge does match

Split PNR / Divide a Booking

Change Held Booking

 

 

Http Headers

Client-key: Your 24-bit API connection key
SOAPAction: OrderChange17_2_V3

 

Endpoints

LIVE	PRE-LIVE	BETA
https://api.ba.com/selling-distribution/OrderChange/17.2/V3	https://test.api.ba.com/selling-distribution/OrderChange/17.2/V3	https://test.api.ba.com/selling-distribution/sandbox/OrderChange/17.2/V3

 

If OrderChangeRQ is invoked within OfferExpiration timelimit (returned in OrderReshopRS(Reprice)), the service will get the offer details from offer storage and do further processing.

 

If OrderChangeRQ is invoked after OfferExpiration timelimit, the system will return an error as the offer will be deleted from the system and agent has to again start from the OrderReshop(Reshop)
 

Checks if the total amount payable passed in OrderChangeRQ matches with the total offer price returned in the OrderReshopRS (Reprice)

The service checks if the total amount payable passed in OrderChangeRQ matches with the total offer price for the offer returned in the OrderReshopRS (Reprice). It returns an error if the amount does not match.

Within Price Guarantee Time Limit...

The service checks if the offer price (base or tax) has changed from the one returned in OrderReshopRS (Reprice), it will Honour the price returned in Reprice if the OrderChange request is made within the Price Guarantee Time limit (returned in Reprice response).

If the price has changed and Price Guarantee Time limit is expired, service will return an error and agent has to again start from the Reshop.

If there is no change in the offer price, the service will not check the Price Guarantee Time limit, it will proceed with the change booking process.

The service works out the commission that is applicable to the agent irrespective of whether the commission value is passed in the request or not.

Re-Issues ETickets for all the flights, once payment is authorised and the total amount payable matches with the offer price returned in Reprice for all passengers.

The service re-issues ETickets for all the flights once payment is authorised and the total amount payable matches with the offer price returned in Reprice for all passengers

The service accepts either Card or Cash (BSP settlement) form of payment

The service returns ETicket details once the documents are successfully re-issued.

Returns all the non-refunded EMD (Associated or Disassociated) details once the tickets are successfully re-issued.

The service returns prices in exact decimal value based on the currency (e.g. GBP will be returned at 2 decimals, while JPY will be returned at integer level only).

The service returns responses in the agent’s preferred language. If the agent’s preferred language is not supported by BA or the agent’s preferred language is not passed in the request then the default language will be used, which is English. Please see section 7 for the languages that are supported by BA.