Content Comparison

Versions Compared

Version	Old Version 9	New Version Current
Changes made by	Alvaro Chaparro	Alvaro Chaparro
Saved on	Jun 20, 2024	Feb 20, 2025

Key

This line was added.
This line was removed.
Formatting was changed.

...

Excerpt

name	Query_Common

Query - Common

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES	NDC SERVICES
<Query> (Common)
OrderID	Order ID previously generated	Alphanumeric	AnyIATA Schema

OrderChangeRQ Query Common example

...

Excerpt

name	Query_AcceptRepricedOrder

Query - AcceptRepricedOrder (BETA ONLY for now)

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES
<Query / AcceptRepricedOrder>
ResponseID	The ID of the response from which the new offer is being accepted and applied to the Order on hold	Alphanumeric	Any

...

Excerpt

name	Query_PassengerServicing

Query - PassengerServicing

Previous

NAME

DESCRIPTION

FORMAT

ALLOWED/POSSIBLE VALUES

NDC SERVICES

<Query / PassengerServicing> (Update contact info flows, name, e-mail, phone, frequent flyer info…)

New

Info

Attribute

PassengerID

The unique identifier of the Passenger whose information is being updated.

Alphanumeric

The PassengerID obtained from the previous OrderViewRS having previously retrieved the Order.

IATA Schema if 'PassengerServicing / New' tag is indicated.

New / ContactInfoRef

Contact info reference, which contact info (email & phone) filled in below will update original contact info.

Alphanumeric

Any

Iberia NDC in case of:

Contact info (email & phone) correction flow

New / Individual / Given

Name of the passenger to change

Alphanumeric

Any

Iberia NDC in case of:

Name correction flow

New / Individual /New / Individual / Surname

Surname of the passenger to change

(Agency can specify separated by a special character "@" first and second surname → Ex: De la Morena@López)

Alphanumeric

Any

IATA Schema if 'New / Individual' tag is indicated

New / LoyaltyProgramAccount / Airline / AirlineDesignator

Airline ID associated to frequent flyer number

Alphanumeric

Any

Iberia NDC in case of:

Add/Update Frequent Flyer Number

New / LoyaltyProgramAccount / AccountNumber

Frequent Flyer or On Business number account

Alphanumeric

Any

Iberia NDC in case of:

Add/Update Frequent Flyer Number
Add/Update On Business Number

New / ActionType

Action type

Alphabetical

Add
Remove

Iberia NDC in case of:

New / ActionType

Action type

Name correction flow
Contact info (email & phone) correction flow
Add/Update Frequent Flyer Number
Add/Update On Business Number

New / IdentityDocument / IdentityDocumentNumber

Identity document number

Alphanumeric

Any

New / IdentityDocument / IdentityDocumentType

Type of identity document

Alphanumeric

Any

New / IdentityDocument / IssuingCountryCode

Country code for identity document issuing

Alphabetical

List of Countries

New / IdentityDocument / ExpiryDate

Expire date for identity document

Date

Any future date

New / IdentityDocument / Birthplace

Birth place for the identity document holder

Alphabetical

List of Countries

New / IdentityDocument / Visa / VisaNumber

New visa number

Numeric

Any

New / IdentityDocument / Visa / VisaType

New type of visa

Alphabetical

Any

Info

Attribute

PassengerID

Passenger ID, which info will be updated

PassengerID attribute value can be indicated in PassengerID attribute from AirShopping request.

Alphanumeric

Type of Passengers

Value indicated in PassengerID attribute from AirShopping request

IATA Schema if 'PassengerServicing / Previous' tag is indicated.

Previous / Individual / GivenName

Old passenger given name, not mandatory, but if informed and does not match, an error will be shown

Alphanumeric

Any

Previous / Individual / Surname

Old passenger surname, not mandatory, but if informed and does not match, an error will be shown

Alphanumeric

Any

IATA Schema if 'Previous / Individual' tag is indicated

Previous / ContactInfoRef

Old contact info reference

Alphanumeric

