Special Service Request (SSR) 17.2

Special Service Request (SSR) 17.2

 

Special Service Request (SSR)

Special Service Request (SSR)

SSR’s is a legacy concept used to request special services for passengers on flights. Initially this service was created for, and is still used for, the requesting of free services, such as Wheelchairs, Special Dietary Meals, services for Passengers with Reduced Mobility, etc

Some SSR are inventory controlled due to operational reasons, and therefore can be rejected due to capacity restraints.

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

Note: The inclusion of SSRs can be done in the initial creation of the Order (Pre-Sale) and also can be added later in a Servicing flow (Post-Sale).

The following are the SSRs that can be requested through our NDC channel.

For more information, please visit our PRM (Passenger with Reduced Mobility) page.

Booking Special Services

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

The bellow file contains a full end to end flow example.

 

SSR Code Table

SSR Code Table

SSR Code

Purpose

SSR Code

Purpose

BLND

Blind Passenger

DEAF

Deaf Passenger

DPNA

Disabled Passenger, with intellectual or developmental disability needing assistance (specify details)

WCHR

Wheelchair for passengers who can ascend/descend steps, and are able to make own way to/from cabin seat, but require wheelchair for distances. 

WCHS

Passenger cannot ascend/descend steps, but is able to make own way to/from cabin seat; requires wheelchair for distances and must be carried up/down steps. 

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

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:

<Qualifier> <SpecialNeedQualifiers> <Code>BLND</Code> </SpecialNeedQualifiers> </Qualifier>

ServiceListRQ Pre-Sale Flow (With OfferID):

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://www.iata.org/IATA/EDIST/2017.2"> <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>5.000</ReferenceVersion> </Document> <Party> <Sender> <TravelAgencySender> <IATA_Number>12233440</IATA_Number> <AgencyID>Agency Name</AgencyID> </TravelAgencySender> </Sender> <Participants> <Participant> <AggregatorParticipant SequenceNumber="1"> <AggregatorID>00011113</AggregatorID> </AggregatorParticipant> </Participant> </Participants> </Party> <Query> <Offers> <Offer> <OfferID Owner="IB">IB25e19492834644ecb104c6a3dd34b375OC</OfferID> <OfferItemIDs> <OfferItemID Owner="IB">IB25e19492834644ecb104c6a3dd34b375OC_01</OfferItemID> </OfferItemIDs> </Offer> </Offers> </Query> <Qualifier> <SpecialNeedQualifiers> <Code>DISA </SpecialNeedQualifiers> </Qualifier> </ServiceListRQ> </soapenv:Body> </soapenv:Envelope>

ServiceListRQ Post-Sale Flow (with OrderID):

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://www.iata.org/IATA/EDIST/2017.2"> <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>5.000</ReferenceVersion> </Document> <Party> <Sender> <TravelAgencySender> <IATA_Number>12233440</IATA_Number> <AgencyID>Agency Name</AgencyID> </TravelAgencySender> </Sender> <Participants> <Participant> <AggregatorParticipant SequenceNumber="1"> <AggregatorID>00011113</AggregatorID> </AggregatorParticipant> </Participant> </Participants> </Party> <Query> <OrderID Owner="IB">IBeab9cc05bfe4444197b3329163909912OC</OrderID> </Query> <Qualifier> <SpecialNeedQualifiers> <Code>DISA </SpecialNeedQualifiers> </Qualifier> </ServiceListRQ> </soapenv:Body> </soapenv:Envelope>

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

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.

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

ServiceDefinitionList

ContainsServiceDefinition with additional information describing each of the specific ALaCarteOfferItem, to which they are linked using the ServiceDefinitionRef in the ALaCarteOfferItem.

The BookingInstructions are used by certain system providers for legacy reasons.

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

<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

OrderCreateRQ Message

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

<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 ServiceSelection is mandatory for Special Service Request in the OrderCreateRQ.

Also the ServiceDefinition is mandatory for Special Service Request in the OrderCreateRQ. Additional information in the Description / Text is optional, except for DPNA, which is mandatory.

The correct SSRCode must be included, otherwise the NDC_DIST_2164 error will be returned.

Example without mandatory ServiceSelection and error message:

<Offer OfferID="ALACARTE_SSR_IBe77ae231cf2040c184b96b814561bf26" Owner="IB" ResponseID="Qm9va2luZ0BHVy0xNzI4NDc0NjEzMTM5LWU2Qzls"> <OfferItem OfferItemID="IB4f4689ba25af417a96cfb5053dfa2e12OC_BLND"> <PassengerRefs>ADULT_01</PassengerRefs> </OfferItem> </Offer> ------------------------------------------------------------------------- <ServiceDefinitionList> <ServiceDefinition ServiceDefinitionID="SPECIAL_NEED-BLND"> <Name>Blind Passenger</Name> <Descriptions> <Description refs="ADULT_01"> <Text>Request Service Animal if travelling with one</Text> </Description> </Descriptions> <BookingInstructions> <SSRCode>BLND</SSRCode> </BookingInstructions> </ServiceDefinition> </ServiceDefinitionList>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <soap:Fault> <faultcode>soap:Server</faultcode> <faultstring>UNEXPECTED_TECHNICAL_EXCEPTION</faultstring> <detail> <code>FRAM_B0006</code> </detail> </soap:Fault> </soap:Body> </soap:Envelope>

Example with optional additional information:

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

 Example without optional additional information:

