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.
The following are the SSRs that can be requested through our NDC channel.
These services must be requested in the OfferPrice service and subsequently booked in OrderCreate. They cannot be added to a previously created Order in a servicing flow.
SSR Code Table |
|---|
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.
OfferPriceRQ Message |
|---|
To request an SSR it should be included in the OfferPriceRQ message as a Qualifier:
<Qualifier>
<SpecialNeedQualifiers>
<Code>BLND</Code>
</SpecialNeedQualifiers>
</Qualifier>
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.
OfferPriceRS Message |
|---|
The Special Service is returned in the OfferPriceRS as an ALaCarteOfferItem with zero price for those services given free of charge.
<OtherOffers> <ALaCarteOffer OfferID="ALACARTE_SSR_IBef14deece1b743bab80c8bff759339c3" Owner="IB"> <OfferExpirationDateTime>2023-02-20T15:34:01.654Z</OfferExpirationDateTime> <ALaCarteOfferItem OfferItemID="IBb5fce81aa5b548f79086259d216c3181OC_BLND"> <Eligibility> <PassengerRefs>ADULT_01 ADULT_02 ADULT_03 ADULT_04</PassengerRefs> <SegmentRefs>IB343620230911</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_SN_c266f83b-195c-4af4-a5f9-7f28fb18d111"> <ServiceDefinitionRef>SPECIAL_NEED-BLND</ServiceDefinitionRef> </Service> </ALaCarteOfferItem> </ALaCarteOffer> </OtherOffers>
And the ALaCarteOfferItem is related to the ServiceDefinition containing the details of the Special Service requested.
<ServiceDefinitionList>
<ServiceDefinition ServiceDefinitionID="SPECIAL_NEED-BLND">
<Name>Pasajero ciego</Name>
<Descriptions>
<Description>
<Text>Solicite servicio de animales si viaja con uno</Text>
</Description>
</Descriptions>
<BookingInstructions>
<SSRCode>BLND</SSRCode>
</BookingInstructions>
</ServiceDefinition>
<...>
</ServiceDefinitionList>
</DataLists>
OrderCreate Message |
|---|
In the OrderCreateRQ the Offer:
<Query>
<Order>
<...>
<Offer OfferID="ALACARTE_SSR_IBef14deece1b743bab80c8bff759339c3" Owner="IB" ResponseID="Qm9va2luZ0BHVy0xNjc2OTA1NDM5MjM3LWFpOUMz">
<OfferItem OfferItemID="IBb5fce81aa5b548f79086259d216c3181OC_BLND">
<PassengerRefs>ADULT_01</PassengerRefs>
<ServiceSelection ServiceID="SSR_SN_c266f83b-195c-4af4-a5f9-7f28fb18d111">
<ServiceDefinitionID>SPECIAL_NEED-BLND</ServiceDefinitionID>
</ServiceSelection>
</OfferItem>
</Offer>
together with the ServiceDefinition in the same way as it is returned in the OfferPriceRS.
<DataLists>
<...>
<ServiceDefinitionList>
<ServiceDefinition ServiceDefinitionID="SPECIAL_NEED-BLND">
<Name>Pasajero ciego</Name>
<Descriptions>
<Description refs="ADULT_01">
<Text>Solicite servicio de animales si viaja con uno</Text>
</Description>
</Descriptions>
<BookingInstructions>
<SSRCode>BLND</SSRCode>
</BookingInstructions>
</ServiceDefinition>
</ServiceDefinitionList>
</DataLists>
OrderView Message |
|---|
The service will then be returned in the OrderViewRS as an OrderItem with with zero price for those services that are offered free of charge.
<OrderItems> <OrderItem OrderItemID="IBb5fce81aa5b548f79086259d216c3181OC_11"> <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_IB343620230911_01" ServiceStatus="HK"> <PassengerRef>ADULT_01</PassengerRef> <ServiceDefinitionRef SegmentRef="IB343620230911">SPECIAL_NEED-BLND</ServiceDefinitionRef> </Service> </OrderItem> </OrderItems>
And the OrderItem is linked to the ServiceDefinition where the service is described.
<DataLists>
<...>
<ServiceDefinitionList>
<...>
<ServiceDefinition ServiceDefinitionID="SPECIAL_NEED-BLND">
<Name>Blind Passenger</Name>
<Descriptions>
<Description>
<Text>Request Service Animal if travelling with one</Text>
</Description>
<Description refs="ADULT_01">
<Text>Solicite servicio de animales si viaja con uno</Text>
</Description>
</Descriptions>
<BookingInstructions>
<SSRCode>BLND</SSRCode>
</BookingInstructions>
</ServiceDefinition>
</ServiceDefinitionList>
</DataLists>
Specifically, the SSRCode represents the special service request this example is making reference to. As shown in the table above, all codes have a 4-charcater length.
The ServiceDefinitionRef contains the code for blind passengers SPECIAL_NEED-BLND.
In the ServiceDefinitionList further details regarding the SSR can be found.
Those SSRs not available through NDC should be made 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.
Rejection
If the special service is not available, due to inventory limits then the OrderCreate will be rejected, indicating the unavailable flight, with the following error:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<OrderViewRS Version="5.000" xmlns="http://www.iata.org/IATA/EDIST/2017.2" xmlns:ns2="http://www.iberia.com/IATA/NDC/SecurePayment/2017.2">
<Document>
<ReferenceVersion>5.000</ReferenceVersion>
</Document>
<Errors>
<Error ShortText="SSE_RES_1001" Code="486">Servicio WCHS (Wheelchair for Steps) no disponible para IB0438-MAD-BIO-17JAN24. Reserva no admitida.</Error>
</Errors>
</OrderViewRS>
</soap:Body>
</soap:Envelope>
Examples of messages with complete flows can be downloaded from here.
