OrderCreate 17.2

 

Functional Description

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

Functionality

Use

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.

  • 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.

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.

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) 

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 el 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 Autónoma” code of the place of residence must be included.

Ancillaries

Seats, Bags, sport equipment and Priority Boarding can be booked at the same time as the flights.

Seats and bags also can be booked and held without payment together with the unpaid flights. An Order on hold must be paid for in full (all OrderItems) using the OrderChange - Payment.

For further and updated information, please visit our Ancillaries page.

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

If product Sport is selected in shopping, one sport equipment can be selected for each passenger and slice:

  • BIKE

  • SKII

  • GOLF

  • SURF

  • SCUB

  • FISH

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 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.

  • Two different passengers can only introduce the same document identification if market is different from ES.

  • Mandatory for adults 14 years and older if using Spanish Resident Discount.

  • Mandatory for flights departing from certain markets (POC), for example Peru (PE) and Ecuador (EC).

Fiscal ID

To include any Fiscal Identification required by the authorities of a country.

  • For sales in certain markets the Fiscal Identity is mandatory for all passengers, except infants. As of today (August 2024) the following markets are mandatory: Peru, Ecuador, Argentina and Guatemala.

  • There are no validations of the data sent.

  • If more than one FiscalID is sent for same passenger, only the first one will be included.

  • The Company Name is optional, and should only be used if the Fiscal ID belongs to the company.

Refuse contact

The ability to refuse to provide passenger contact information only applies to IATA agencies --> The passenger contact must include tag <ContactNotProvided/>

  • The agency's contact details (if any) are assigned to passengers who refuse.

  • If no passenger provides their contact details and not all refuse --> Error "You must indicate if the passengers have refused to provide their contact details"

  • If any passenger provides contact details --> It's optional to refuse

  • If all passengers refuse and no Agency Contact is provided --> Error

  • Refuse Tag for Non IATA Agencies --> Warning and no assignment is done

 

New NDC Footer.png