Any

Previous / ActionType

Action type

Alphabetical

Add
Remove

PassengerServicing example

...

title	PassengerServicing example

...

language	xml

...

Alphabetical

Add
Remove

Previous

Info

Attribute

PassengerID

Passenger ID, which info will be updated

PassengerID attribute value can be indicated in PassengerID attribute from AirShopping request.

Alphanumeric

Type of Passengers

Value indicated in PassengerID attribute from AirShopping request

Previous / Individual / GivenName

Old passenger given name, not mandatory, but if informed and does not match, an error will be shown

Alphanumeric

Any

Previous / Individual / Surname

Old passenger surname, not mandatory, but if informed and does not match, an error will be shown

Alphanumeric

Any

Previous / ContactInfoRef

Old contact info reference

Alphanumeric

Any

Previous / ActionType

Action type

Alphabetical

Add
Remove

PassengerServicing example

Expand

title	PassengerServicing example

Code Block

language	xml

<Query>
      <OrderID>xxxxxxxxxxxxxxxxxxx</OrderID>
      <PassengerServicing>
         <New PassengerID="ADULT_01">
            <LoyaltyProgramAccount>
               <Airline>
                  <AirlineDesignator>IB</AirlineDesignator>
               <OrderID>xxxxxxxxxxxxxxxxxxx<</OrderID>Airline>
      <PassengerServicing>         <AccountNumber>#########</AccountNumber>
<New PassengerID="ADULT_01">           </LoyaltyProgramAccount>
 <LoyaltyProgramAccount>           <ActionType>Add</ActionType>
    <Airline>                   <AirlineDesignator>IB</AirlineDesignator></New>
               </Airline>
               <AccountNumber>#########</AccountNumber>
            </LoyaltyProgramAccount>
            <ActionType>Add</ActionType>
         </New>
      </PassengerServicing>
</Query>

...

name	Query_OrderServicing

Query - OrderServicing

...

NAME

...

DESCRIPTION

...

FORMAT

...

ALLOWED/POSSIBLE VALUES

...

NDC SERVICES

...

<Query / OrderServicing> (Add ancillaries, delete paxes, partial refund and voluntary flight change flows…)

AcceptOffer / Offer

Info
Attribute OfferID

Info

Attribute

OfferID

Identification of the service Offer

PassengerServicing>
</Query>

Excerpt

name	Query_OrderServicing

Query - OrderServicing

NAME

DESCRIPTION

FORMAT

ALLOWED/POSSIBLE VALUES

<Query / OrderServicing> (Add ancillaries, delete paxes, partial refund and voluntary flight change flows…)

AcceptOffer / Offer

Info

Attribute

OfferID

Identification of the service Offer

SeatAvailability ResponseID / ServiceList ResponseID / New Offer Identification (Voluntary Change Flow)

Alphanumeric

Any

IATA Schema if 'AcceptOffer' tag is indicated and Iberia NDC in case of:

Add ancillaries flow
Voluntary Change flow
Add ancillaries flow
Voluntary Change flow
Delete Passengers flow
Partial Refund flow

Alphanumeric

Any

AcceptOffer / Offer

Info

Attribute

Owner

Airline identification

Alphabetical

IATA Schema if 'AcceptOffer' tag is indicated and Iberia NDC in case of:

Add ancillaries flow
Voluntary Change flow
Delete Passengers flow
Partial Refund flow

Alphabetical

AcceptOffer / Offer

Info

Attribute

ResponseID

Response Identification

Alphanumeric

Any

IATA Schema if 'AcceptOffer' tag is indicated and Iberia NDC in case of:

Add ancillaries Add ancillaries flow
Voluntary Change flow
Delete Passengers flow
Partial Refund flow

Alphanumeric

Any

AcceptOffer / Offer / OfferItem

Info

Attribute

OfferItemID

Offer item identification of the new service to add

Alphanumeric

Any

IATA Schema if 'Offer' tag is indicated and Iberia NDC in case of:

Add ancillaries flow
Voluntary Change flow
Delete Passengers flow
Partial Refund flow

Alphanumeric

Any

AcceptOffer / Offer / OfferItem / PassengerRefs

Reference for the passengers

Alphanumeric

Type of Passengers

IATA Schema if 'Offer' tag is indicated and Iberia NDC in case of:

Add ancillaries flow
Voluntary Add ancillaries flow
Voluntary Change flow
Delete Passengers flow
Partial Refund flow

Alphanumeric

Type of Passengers

AcceptOffer / Offer / OfferItem / SeatSelection / Row

Row for the seat

Add ancillaries flow

Numeric

AnyIATA Schema if 'SeatSelection' tag is indicated and Iberia NDC in case of:

Add ancillaries flow

AcceptOffer / Offer / OfferItem / SeatSelection / Column

Column for the seat

Add ancillaries flow

Alphabetical

Any

IATA Schema if 'SeatSelection' tag is indicated and Iberia NDC in case of:

Add ancillaries flow

Delete / OrderItemID

OrderItem identification to be deleted

Alphanumeric

Any

IATA Schema if 'Delete' tag is indicated

OrderServicing example

When cancelling flights with Ancillaries or other associated services it is only necessary to include the OrderItemIDs of the flights, as all associated services will automatically be cancelled with the flights.

Alphanumeric

Any

OrderServicing example

Expand

title	OrderServicing example

Code Block

language	xml

<OrderServicing>
	<AcceptOffer>
		<Offer OfferID="IB1ce71d2c930a46afbca517f2feb15730OP" Owner="IB" ResponseID="Qm9va2luZ0AxNjk3NzE4ODAyNjA0LXlpdWlx">
			<OfferItem OfferItemID="IB1ce71d2c930a46afbca517f2feb15730OP_01">
				<PassengerRefs>ADULT_01</PassengerRefs>
			</OfferItem>
		</Offer>
	</AcceptOffer>
	<Delete>
		<OrderItemID>IB79563e1e6cd94495a58513924d3cd894OC_01</OrderItemID>
	</Delete>
</OrderServicing>

...

Method / Voucher

IATA Schema if 'Payment' tag is indicated and Iberia NDC

Amount

Excerpt

name	Query_Payments

Query - Payments

IATA Schema if 'Payment' tag is indicated

Method / PaymentCard

NAME

DESCRIPTION

FORMAT

ALLOWED/POSSIBLE VALUES

NDC SERVICES

<Query / Payments / Payment> (Add ancillaries and voluntary flight change flows…)

Type

Payment Methods can vary depending on market and type of seller.

Please check here.

Alphabetical

CA (Cash)
CC (Credit Card)
MS (Voucher)

SF (Service Fee)

-- This refers to Cash payment method --

Method / Cash

Info

Attribute

CashInd

Cash payment method.

Alphabetical

Info

Attribute

refs

This is used to reference the associated 3DS info in PaymentCardSecureInfo ObjectKey, and/or the installment payment info in PaymentFormMetadata MetadataKey.

If both 3DS and installment payments are being used for the same Order, then the two references are included here together separated by a space.

Example:

Code Block
<PaymentCard refs="KEY_3DS KEY_QUOTAS">

Alphanumeric

Any

true

IATA Schema if 'Payment' tag is indicated and Iberia NDC

-- This refers to Credit Card method – If Secure Payment applies additional info needed is defined below in 3DS INFO --

NDC

Amount

Info

Attribute

Code

Total amount of the offer.

Code refers to currency code for payment.

Numeric

Any

Payer / ContactInfoRefs

Reference for the payer info, that must be associated correctly in the XML below.

In Cash Payment Method is OPTIONAL

Alphanumeric

Any valid reference associated in the XML below.

-- This refers to Credit Card method – If Secure Payment applies additional info needed is defined below in 3DS INFO --

Method / PaymentCard

Info

Attribute

refs

NDC Mandatory for 3DS and/or intallments installments payment.

Method / PaymentCard / CardType

Type of credit card

