Versions Compared

Old Version 2

changes.mady.by.user Valentina Maio

Saved on

compared with

New Version 3

changes.mady.by.user Alvaro Chaparro

Saved on

Key

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

...

Table of Contents
minLevel1
maxLevel6
outlinefalse
typelist
printablefalse

...

To purchase Sporting Equipment baggage, the ServiceFilter/GroupCode needs to be sent in the ServiceListRQ message as per the SubGroup and Group codes diplayed displayed in this table:

Presently, the purchase of Sporting Equipment is only available in the Pre-Sale flow. Likewise, on Unpaid (On-Hold) Orders is not permittedcan be included in an OrderCreate (with or without payment), and held with the flights until the PaymentTimeLimit expires.

The information regarding the price and details is included in the message response, later displayed in these examples.

 

ServiceListRQ Message

When new services are released, we will publish the new applicable ServiceFilters, and you can include them as and when required, as per the following examples:

language
Code Block
xml
<Parameters>
	<ServiceFilters>
		<ServiceFilter>
			<GroupCode>BG</GroupCode>
		</ServiceFilter>
		<ServiceFilter>
			<GroupCode>TS</GroupCode>
			<SubGroupCode>PR</SubGroupCode>
		</ServiceFilter>
		<ServiceFilter>
			<GroupCode>BG</GroupCode>
			<SubGroupCode>SP</SubGroupCode>
		</ServiceFilter>
	</ServiceFilters>
 </Parameters>

...

An example of a ServiceListRQ in the prime shopping flow, following the OfferPrice could look something like the following:

Code Block
languagexml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
	<soapenv:Header/>
	<soapenv:Body>
		<ServiceListRQ Version="5.000" PrimaryLangID="es" xmlns="http://www.iata.org/IATA/EDIST/2017.2">
			<PointOfSale>
				<Location>
					<CountryCode>ES</CountryCode>
				</Location>
			</PointOfSale>
			<Document>
				<ReferenceVersion>1.0</ReferenceVersion>
			</Document>
			<Party>
				<Sender>
					<TravelAgencySender>
						<IATA_Number>########</IATA_Number>
						<AgencyID>firstAgency</AgencyID>
					</TravelAgencySender>
				</Sender>
				<Participants>
					<Participant>
						<AggregatorParticipant SequenceNumber="1">
							<AggregatorID>########</AggregatorID>
						</AggregatorParticipant>
					</Participant>
				</Participants>
			</Party>
			<Parameters>
				<ServiceFilters>
					<ServiceFilter>
						<GroupCode>BG</GroupCode>
					</ServiceFilter>
					<ServiceFilter>
						<GroupCode>TS</GroupCode>
						<SubGroupCode>PR</SubGroupCode>
					</ServiceFilter>
					<ServiceFilter>
						<GroupCode>BG</GroupCode>
						<SubGroupCode>SP</SubGroupCode>
					</ServiceFilter>
				</ServiceFilters>
			</Parameters>
			<ShoppingResponseID>
				<ResponseID>Qm9va2luZ0AxNjg5NTgxODI4OTI5LWFzcHd6</ResponseID>
			</ShoppingResponseID>
			<Query>
				<Offers>
					<Offer>
						<OfferID Owner="IB">IBda189b81160243a9932b7aeb1ef0d6a6OC</OfferID>
						<OfferItemIDs>
							<OfferItemID Owner="IB">IBda189b81160243a9932b7aeb1ef0d6a6OC_01  </OfferItemID>
						</OfferItemIDs>
					</Offer>
				</Offers>
			</Query>
		</ServiceListRQ>
	</soapenv:Body>
</soapenv:Envelope>

 

ServiceListRS Message

All services offered are included within the ServiceList message response. This will evolve as more services are offered through the NDC channel.

Maintaining backward compatibility with our initial implementation, and with the new services being added, it is necessary to include the ServiceFilter if you want to sell them (as applied to Priority Boarding and Bags, and within the Parameters section). There is no need, however, to request them all since each ServiceFilter will retrieve the associated one.

...

The OfferItem shows the unit price of the Service for the applicable passengers and flight segments.

