Spanish Resident Fares (CKIN SSR)

Spain offers fare discounts for residents of the Balearic Islands, Canary Islands, and Ceuta. To be eligible for a resident discount, passengers must be either Spanish citizens, citizens of other member states of the European Union, or citizens of other States that are members of the European Economic Area who can prove that they are resident in the Balearic or Canary Islands. Residents from the Balearic or Canary Islands must be travelling between their place of residence to any other part of Spain. Residents from Ceuta must be travelling between Seville, Malaga, or Jerez to any other part of Spain.

Residents must provide:

Residency is required to validate the rules of some air fares such as Government State fares (Passenger Type GST). In addition, the residency validates Check-In Information (CKIN) SSR data, which is required for Spanish Resident fares in Galileo (1G).

Notes:

Request

Personal Geography

PersonalGeography within the typePassengerType complex type is used to support location-specific fares. This complex type is used by the SearchPassenger element.

The PersonalGeography element supports discounts in Low Fare Shopping (synchronous and asynchronous), Air Pricing, Air Booking, and Universal Record (UR) Modify transactions. CountryCode, StateProvinceCode, or CityCode child elements can be used to specify required location details. These child elements are mutually exclusive; only one PersonalGeography child element can be used per BookingTraveler in a request, but at least one of these fields must be submitted per booking traveler.

Some carriers do not file Personal Geography data for Spanish Resident Discounts. For these carriers, applicable Spanish Resident fares are determined solely by the Passenger Type, such as Adult Resident (ADR). For these carriers, Personal Geography data is optional in the request, whereas it is required for carriers that do file Personal Geography data with the fare.

The following requests support the PersonalGeography element and Spanish Resident Fares:

Booking with CKIN SSRs

In addition to the PersonalGeography values used for pricing in Low Fare Shopping and Air Pricing, a booking with Spanish Resident fares also requires a CKIN SSR that contains a text format for the residency data. This SSR is required for initial bookings that use AirCreateReservationReq and updated bookings that use UniversalRecordModifyReq. Multiple CKIN SSRs are supported within a PNR, as a single CKIN SSR is associated to each traveler (BookingTraveler).

The CKIN SSRs used for Spanish Resident Fares have two basic formats: Resident and Family, for use by extended family members traveling with the Resident passenger.

Spanish resident infant remarks

Spanish resident child (CHR) and infant (INR) passengers, both with and without a valid ID, are supported to reduce debit memos due to improper handling of these passenger types. For Spanish resident infant remarks, in the request, if the date of birth is included in the <RemarkData>, it should not be populated in the DOB field. The system automatically appends the DOB in the Response based on the Remarks Data.

Note: When including the date of birth in the remarks field it must precede all other data and it must be in DDMMMYY format.

For example:

Copy
Request:
<BookingTraveler TravelerType="INR" Key="3" xmlns=http://www.travelport.com/schema/common_v51_0>
<BookingTravelerName First="TEST" Last="MARPINEZ " Prefix="INF"/>
<SSR Key="2MDAwMDAwMDAwMDAwMDAwMA==" Type="CTCE" FreeText="iremola//*****.com" Carrier="UX"/>
<SSR Key="2MDAwMDAwMDAwMDAwMDAwMQ==" Type="CTCM" FreeText="XXXXXXXXX" Carrier="UX"/>
<SSR Key="22" Type="FOID" FreeText="NI11111111h" Carrier="UX" Status="HK"/>
<NameRemark Key="3">
<RemarkData>12APR22 P-INRLPMI</RemarkData>
</NameRemark>
</BookingTraveler>

Response:
<common_v51_0:BookingTraveler Key="JffxZ0SqWDKAltQbBAAAAA==" TravelerType="INR" DOB="2022-04-12" ElStat="A">
<common_v51_0:BookingTravelerName Prefix="INF" First="TEST" Last="MARPINEZ "/>
<common_v51_0:NameRemark Key="JffxZ0SqWDKAptQbBAAAAA==" ElStat="A">
<common_v51_0:RemarkData>12APR22 P-INRLPMI</common_v51_0:RemarkData>
<common_v51_0:ProviderReservationInfoRef Key="JffxZ0SqWDKAlwQbBAAAAA=="/>
</common_v51_0:NameRemark>
</common_v51_0:BookingTraveler>

In the request if the date of birth is included in the DOB field, it should not be included in the remarks data. The system will automatically append the date of birth in the <RemarkData> in the response.

For example:

