RCS Language Options
Common:BaseReq @LanguageCode
Rail Content Service (RCS) supports translated text for Fare Rule conditions sent by the rail supplier (distributor).
The LanguageCode attribute is part of BaseReq, which used for all Universal API requests. However, @Language code is currently supported only for Airline Content Hub (ACH) for Air requests and RCS for rail requests.
Implementation by Provider
See Associated Transactions for provider functionality specific to each transaction.
Provider |
Implementation |
---|---|
RCH |
Implemented for RCS |
Request
To request translated Fare Rules conditions for rail:
- Confirm that the requested provider (@ProviderCode) is "RCH".
- Submit @LanguageCode to define the desired language, using a string in ISO-639 format. The language may not be changed after it is initially set in the Search request.
Currently supported languages for RCS are listed in the following table. Supported languages vary by supplier.
Language | Universal API Value (ISO 639) | Provider System |
---|---|---|
French | FR or FRFR | 2C |
English | EN or ENGB or ENUS | BN, TL, 2C, 2V |
German | DE or DEDE or DECH | DB, 2C |
Spanish | ES or ESES | 2C |
Italian | IT or ITIT | 2C |
Dutch | NL or NLNL | 2C |
All other languages |
Other language codes are accepted but not supported. ISO 639 language codes must be entered in 2, 3, or 4 characters for languages not listed above. |
2C |
Response
Currently, only the text for Fare Rules conditions (/RailFareNote @NoteName) are translated when a supported language is request. For example, the following text returns translated @NoteName text for the requested language, if available from the supplier:
<rail:RailFareNoteList>
<rail:RailFareNote Key="BuWAPq8UTwWOtIqlStL0FA==" NoteName="Exchange and refund service free of charge up until departure, and subject to conditions after departure.;minPaxNumber=1 returnMandatory=false"/>
</rail:RailFareNoteList>
All other rail response data remains in the default language (English) even if another language is requested.
Any Rail Booking (RailAvailabilitySearchReq) created using a specific language modifier retains that language for subsequent such as Universal Record Retrieve or Universal Record Modify.
Warning Responses
Depending on the supplier, warning text may be returned in the default English or the selected language.
If a language is not supported, the following error message is returned:
<Warning xmlns="http://www.travelport.com/rch/v1_1/businessmodel" Code="7000.ERR" Type="3.EWT" Context="RCH.2C">Language not requested or requested language not supported, defaulting to EN.</Warning>
Associated Transactions
Currently, the RCS FareConditions text is mapped to UAPI for RailAvailabilitySearchRsp and RailExchangeQuoteRsp. All other responses use the rule data which is in the associated request (and that request contains the rule data from the preceding AvailabilityRsp or ExchangeQuoteRsp. There is no guarantee that a supplier will return fare rule text in any service.
RailAvailabilitySearchReq @LanguageCode
RailAvailabilitySearchRsp/RailFareNoteList/RailFareNote @NoteName
Translated Fare Rules text is returned for Rail Availability for applicable suppliers. Note that the selected Language Code for the Rail Availability request cannot be modified for Rail Booking or subsequent transactions.
RailCreateReservationReq @LanguageCode
RailCreateReservationRsp/UniversalRecord/RailReservation/ RailPricingInfo/ RailFare/RailFareNote @NoteName
Translated Fare Rules text is returned for Rail Booking for applicable suppliers.
UniversalRecordRetrieveReq @LanguageCode
UniversalRecordRetrieveRsp UniversalRecord/RailReservation/ RailFareNoteList/RailFareNote @NoteName
Retrieved Rail bookings return language that the Fare Rules text was returned in for the booking.
UniversalRecordModifyReq @LanguageCode
UniversalRecordModifyRsp/UniversalRecord/ RailReservation/RailFareNoteList/ RailFareNote/@NoteName
The FareNote data contains the same data from the Universal Record Retrieve Request.
RailExchangeQuoteReq @LanguageCode
RailExchangeQuoteRsp/RailFareNoteList/ RailFareNote @NoteName
RailExchangeQuote is not supported for SNCF.
RailExchangeReq/@LanguageCode
RailExchangeRsp/UniversalRecord/ RailReservation/RailFareNoteList/ RailFareNote/@NoteName
The FareNote data is taken from the RailExchangeReq which should contain the data from the RailExchangeQuoteRsp
RailRefundReq/ @LanguageCode
RailRefundQuoteRsp
The NoteName attribute does not exist in RailRefundQuoteRsp