Implementation Notes
Parameters
Parameter | Value | Description |
---|---|---|
Response Messages
|
Reason | Response Model |
---|---|---|
200 |
This method returns the detailed information of the reservations created through our reservation system. It covers reservations made from all sales channels.
Name | Description | Type | Required |
requestHeader |
RequestHeader | Yes | |
retrieveReservationOTARequest |
Complex Element | No |
Name | Description | Type | Required |
clientCode |
Client Code | String | Mandatory (Optional for WEBSDOM) |
clientUsername |
Client Username | String | Mandatory |
channel |
Channel info | String | Mandatory (Optional for WEBSDOM) |
airlineCode |
Airline info | String (TK,AJ) | Mandatory (Optional for WEBSDOM) |
application |
Application name | String | Optional |
clientTransactionId |
A unique id to identify transaction | String | Mandatory |
agent |
Information on which device made the service call (Nokia E72, Browser) | String | Optional |
languageCode |
Language Code | String (TR,EN) | Optional |
agencyOfficeCode |
Agency Office Code | String (ITT) | Optional |
extraParameters |
The model object which contains key, value | Model[] | Optional |
Name | Description | Type | Required |
UniqueID |
Request a reservation based on a PNR number. | UniqueID_Type | Yes |
Surname |
Family name, last name. May also be used for full name if the sending system does not have the ability to separate a full name into its parts, e.g. the surname element may be used to pass the full name. | StringLength1to64 | Yes |
GivenName |
First Name, given name based on PNR. That means if passenger have more than one name but PNR shows only one of them, givenName must be the same on PNR | StringLength1to64 | Mandatory for WEBSDOM, optional for others |
Name | Description | Type |
status |
Status of the transaction | String |
requestId |
Request Id | String |
message |
Transaction message | Model[] |
data |
Ota response details | Model[] |
Name | Description | Type |
code |
not used yet | String |
description |
request process message | String |
Name | Description | Type |
OTA_AirBookRS |
(The Book Response message contains the itinerary, passenger and pricing information sent in the request, along with a Booking reference number (PNR Locator) and ticketing information if the booking was successful. This message contains similar information to a standard airline CRS or GDS Display PNR message.) | Compex Element |
contact |
used for PNR CT area | Element |
baggage |
used for baggage detail | Element |
svc |
shows SVC details | Element |
reservationInfoOTAResponse |
shows extra details according to client demands | Element |
WKSC_Info |
detail for WK, SC segments | Element |
Name | Description | Type |
AirReservation |
Contains all booking response information pertaining to a completed reservation. | AirReservation |
RetransmissionIndicator |
not used yet | boolean |
Version |
Not used always 0 | string |
TimeStamp |
transaction time stamp | string |
Warnings |
Standard way to indicate successful processing of an OTA message, but one in which warnings are generated. | element |
Name | Description | Type |
AirItinerary |
A collection of all flight segments requested for booking. Specifies the origin and destination of the traveler. | AirItineraryType |
PriceInfo |
Container for all the fare information. | BookingPriceInfoType |
TravelerInfo |
All traveler information relevant to a booking request. Identifies passenger(s) who will travel on the reservation. | TravelerInfoType |
ArrangerInfo |
PNR creator info | Element |
Fulfillment |
All payment information relevant to a booking request. Payment information relevant to a booking. | FulfillmentType |
Ticketing |
Minimum information about ticketing required to complete the booking transaction. | TicketingInfoType |
BookingReferenceID |
shows PNR number | Element |
Emd_Info |
Shows EMD type | EMD_Type |
Comment |
Textual information for the EMD document. | FormattedTextTextType |
PricingOverview |
Information applicable to the pricing of the reservation. | PricingOverviewType |
Name | Description | Type |
OriginDestinationOptions |
A collection of OriginDestinationOption. | AirItineraryType-OriginDestinationOptions |
Name | Description | Type |
OriginDestinationOption |
A container for OriginDestinationOptionType | OriginDestinationOption1 |
Name | Description | Type |
FlightSegment |
A container for necessary data to describe one or more legs of a single flight number. | OriginDestinationOptionType-FlightSegment |
RPH |
Reference place holder for this flight segment. | RPH_Type |
Name | Description | Type |
DepartureAirport |
Departure point of flight segment. | FlightSegmentBaseType-DepartureAirport |
ArrivalAirport |
Arrival point of flight segment. | FlightSegmentBaseType-ArrivalAirport |
OperatingAirline |
The operating airline of the flight if it is a codeshare flight. Identifies the operating carrier and flight number. | OperatingAirlineType |
BookingClassAvails |
A collection of availability counts per booking class. | BookFlightSegmentType-BookingClassAvails |
Comment |
Textual information | FreeTextType |
DepartureDateTime |
The date and time of the flight segment departure. | dateTime |
ArrivalDateTime |
The date and time of the flight segment arrival | dateTime |
RPH |
Reference place holder for this flight segment. | RPH_Type |
InfoSource |
Involuntary indicator | InfoSourceType |
FlightNumber |
The flight number of the flight. This is required for use with scheduled airline messages but may be omitted for requests by tour operators. Identifies a flight number (1 to 4 numbers followed by optional uppercase A - Z, which specifies an operational suffix) or OPEN or ARNK.) | FlightNumberType |
FareBasisCode |
The fare basis code for this flight leg. | StringLength1to16 |
ResBookDesigCode |
Used for an Alpha String, length 1 to 2 (for letter codes). | UpperCaseAlphaLength1to2 |
NumberInParty |
Number of travelers associated with this segment. | positiveInteger |
Status |
Code providing status information for this segment. Refer to OpenTravel Code List Status (STS). | OTA_CodeType |
E_TicketEligibility |
Specifies whether a flight segment is eligible for electronic ticketing. | BookFlightSegmentType_E_TicketEligibility |
DepartureDay |
Departure Day | DayOfWeekType |
ConnectionType |
Used for Character Strings, length 0 to 8. | StringLength1to8 |
ValidConnectionInd |
When true, this flight segment constitutes a valid connection. | Boolean |
Name | Description | Type |
LocationCode |
Location code used to identify a specific airport. | String |
CodeContext |
Identifies the context of the identifying code, such as IATA, ARC, or internal code, etc. | String |
Name | Description | Type |
LocationCode |
Location code used to identify a specific airport. | String |
CodeContext |
Identifies the context of the identifying code, such as IATA, ARC, or internal code, etc. | String |
Name | Description | Type |
CompanyShortName |
Used to provide the company common name. | StringLength1to32 |
Code |
Identifies a company by the company code. | StringLength1to32 |
Name | Description | Type |
PTC_FareBreakdowns |
This is a collection of PTC Fare Breakdowns. | AirItineraryPricingInfoType-PTC_FareBreakdowns |
ItinTotalFare |
Total price of the itinerary. | AirItineraryPricingInfoType |
FareInfos |
This is a collection of FareInfo | AirItineraryPricingInfoType |
Name | Description | Type |
GrandTotal |
Total Price | Element |
GrandTaxTotal |
Total Tax | Element |
PTC_FareBreakdown |
Per passenger type code pricing for a travel itinerary. Per passenger type code pricing for this itinerary. Set if fareBreakdown was requested. | PTCFareBreakdownType |
Name | Description | Type |
PassengerFare |
The total passenger fare with cost breakdown. | FareType |
PassengerTypeQuantity |
Specifies a PTC and the associated number of PTC's - for use in specifying passenger lists. | String |
FareInfo |
Detailed information on individual priced fares. | FareInfoType |
Name | Description | Type |
BaseFare |
Price of the inventory excluding taxes and fees. | Element |
Taxes |
collection of Taxes | Element |
Fees |
collection of Fees | Element |
TotalFare |
The total price that the passenger would pay (includes fare, taxes, fees) | Element |
Name | Description | Type |
CurrencyCode |
An ISO 4217 (3) alpha character code that specifies a monetary unit. | AlphaLength3 |
Amount |
A monetary amount. | Money |
Name | Description | Type |
AirTraveler |
Identifies passenger(s) who will travel on the reservation. | AirTravelerType |
SpecialReqDetails |
Provides detailed information regarding any special needs, requests, or remarks associated with the traveler | SpecialReqDetailsType |
Name | Description | Type |
PassengerTypeCode |
Code used to indicate the type of traveler that will be traveling (e.g., ADT, CHD, INF, GRP). | AlphaLength3 |
BirthDate |
Traveler's date of birth. | date |
AccompaniedByInfantInd |
Indicates if an infant accompanying a traveler is with or without a seat. | Boolean |
GroupInd |
Traveler group indicator. | Boolean |
Gender |
Identifies the gender. | NMTOKEN |
ProfileRef |
Stored information about a customer. May contain readily available information relevant to the booking. | AirTravelerType-ProfileRef |
Name | Description | Type |
UniqueID |
An identifier used to uniquely reference a customer profile. An identifier used to uniquely reference an object in a system (e.g. an airline reservation reference, customer profile reference, booking confirmation number, or a reference to a previous availability quote). | UniqueID_Type |
Name | Description | Type |
ID |
A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation. | StringLength1to32 |
Type |
A reference to the type of object defined by the UniqueID element. Refer to OpenTravel Code List Unique ID Type | OTA_CodeType |
Name | Description | Type |
Status |
Code providing status information for this special service request. Refer to OTA Code List 'Status' (STS). | OTA_CodeType |
TravelerRefNumberRPHList |
One or more travelers to whom this request applies | ListOfRPH |
FlightRefNumberRPHList |
One or more flights to whom this request applies | ListOfRPH |
SSRCode |
The four alpha position industry code identifying a particular type of special service request. | AlphaLength4 |
Name | Description | Type |
PaymentDetails |
Container for Payment Detail. | FulfillmentType-PaymentDetails |
Name | Description | Type |
PaymentDetail |
Form of payment details for the requested booking. It is possible to use multiple forms of payment for one transaction, therefore this element may be used more than once. | PaymentDetail |
Name | Description | Type |
RPH |
Provides a reference to a specific form of payment. | RPH_Type |
PaymentTransactionTypeCode |
This is used to indicate either a charge, reserve (deposit) or refund. | NMTOKEN |
Remark |
A remark associated with the payment form. | StringLength1to128 |
PaymentType |
Used to specify the form of payment. Refer to OpenTravel Code List Payment Type | OTA_CodeType |
LoyaltyRedemption |
Details of a loyalty redemption arrangement. This is normally miles or points. | PaymentDetail |
PaymentAmount |
Provides the monetary amount due for payment as quoted. A second instance could show the actual paid amount in a different currency. | PaymentDetailType-PaymentAmount |
PaymentCard |
Details of a debit or credit card. Specific payment card information. | PaymentCardType |
Name | Description | Type |
Amount |
A monetary amount. | Money |
CurrencyCode |
An ISO 4217 (3) alpha character code that specifies a monetary unit. | AlphaLength3 |
DecimalPlaces |
The ISO 4217 standard "minor unit" for the number of decimal places for a particular currency. | nonNegativeInteger |
Name | Description | Type |
Code |
Bank identifier | string |
Description |
Card type (Master or visa or..) | string |
List_PaymentCardIssuer_Basex |
Card issuer. Current usage value is always OTHER_ | string |
Explanationx |
Not used yet | not used yet |
Name | Description | Type |
TotalFltSegQty |
baggageAmount | Numeric0to99 |
EMD_Type |
EMD-A, EMD-S | EMD_Type_EMD_Type |
RPH |
Provides a reference to a specific EMD. | RPH_Type |
TravelerRefNumber |
The original ticket/document issue information. | EMD_Type-OriginalIssueInfo |
Commission |
Commission information for this ticket/document. | EMD_Type-Commission |
TotalFare |
Used to specify tax coupon information. | EMD_Type-TaxCouponInformation |
FareInfo |
The reason for issuance information. | EMD_Type-ReasonForIssuance |
TicketDocument |
Provides a reference to a specific EMD. | RPH_Type |
Name | Description | Type |
RPH |
A unique reference for the traveler. | RPH_Type |
Name | Description | Type |
baggageItems |
diplays each segment and each passenger baggage allowance | element |
Name | Description | Type |
boardPoint |
SVC segment board point | string |
carrierCode |
airline carrier identification (2chars) | string |
couponIndex |
SVC EMD couponIndex | string |
date |
date of SVC | string |
descriptionOfRfisc |
descriptionOfRfisc | string |
emdNo |
emdNo of svc | string |
numberOfServices |
numberOfServices | string |
passengerAssociation |
related passenger | string |
reasonForIssuanceCode |
reasonForIssuanceCode | string |
reasonForIssuanceSubCode |
reasonForIssuanceSubCode | string |
segmentNumber |
segmentNumber | string |
status |
status | string |
svcField |
svcField explanation | string |
weekDay |
weekDay | string |
Name | Description | Type |
isPurged |
true, if pnr purged | boolean |
isITTReservation |
true, if reservation ITT | boolean |
isOriginalITTReservation |
true, if Pnr created by ITT | boolean |
isCircleItinerary |
true, if circle flight | boolean |
isAward |
true, if award ticket | boolean |
isInvoluntary |
true, if involuntary | boolean |
pnrOwner |
pnr owner code | string |
isVIPIncluded |
true, if pnr is VIP | boolean |
FQdateTime |
FQ date time | string |
Name | Description | Type |
FlightSegment |
Itinerary | Element |
Name | Description | Type |
Chain_Order |
If there is one or more WKSC segment then chain_order shows Trophy chain order info | string |
Chain_Number |
If there is one or more WKSC segment then chain_number shows Trophy chain number info | string |
RPH |
If there is one or more WKSC segment then RPH shows segment info filled by Trophy | string |
Name | Description | Type |
Warning |
Used in conjunction with the Success element to define a business error. | WarningType |
Description |
Not used yet |
Name | Description | Type |
Value |
warning for reissue or SPA | string |
Type |
warning for reissue or SPA | string |
Description |
warning for reissue or SPA | string |
Tag |
warning for reissue or SPA | string |
Name | Description | Type |
CabinType |
Used to provide the company common name. | StringLength1to32 |
Name | Description | Type |
CabinType |
Used for Arrival Unknown segment | StringLength1to32 |
Name | Description | Type |
CurrencyCode |
The code specifying a monetary unit. Use ISO 4217, three alpha code. | AlphaLength3 |
DecimalPlaces |
Indicates the number of decimal places for a particular currency. This is equivalent to the ISO 4217 standard "minor unit". Typically used when the amount provided includes the minor unit of currency without a decimal point (e.g., USD 8500 needs DecimalPlaces="2" to represent $85). | nonNegativeInteger |
Amount |
Payment amount | Money |
Name | Description | Type |
CurrencyCode |
The code specifying a monetary unit. Use ISO 4217, three alpha code. | AlphaLength3 |
DecimalPlaces |
Indicates the number of decimal places for a particular currency. This is equivalent to the ISO 4217 standard "minor unit". Typically used when the amount provided includes the minor unit of currency without a decimal point (e.g., USD 8500 needs DecimalPlaces="2" to represent $85). | nonNegativeInteger |
Amount |
Tax amount | Money |
Name | Description | Type |
CurrencyCode |
The code specifying a monetary unit. Use ISO 4217, three alpha code. | AlphaLength3 |
DecimalPlaces |
Indicates the number of decimal places for a particular currency. This is equivalent to the ISO 4217 standard "minor unit". Typically used when the amount provided includes the minor unit of currency without a decimal point (e.g., USD 8500 needs DecimalPlaces="2" to represent $85). | nonNegativeInteger |
Amount |
A monetary amount. | Money |
Name | Description | Type |
Tax |
Any individual tax applied to the fare | Element |
Amount |
A monetary amount. | Money |
Name | Description | Type |
Fee |
Any individual fee applied to the fare | Element |
Name | Description | Type |
Code |
Refer to OTA Code List Age Qualifying Code (AQC) or use StringLength1to8 with CodeContext to use a non-OTA code. | Simple Type Union |
Quantity |
Used to define the quantity for an associated element or attribute. | nonNegativeInteger |
Name | Description | Type |
TariffNumber |
The tariff number for the rule. For YUS and YDUS project this area will be used for defination of the brand Code: For ex. If we expand the meaning of BFXF brand, BF means BrandFare and XF means Extra Fly. Then TariffNumber shows "EXTRA FLY" | AlphaNumericStringLength1to8 |
RuleNumber |
The number associated with the fare rule. Same logic with tariffNumber tihs area also used for YUS and YDUS for initial code of brand. For example RuleNumber="XF" means for TariffNumber: "Extra Fly" | AlphaNumericStringLength1to8 |
RPH |
Fare segment relation | String |
Name | Description | Type |
NamePrefix |
Salutation of honorific. (e.g., Mr. Mrs., Ms., Miss, Dr.) | StringLength1to16 |
GivenName |
Given name, first name or names | StringLength1to64 |
Surname |
Family name, last name. | StringLength1to64 |
Name | Description | Type |
CardCode |
The 2 character code of the credit card issuer. | PaymentCardCodeType |
Remark |
remark | StringLength1to128 |
CardType |
Indicates the type of magnetic striped card. Refer to OTA Code ListCard Type (CDT). | OTA_CodeType |
|
Order id bu parametreye set edilir | string |
CardNumber |
Credit card number embossed on the card.Secure information that supports PCI tokens, data masking and other encryption methods. | EncryptionTokenType |
Name | Description | Type |
FlightSegmentRefNumber |
Specifies one or more segment numbers for ticketing purposes. This RPH is associated with the RPH contained in the FlightSegment element in AirBookRQ. | ListOfRPH |
MiscTicketingCode |
Specifies one or more ticketing relevant codes. Refer to OpenTravel code list Misc Ticketing Code (MTC).List of OpenTravel Codes. | OTA_CodeType |
TicketDocumentNbr |
The ticket document number including the airline code, the form code, and the serial number. | StringLength1to16 |
TicketType |
TicketType - Indicates the type of ticket (Paper, eTicket) | TicketType |
TravelerRefNumber |
Specifies one or more traveler names for ticketing purposes. This RPH is associated with the RPH contained in the TravelerRefNumber element in AirBookRQ. | ListOfRPH |
PseudoCityCode |
An identification code assigned to an office/agency by a reservation system. | StringLength1to16 |
CancelOnExpiryInd |
When true, unticketed bookings should be cancelled when the TicketTimeLimit has expired. | boolean |
Name | Description | Type |
PlainText |
Non-secure (plain text) value. | string |
Name | Description | Type |
Type |
A reference to the type of object defined by the UniqueID element. Refer to OpenTravel Code List Unique ID Type (UIT). | OTA_CodeType |
ID |
A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation. | StringLength1to32 |
Comment |
comment | Element |
Name | Description | Type |
Value |
A comment applicable to all the pricing information.Textual information to provide descriptions and/or additional information. | string |
Name | Description | Type |
CompanyInfo |
Name and contact person information for the company associated with the air travel.Identifies a company by name. | CompanyNameType |
Name | Description | Type |
Code |
Identifies a company by the company code. | StringLength1to16 |
Name | Description | Type |
|
passenger's email | string |
emailLanguage |
email settings | string |
mobilePhone |
passenger's phone | string |
name |
passenger name | string |
passengerIndex |
passenger index | string |
receiveSMS |
passenger SMS preference(true or falce9 | string |
receiveSMSLanguage |
SMS language setting | string |
Name | Description | Type |
CurrencyCode |
Fare Currency | StringLength1to16 |
Amount |
Fare Amount |
Name | Description | Type |
TicketDocumentNbr |
Document number comprised of the airline code, form code, and serial number. | StringLength1to16 |
Name | Description | Type |
CurrencyCode |
An ISO 4217 (3) alpha character code that specifies a monetary unit. | AlphaLength3 |
DecimalPlaces |
The ISO 4217 standard "minor unit" for the number of decimal places for a particular currency. | nonNegativeInteger |
Amount |
A monetary amount. | Money |
Name | Description | Type |
TaxCode |
Identifies the code for the tax. | StringLength1to16 |
TaxTransactionType |
PAID or UNPAID | |
CurrencyCode |
The code specifying a monetary unit. Use ISO 4217, three alpha code. | AlphaLength3 |
DecimalPlaces |
Indicates the number of decimal places for a particular currency. This is equivalent to the ISO 4217 standard "minor unit". Typically used when the amount provided includes the minor unit of currency without a decimal point (e.g., USD 8500 needs DecimalPlaces="2" to represent $85). | nonNegativeInteger |
Amount |
A monetary amount. | Money |
Name | Description | Type |
FeeCode |
Identifies the code for the fee. | StringLength1to16 |
CurrencyCode |
The code specifying a monetary unit. Use ISO 4217, three alpha code. | AlphaLength3 |
DecimalPlaces |
Indicates the number of decimal places for a particular currency. This is equivalent to the ISO 4217 standard "minor unit". Typically used when the amount provided includes the minor unit of currency without a decimal point (e.g., USD 8500 needs DecimalPlaces="2" to represent $85). | nonNegativeInteger |
Amount |
A monetary amount. | Money |
Name | Description | Type |
SpecialServiceRequests |
A collection of Special Service Request | Element |
OtherServiceInformations |
Collection of PNR,OSI | Element |
SeatRequests |
A collection of Seat Request | Element |
Name | Description | Type |
SpecialServiceRequest |
Special Service Requests (SSR) for this booking | SpecialServiceRequestType |
Name | Description | Type |
SeatRequest |
Seating requests for each passenger for each air leg of this trip. | SeatRequestType |
Name | Description | Type |
Status |
Code providing status information for this special service request. Refer to OTA Code List 'Status' (STS). | OTA_CodeType |
RowNumber |
Sequence number of a row. | Numeric1to999 |
SeatInRow |
Seat number within a row.Used for an Alpha String, length exactly 1. | AlphaLength1 |
SmokingAllowed |
Indicates smoking is allowed when true and is not allowed when false. | boolean |
TravelerRefNumberRPHList |
One or more travelers to whom this request applies | ListOfRPH |
FlightRefNumberRPHList |
One or more flights to whom this request applies | ListOfRPH |
Name | Description | Type |
Code |
A proprietary code used between systems to identify an other service information item. | AlphaLength4 |
RPH |
Unique value associated with the OSI. | RPH_Type |
Text |
The OSI text. | StringLength1to64 |
Name | Description | Type |
OtherServiceInformation |
Other Service Information (OSI) for relevant airlines | OtherServiceInfoType |
Name | Description | Type |
allowedPiece |
allowence for piece | string |
allowedWeight |
allowence for piece. if allowed piece exists; allowed weight not seen | string |
measureType |
PC for PIECE,K or KG for Kilogram measures identified here | string |
paxIndex |
passenger index | string |
segmentIndexList |
segment index | string |
Name | Description | Type |
Value |
Provides text and indicates whether it is formatted or not. | FormattedTextTextType |
Name | Description | Type |
Comment |
A comment applicable to all the pricing information.Textual information to provide descriptions and/or additional information. | FormattedTextTextType |
Code | Description | Detailed Description |
90000 |
SURNAME_NOT_VERIFIED_FOR_PNR | The surname parameter sent does not match PNR number /Gonderilen soyadi parametresi PNR numarasiyla eslesmemektedir |
10006 |
UNABLE_TO_RETRIEVE_PNR | UNABLE_TO_RETRIEVE_PNR |
28002 |
TROYA_TERMINAL_EXCEPTION | "There was an error while connecting to Troya reservation system, it is likely to be a momentary error. We recommend that you try again with the same request. In the case of continuity, you can contact the BWS team with your CTID information." |
10002 |
TROYA_RESPONSE_EXCEPTION | Please contact BWS team with CTID of your request. / CtId bilgisi ile birlikte BWS ekibine basvurabilirsiniz. |
17059 |
PNR_RETRIEVAL_ERROR | PNR_RETRIEVAL_ERROR |
14037 |
UNABLE_TO_PARSE_PNR | UNABLE_TO_PARSE_PNR |
99999 |
UNKNOWN_ERROR | UNKNOWN_ERROR |
99993 |
javax.validation.constraints.Pattern | Asagidaki alan uygun olmayan karakterler icermektedir. İnceleme yapilmasi isteniyorsa clientTransactionId bilgisiyle birlikte BWS ekibi ile iletisime gecilmesi gerekmektedir. |
10035 |
UNABLE_TO_RETRIEVE_PNR_FROM_TROYA_AND_TROPHY | PNR and surname cannot be found in our reservation system./ Girilmis olan PNR ve surname bilgileriyle rezervasyon sistemimizde herhangi bir kayit bulunamamaktadir. |
12022 |
PNR_NUMBER_NOT_VALID | "The 6-digit PNR number in your reservation information has been sent incorrectly. The PNR number starting with the letters R, S, T, U, V must be sent as stated in the reservation." |
29036 |
INCONSISTENT_FARE_RESULT | INCONSISTENT_FARE_RESULT |
30123 |
MISMATCH_NAME_OR_SURNAME | Name or surname mismatch / İsim veya soyisim hatali. |
93006 |
PASSENGER_NAME_SURNAME_MISSING | Passenger name or surname is missing in request / Requestte yolcu ismi veya soyismi eksik |
{
"requestHeader": {
"clientUsername": "OPENAPI",
"channel": "WEB",
"clientTransactionId": "CLIENT_TEST_1",
"airlineCode": "TK"
},
"retrieveReservationOTARequest": {
"UniqueId" : "TT8VN8",
"Surname": "CELIKTAS"
}
}
Sample Request for Websdom Clients
{
"requestHeader": {
"clientTransactionId": "test--retrieve-open0api0002",
"clientUsername": "WEBSDOM",
"channel": "WEB",
"airlineCode": "TK"
},
"retrieveReservationOTARequest": {
"UniqueId": "UTRXLU",
"Surname": "OZKARALI",
"GivenName": "IREM"
}
}
{
"status": "SUCCESS",
"requestId": "000001683b929326-17b17c5",
"message": {
"code": "TK-0000",
"description": "Request Processed Successfully."
},
"data": {"retrieveReservationOTAResponse": {
"svc": "",
"reservationInfoOTAResponse": {
"isVIPIncluded": false,
"isPurged": true,
"isOriginalITTReservation": true,
"isAward": false,
"pnrOwner": "ITT",
"isITTReservation": true,
"isInvoluntary": false,
"isCircleItinerary": false
},
"baggage": "",
"contact": {
"emailLanguage": "EN",
"mobilePhone": "1111111111",
"name": "B******",
"email": "****@*****.***",
"receiveSMS": true,
"passengerIndex": "1",
"receiveSMSLanguage": "EN"
},
"WKSC_Info": "",
"OTA_AirBookRS": {
"Version": "0",
"RetransmissionIndicator": false,
"AirReservation": {
"Fulfillment": {"PaymentDetails": {"PaymentDetail": [
{
"PaymentType": "REND",
"RPH": "[1]",
"PaymentAmount": {
"DecimalPlaces": "0",
"Amount": "0"
}
},
{
"PaymentCard": {
"CardNumber": {"PlainText": "561059******8250"},
"Email": "",
"CardType": {
"Explanationx": "",
"Description": "Master Card",
"List_PaymentCardIssuer_Basex": "Other_",
"Code": "IS"
},
"CardCode": "CA",
"Remark": "CC"
},
"PaymentType": "VPOS",
"RPH": "[1]",
"PaymentAmount": {
"CurrencyCode": "TRY",
"DecimalPlaces": "2",
"Amount": "1745.61"
}
}
]}},
"Ticketing": {
"MiscTicketingCode": "2352311438683C1 2352311438683C2",
"CancelOnExpiryInd": false,
"TravelerRefNumber": "1",
"FlightSegmentRefNumber": "1 2",
"TicketType": "eTicket",
"TicketDocumentNbr": "2352311438683",
"PseudoCityCode": "ITT"
},
"PricingOverview": {"Comment": [
{
"Description": "",
"Value": ".. LDTP IST(02-05-2017 06:44) ITTITSU28APR"
},
{
"Description": "",
"Value": ".. 1493385405143TT8VN8E0G51N ITTITSU28APR"
},
{
"Description": "",
"Value": "CCHEMAIL/****@*****.*** ITTITSU28APR"
},
{
"Description": "",
"Value": ".. ET/ELECTRONIC COMMERCE ITTITSU28APR"
},
{
"Description": "",
"Value": ".. 1493385704659TT8VN8E0G51S ITTITSU28APR"
},
{
"Description": "",
"Value": ".. ET/ELECTRONIC COMMERCE ITTITSU28APR"
}
]},
"BookingReferenceID": [
{
"Type": "PNR",
"ID": "TT8VN8"
},
{
"Type": "RECORDKEY",
"ID": "1493385704659TT8VN8E0G51S"
},
{
"Type": "REFERENCE",
"ID": "TT8VN8TT8VN8"
}
],
"CreateDateTime": "28Apr2018",
"TravelerInfo": {
"SpecialReqDetails": {"SpecialServiceRequests": {"SpecialServiceRequest": [
{
"FlightRefNumberRPHList": "1",
"Number": "3",
"SSRCode": "TKNE",
"TravelerRefNumberRPHList": "1",
"Text": "2352311438683C1"
},
{
"FlightRefNumberRPHList": "2",
"Number": "3",
"SSRCode": "TKNE",
"TravelerRefNumberRPHList": "1",
"Text": "2352311438683C2"
}
]}},
"AirTraveler": {
"Comment": {
"Description": "",
"Value": "VALID_IDENTITY_NUMBER",
"Name": "VALIDATION"
},
"ProfileRef": {"UniqueID": {
"Type": "ADULT",
"ID": "1"
}},
"PersonName": {
"NamePrefix": "MR",
"GivenName": "B******",
"Surname": "C******"
},
"Email": {
"Description": "",
"Value": "****@*****.***",
"Remark": "EN"
},
"Telephone": {
"PhoneNumber": "1111111111",
"PhoneUseType": "M",
"Remark": "SMS:EN"
},
"PassengerTypeQuantity": {"Quantity": "1"},
"GroupInd": false,
"AccompaniedByInfantInd": false,
"Gender": "MALE",
"PassengerTypeCode": "ADULT",
"Document": [
{
"DocID": "0",
"Remark": "TCKN"
},
{
"DocHolderFormattedName": {
"GivenName": "B******",
"Surname": "C******"
},
"DocID": "",
"DocHolderNationality": "",
"DocIssueCountry": "",
"Gender": "M",
"DocType": "P",
"BirthDate": "2000-01-01+02:00",
"Remark": "DOCS"
}
],
"CustLoyalty": {
"MembershipID": "309790080",
"ProgramID": "TK"
}
}
},
"ArrangerInfo": {"CompanyInfo": {
"CompanyShortName": "ITT",
"Description": "",
"Code": "ITTTKIT"
}}
},
"Warnings": {"Warning": {
"Type": "",
"Description": "",
"Value": false,
"Tag": "REISSUED"
}},
"TimeStamp": "2019-01-16T10:34:22.531+03:00"
}
}}
}
You can find how to test an API in documentation page.
API URL : https://api.turkishairlines.com