SSRs (Special Service Requests)

A Special Service Request (SSR) is a message sent directly to suppliers to communicate traveler preferences, special services needed by a traveler, or of a procedural requirement necessary of the carrier. SSRs are used for air segments only.

SSRs include information such as meal preference or special assistance required the traveler. In addition, the SSR can send an alert message back to the agency or travel provider. SSRs can originate with the travel provider asking for service from the carrier or from the carrier asking for information (like a ticket number) from the travel provider.

Because action must be taken by the carrier, there is usually a reply from them in the form of the status code on the SSR (HK, UN, etc.)

A Special Service Request (SSR) can be made in a PNR on behalf of one traveler, several travelers, or all travelers for specific segments or an entire itinerary. A single traveler and/or single segment may have multiple SSRs assigned to it, but the same SSR cannot be assigned to the same traveler/segment more than once.

Important: SSRs require the carrier to take action, while OSIs are informational only and do not typically require an action or response from the carrier. OSIs and SSRs are NOT interchangeable. An SSR should be used if possible; an OSI should be used only if there is no standardized SSR available for the service needed.

SSR Codes

Each SSR uses a four-character IATA code that specifies the type of service requested. These codes and their recommended use are pre-defined by IATA, however, not all suppliers or providers support the use of all SSR codes.

SSRs can be sent with or without additional descriptive free text. Additional text may be required, optional, or prohibited, depending on the type of SSR. Also, some providers or carriers may not support additional text for an SSR type, even if free text is permitted for that SSR by IATA standards.

Free text can be used to further define a request. For example, two additional baggage items can be detailed in the free text. If one passenger is traveling with two bicycles then the text can say "traveling with 2 bikes". If two passengers are traveling, and there are two bikes, then one BIKE SSR can be assigned to each passenger.

The following SSRs are currently supported by Galileo. Additional SSRs for Galileo and other providers will be supported in future releases.

Note: Seat SSRs are not supported, as a seat assignment can be requested with the booking.

 

Status Code

Description

Free Text

Example Text

Reply

DOCS

Passport information.

Required in specific format.

 

None. Status remains 'NN'

BLND

Traveler is blind.

Optional.

 

Mandatory.

DEAF

Traveler is deaf.

Optional.

 

Mandatory.

WCH

Wheelchair is needed -- traveler cannot go long distance.

Optional.

 

Mandatory.

WCHR

Wheelchair is needed -- traveler cannot climb stairs

Optional.

 

Mandatory.

TKNM

Manually entered ticket number for carrier notification

Required, must include ticket number.

 

None.

Meal SSRs

AVML, BBML, BLML, CHML, DBML, FPML, GFML, HFML, HNML, KSML, LCML, LFML, LPML, LSML, ,MOML, NLML, ORML, PRML, RVML, SFML, SPML, VGML, VLML

None, except SPML, which permits free text.

 

Typically returns 'KK'

INFT

Infant traveling in lap

Optional  free text.

 

Mandatory to confirm or decline

CHLD

Child traveling

Optional date of birth. (No additional free text allowed.)

 

Optional. Status may remain 'NN'

FQTU

Frequent traveler with upgrade and mileage accrual

 

Not supported by all carriers. Host will do validation and fail the SSR if not supported.

None.

 

 

DOCA

APIS passenger residence address information

See example.

SSR DOCA BA HK1/R/US/1600 SMITH ST/HOUSTON/TX/77001

 

/R/ designates residence and /US/ designates the country code of the address. The format of the address after the country code is to delimit each address element with a "/".

None.

DOCO

APIS secondary document information

See example.

SSR DOCO BA HK1//V/9891404/LONDON/14MAR07
/USA-1SMITH/JOHNMR  

/V/ designates a Visa as the alternate document, London is the place of issue, and DDMMMYY is the date of issue.

Some providers have different  requirements for DOCO data. See  for details.

None.

GUAR

Not an IATA-standard SSR, but is supported in Gailleo only on guaranteed payment carriers.

Required.

Free text includes the credit card, expiration date, and cardholder name.

 

None.

FOID

Form of ID. Universal API supports all forms of ID, except Credit Card.

Mandatory

 

Action code is mandatory but a reply will not be retuned.

Driver's License

 

 

Frequent Flier Card

 

 

Passport

 

 

National ID Card

 

 

Record Locator

 

 

Carrier Ticket Number

 

 

Local ID

 

 

TWOV  

Transit without visa

Segment reference and text are optional

 

 

 

DOCO SSR

For the DOCO SSR, the requirements for visa information vary by provider. The following table lists the visa information that can be sent in Universal API™ as free-form text for SSR DOCO, and which fields are required in Galileo, ACH, Sabre, and Worldspan.

Provider

Place of Birth

Visa Number

Place of Issue

Date of Issue

Country to which visa applies

Passenger Name

Expiration Date

Galileo

No

Yes

Yes

Yes

Yes

No

No

ACH

No

No

No

No

No

No

Yes

Sabre

Yes

Yes

Yes

No

No

No

No

Worlspan

Yes

Yes

Yes

Yes

Yes

Yes

No

 

SSR Status Codes

SSRs have status codes to indicate their current status in the fulfillment process:

Status Code

Description

NN

SSR has been requested.

PN

SSR is pending confirmation.

UN

Supplier (carrier) is unable to fulfill the request. The SSR in this case will remain in the PNR as evidence that the service was requested and declined.

HK

SSR has been confirmed.

other

A carrier may send a different status or choose not to reply to an SSR with an HK message, which means that the SSR status will always remain as 'NN'. This status is allowed on some SSRs with the assumption that the supplier has received the message, and that the service will be provided.

 

Exceptions

Galileo

For Galileo, if the required fields are not sent in the SSR, an error response is returned in the book response.

ACH

RCH

RCH rail supplier Deutsche Bahn does not support SSRs.