xml
Code Block
language
<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>Qm9va2luZ0AxNjg5NTgxODI4OTI5LWFzcHd6</ResponseID>
			</ShoppingResponseID>
			<...>
				<ALaCarteOffer OfferID="ALACARTE_IBe28d6d416b76474c90fe4371da43b132" Owner="IB">
					<OfferExpirationDateTime>2023-07-17T08:47:11.797Z</OfferExpirationDateTime>
					<ALaCarteOfferItem OfferItemID="ALACARTE_SPEQUIPMENT_IBe28d6d416b76474c90fe4371da43b132_01">
						<Eligibility>
							<PassengerRefs>ADULT_01</PassengerRefs>
							<SegmentRefs>IB684520231213</SegmentRefs>
						</Eligibility>
						<UnitPriceDetail>
							<TotalAmount>
								<SimpleCurrencyPrice Code="EUR">150.00</SimpleCurrencyPrice>
							</TotalAmount>
							<BaseAmount Code="EUR">150.00</BaseAmount>
							<Taxes>
								<Total Code="EUR">0.00</Total>
							</Taxes>
						</UnitPriceDetail>
						<Service ServiceID="SPE_SERVICE_3053636e-339f-43ec-8e54-853c0b399f02">
							<ServiceDefinitionRef>SPESERVICE-BICYCLE-1</ServiceDefinitionRef>
						</Service>
					</ALaCarteOfferItem>
					<...>
						<ALaCarteOfferItem OfferItemID="ALACARTE_SPEQUIPMENT_IBe28d6d416b76474c90fe4371da43b132_05">
							<Eligibility>
								<PassengerRefs>ADULT_01</PassengerRefs>
								<SegmentRefs>IB684520231213</SegmentRefs>
							</Eligibility>
							<UnitPriceDetail>
								<TotalAmount>
									<SimpleCurrencyPrice Code="EUR">260.00</SimpleCurrencyPrice>
								</TotalAmount>
								<BaseAmount Code="EUR">260.00</BaseAmount>
								<Taxes>
									<Total Code="EUR">0.00</Total>
								</Taxes>
							</UnitPriceDetail>
							<Service ServiceID="SPE_SERVICE_3c6f750a-8247-463a-b914-3ccd2ddef6d7">
								<ServiceDefinitionRef>SPESERVICE-GOLF_EQUIPMENT-2</ServiceDefinitionRef>
							</Service>
						</ALaCarteOfferItem>
						<...>
							<ALaCarteOfferItem OfferItemID="ALACARTE_SPEQUIPMENT_IBe28d6d416b76474c90fe4371da43b132_06">
								<Eligibility>
									<PassengerRefs>ADULT_01</PassengerRefs>
									<SegmentRefs>IB684520231213</SegmentRefs>
								</Eligibility>
								<UnitPriceDetail>
									<TotalAmount>
										<SimpleCurrencyPrice Code="EUR">390.00</SimpleCurrencyPrice>
									</TotalAmount>
									<BaseAmount Code="EUR">390.00</BaseAmount>
									<Taxes>
										<Total Code="EUR">0.00</Total>
									</Taxes>
								</UnitPriceDetail>
								<Service ServiceID="SPE_SERVICE_826aa018-036a-43b5-8331-575dff5a62ce">
									<ServiceDefinitionRef>SPESERVICE-GOLF_EQUIPMENT-3</ServiceDefinitionRef>
								</Service>
							</ALaCarteOfferItem>
						</ALaCarteOffer>

...

Using the RFIC together with the Subcode together with the ATPCo Optional Services Industry Sub Codes., the Grouping and SubGrouping of the services can be achieved.

