Versions Compared

Version Old Version 14 New Version Current
Changes made by

Alvaro Chaparro Molina

Alvaro Chaparro Molina

Saved on

Key

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

...

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:

...

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>

The above example is in the presale flow. For a post-sale flow, simply replace the OfferID within the Query section with the OrderID:

Code Block
languagexml
<Query>
	<OrderID Owner="IB">IB24847487859643f69318ea7fa100e3beOC</OrderID>
</Query>

ServiceListRS Message

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

...

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

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

The ServiceDefinitionList contains a list of the different Services each defined as necessary.

...

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.

...

Code Block
languagexml
<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 Special Equipment baggage is being assigned to different passengers, following the same process as in Bags with different weights.

...

If you are adding the ancillary to an already existing, and paid for, Order then the OrderChangeRQ is used as per the following:

OderChangeRQ Message

When adding ancillaries to an existing Order, you reference the existing OrderID and the OfferItem’s that you wish to purchase from the previous ServiceListRQ.

...

Code Block
languagexml
<Query>
	<OrderID>IB24847487859643f69318ea7fa100e3beOC</OrderID>
	<OrderServicing>
		<AcceptOffer>
			<Offer OfferID="ALACARTE_IBe28d6d416b76474c90fe4371da43b132" Owner="IB" ResponseID="Qm9va2luZ0AxNjg5NTgxODI4OTI5LWFzcHd6">
				<OfferItem OfferItemID="ALACARTE_SPEQUIPMENT_IBe28d6d416b76474c90fe4371da43b132_03">
					<PassengerRefs>ADULT_01</PassengerRefs>
				</OfferItem>
			</Offer>
		</AcceptOffer>
	</OrderServicing>
	<Payments>
		<Payment>
			<Type>CA</Type>
			<Method>
				<Cash CashInd="true"/>
			</Method>
			<Amount Code="EUR">80.0</Amount>
			<Payer>
				<ContactInfoRefs>Payer</ContactInfoRefs>
			</Payer>
		</Payment>
	</Payments>
</Query>

OrderViewRS Message

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

...

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.

...