Versions Compared

Key

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

...

Table of Contents
minLevel1
maxLevel7

...

Some services are not accepted by our code-share partners, and therefore may be rejected.

Note: The inclusion of SSRs can only be done in the initial creation of the Order and not added later in a Servicing flow.

...

The code “DISA” can be included in the request, and this will return all the Special Services for disabilities that we offer in the response.

 

ServiceListRQ Message

The applicable SSR Codes, that you can include as and when required, are taken from the table above.

To request an SSR it should be included in the ServiceListRQ message as a Qualifier:

Code Block
languagexml
<Qualifier>
	<SpecialNeedQualifiers>
		<Code>BLND</Code>
	</SpecialNeedQualifiers>
</Qualifier>

Note: Formerly, the only way to request SSRs was through OfferPriceRQ message, which is still possible to maintain backward compatibility. However, we recommend that from now on the ServiceList is used.

It should be noted that if SSRs are requested in both the OfferPriceRQ and the ServiceListRQ, then an error will be returned (please, see an example of this scenario in our Special Services Error Messages page).

 

ServiceListRS Message

ALaCarteOfferItem

The Special Services are returned in the ServiceListRS as ALaCarteOfferItems, for the passengers and flight segments for which they can be requested. This does not mean that the service is necessarily available, and is subject to confirmation at time of booking.

The Special Services can be booked and held in unpaid (On-Hold) Orders to be paid with the flights in the servicing flow.

Code Block
languagexml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
	<soap:Body>
		<ServiceListRS Version="5.000" PrimaryLangID="es" xmlns:ns2="http://www.iberia.com/IATA/NDC/SecurePayment/2017.2" xmlns="http://www.iata.org/IATA/EDIST/2017.2">
			<Document>
				<ReferenceVersion>5.000</ReferenceVersion>
			</Document>
			<Success/>
			<ShoppingResponseID>
				<ResponseID>Qm9va2luZ0BHVy0xNjk1NjUyMTg3MjcwLTRSWERW</ResponseID>
			</ShoppingResponseID>
			<ALaCarteOffer OfferID="ALACARTE_IB48ed39bdf2204eb19f485e1357abe0a3" Owner="IB">
				<OfferExpirationDateTime>2023-09-25T14:59:49.506Z</OfferExpirationDateTime><OfferExpirationDateTime>2024-03-06T14:05:42.327Z</OfferExpirationDateTime>
                <TimeLimits>
                   <Payment DateTime="2024-03-24T22:59:00.000Z"/>
                </TimeLimits>
				<ALaCarteOfferItem OfferItemID="ALACARTE_SSR_IB48ed39bdf2204eb19f485e1357abe0a3_BLND">
					<Eligibility>
						<PassengerRefs>ADULT_01 ADULT_02</PassengerRefs>
						<SegmentRefs>IB042620240108 IB042520240128</SegmentRefs>
					</Eligibility>
					<UnitPriceDetail>
						<TotalAmount>
							<SimpleCurrencyPrice Code="EUR">0.00</SimpleCurrencyPrice>
						</TotalAmount>
						<BaseAmount Code="EUR">0.00</BaseAmount>
						<Taxes>
							<Total Code="EUR">0.00</Total>
						</Taxes>
					</UnitPriceDetail>
					<Service ServiceID="SSR_BLND_d0730723-ab16-405a-8c44-6adbd32a0efc">
						<ServiceDefinitionRef>SPECIAL_NEED-BLND</ServiceDefinitionRef>
					</Service>
				</ALaCarteOfferItem>
			</ALaCarteOffer>

...

MaximumQuantity is the amount services permitted for each passenger per flight.

language
Code Block
xml
<ServiceDefinitionList>
	<ServiceDefinition ServiceDefinitionID="SPECIAL_NEED-BLND">
		<Name>Blind Passenger</Name>
		<Descriptions>
			<Description>
				<Text>Request Service Animal if travelling with one</Text>
			</Description>
		</Descriptions>
		<BookingInstructions>
			<SSRCode>BLND</SSRCode>
			<Method>SSR</Method>
		</BookingInstructions>
		<Detail>
			<ServiceItemQuantityRules>
				<MaximumQuantity>1</MaximumQuantity>
			</ServiceItemQuantityRules>
		</Detail>
	</ServiceDefinition>
</ServiceDefinitionList>

 

OrderCreateRQ Message

The OfferID for each is ALaCarteOfferItem is included in an Offer in the OrderCreateRQ to book the service.