<ServiceDefinitionList> <ServiceDefinition ServiceDefinitionID="SPECIAL_NEED-BLND"> <Name>Blind Passenger</Name> <Descriptions> <Description refs="ADULT_01"/> </Descriptions> <BookingInstructions> <SSRCode>BLND</SSRCode> </BookingInstructions> </ServiceDefinition> <ServiceDefinition ServiceDefinitionID="SPECIAL_NEED-WCHR"> <Name>Wheelchair for Ramps</Name> <Descriptions> <Description refs="ADULT_02"/> </Descriptions> <BookingInstructions> <SSRCode>WCHR</SSRCode> </BookingInstructions> </ServiceDefinition> <ServiceDefinition ServiceDefinitionID="SPECIAL_NEED-WCHS"> <Name>Weelchair for Steps</Name> <Descriptions> <Description refs="ADULT_03"/> </Descriptions> <BookingInstructions> <SSRCode>WCHS</SSRCode> </BookingInstructions> </ServiceDefinition> <ServiceDefinition ServiceDefinitionID="SPECIAL_NEED-DEAF"> <Name>Deaf Passenger</Name> <Descriptions> <Description refs="ADULT_04"/> </Descriptions> <BookingInstructions> <SSRCode>DEAF</SSRCode> </BookingInstructions> </ServiceDefinition> </ServiceDefinitionList>

 DPNA example with mandatory Description / Text

<ServiceDefinitionList> <ServiceDefinition ServiceDefinitionID="SPECIAL_NEED-DPNA"> <Name>Disabled Passenger</Name> <Descriptions> <Description refs="ADULT_01"> <Text>Disabled Passenger, with intellectual or developmental disability needing assistance. If you need any type of help, you must request it from the airport manager.</Text> </Description> </Descriptions> <BookingInstructions> <SSRCode>DPNA</SSRCode> </BookingInstructions> </ServiceDefinition> </ServiceDefinitionList>

DPNA example without mandatory Description / Text and error message:

<ServiceDefinitionList> <ServiceDefinition ServiceDefinitionID="SPECIAL_NEED-DPNA"> <Name>Disabled Passenger</Name> <Descriptions> <Description refs="ADULT_01"/> </Descriptions> <BookingInstructions> <SSRCode>DPNA</SSRCode> </BookingInstructions> </ServiceDefinition> </ServiceDefinitionList>
<OrderViewRS xmlns:tag0="http://www.iata.org/IATA/EDIST/2017.2" Version="5.000"> <Document> <ReferenceVersion>5.000</ReferenceVersion> </Document> <Errors> <Error ShortText="SSE_ORM_9138" Code="486">Missing information for the service of disabled passenger.</Error> </Errors> </OrderViewRS>

 

OrderChangeRQ Message

OrderChangeRQ Message

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

Points to consider:

  1. Special Services can be added to an paid or unpaid Order.

  2. You cannot add Special Services with another Ancillaries in the same OrderChangeRQ.

  3. You cannot add Special Services to an Order with already selected Seats.

  4. Permitted for Orders made more than 48 hours before the departure of the first flight segment.

<Query> <OrderID>IB77a88d72e24c4c449a59b088e7cf2a21OC</OrderID> <OrderServicing> <AcceptOffer> <!--SPECIAL SERVICES--> <Offer OfferID="ALACARTE_IBf5e9532cdebd485c8400564e35186014" Owner="IB" ResponseID="Qm9va2luZ0BHVy0xNzgzMzMzOTQzNjM3LUJJUjdI"> <OfferItem OfferItemID="ALACARTE_SSR_IBf5e9532cdebd485c8400564e35186014_BLND"> <PassengerRefs>ADULT_01</PassengerRefs> <ServiceSelection ServiceID="SSR_BLND_a152ff81-6bf7-4ceb-aae8-c6b4643fb140"> <ServiceDefinitionID>SPECIAL_NEED-BLND</ServiceDefinitionID> </ServiceSelection> </OfferItem> <OfferItem OfferItemID="ALACARTE_SSR_IBf5e9532cdebd485c8400564e35186014_DEAF"> <PassengerRefs>CHILD_01</PassengerRefs> <ServiceSelection ServiceID="SSR_DEAF_cc0fdbd4-333a-4ac5-9e8a-684349cfd044"> <ServiceDefinitionID>SPECIAL_NEED-DEAF</ServiceDefinitionID> </ServiceSelection> </OfferItem> <OfferItem OfferItemID="ALACARTE_SSR_IBf5e9532cdebd485c8400564e35186014_WCHR"> <PassengerRefs>ADULT_01</PassengerRefs> <ServiceSelection ServiceID="SSR_WCHR_9aa34a6e-a44b-4312-8d0e-3d738d252e5f"> <ServiceDefinitionID>SPECIAL_NEED-WCHR</ServiceDefinitionID> </ServiceSelection> </OfferItem> <OfferItem OfferItemID="ALACARTE_SSR_IBf5e9532cdebd485c8400564e35186014_WCHS"> <PassengerRefs>CHILD_01</PassengerRefs> <ServiceSelection ServiceID="SSR_WCHS_6801c96a-1d1e-4117-a521-8e2489ae1edd"> <ServiceDefinitionID>SPECIAL_NEED-WCHS</ServiceDefinitionID> </ServiceSelection> </OfferItem> </Offer> </AcceptOffer> </OrderServicing> </Query>

 

OrderViewRS Message

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:

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

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

In the ServiceDefinitionList the additional information provided is reflected back to you, together with the BookingInstructions needed by legacy systems.

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

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:

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

 

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