OrderCreate v17.2

Functional Description - RLS2021.23

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 pre-purchased excess baggage is required)

  • OrderCreate

Functionality

Use

Examples → Complete Flow (All RQ/RS)

Functionality

Use

Examples → Complete Flow (All RQ/RS)

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.

  • Cash (allows not to specify payer)

  • Credit Card (see 3DS Payment section below if required by the card in the Market)

  • Voucher (see Voucher section below)

  • Voucher and Cash (see Voucher and Cash section below)

OrderChange must be used to pay for any Order created with a PaymentTimeLimit.

OrderCreate - Cash - Multicity - 1 ADT

OrderCreate - Cash - RT - 1 ADT - Corporates

OrderCreate - Cash - RT - 1 ADT - Escalas

OrderCreate - CC - AMEX - RT - 1 ADT

3DS Payment

When 3-Domain Secure payment is required by the Credit Card and Market

OrderCreate - 3DS v1 - RT - Pseudo IATA - ES - No Ancillaries - Resident & LF (Service Fee)

OrderCreate - 3DS v2 - RT - Pseudo IATA - ES - No Ancillaries - VI

Vouchers Payment

To pay the complete cost of an Order (with or without Ancillaries) with an Iberia Voucher.

OrderCreate - RT - 1 ADT 1 CHD 1 INF - FOP Voucher - Porcentual

 

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.

OrderCreate - RT - 1 ADT 1 CHD - Voucher & Cash - Fixed Voucher

OrderCreate - RT - 1 ADT 1 INF - Voucher & Cash - ES Market - USD Voucher

Private Fare

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) 

OrderCreate - Cash - RT - 1 ADT - Private Fare

OrderCreate - Cash - RT - 1 ADT - Corporates - Private Fare

Resident Discount

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:

  • RC (Residente Canarias)

  • BP (Residente Baleares)

  • RM (Residente Melilla)

  • RE (Residente Ceuta)

  • BI (Para en interior de Baleares)

  • DC (Para el interior de Canarias)

There are some restrictions in Resident Discount

  • Resident Discounts can ONLY be sold in Spain.

  • Only one Resident Discount type can be sold in an Order.

  • The origin or destination of the journey must include a city where the resident discount applies.

  • The passenger document must be a Spanish DNI or NIE, and is mandatory for passengers over 14 years.

  • The “Certificado de Residencia” number must be included.

  • The municipality code of the place of residence must be included.

Large Family

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:

  • F1 (General Discount - 3 children)

  • F2 (Special Discount - More than 3 children)

There are some restrictions in Large Family Discount:

  • Large Family Discount can ONLY be sold in Spain.

  • Only one Large Family Discount type can be sold in an Order.

  • The passenger document must be a Spanish DNI or NIE, and is mandatory for passengers over 14 years.

  • The “Certificado de Familia Numerosa” number must be included.

  • The “Comunidad Autonoma” code of the place of residence must be included.

Seats And Bags

Seats can be booked at the same time as the flights.

Up to 9 additional bags, per adult or child, can be purchased at the same time as the flights.

Both seats and bags can also be added as part of the servicing flow.

Special Needs

The ability to request special services is implemented for:

  • BLND (Blind Passenger)

  • DEAF (Deaf Passenger)

  • WCHR (Wheelchair for ramp)

  • WCHS (Wheelchair for steps)

  • DPNA (Disabled Passenger)

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:

  • Several passengers with / without country code.

  • Several passengers with emergency contact with / without country code.

  • Agency contact with / without country code.

  • Payer data with / without country code.

Frequent Flyer

Include an Iberia Frequent Flyer number in the booking for each passenger (excluding infants).

If the FF information is not valid, we will show an error message in OrderViewRS and the booking will not be created.

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.

RUC (Fiscal ID)

The possibility to include Fiscal ID associated to passengers.

  • FiscalID is mandatory for all passengers, except infants for markets Peru and Ecuador

  • Other Foid (such as DNI, Passport or Other Documentation available) are optional for markets Peru and Ecuador

  • Differents passengers can use same FiscalID/CompanyName

  • There will not be any FiscalID/CompanyName format validations

  • There will not be any FiscalID type send validations

  • Available to include FiscalID/CompanyName for other markets differents from Peru and Ecuador

  • If more than one FiscalID/CompanyName is send for same passenger, only the first one will be included

  • CompanyName is optional

The format must be:

  1. DocumentType/DocumentNumber/CompanyRUC

  2. DocumentType/DocumentNumber