Code Block
languagexml
<Order>
	<Offer OfferID="IB01db6efac4044bd7b6d65113a60b5281OC" Owner="IB" ResponseID="Qm9va2luZ0BHVy0xNjk1NjUyMTg3MjcwLTRSWERW">
		<OfferItem OfferItemID="IB01db6efac4044bd7b6d65113a60b5281OC_01">
			<PassengerRefs>ADULT_01 ADULT_02</PassengerRefs>
		</OfferItem>
		<OfferItem OfferItemID="IB01db6efac4044bd7b6d65113a60b5281OC_02">
			<PassengerRefs>INFANT_01</PassengerRefs>
		</OfferItem>
	</Offer>
	<Offer OfferID="ALACARTE_IB48ed39bdf2204eb19f485e1357abe0a3" Owner="IB" ResponseID="Qm9va2luZ0BHVy0xNjk1NjUyMTg3MjcwLTRSWERW">
		<OfferItem OfferItemID="ALACARTE_SSR_IB48ed39bdf2204eb19f485e1357abe0a3_BLND">
			<PassengerRefs>ADULT_01 ADULT_02</PassengerRefs>
			<ServiceSelection ServiceID="SSR_BLND_d0730723-ab16-405a-8c44-6adbd32a0efc">
				<ServiceDefinitionID>SPECIAL_NEED-BLND</ServiceDefinitionID>
			</ServiceSelection>
		</OfferItem>
	</Offer>
</Order>

...

The following is an example of the type of additional information that can be communicated to us:

xml
Code Block
language
<ServiceDefinitionList>
	<ServiceDefinition ServiceDefinitionID="SPECIAL_NEED-BLND">
		<Name>Blind Passenger</Name>
		<Descriptions>
			<Description refs="ADULT_01 ADULT_02">
				<Text>Please supply security instructions in braile</Text>
			</Description>
		</Descriptions>
		<BookingInstructions>
			<SSRCode>BLND</SSRCode>
		</BookingInstructions>
	</ServiceDefinition>
</ServiceDefinitionList>

 

 

OrderViewRS Message

The service will then be returned in the OrderViewRS as an OrderItem with zero price for those services that are offered free of charge and without any EMD:

Code Block
languagexml
<OrderItem OrderItemID="IB01db6efac4044bd7b6d65113a60b5281OC_04">
	<PriceDetail>
		<TotalAmount>
			<SimpleCurrencyPrice Code="EUR">0.00</SimpleCurrencyPrice>
		</TotalAmount>
		<BaseAmount Code="EUR">0.00</BaseAmount>
		<Taxes>
			<Total Code="EUR">0.00</Total>
		</Taxes>
	</PriceDetail>
	<Service ServiceID="SPECIAL_NEED_IB042520240128_02" ServiceStatus="HK">
		<PassengerRef>ADULT_01</PassengerRef>
		<ServiceDefinitionRef SegmentRef="IB042520240128">SPECIAL_NEED-BLND</ServiceDefinitionRef>
	</Service>
	<TimeLimits>
        <Payment DateTime="2024-03-24T22:59:00.000Z"/>
    </TimeLimits>
			<Service ServiceID="SPECIAL_NEED_IB042620240108_01" ServiceStatus="HK">
		<PassengerRef>ADULT_01</PassengerRef>
		<ServiceDefinitionRef SegmentRef="IB042620240108">SPECIAL_NEED-BLND</ServiceDefinitionRef>
	</Service>
	<TimeLimits>
        <Payment DateTime="2024-03-24T22:59:00.000Z"/>
    </TimeLimits>
</OrderItem>

And the OrderItem is linked to the ServiceDefinition where the service is again described:

Code Block
languagexml
<ServiceDefinitionList>
	<ServiceDefinition ServiceDefinitionID="SPECIAL_NEED-BLND">
		<Name>Blind Passenger</Name>
		<Descriptions>
			<Description>
				<Text>Please supply security instructions in braile</Text>
			</Description>
			<Description refs="ADULT_01">
				<Text>Please supply security instructions in braile</Text>
			</Description>
			<Description refs="ADULT_02">
				<Text>Please supply security instructions in braile</Text>
			</Description>
		</Descriptions>
		<BookingInstructions>
			<SSRCode>BLND</SSRCode>
		</BookingInstructions>
	</ServiceDefinition>
</ServiceDefinitionList>

...

Any Special Services not available through NDC should be requested through ServIberia at least 48 hours before the flight. 

IMPORTANT NOTE

Under no circumstances should the contents of any refs or ID’s be used to identify the type of service being offered/given. In the case of Ancillaries the RFIC and SubCode(RFISC) decoded against the ATPCo Optional Services Industry Sub Codes should be used, and in the case of Special Service Requests, the SSRCode should be used, decoded against the IATA Airimp or the above table, or you can simply use the <Name>.

 

MediaList

Here is where we put URLs that can be used to link to additional information such as rich media and other useful information for the customer:

Code Block
<MediaList>
	<Media ListKey="Legal-Information">
		<MediaLink>http://www.iberia.com/gb/legal-information/?language=en</MediaLink>
	</Media>
	<Media ListKey="Cabin-features">
		<MediaLink>https://www.iberia.com/es/a-new-concept-in-flying/</MediaLink>
	</Media>
	<Media ListKey="Media-Checked-Baggage">
		<MediaLink>https://www.iberia.com/es/luggage/allowance-in-hold/</MediaLink>
	</Media>
	<Media ListKey="Special-Needs">
		<MediaLink>https://www.iberia.com/es/fly-with-iberia/special-needs/</MediaLink>
	</Media>
</MediaList>

 

Examples of messages with complete flows can be downloaded from here.

...