IATA_ServiceListRQ/RS

Introduction

The IATA_ServiceListRQ/RS message pair can be used to retrieve a service-catalogue for requested flights.

The operation can be used in context of a previously returned Offer, for an existing Order or in an informational standalone context.

The response also features rich content like description texts and media links (e.g. for images).

General Usage

The information required for this request varies on the context:

  • offer-based: The request contains an OfferID, that has been returned by NDC in a prior IATA_AirShoppingRS or an IATA_OfferPriceRS.

  • order-based: The request contains the ID of an existing Order. Please note, that the Order has to be retrieved via IATA_OrderRetrieveRQ, to load the Order into the NDC-Cache and enable Order-based shopping.

  • standalone: The request contains the exact flight route details, for which seatmaps should be returned

In the standalone-case, the results can be filtered by adding more parameters, e.g. cabin type. For the other cases, the parameters are used from the existing Offer-/Order-context.

Sample

IATA_ServiceListRQ

offer-based

Show/Hide Request

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<IATA_ServiceListRQ
   xmlns="http://www.iata.org/IATA/2015/00/2019.2/IATA_ServiceListRQ">
   <Party>
      <Sender>
         <EnabledSystem>
            <SystemID>94021</SystemID>
         </EnabledSystem>
      </Sender>
   </Party>
   <Request>
      <CoreRequest>
         <Offer>
            <OfferID>OF518fb518-77e5-11ea-abfe-651ef0d5ad6e</OfferID>
            <OfferItem>
               <OfferItemID>OFI518fb518-77e5-11ea-abfe-651ef0d5ad6e1</OfferItemID>
               <OwnerCode>NA</OwnerCode>
            </OfferItem>
            <OwnerCode>NA</OwnerCode>
         </Offer>
      </CoreRequest>
   </Request>
</IATA_ServiceListRQ>

order-based

Show/Hide Request

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<IATA_ServiceListRQ
    xmlns="http://www.iata.org/IATA/2015/00/2019.2/IATA_ServiceListRQ">
    <Party>
        <Sender>
            <EnabledSystem>
                <SystemID>94021</SystemID>
            </EnabledSystem>
        </Sender>
    </Party>
    <Request>
        <CoreRequest>
            <Order>
                <OrderID>1234567</OrderID>
                <OrderItem>
                    <GrandTotalAmount>0</GrandTotalAmount>
                    <OrderItemID>OI12345671</OrderItemID>
                </OrderItem>
                <OwnerCode>NA</OwnerCode>
            </Order>
        </CoreRequest>
    </Request>
</IATA_ServiceListRQ>

standalone

Show/Hide Request

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<IATA_ServiceListRQ
    xmlns="http://www.iata.org/IATA/2015/00/2019.2/IATA_ServiceListRQ">
    <MessageDoc>
        <RefVersionNumber>1</RefVersionNumber>
    </MessageDoc>
    <Party>
        <Sender>
            <EnabledSystem>
                <SystemID>12345</SystemID>
            </EnabledSystem>
        </Sender>
    </Party>
    <Request>
        <CoreRequest>
            <OriginDest>
                <DestStationCode>TFS</DestStationCode>
                <OriginStationCode>FRA</OriginStationCode>
                <PaxJourney>
                    <PaxSegment>
                        <Arrival>
                            <IATA_LocationCode>TFS</IATA_LocationCode>
                        </Arrival>
                        <CabinType>
                            <CabinTypeCode>Y</CabinTypeCode>
                        </CabinType>
                        <Dep>
                            <AircraftScheduledDateTime>2020-05-13T12:20:00</AircraftScheduledDateTime>
                            <IATA_LocationCode>FRA</IATA_LocationCode>
                        </Dep>
                        <MarketingCarrierInfo>
                            <CarrierDesigCode>ZZ</CarrierDesigCode>
                            <MarketingCarrierFlightNumberText>1478</MarketingCarrierFlightNumberText>
                        </MarketingCarrierInfo>
                    </PaxSegment>
                </PaxJourney>
            </OriginDest>
        </CoreRequest>
        <ShoppingCriteria>
            <FareCriteria>
                <FareBasisCode>SPO</FareBasisCode>
                <PrefLevel />
            </FareCriteria>
        </ShoppingCriteria>
    </Request>
</IATA_ServiceListRQ>

IATA_ServiceListRS

