OrderCreate Overview




 OrderCreate

VersionReason for ChangeRelease StatusPre-Live DateLive Date
0.8Book with Confidence - Return voucher validity and remark
0.7Book with Confidence - E-voucher as a form of payment. (See Release Notes 14-07-20 and 21-07-20)  
0.6Cabin Name Change (See Release Note) This will be released as a soft release. We will notify you about our Sandbox testing environment for this feature. Relative updates in PriceListClass, DisclosureList, FlightSegmentList and SeatAvailabilityRS
0.5CardHolder Name Validation See Release Note  
0.4Prime Sale Baggage Purchase.  
0.3Booking can be created with or without the title for payer for card payment.  
0.2Short Sell  
0.1Long Sell  

 Introduction

The OrderCreate Webservice provides IATA Accredited Travel Agents, new retailers, and Service Providers the ability to book for flights and seats as per IATA NDC schema standards.

OrderCreate service can be invoked in 2 contexts:

Context 1 – Instant purchase:  The ability for clients to pay and confirm in the same transaction. The service accepts payment (card or cash aka BSP settlement or e-voucher (See )), creates a booking and issues etickets. The service can also be used to purchase seats or bags (See  below), along with flights and issues EMD once the seat or bag (See  below) purchase is successful. Both booking and document (ETicket and EMD) details are returned in the OrderViewRS along with the booking reference (PNR)

Context 2 – Hold booking:  The ability for clients to create a booking without making a payment. The service checks if the client is eligible to create a held booking and if eligible it creates a booking. Along with flights clients can also reserve seats (paid or frees seats) without paying for it. The service returns booking details in the OrderViewRS along with the booking reference (PNR). The service also returns Payment Time Limit (Ticket Time Limit). The client must pay for the booking using AirDocIssue Webservice before the time limit expires otherwise booking will automatically be cancelled.


 OrderCreate Webservice

This service creates an Order (PNR) with or without issuing the documents (etickets/EMD) based on the context it is being called.

Interface Design

This web service is called with the following inputs:

  1. Price per pax type, list of flight segments and for each flight segment, the departure airport, arrival airport, carrier code, flight number and booking class (selling class)
  2.  OfferItemIDs, OfferID and ShoppingResponseID are returned in the previous OfferPrice, SeatAvailability and ServiceList response for flights, seats & bags respectively 
  3. Leisure Fare Type
  4. Seat details
  5.  Baggage details or Baggage offers (Short sell)
  6. List of passengers and for each passenger
    • Name details (surname, first name etc) and frequent flyer details (if available)
    • Email address
    • Phone details
    • Address details
  7. Payment details (card, cash or e-voucher )

The output data this service returns include:

  1. Booking reference (PNR)
  2. Offer Expiry Time Limit and Price Guarantee Time Limit
  3. 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
    • Gender, if it is present in the booking
    • Immigration details
    • Contact details
      • Phone contact along with country code/ area code
      • Address contact including country code
      • Email contact
  4.  Total Order Price – This is the sum of fare and tax for all passengers in the booking along with seat/bag price for all passengers in the booking.
  5. Tax breakdown along with nature code and description.
  6. For hold booking price for the itinerary (base fare, tax, and total price) per passenger.
  7. Seat price along with seat details per passenger per flight segment.
  8.  Baggage Allowance per passenger per origin-destination if an additional bag is purchased
  9. Stop locations along with stop quantity.
  10. Flight segment details.
    • Flight list along with associated flight segment references.
    • Passenger Type Code (PTC)
    • Origin and destination list.
    • eTicket details per passenger.
    • E-Voucher residual EMD detail (see )
    • EMD details per passenger.
    • Manage my booking link
    • Seating policy link, if passengers have purchased seats
    • Seating terms and conditions link if passengers have purchased seats
    • Warning message if seat purchase failed i.e create a booking without seats.
    • Payment Time Limit for hold booking.
    • Payment information (for instant purchase) with masked payment card details.
    • Payer’s contact details, if payer is not a passenger.
    • Error message along with the list of applicable payment cards if
    • If the requested card is not applicable for the customer’s billing country and agent location
    • If the requested card surcharge does match

 Mandatory Headers

If you have PRE-LIVE access for 16.1, then you will automatically be able to build to 17.2 using the PRE-LIVE environment.

In order to access our API, you will need to pass the following two headers for each call.

 Web Service URLs

 General Usage Guidelines

The OrderCreate Service

General

Non-IATA agents can also shop and order using BA NDC services (AirShopping, OfferPrice, SeatAvailability, ServiceList and OrderCreate). The following rules are applicable for non-IATA agents