Alphanumeric

1-6 characters

Iberia NDCThis is used to reference the associated 3DS info in PaymentCardSecureInfo ObjectKey, and/or the installment payment info in PaymentFormMetadata MetadataKey.

If both 3DS and installment payments are being used for the same Order, then the two references are included here together separated by a space.

Example:

Code Block

language	xml

<PaymentCard refs="KEY_3DS KEY_QUOTAS">

Alphanumeric

Any

Method / PaymentCard / CardNumberCardType

Number Type of credit card

NumericAlphanumeric

1-19 6 charactersIberia NDC

Method / PaymentCard / SeriesCode

Series Code of credit card

Numeric

1-8 characters

Iberia NDC

Method / PaymentCard / CardHolderName

Card Holder Name

Alphanumeric

0-50 characters

Method / PaymentCard / CardHolderBillingAddress / Street

Street of the billing address of the cardholder.

NDC Mandatory that at least one field has to be filled in inside "CardHolderBillingAddress" tag.

Alphanumeric

If tag is indicated once, only first 40 characters will be considered

If tag is indicated twice, only first 80 characters will be considered

Iberia NDC that at least one field has to be filled in inside "CardHolderBillingAddress" tag.

Method / PaymentCard / CardHolderBillingAddress / CityName

City of the Billing Address of cardholder

Alphanumeric

Only first 50 characters will be considered

Iberia NDC Mandatory that at least one field has to be filled in inside "CardHolderBillingAddress" tag.Method / PaymentCard /

Alphanumeric

Only first 50 characters will be considered

Method / PaymentCard / CardHolderBillingAddress / StateProv

State Prov. of the Billing Address of cardholder

NDC Mandatory that at least one field has to be filled in inside "CardHolderBillingAddress" tag.

Alphanumeric

1-40 charactersIberia NDC

Method / PaymentCard / CardHolderBillingAddress / PostalCode

Postal Code of the Billing Address of cardholder

NDC Mandatory that at least one field has to be filled in inside "CardHolderBillingAddress" tag.

Method / PaymentCard / CardHolderBillingAddress / PostalCode

Postal Code of the Billing Address of cardholder

Alphanumeric

2-10 characters

Iberia NDC that at least one field has to be filled in inside "CardHolderBillingAddress" tag.

Method / PaymentCard / CardHolderBillingAddress / CountryCode

Country Code of the Billing Address of cardholder

Alphabetical

2 characters

Iberia NDC that at least one field has to be filled in inside "CardHolderBillingAddress" tag.

Method / PaymentCard / EffectiveExpireDate / Expiration

Effective expiration date of the credit card

Numeric

4 characters

Iberia NDC

-- This refers to Voucher payment method --

Voucher payment method.

Alphabetic

true

Method / Voucher / Number

Number of voucher

Alphanumeric

any

Iberia NDC

Info
Attribute Code

Info

Attribute

Code

Total amount of the offer.

Code refers to currency code for payment.

Numeric

Any

IATA Schema

Payer / ContactInfoRefs

Reference for the payer info, that must be associated correctly in the XML below.

Alphanumeric

Any valid reference associated in the XML below.

Iberia NDC

In Cash Payment Method is OPTIONAL

Payments example

...

Alphanumeric

2-10 characters

Method / PaymentCard / CardHolderBillingAddress / CountryCode

Country Code of the Billing Address of cardholder

NDC Mandatory that at least one field has to be filled in inside "CardHolderBillingAddress" tag.

Alphabetical

2 characters

Method / PaymentCard / CardNumber

Number of credit card

Numeric

1-9 characters

Method / PaymentCard / EffectiveExpireDate / Expiration

Effective expiration date of the credit card

Numeric

4 characters

Amount

Info

Attribute

Code

Total amount of the offer.

Code refers to currency code for payment.

Numeric

Any

Payer / ContactInfoRefs

Reference for the payer info, that must be associated correctly in the XML below.

Alphanumeric

Any valid reference associated in the XML below.

-- This refers to Voucher payment method --