Show/Hide Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<IATA_ServiceListRS xmlns="http://www.iata.org/IATA/2015/00/2019.2/IATA_ServiceListRS">
   <Response>
      <ALaCarteOffer>
         <ALaCarteOfferItem>
            <Eligibility>
               <FlightAssociations>
                  <PaxSegmentRefID>SEG7</PaxSegmentRefID>
               </FlightAssociations>
            </Eligibility>
            <OfferItemID>OFI5f7f5ded-77e5-11ea-abfe-078514e8b01f1</OfferItemID>
            <Service>
               <ServiceDefinitionRefID>SVD1</ServiceDefinitionRefID>
               <ServiceID>SV1</ServiceID>
            </Service>
            <UnitPrice>
               <TotalAmount CurCode="EUR">129.99</TotalAmount>
            </UnitPrice>
         </ALaCarteOfferItem>
         <ALaCarteOfferItem>
            <Eligibility>
               <FlightAssociations>
                  <PaxSegmentRefID>SEG7</PaxSegmentRefID>
               </FlightAssociations>
            </Eligibility>
            <OfferItemID>OFI5f7f5ded-77e5-11ea-abfe-078514e8b01f2</OfferItemID>
            <Service>
               <ServiceDefinitionRefID>SVD2</ServiceDefinitionRefID>
               <ServiceID>SV2</ServiceID>
            </Service>
            <UnitPrice>
               <TotalAmount CurCode="EUR">149.99</TotalAmount>
            </UnitPrice>
         </ALaCarteOfferItem>
         <OfferID>OF5f7f5ded-77e5-11ea-abfe-078514e8b01f</OfferID>
         <OwnerCode>ZZ</OwnerCode>
      </ALaCarteOffer>
      <DataLists>
         <OriginDestList>
            <OriginDest>
               <DestCode>TFS</DestCode>
               <OriginCode>FRA</OriginCode>
               <OriginDestID>OD1</OriginDestID>
               <PaxJourneyRefID>FL1</PaxJourneyRefID>
            </OriginDest>
         </OriginDestList>
         <PaxJourneyList>
            <PaxJourney>
               <PaxJourneyID>FL1</PaxJourneyID>
               <PaxSegmentRefID>SEG7</PaxSegmentRefID>
            </PaxJourney>
         </PaxJourneyList>
         <PaxSegmentList>
            <PaxSegment>
               <Arrival>
                  <AircraftScheduledDateTime>2020-05-13T16:05:00</AircraftScheduledDateTime>
                  <IATA_LocationCode>TFS</IATA_LocationCode>
               </Arrival>
               <Dep>
                  <AircraftScheduledDateTime>2020-05-13T12:20:00</AircraftScheduledDateTime>
                  <IATA_LocationCode>FRA</IATA_LocationCode>
               </Dep>
               <MarketingCarrierInfo>
                  <CarrierDesigCode>ZZ</CarrierDesigCode>
                  <MarketingCarrierFlightNumberText>1478</MarketingCarrierFlightNumberText>
               </MarketingCarrierInfo>
               <PaxSegmentID>SEG7</PaxSegmentID>
            </PaxSegment>
         </PaxSegmentList>
         <ServiceDefinitionList>
            <ServiceDefinition>
               <Desc>
                  <DescText>Baggage Package 15kg</DescText>
               </Desc>
               <Desc>
                  <DescText>Need more hold baggage than you thought? Simply add an additional 15 kg hold luggage to your booking in advance to make packing more relaxing.</DescText>
               </Desc>
               <Desc>
                  <URL>http://ndc-cdn.pribas.com/images/stage/LGXB/LGXB.png</URL>
               </Desc>
               <Name>Baggage Package 15kg</Name>
               <RFISC>XBAG</RFISC>
               <ServiceCode>LGXB</ServiceCode>
               <ServiceDefinitionID>SVD1</ServiceDefinitionID>
            </ServiceDefinition>
            <ServiceDefinition>
               <Desc>
                  <DescText>Baggage Package 20kg</DescText>
               </Desc>
               <Desc>
                  <DescText>Need more hold baggage than you thought? Simply add an additional 20 kg hold luggage to your booking in advance to make packing more relaxing.</DescText>
               </Desc>
               <Name>Baggage Package 20kg</Name>
               <RFISC>XBAG</RFISC>
               <ServiceCode>XLXB</ServiceCode>
               <ServiceDefinitionID>SVD2</ServiceDefinitionID>
            </ServiceDefinition>
         </ServiceDefinitionList>
      </DataLists>
      <ShoppingResponse>
         <ShoppingResponseRefID>1f1b07cf-0681-4494-b96a-629c8b7dd50b</ShoppingResponseRefID>
      </ShoppingResponse>
   </Response>
   <PayloadAttributes>
      <Timestamp TimeZoneCode="UTC">2020-04-06T09:02:42.162</Timestamp>
      <VersionNumber>19.2</VersionNumber>
   </PayloadAttributes>
</IATA_ServiceListRS>