Functional Description - RLS2023.09
The OrderCreate service generates a booking for the supplied itinerary and passenger details, returning an OrderID.
Subject to the conditions of the Offer a Payment Time Limit may have been offered in the OfferPriceRS, if not then payment must be included to create the Order.
The payment methods available depend on the market/currency and type of Seller.
Today an order can be generated with up to 16 flight segments, which corresponds to 4 tickets issued in conjunction with one another.
Sellers are able to control to whom emails are sent and what information is included in the email. See here for more information.
Although the Order Create service is stateless it is assumed that in most cases it will be called as part of a specific sequence such as:
AirShopping
OfferPrice (Direct or through a previous Air Shopping)
SeatAvailability (if Seat selection is required)
ServiceList (if other Ancillaries are required)
OrderCreate
Examples of messages with complete flows can be downloaded from here.
Functionality | Use |
---|---|
Basic | Create a reservation with a variety of itinerary types (One Way, Round Trip, Open-Jaw, Multi City) for up to 9 passengers occupying seats, including children, and with up to one infant in the lap of each adult. Payment must be included unless the Offer included a PaymentTimeLimit, by which time the Order will be cancelled if not paid for. The following payment methods can be used depending of type of Seller (IATA or Non IATA) and the Market.
OrderChange must be used to pay for any Order created with a PaymentTimeLimit. |
3DS Payment | When 3-Domain Secure payment is required by the Credit Card and Market |
Installment Payment | To pay for an order by installments where allowed |
Vouchers Payment | To pay the complete cost of an Order (with or without Ancillaries) with an Iberia Voucher. |
Voucher and Cash Payment | To pay the cost of an Order (with or without Ancillaries) with an Iberia Voucher and Cash. If the value of the Voucher is zero then an error will be returned. If the value of the Voucher is greater than zero then the difference will be changed in Cash, and the amount charged against each FOP will be returned in the OrderViewRS. Cash payment method allows not to specify payer. |
To create orders using Private Fares, the request must provide a fare preference type with the 758 code (private fares) and the suitable product code to be applied, or a fare preference type with the 70M code (corporate private fares) | |
Unique to the Spanish market, you are able to create orders with Resident Discount, also combinable with the Large Family Discount. It is implemented for Canary Islands, Balearic Islands and Melilla and only with POINT OF SALE SPAIN. To obtain the discount, the flight has to have an Origin/Destination airport included in this modality. The types of residents are:
There are some restrictions in Resident Discount
| |
Also unique to the Spanish market, you are able to create orders with Large Family Discount, combinable with the Resident Discount. Only applicable to Spanish domestic flights and with POINT OF SALE SPAIN. The types of residents are:
There are some restrictions in Large Family Discount:
| |
Ancillaries | Seats, Bags and Priority Boarding can be booked at the same time as the flights. For further and updated information, please visit our Ancillaries page. Both seats and bags can also be added as part of the servicing flow. |
The ability to request special services is implemented for:
| |
Phone Contact | It will give you the possibility to accept telephone numbers of less than 9 characters with the country code separately. It is implemented to:
|
Frequent Flyer | Include a Frequent Flyer and/or an OnBussiness number in the booking for each passenger (excluding infants). If the Iberia Plus fails validation the booking will be created, however we will show a warning message in the OrderViewRS. No validation is done for OnBussiness. |
Remarks - External Reference | It will give the possibility to include an External Reference in the system for future correlation. This reference will be saved in database and showed in OrderViewRS from OrderCreate and OrderRetrieve services. The max length for this reference is 30 characters. If the limit is exceeded, the reference will be saved only with 30 characters. If this reference is not saved in database, OrderViewRS from OrderCreate will show an Warning message with the following text: "The Reserve Reference has not been registered in NDC". This message will be not appears in OrderViewRS from OrderRetrieve and OrderChange services. |
Form of Identification (FOID) | Used to define the Form of ID of passenger check-in identification.
|
Fiscal ID | To include any Fiscal Identification required by the authorities of a country.
|