Copy
Request:
<BookingTraveler TravelerType="INR" DOB="2022-04-12 Key="3" xmlns=http://www.travelport.com/schema/common_v51_0>
<BookingTravelerName First="TEST" Last="MARPINEZ " Prefix="INF"/>
<SSR Key="2MDAwMDAwMDAwMDAwMDAwMA==" Type="CTCE" FreeText="iremola//*****.com" Carrier="UX"/>
<SSR Key="2MDAwMDAwMDAwMDAwMDAwMQ==" Type="CTCM" FreeText="XXXXXXXXX" Carrier="UX"/>
<SSR Key="22" Type="FOID" FreeText="NI11111111h" Carrier="UX" Status="HK"/>
<NameRemark Key="3">
<RemarkData>P-INRLPMI</RemarkData>
</NameRemark>
</BookingTraveler>

Response:
<common_v51_0:BookingTraveler Key="JffxZ0SqWDKAltQbBAAAAA==" TravelerType="INR" DOB="2022-04-12" ElStat="A">
<common_v51_0:BookingTravelerName Prefix="INF" First="TEST" Last="MARPINEZ "/>
<common_v51_0:NameRemark Key="JffxZ0SqWDKAptQbBAAAAA==" ElStat="A">
<common_v51_0:RemarkData>12APR22 P-INRLPMI</common_v51_0:RemarkData>
<common_v51_0:ProviderReservationInfoRef Key="JffxZ0SqWDKAlwQbBAAAAA=="/>
</common_v51_0:NameRemark>
</common_v51_0:BookingTraveler>

SARA Validation

As of Universal API Release 19.1.4 Release 19.1, and enhanced with Release 19.1.8 and 20.4.1 Release 20.4, a new framework was implemented to verify the eligibility of passengers wanting to fly using a Spanish Residency discount. This validation is done when the ticket is issued. The Spanish government has provided access to a database called SARA (Sistema de Acreditación de Residencia Automático, or Automatic Residency Accreditation System) which can validate if the passenger is eligible for that discount. If the passenger has a Resident discount, the provider must call SARA to validate the passenger. The default Boolean @ValidateSpanishResidency value is false, and if set to 'true' a SARA validation is executed.

These are the possible responses from that Validation call:

All carriers, in addition to the SSR CKIN information, also require the transmission of all resident, numerous family details and the SARA validation results via the RET FILE FRCA IT/07, when the BSP reports take place. Consequently, all these details are present in the fare construction of the electronic ticket in order to properly populate and transmit.

After the ticket is issued the Web Service “Ticket” is called.

 

Response

Personal Geography data is not included in responses. Therefore, there is no change to the Travelport Universal API responses for transactions that include Personal Geography data in the request.

Applied residency data are returned in booking and ticketing retrieve responses, so that the nationality from the applied residency type by passenger line or data can be applied in a future exchange.
/AirPricingInfo/PassengerType @ResidencyType Release 23.1

Airlines may return Fare Basis codes (FareInfo @FareBasis) in the response that indicate a geographic fare, such as a code that ends with the two characters of the Spanish geographic area of the trip. However, the format of the Fare Basis code varies by carrier.

Error and Warning Messages

While CKIN SSR data is not a new function for Travelport Universal API, new validation errors may be returned in Travelport Universal API directly from Galileo.

Note: When the error, "003 PLATAFORMA SARA NO DISPONIBLE (Platform not available)." when requesting Spanish resident fares and the residency cannot be validated against the Spanish Government residency database, SARA. However, a ticket is still issued, and new endpoints are called to update the passenger information in the SARA database. Following the update, a response message returns,

<common_v53_0:ResponseMessage Code="0" Type="Info" ProviderCode="1G">SaveResidence/MR LASTNAME FIRSTNAME/007-RESIDENT DATA CORRECTLY INSERTED IN DDBB</common_v53_0:ResponseMessage> Release 24.1

Carrier-Specific Errors

Following Release 20.4.1, Universal API adds the following logic for SARA resident fares when a ticket is issued on carrier NT (Binter Canarias): Release 20.4

Travelport can process the requests from carriers to exclude tariffs, rules, and fare classes from the Spanish Resident and Family discounts. When updates, changes, and/or deletions are necessary for carrier-specific changes to Spanish Resident fares, those requests should be sent to: ManualTableRequest@Travelport.com. The email subject line should include: ‘SDE Table Changes for Exemptions from the Spanish Resident & Family Discounts’.

Exceptions

Apollo (1V), Worldspan (1P), and Airline Content Hub (ACH) do not currently support Spanish Resident Discount functionality through Universal API. While CKIN SSRs with locale data were previously supported in Universal API, the validation functionality for Spanish resident fares is new to Universal API in release 4.1.