.. _IATA_ServiceListRQ/RS:

*********************
IATA_ServiceListRQ/RS
*********************

.. raw:: html

   <h3>Introduction</h3>

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

.. raw:: html

   <h3>General Usage</h3>

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.

.. raw:: html

   <h3>Sample</h3>

.. raw:: html

   <h4>IATA_ServiceListRQ</h4>

**offer-based**

.. toggle-header::
    :header: **Show/Hide Request**

        .. code-block:: xml

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

.. toggle-header::
    :header: **Show/Hide Request**

        .. code-block:: xml

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

.. toggle-header::
    :header: **Show/Hide Request**

        .. code-block:: xml

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

|

.. raw:: html

   <h4>IATA_ServiceListRS</h4>

.. toggle-header::
    :header: **Show/Hide Response**

        .. code-block:: xml

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

|