language
Code Block
xml
<ServiceDefinitionList>
	<ServiceDefinition ServiceDefinitionID="SPESERVICE-BICYCLE-1">
		<Name>1 BICYCLE</Name>
		<Encoding>
			<RFIC>C</RFIC>
			<SubCode>0EC</SubCode>
		</Encoding>
		<Descriptions>
			<Description>
				<Text>1 BI - Bicycle</Text>
			</Description>
		</Descriptions>
		<BookingInstructions>
			<SSRCode>BIKE</SSRCode>
			<Method>SSR</Method>
		</BookingInstructions>
		<Detail>
			<ServiceCombinations>
				<Combination>
					<Rule>NotPermitted</Rule>
					<ServiceReference>SPESERVICE-BICYCLE-2</ServiceReference>
					<ServiceReference>SPESERVICE-BICYCLE-3</ServiceReference>
				</Combination>
			</ServiceCombinations>
			<ServiceItemQuantityRules>
				<MaximumQuantity>1</MaximumQuantity>
			</ServiceItemQuantityRules>
		</Detail>
	</ServiceDefinition>
	<ServiceDefinition ServiceDefinitionID="SPESERVICE-BICYCLE-2">
		<Name>2 BICYCLE</Name>
		<ServiceBundle>
			<ServiceDefinitionRef>SPESERVICE-BICYCLE-1</ServiceDefinitionRef>
			<ServiceDefinitionRef>SPESERVICE-BICYCLE-1</ServiceDefinitionRef>
		</ServiceBundle>
		<Encoding>
			<RFIC>C</RFIC>
			<SubCode>0EC</SubCode>
		</Encoding>
		<Descriptions>
			<Description>
				<Text>2 BI - Bicycle</Text>
			</Description>
		</Descriptions>
		<BookingInstructions>
			<SSRCode>BIKE</SSRCode>
			<Method>SSR</Method>
		</BookingInstructions>
		<Detail>
			<ServiceCombinations>
				<Combination>
					<Rule>NotPermitted</Rule>
					<ServiceReference>SPESERVICE-BICYCLE-1</ServiceReference>
					<ServiceReference>SPESERVICE-BICYCLE-3</ServiceReference>
				</Combination>
			</ServiceCombinations>
			<ServiceItemQuantityRules>
				<MaximumQuantity>1</MaximumQuantity>
			</ServiceItemQuantityRules>
		</Detail>
	</ServiceDefinition>
	<ServiceDefinition ServiceDefinitionID="SPESERVICE-BICYCLE-3">
		<Name>3 BICYCLE</Name>
		<ServiceBundle>
			<ServiceDefinitionRef>SPESERVICE-BICYCLE-1</ServiceDefinitionRef>
			<ServiceDefinitionRef>SPESERVICE-BICYCLE-1</ServiceDefinitionRef>
			<ServiceDefinitionRef>SPESERVICE-BICYCLE-1</ServiceDefinitionRef>
		</ServiceBundle>
		<Encoding>
			<RFIC>C</RFIC>
			<SubCode>0EC</SubCode>
		</Encoding>
		<Descriptions>
			<Description>
				<Text>3 BI - Bicycle</Text>
			</Description>
		</Descriptions>
		<BookingInstructions>
			<SSRCode>BIKE</SSRCode>
			<Method>SSR</Method>
		</BookingInstructions>
		<Detail>
			<ServiceCombinations>
				<Combination>
					<Rule>NotPermitted</Rule>
					<ServiceReference>SPESERVICE-BICYCLE-1</ServiceReference>
					<ServiceReference>SPESERVICE-BICYCLE-2</ServiceReference>
				</Combination>
			</ServiceCombinations>
			<ServiceItemQuantityRules>
				<MaximumQuantity>1</MaximumQuantity>
			</ServiceItemQuantityRules>
		</Detail>
	</ServiceDefinition>
</ServiceDefinitionList>

...

Please, note that the ServiceDefinition BookingInstructions section for Golf and Ski baggage type the SSRCode looks like the following:

Code Block
languagexml
<BookingInstructions>
     <SSRCode>SPEQ</SSRCode>
     <Method>SSR</Method>
</BookingInstructions>

And for the Bike baggage type is:

language
Code Block
xml
<BookingInstructions>
     <SSRCode>BIKE</SSRCode>
     <Method>SSR</Method>
</BookingInstructions>

 

OrderCreateRQ Message

Service Bundle

From the OrderCreate Request (and as an example of the various combinations) the following code shows that Sporting Equipment baggage is being assigned to different passengers, following the same process as in Bags with different weights.

...

Since these samples are being extracted from the same Flow, we can see that the OfferID is the same reported in the ServiceListRQ (<OfferID Owner="IB">IBda189b81160243a9932b7aeb1ef0d6a6OC</OfferID>), and so is the OfferItemID (<OfferItemID Owner="IB">IBda189b81160243a9932b7aeb1ef0d6a6OC_01 </OfferItemID>).

Code Block
languagexml
<Query>
	<Order>
		<Offer OfferID="IBda189b81160243a9932b7aeb1ef0d6a6OC" Owner="IB" ResponseID="Qm9va2luZ0AxNjg5NTgxODI4OTI5LWFzcHd6">
			<OfferItem OfferItemID="IBda189b81160243a9932b7aeb1ef0d6a6OC_01">
				<PassengerRefs>ADULT_01</PassengerRefs>
			</OfferItem>
		</Offer>
		<Offer OfferID="ALACARTE_IBe28d6d416b76474c90fe4371da43b132" Owner="IB" ResponseID="Qm9va2luZ0AxNjg5NTgxODI4OTI5LWFzcHd6">
			<OfferItem OfferItemID="ALACARTE_BAGGAGE_IBe28d6d416b76474c90fe4371da43b132_01">
				<PassengerRefs>ADULT_01</PassengerRefs>
			</OfferItem>
			<OfferItem OfferItemID="ALACARTE_SPEQUIPMENT_IBe28d6d416b76474c90fe4371da43b132_03">
				<PassengerRefs>ADULT_01</PassengerRefs>
			</OfferItem>
			<OfferItem OfferItemID="ALACARTE_PRIORITY_IBe28d6d416b76474c90fe4371da43b132_01">
				<PassengerRefs>ADULT_01</PassengerRefs>
			</OfferItem>
		</Offer>
	</Order>

 