Method / Voucher

Voucher payment method.

Alphabetical

true

Method / Voucher / Number

Number of the voucher

Alphanumeric

any

Amount

Info

Attribute

Code

Total amount of the offer.

Code refers to currency code for payment.

Numeric

Any

Payer / ContactInfoRefs

Reference for the payer info, that must be associated correctly in the XML below.

Alphanumeric

Any valid reference associated in the XML below.

-- This refers to Service Fee method --

Method / Other / Remarks

Info

Attribute

refs

References for all passengers of the order

Alphanumeric

any

Method / Other / Remarks / Remark

Service Fee payment method

Mandatory for schema if "Remarks" tag is indicated

Alphabetical

ServiceFee

Amount

Info

Attribute

Code

Total amount of the Service Fee

Code refers to currency code for payment.

Numeric

Any

OrderChangeRQ Query Payments examples

Expand

title	Query Cash Payment example

Code Block

language	xml

<Payments>
    <Payment>
      <Type>CA</Type>
      <Method>
          <Cash CashInd="true"/>
      </Method>
      <Amount Code="EUR">10.00</Amount>
      <Payer>
          <ContactInfoRefs>Payer</ContactInfoRefs>
      </Payer>
    </Payment>
</Payments>

Expand

title	Query Credit Card Payment example

Code Block

language	xml

<Payments>
    <Payment>
      <Type>CC</Type>
      <Method>
          <PaymentCard refs="KEY_QUOTAS">
            <CardType>VI</CardType>
            <SeriesCode>XXX</SeriesCode>
            <CardHolderName>JANE SMITH</CardHolderName>
            <CardHolderBillingAddress>
                <Street>125 PRESTON RD BRIGH</Street>
                <CityName>MA</CityName>
                <StateProv>BN</StateProv>
                <PostalCode>BN12LP</PostalCode>
                <CountryCode>PE</CountryCode>
            </CardHolderBillingAddress>
            <CardNumber>44XXXXXXXXXXXX04</CardNumber>
            <EffectiveExpireDate>
                <Expiration>MMYY</Expiration>
            </EffectiveExpireDate>
          </PaymentCard>
      </Method>
      <Amount Code="USD">119.80</Amount>
      <Payer>
          <ContactInfoRefs>Payer</ContactInfoRefs>
      </Payer>
    </Payment>
</Payments>

Expand

title	Query Voucher Payment example

Code Block

language	xml

<Payments>
	<Payment>
		<Type>MS</Type>
		<Method>
			<Voucher>
				<Number>BONO100EUR</Number>
			</Voucher>
		</Method>
		<Amount Code="EUR">339.67</Amount>
		<Payer>
			<ContactInfoRefs>Payer</ContactInfoRefs>
		</Payer>
	</Payment>
</Payments>

Expand

title	Query Service Fee Payment example

Code Block

language	xml

<Payments>
	<Payment>
		<Type>CC<  <Payment>
      <Type>SF</Type>
		<Method>
			<PaymentCard      <Method>
        <Other>
            <Remarks refs="MISCUOTASADULT_01">
   				<CardType>VI</CardType>
				<CardNumber>##########</CardNumber>
				<SeriesCode>382</SeriesCode>
				<CardHolderName>Dinel Garcia Garcia</CardHolderName>
				<CardHolderBillingAddress>
					<Street>#####</Street>
					<CityName>MA</CityName>
					<StateProv>28</StateProv>
					<PostalCode>#####</PostalCode>
					<CountryCode>ES</CountryCode>
				</CardHolderBillingAddress>
				<EffectiveExpireDate>
					<Expiration>####</Expiration>
				</EffectiveExpireDate>
			</PaymentCard>
		</Method>
		           <Remark>ServiceFee</Remark>
            </Remarks>
        </Other>
      </Method>
      <Amount Code="EUR">194>11.74<00</Amount>
		<Payer>
			<ContactInfoRefs>Payer</ContactInfoRefs> 		</Payer> 	</Payment>
</Payments>