OrderViewRS Message

In the OrderViewRS the Sporting Equipment Ancillary is shown in the following way.

First, the OrderItem:

language
Code Block
xml
<OrderItem OrderItemID="IBda189b81160243a9932b7aeb1ef0d6a6OC_04">
	<PriceDetail>
		<TotalAmount>
			<SimpleCurrencyPrice Code="EUR">450.00</SimpleCurrencyPrice>
		</TotalAmount>
		<BaseAmount Code="EUR">450.00</BaseAmount>
		<Taxes>
			<Total Code="EUR">0.00</Total>
		</Taxes>
	</PriceDetail>
	<Service ServiceID="SPE_SERVICE_IB684520231213_01" ServiceStatus="HK">
		<PassengerRef>ADULT_01</PassengerRef>
		<ServiceDefinitionRef SegmentRef="IB684520231213">SPESERVICE-BICYCLE-3</ServiceDefinitionRef>
	</Service>
</OrderItem>

And the ServiceDefinition, where we can observe all Ancillaries that are included in this specific example, according to their ServiceDefinitionID (Bags, Priority Boarding, and Sporting Equipment services).

Code Block
languagexml
<ServiceDefinitionList>
	<ServiceDefinition ServiceDefinitionID="BAGSERVICE-15-1">
		<Name>1 EXTRA BAG 15</Name>
		<Encoding>
			<RFIC>C</RFIC>
			<SubCode>0LM</SubCode>
		</Encoding>
		<Descriptions>
			<Description>
				<Text>1 Additional Bag up to 15 KG each</Text>
			</Description>
		</Descriptions>
		<BookingInstructions>
			<SSRCode>XBAG</SSRCode>
			<Method>SSR</Method>
		</BookingInstructions>
	</ServiceDefinition>
	<ServiceDefinition ServiceDefinitionID="PRIOBOARDINGSERVICE">
		<Name>PRIORITY BOARDING</Name>
		<Encoding>
			<RFIC>E</RFIC>
			<SubCode>0G6</SubCode>
		</Encoding>
		<Descriptions>
			<Description>
				<Text>PRIORITY BOARDING</Text>
			</Description>
		</Descriptions>
		<BookingInstructions>
			<SSRCode>BDPR</SSRCode>
			<Method>SSR</Method>
		</BookingInstructions>
		<Detail>
			<ServiceItemQuantityRules>
				<MaximumQuantity>1</MaximumQuantity>
			</ServiceItemQuantityRules>
		</Detail>
	</ServiceDefinition>
	<ServiceDefinition ServiceDefinitionID="SPESERVICE-BICYCLE-1">
		<Name>1 - BICYCLE</Name>
		<Encoding>
			<RFIC>C</RFIC>
			<SubCode>0EC</SubCode>
		</Encoding>
		<Descriptions>
			<Description>
				<Text>1 - BI - Bicycle</Text>
			</Description>
		</Descriptions>
		<BookingInstructions>
			<SSRCode>BIKE</SSRCode>
			<Method>SSR</Method>
		</BookingInstructions>
	</ServiceDefinition>
	<ServiceDefinition ServiceDefinitionID="SPESERVICE-BICYCLE-3">
		<Name>3 - BICYCLE</Name>
		<ServiceBundle>
			<ServiceDefinitionRef>SPESERVICE-BICYCLE-1</ServiceDefinitionRef>
			<ServiceDefinitionRef>SPESERVICE-BICYCLE-1</ServiceDefinitionRef>
			<ServiceDefinitionRef>SPESERVICE-BICYCLE-1</ServiceDefinitionRef>
		</ServiceBundle>
		<Encoding>
			<RFIC>C</RFIC>
			<SubCode>0EC</SubCode>
		</Encoding>
		<Descriptions>
			<Description>
				<Text>3 - BI - Bicycle</Text>
			</Description>
		</Descriptions>
		<BookingInstructions>
			<SSRCode>BIKE</SSRCode>
			<Method>SSR</Method>
		</BookingInstructions>
	</ServiceDefinition>
</ServiceDefinitionList>

 

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.

xml
Code Block
language
<Media ListKey="Media-Checked-Baggage">
	<MediaLink>https://www.iberia.com/es/equipajes/especiales/</MediaLink>
</Media>

 

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

...