TAIS CRS Web Services (TCWS) is a standard interface implementing the most important functions of TAIS CRS (legacy name Sirena-2.3). A similar product is available for TAIS DCS (legacy name Regina). At the moment, the following features of TAIS CRS are supported:
The interface can be used for different purposes, for example:
TCWS is a SOAP server. Access to Test (Integration) and Production Systems is provided to each customer. You will receive URLs (“WebServiceURL” in the examples below), and possibly Login + Password for http authentication (depending on security level agreed on). At the moment, TAIS doesn’t employ WS Security.
Once having access to Test or Production System, you can readily request WSDL. Such request follows the standard pattern:
WebServiceURL/sigws/Action/SIRENA.Input/SIRENA.Output?WSDL
Case matters!
where:
WebServiceURL – customer-specific part of WSDL address
Action – operation name
Input – name of request root element (the one immediately following the <soapenv:Body> tag)
Output – name of response root element (the one immediately following the <soapenv:Body> tag)
For example:
https://sigtest.tais.ru/sigws/SciGetPNR/SIRENA.SCILOCATOR/SIRENA.SCIPNR?WSDL
or
http://109.73.1.66:23002/cgi/sirena23.cgi/sigws/SciGetPNR/SIRENA.SCILOCATOR/SIRENA.SCIPNR?WSDL
Below is a table of supported operations and the related root elements.
# |
Action |
Input |
Output |
Comment |
1 |
SciGetAvailabiltiy |
SCIAVLQRY |
SCIAVLRPL |
OW or RT availability search for a city pair |
2 |
SciGetAvailableFares |
SCIAVAILFARESQRY |
SCIAVAILFARESRPL |
Combined Availability and Fare Search |
3 |
SciCreatePNR |
SCIPNRCREATEDATA |
SCIPNR |
PNR creation in one step, including SSR etc |
4 |
SciGetPNR |
SCILOCATOR |
SCIPNR |
PNR retrieval |
5 |
SciPNRFareQuote |
SCIPNRFAREQUOTEQRY |
SCIFAREQUOTERPL |
PNR pricing |
6 |
SciTicketIssue |
SCITICKETISSUEQRY |
SCIDOCSET |
Ticket issuance |
7 |
SciTicketVoid |
SCITICKETVOIDQRY |
SCIDOCSET |
Ticket void |
8 |
SciPNRExchangeQuote |
SCIPNREXCQUOTEQRY |
SCIEXCQUOTERPL |
Ticket Exchange Quote |
9 |
SciTicketExchange |
SCITICKETEXCQRY |
SCIDOCSET |
Ticket Exchange |
10 |
SciRefundQuote |
SCIRFNDQUOTEQRY |
SCIRFNDQUOTERPL |
Ticket Refund Quote |
11 |
SciTicketRefund |
SCIRFNDQUOTEQRY |
SCIRFNDQUOTERPL |
Ticket Refund |
WSDL advises the endpoint location and provides the essential information regarding the request and response format. The endpoint address is constructed as follows:
WebServiceURL/sigws/Action.wsdl
Following the examples above, the endpoint addresses would be:
https://sigtest.tais.ru/sigws/SciGetPNR.wsdl
or
http://109.73.1.66:23002/cgi/sirena23.cgi/sigws/SciGetPNR.wsdl
A sample request sent to the first endpoint of the above might look as follows:
What you will find below is mainly description of xml requests and responses. As TCWS is virtually attribute-free, it will be mainly description of elements. The description always begins with the root element and then lists the immediate child elements either by reference (E1_2) or complete explanation. In either case, the list of child elements looks as follows:
Name |
Type |
ST |
RP |
Comment |
AVLQRY |
n/a |
M |
1 |
See below E1_2) |
where:
Name – element name
Type – element data type (in xsd terms)
ST – element status (M – mandatory, O – optional, NA - not allowed)
RP – maximum number of repetitions (blank – unlimited)
Comment – for elements that do have child elements, this will show reference to element’s own description (like in the example above, where AVLQRY has child elements). For elements that don’t have child elements, complete description is provided, for example:
Name |
Type |
ST |
RP |
Comment |
DEPPOINT |
string |
M |
1 |
Departure city or airport code. Use IATA or STC (TCH) code. Specifying part of the name (Russian or English) is also allowed. |
As this document is aimed at both Cyrillic and English users, code sets in both languages are provided where applicable as follows:
Flight Type:
C |
E |
Explanation |
Н |
N |
only Non-stop flights |
П |
D |
only Direct flights |
where:
C – Cyrillic Code
E – English Code
SciGetAvailabiltiy returns flight availability for the specified search criteria.
The minimum set of the required data in the request includes Departure Point, Arrival Point, Departure Date. You can add other preferences as needed.
The response will contain schedule and availability data for all flights matching the filters. In addition, it will provide comprehensive reference data (full names and other details) on all Carriers, Equipment Types and Points present in the response.
WSDL for SciGetAvailability is as follows:
WebServiceURL/sigws/SciGetAvailability/SIRENA.SCIAVLQRY/SIRENA.SCIAVLRPL?WSDL
E1_1) SIRENA.SCIAVAILQRY: The root element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
AVLQRY |
n/a |
M |
1 |
See below E1_2) |
E1_2) AVLQRY: Group of search criteria.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | ||||||||||||||||||||||||||||||||||||||||||
DEPPOINT |
string |
M |
1 |
Departure city or airport code. Use IATA or STC (TCH) code. Specifying part of the name (Russian or English) is also allowed. | ||||||||||||||||||||||||||||||||||||||||||
ARRPOINT |
string |
M |
1 |
Arrival city or airport code. Use IATA or STC (TCH) code. Specifying part of the name (Russian or English) is also allowed. | ||||||||||||||||||||||||||||||||||||||||||
ROUTETYPE |
string |
O |
1 |
Journey type: OW – one-way RT – round-trip | ||||||||||||||||||||||||||||||||||||||||||
DATEOUT |
dateTime |
M |
1 |
Departure date for outbound flight | ||||||||||||||||||||||||||||||||||||||||||
DATEBACK |
dateTime |
O |
1 |
Departure date for return flight. Use only if ROUTETYPE=’RT’ | ||||||||||||||||||||||||||||||||||||||||||
NODAYS |
short |
O |
1 |
Number of days to perform the search for. If specified, the search will be done for the range [DATEOUT; DATEOUT+NODAYS]. The same applies to DATEBACK | ||||||||||||||||||||||||||||||||||||||||||
NOSEATS |
short |
O |
1 |
Number of seats. Flights / RBD with availability less than NOSEATS will be excluded from the response | ||||||||||||||||||||||||||||||||||||||||||
TIMEOUTMIN TIMEOUTMAX |
long |
O |
1 |
Departure time range for outbound flight. Provide range limits as numbers of seconds after 00:00 of DATEOUT | ||||||||||||||||||||||||||||||||||||||||||
TIMEBACKMIN TIMEBACKMAX |
long |
O |
1 |
Departure time range for return flight. Provide range limits as numbers of seconds after 00:00 of DATEBACK | ||||||||||||||||||||||||||||||||||||||||||
AK |
string |
O |
1 |
Carrier code. Use IATA or STC (TCH) code. | ||||||||||||||||||||||||||||||||||||||||||
SERVCLASS |
string |
O |
1 |
Service class code: П/Б/Э F/C/Y (only for English users!) | ||||||||||||||||||||||||||||||||||||||||||
DIRECTONLY |
short |
O |
1 |
obsolete | ||||||||||||||||||||||||||||||||||||||||||
FLAGS |
string |
O |
1 |
Additional preferences (modifiers of СМ/AD entry in TAIS CRS). Provide as many modifiers as needed without separators (e.g., ‘NO’). Please note that in the explanation below both Cyrillic (C) and English (E) codes are provided. Cyrillic codes are available to all users. English codes are available only to English users!
|
E1_21) SCIAVLRPL: The root element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
AVLQRY |
n/a |
M |
1 |
See below E1_22) |
COMPANYLKP |
n/a |
M |
|
Carrier reference data. For explanation, please refer to the relevant sciWhat section (TBA) |
FLIGHT |
n/a |
M |
|
See below E1_23) |
FLIGHTAVL |
n/a |
M |
|
See below E1_24) |
PLANETYPELKP |
n/a |
M |
|
Equipment Type reference data. For explanation, please refer to the relevant sciWhat section (TBA) |
TOWN |
n/a |
M |
|
Point reference data. For explanation, please refer to the relevant sciWhat section (TBA) |
E1_22) AVLQRY: Information on usage of external (in relation to TAIS CRS) availability sources.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
RSSLINKDOWN |
short |
M |
1 |
Gallileo RSS link availability flag 0 – link available 1 – link down
|
E1_23) FLIGHT: Schedule and general data for a flight.
Attributes: none.
Elements:
Please note that code sets used in the response will depend on your language settings. For Cyrillic users, STC (TCH) Cyrillic codes will be used if available. If not, IATA codes will be used. For English users, the response will always show IATA codes.
Name |
Type |
ST |
RP |
Comment | ||||||||||||
ORDERNO |
short |
M |
1 |
First part of the unique FLIGHT element reference within the response. The complete reference consists of ORDERNO and POSINROUTE. When a connection (two or more connecting flights) is returned in the response, all flights of the connection have the same ORDERNO but different POSINROUTE (see below). | ||||||||||||
POSINROUTE |
short |
M |
1 |
Second part of the unique FLIGHT element reference within the response. The complete reference consists of ORDERNO and POSINROUTE. When a connection (two or more connecting flights) is returned in the response, all flights of the connection have the same ORDERNO but different POSINROUTE (see below). POSINOUTE numbering begins with 1. For direct flights, this element value is always 0. | ||||||||||||
AK |
string |
M |
1 |
Marketing carrier code | ||||||||||||
OAK |
string |
O |
1 |
Operating carrier code (for code-share flights only) | ||||||||||||
FLIGHTNO |
string |
M |
1 |
Flight number | ||||||||||||
DEPDATE |
date |
M |
1 |
Departure date | ||||||||||||
TOS |
string |
O |
1 |
Type of service:
| ||||||||||||
PLANETYPE |
string |
M |
1 |
Equipment type | ||||||||||||
DEPARPT |
string |
M |
1 |
Departure airport code | ||||||||||||
DEPTERM |
string |
O |
1 |
Departure terminal code | ||||||||||||
ARRARPT |
string |
M |
1 |
Arrival airport code | ||||||||||||
ARRTERM |
string |
O |
1 |
Arrival terminal code | ||||||||||||
DEPTIME |
long |
M |
1 |
Departure time. Number of seconds after 00:00:00 of DEPDATE | ||||||||||||
ARRTIME |
long |
M |
1 |
Arrival time. Number of seconds after 00:00:00 of DEPDATE | ||||||||||||
CHECKINTIME |
long |
M |
1 |
Check-in start time. Number of seconds after 00:00:00 of DEPDATE | ||||||||||||
DEPTIMEGMT |
long |
M |
1 |
Departure time in GMT/UTC. Number of seconds after 00:00:00 of DEPDATE. Can be negative. | ||||||||||||
ARRTIMEGMT |
long |
M |
1 |
Arrival time in GMT/UTC. Number of seconds after 00:00:00 of DEPDATE. Can be negative. | ||||||||||||
NOSTOPS |
short |
O |
1 |
Number of intermediate stops. This is used only for flights with the same flight number and one or several scheduled landings in the route. Not to be confused with connections, which consist of different flight numbers and therefore are shown as separate FLIGHT elements. | ||||||||||||
MEAL |
string |
O |
1 |
Currently not used | ||||||||||||
INVGRD INVORG |
string string |
O |
1 |
Code of the flight inventory system (e.g., MUC1A). Normally blank for TAIS-hosted airline projects. | ||||||||||||
ACCESSLEVEL |
short |
M |
1 |
Flight inventory access level (for booking): 0 – unavailable 1 – standard (teletype) 2 – interactive 3 – local TAIS CRS host | ||||||||||||
LINKSTATUS |
short |
M |
1 |
Flight availability source link status: 0 – no link 1 – link down 2 – link up 3 – local TAIS CRS host | ||||||||||||
AVLSOURCE |
short |
M |
1 |
Availability source type: 0 – no availability data 1– Segment AVS (offline data based on processing of teletype Availability Status Messages which tell that seats are available but don’t tell how many) 2– Numeric AVS (offline data based on processing of teletype Availability Status Messages which tell how many seats are available) 3 – cached real-time data from airline host 4 – real-time data from airline host |
E1_24) FLIGHTAVL: Availability data for one booking class (RBD).
Attributes: none.
Elements:
Please note that code sets used in the response will depend on your language settings. For Cyrillic users, STC (TCH) Cyrillic codes will be used if available. If not, IATA codes will be used. For English users, the response will always show IATA codes.
Name |
Type |
ST |
RP |
Comment |
ORDERNO |
short |
M |
1 |
First part of the unique reference to the FLIGHT element within the response.
|
POSINROUTE |
short |
M |
1 |
Second part of the unique reference to the FLIGHT element within the response
|
RBD |
string |
M |
1 |
Booking class |
SERVCLASS |
string |
M |
1 |
Service class |
NOSEATS |
string |
M |
1 |
Seat availability 1-9 – no less than the number of seats shown 0 – no seats, waitlist open R – on request С – no seats, waitlist closed X – flight/class canceled |
SciGetAvailableFares returns flight availability and the applicable fares for the specified search criteria.
The minimum set of the required data in the request includes Departure Point, Arrival Point, Departure Date. You can add other preferences as needed.
The request is “per segment” in essence. That is, if you search for a round trip ADA-IST-ADA, you should send 2 requests – one for the outbound (ADA - IST) and one for the return (IST - ADA) flight.
However, it will return both OW and RT/2 fares in the response, and validate Fare Rules in accordance with your search criteria. This is how you should understand all data related to the “retrun flight” in the description – all such data is for Fare Rule validation only.
The request is also “per passenger type”. That is, you have to send 2 separate requests for adult and infant. But normally this is not something that you do, as SciGetAvailableFares is a request sent on the first step of the booking process when only adult price (with our without taxes) is required.
The response will contain schedule, availability data and fare data matching the filters. In addition, it will provide comprehensive reference data (full names and other details) on all Carriers, Currencies, Equipment Types and Points present in the response.
The most important elements are FLIGHT, FLIGHTAVL, FARE, FAREAVL. FLIGHT contains generalt flight details. FLIGHTAVL contains availability for each booking class. FARE contains fare (tax, etc) data, and FAREAVL establishes association between FARE and FLIGHTAVL.
WSDL for SciGetAvailableFares is as follows:
WebServiceURL/sigws/SciGetAvailableFares/SIRENA.SCIAVAILFARESQRY/SIRENA.SCIAVAILFARESRPL?WSDL
E3_1) SIRENA.SCIAVAILFARESQRY: The root element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
AVAILFARESQRY |
n/a |
M |
1 |
See below E3_2) |
PRICINGOPT |
n/a |
O |
|
See below E3_3) |
E3_2) AVAILFARESQRY: Group of search criteria.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
CURRENCY |
string |
O |
1 |
Pricing (and payment) currency. Use IATA or STC (TCH) code. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
DEPPOINT |
string |
M |
1 |
Departure city or airport code. Use IATA or STC (TCH) code. Specifying part of the name (Russian or English) is also allowed. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
ARRPOINT |
string |
M |
1 |
Arrival city or airport code. Use IATA or STC (TCH) code. Specifying part of the name (Russian or English) is also allowed. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
ROUTETYPE |
string |
O |
1 |
Journey type: OW – one-way RT – round-trip | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
DATEOUT |
dateTime |
M |
1 |
Departure date for outbound flight | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
DATEBACK |
dateTime |
O |
1 |
Departure date for the return flight. Please note that this method returns flights ONLY from DEPPOINT to ARRPOINT! DATEBACK, if provided, will not be used for the return flight search, but for validation of MIN and MAX STAY in Fare Rules | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
NODAYS |
short |
O |
1 |
Number of days to perform the search for. If specified, the search will be done for the range [DATEOUT; DATEOUT+NODAYS]. The same applies to DATEBACK | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
NOSEATS |
short |
O |
1 |
Number of seats. Flights / RBD with availability less than NOSEATS will be excluded from the response | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
TIMEOUTMIN TIMEOUTMAX |
long |
O |
1 |
Departure time range for outbound flight. Provide range limits as numbers of seconds after 00:00 of DATEOUT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
TIMEBACKMIN TIMEBACKMAX |
long |
O |
1 |
Departure time range for return flight. Provide range limits as numbers of seconds after 00:00 of DATEBACK | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
AK |
string |
O |
1 |
Carrier code. Use IATA or STC (TCH) code. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
SERVCLASS |
string |
O |
1 |
Service class code: П/Б/Э F/C/Y (only for English users!) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
PCSET |
string |
O |
1 |
Passenger type code. Please use ‘КП’ (‘PTC’ in English) command on TAIS CRS terminal for a complete list. Some commonly used codes are: CNN – child INF – infant INS – infant occupying a seat YTH – youth SRC – senior MIL – military (there are a lot of other codes for military persons) SEA – seaman blank – adult | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
PMSET |
string |
O |
1 |
Form of payment. Normally not used for this query. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
FLAGS |
string |
O |
1 |
Additional preferences (modifiers of СК/?? entry in TAIS CRS). Provide as many modifiers as needed without separators (e.g., ‘RT’). Please note that in the explanation below both Cyrillic (C) and English (E) codes are provided. Cyrillic codes are available to all users. English codes are available only to English users!
Fare Type:
Availability Level:
|
E3_3) PRICINGOPT: Additional pricing options.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
OPTKEY |
string |
M |
1 |
Option key (name). Details are available from TAIS upon request. |
OPTVAL |
string |
M |
1 |
Option value. Details are available from TAIS upon request. |
E3_21) SCIAVAILFARESRPL: The root element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
AVAILFARESRPL |
n/a |
M |
1 |
See below E3_22) |
COMPANYLKP |
n/a |
M |
|
Carrier reference data. For explanation, please refer to the relevant sciWhat section (TBA) |
CURENCYLKP |
n/a |
M |
|
Currency reference data. For explanation, please refer to the relevant sciWhat section (TBA) |
FLIGHT |
n/a |
M |
|
See below E3_23) |
FLIGHTAVL |
n/a |
M |
|
See below E3_24) |
FARE |
n/a |
M |
|
See below E3_25) |
FAREAVL |
|
|
|
See below E3_26) |
PLANETYPELKP |
n/a |
M |
|
Equipment Type reference data. For explanation, please refer to the relevant sciWhat section (TBA) |
TOWN |
n/a |
M |
|
Point reference data. For explanation, please refer to the relevant sciWhat section (TBA) |
E3_22) AVAILFARESRPL: General information.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
CURRENCY |
string |
M |
1 |
Pricing (and payment) currency. Encoding (Cyrillic / English) will depend on your language settings. |
LINKDOWN |
short |
M |
1 |
“Link down” flag for fare queries sent by Sirena to some other hosts 0 – no “link down“ situation occured 1 – “link donw” situation occured |
E3_23) FLIGHT: Schedule and general data for a flight.
Attributes: none.
Elements:
Please note that code sets used in the response will depend on your language settings. For Cyrillic users, STC (TCH) Cyrillic codes will be used if available. If not, IATA codes will be used. For English users, the response will always show IATA codes.
Name |
Type |
ST |
RP |
Comment | ||||||||||||
ORDERNO |
short |
M |
1 |
First part of the unique FLIGHT element reference within the response. The complete reference consists of ORDERNO and POSINROUTE.
When a connection (two or more connecting flights) is returned in the response, all flights of the connection have the same ORDERNO but different POSINROUTE (see below). | ||||||||||||
POSINROUTE |
short |
M |
1 |
Second part of the unique FLIGHT element reference within the response. The complete reference consists of ORDERNO and POSINROUTE.
When a connection (two or more connecting flights) is returned in the response, all flights of the connection have the same ORDERNO but different POSINROUTE (see below). POSINOUTE numbering begins with 1.
For direct flights, this element value is always 0. | ||||||||||||
AK |
string |
M |
1 |
Marketing carrier code | ||||||||||||
OAK |
string |
O |
1 |
Operating carrier code (for code-share flights only) | ||||||||||||
FLIGHTNO |
string |
M |
1 |
Flight number | ||||||||||||
DEPDATE |
date |
M |
1 |
Departure date | ||||||||||||
TOS |
string |
O |
1 |
Type of service:
| ||||||||||||
PLANETYPE |
string |
M |
1 |
Equipment type | ||||||||||||
DEPARPT |
string |
M |
1 |
Departure airport code | ||||||||||||
DEPTERM |
string |
O |
1 |
Departure terminal code | ||||||||||||
ARRARPT |
string |
M |
1 |
Arrival airport code | ||||||||||||
ARRTERM |
string |
O |
1 |
Arrival terminal code | ||||||||||||
DEPTIME |
long |
M |
1 |
Departure time. Number of seconds after 00:00:00 of DEPDATE | ||||||||||||
ARRTIME |
long |
M |
1 |
Arrival time. Number of seconds after 00:00:00 of DEPDATE | ||||||||||||
CHECKINTIME |
long |
M |
1 |
Check-in start time. Number of seconds after 00:00:00 of DEPDATE | ||||||||||||
DEPTIMEGMT |
long |
M |
1 |
Departure time in GMT/UTC. Number of seconds after 00:00:00 of DEPDATE. Can be negative. | ||||||||||||
ARRTIMEGMT |
long |
M |
1 |
Arrival time in GMT/UTC. Number of seconds after 00:00:00 of DEPDATE. Can be negative. | ||||||||||||
NOSTOPS |
short |
O |
1 |
Number of intermediate stops. This is used only for flights with the same flight number and one or several scheduled landings in the route. Not to be confused with connections, which consist of different flight numbers and therefore are shown as separate FLIGHT elements. | ||||||||||||
MEAL |
string |
O |
1 |
Currently not used | ||||||||||||
INVGRD INVORG |
string string |
O |
1 |
Code of the flight inventory system (e.g., MUC1A). Normally blank for TAIS-hosted airline projects. | ||||||||||||
ACCESSLEVEL |
short |
M |
1 |
Flight inventory access level (for booking): 0 – unavailable 1 – standard (teletype) 2 – interactive 3 – local TAIS CRS host | ||||||||||||
LINKSTATUS |
short |
M |
1 |
Flight availability source link status: 0 – no link 1 – link down 2 – link up 3 – local TAIS CRS host | ||||||||||||
AVLSOURCE |
short |
M |
1 |
Availability source type: 0 – no availability data 1– Segment AVS (offline data based on processing of teletype Availability Status Messages which tell that seats are available but don’t tell how many) 2– Numeric AVS (offline data based on processing of teletype Availability Status Messages which tell how many seats are available) 3 – cached real-time data from airline host 4 – real-time data from airline host |
E3_24) FLIGHTAVL: Availability data for one booking class (RBD).
Attributes: none.
Elements:
Please note that code sets used in the response will depend on your language settings. For Cyrillic users, STC (TCH) Cyrillic codes will be used if available. If not, IATA codes will be used. For English users, the response will always show IATA codes.
Name |
Type |
ST |
RP |
Comment |
ORDERNO |
short |
M |
1 |
First part of the unique reference to the FLIGHT element within the response.
A set of FLIGHTAVL elements with the same unique reference provides availability data for all booking classes of the given FLIGHT. |
POSINROUTE |
short |
M |
1 |
Second part of the unique reference to the FLIGHT element within the response
A set of FLIGHTAVL elements with the same unique reference provides availability data for all booking classes of the given FLIGHT. |
RBD |
string |
M |
1 |
Booking class |
SERVCLASS |
string |
M |
1 |
Service class |
NOSEATS |
string |
M |
1 |
Seat availability 1-9 – no less than the number of seats shown 0 – no seats, waitlist open R – on request С – no seats, waitlist open X – flight/class canceled |
E3_25) FARE: Pricing data.
Attributes: none.
Elements:
Please note that code sets used in the response will depend on your language settings. For Cyrillic users, STC (TCH) Cyrillic codes will be used if available. If not, IATA codes will be used. For English users, the response will always show IATA codes.
Name |
Type |
ST |
RP |
Comment | |||||||||||||||
FARENO |
short |
M |
1 |
Unique reference to the FARE element within the response. | |||||||||||||||
AK |
string |
M |
1 |
Carrier code | |||||||||||||||
TARCODE |
string |
M |
1 |
Fare basis code | |||||||||||||||
PASSCAT0 |
string |
M |
1 |
Passenger type code. Please use ‘КП’ (‘PTC’ in English) command on TAIS CRS terminal for a complete list. Some commonly used codes are: CNN – child INF – infant INS – infant occupying a seat YTH – youth SRC – senior MIL – military (there are a lot of other codes for military persons) SEA – seaman ADT – adult | |||||||||||||||
PASSCAT1 |
string |
O |
1 |
Passenger type code for Discount 1 | |||||||||||||||
PASSCAT2 |
string |
M |
1 |
Passenger type code for Discount 2. This element is always present but can be blank. | |||||||||||||||
PCT1 |
short |
M |
1 |
Percentage of Discount 1 | |||||||||||||||
PCT2 |
float |
M |
1 |
Percentage of Discount 1 | |||||||||||||||
RBD |
string |
M |
1 |
Booking class | |||||||||||||||
VALINTARCUROW |
float |
M |
1 |
Fare amount for a OW journey in the fare filing (publication) currency | |||||||||||||||
VALINTARCURRT |
float |
M |
1 |
Fare amount for a RT journey in the fare filing (publication) currency | |||||||||||||||
TARCUR |
string |
M |
1 |
Fare filing (publication) currency | |||||||||||||||
VALINPAYCUROW |
float |
O |
1 |
Fare amount for a OW journey in the payment currency | |||||||||||||||
VALINPAYCURRT |
float |
O |
1 |
Fare amount for a RT journey in the payment currency | |||||||||||||||
EXCHANGERATE |
float |
O |
1 |
Exchange rate used | |||||||||||||||
UPTKEY |
string |
M |
1 |
Reference to the Fare Rules. This reference can be used to retrieve Fare Rules via the SciGetUPT request. | |||||||||||||||
VIAPOINTS |
string |
M |
1 |
Intermediate points for through fares | |||||||||||||||
DATN |
dateTime |
M |
1 |
Fare effective date (flight departure date) | |||||||||||||||
DATK |
dateTime |
O |
1 |
Fare discontinued date (flight departure date) | |||||||||||||||
DAYSOUT |
string |
M |
1 |
Allowed departure Days of Week for the outbound flight: 1 – Monday 135 – Monday, Wedndsaday, Friday 1234567 – daily | |||||||||||||||
DAYSBACK |
string |
O |
1 |
Allowed departure Days of Week for the return flight | |||||||||||||||
MINSTAY MAXSTAY |
string |
O |
1 |
Minumum and maximum stay in the turnaround point: 7 – seven days 3MB – three months 1SUN – “Sunday rule” blank – no restrictions | |||||||||||||||
STARTTERM STOPTERM |
string |
O |
1 |
Sale start and end dates allowed by the fare, in relation to the departure date:
| |||||||||||||||
TAXVALUEOW |
float |
M |
1 |
Tax amount for the OW flight | |||||||||||||||
TAXVALUERT |
float |
O |
1 |
Tax amount for the RT flight |
E3_26) FAREAVL: Association between FARE and FLIGHTAVL elements.
In other words, this set of elements tells for each Flight+Date+RBD which Fares do apply.
Attributes: none.
Elements:
Please note that code sets used in the response will depend on your language settings. For Cyrillic users, STC (TCH) Cyrillic codes will be used if available. If not, IATA codes will be used. For English users, the response will always show IATA codes.
Name |
Type |
ST |
RP |
Comment |
ORDERNO |
short |
M |
1 |
First part of the unique reference to the FLIGHT / FLIGHTAVL element within the response |
POSINROUTE |
short |
M |
1 |
Second part of the unique reference to the FLIGHT / FLIGHTAVL element within the response |
RBD |
string |
M |
1 |
Booking class |
FARENO |
string |
M |
1 |
Unique reference to the FARE element within the response. |
Codesets in the response are as for the Cyrillic user.
There are two possible booking scenarios: one-step booking and two-step booking. This section is dedicated to the first option.
With one-step booking, you need a complete set of PNR data, which you provide in one SciCreatePNR request. The benefit of this approach is simplicity. However, it doesn’t let you to secure a seat until you have all PNR details (passengers, etc).
This approach also doesn’t apply if you need to interactively book flight inventory outside of your local TAIS CRS host (for example, flights of interline partners) using TAIS CRS distribution features. But it works well for teletype interaction with other GDS/CRS.
If unfamiliar with PNR basics in TAIS CRS, it’s strongly recommended that you refer to section 1 of volume 3-1 Booking. Basic Techniques (ftp://ftp.tais.ru/pub/doc/Agents_Manuals_English/volume%203-1%20Booking.%20Basic%20Techniques.doc) first. Russian equivalent is available at (ftp://ftp.tais.ru/pub/doc/Agents_Manuals_Russian/%D2%EE%EC%201%20-%20%D0%D3%CA%CE%C2%CE%C4%D1%D2%C2%CE%20%CF%CE%20%C1%D0%CE%CD%C8%D0%CE%C2%C0%CD%C8%DE.doc).
WSDL for SciCreatePNR is as follows:
WebServiceURL/sigws/SciCreatePNR/SIRENA.SCIPNRCREATEDATA/SIRENA.SCIPNR?WSDL
E2_1) SIRENA.SCIPNRCREATEDATA: The root element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
ORDER |
n/a |
M |
1 |
General data. See below E2_1) |
PASSENGER |
n/a |
M |
99 |
Passenger data. See below E2_2) |
PSGRDISC |
n/a |
O |
|
Passenger type code (not required for adults). See below E2_3) |
PSGRREF |
n/a |
O |
|
Reference between PASSENGER and SSR, OSI, COMMENT, FFPDOC elements. See below E2_4) |
AIRSEG |
n/a |
M |
16 |
Flight segment. See below E2_5) |
SSR |
n/a |
O |
|
Special Service Request. See below E2_6) |
OSI |
n/a |
O |
|
Other Service Information. See below E2_7) |
COMMENT |
n/a |
O |
|
Comment. See below E2_8) |
TELEPHONE |
n/a |
M |
|
Contact. See below E2_9) |
FFPINFO |
n/a |
O |
|
Frequent Flyer data. See below E2_10) |
ITNPRICE |
n/a |
O |
|
Not used for PNR creation without pricing |
ITNFARE |
n/a |
O |
|
Not used for PNR creation without pricing |
ITNFAREPART |
n/a |
O |
|
Not used for PNR creation without pricing |
TAX |
n/a |
O |
|
Not used for PNR creation without pricing |
Most elements will have their own unique ID within the request (PSGRID, SEGID, SSRID, etc). PLEASE MAKE SURE THAT EACH ID IS REALLY UNIQUE WITHIN THE REQUEST. Otherwise, if you have the same value, for example, of SSRID=’1’ and OSIID=’1’ for some SSR and OSI elements within the request, you lose the ability to properly associate them to passengers.
E2_1) ORDER: General data.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference). Specify ‘NEW’ for a new PNR. |
ORDTYPE |
string |
M |
1 |
PNR Type: С – non-group PNR G – group PNR |
GROUPNAME |
string |
O |
1 |
Group name (for group PNR only) |
NOADULT |
short |
M |
1 |
Number of Adults |
NOCHILDREN |
short |
M |
1 |
Number of Children |
NOINFANTS |
short |
M |
1 |
Number of Infants |
TLTYPE1 |
string |
O |
1 |
Type of time limit 1 (a PNR can have two time limits in TAIS CRS): blank – to be calculated by TAIS CRS ‘-‘ – no time limit A – automatic М – manual I – immediate ticketing |
EXPIREDATE1 |
dateTime |
O |
1 |
Expiration time of time limit 1. Local time of the TLPOINT point. If TLPOINT is omitted, time zone of the TAIS CRS terminal executing the request will be assumed. |
TLTYPE2 |
string |
O |
1 |
Type of time limit 2 |
EXPIREDATE2 |
dateTime |
O |
1 |
Expiration time of time limit 2 |
TLPOINT |
string |
O |
1 |
Point (location) whose time zone is assumed to be used in EXPIREDATE1 / EXPIREDATE2. If omitted, time zone of the TAIS CRS terminal executing the request will be assumed. |
TKTGRD TKTORG |
string string |
O |
1 |
Ticketing organization (agency) code. If omitted, same as booking organization. Booking organization is defined by settings of TAIS CRS terminal executing the request. |
TKTOFFICENO |
long |
O |
1 |
Ticketing office code (within ticketing organization). If omitted, same as booking office code. Booking organization is defined by settings of TAIS CRS terminal executing the request. |
ERSPUSERID |
string |
O |
1 |
ERSP user ID |
E2_2) PASSENGER: Passenger data.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | ||||||||||||||||||
LOCATOR |
string |
M |
1 |
PNR locator (unique reference). Specify ‘NEW’ for a new PNR. | ||||||||||||||||||
PSGRID |
short |
M |
1 |
Passenger unique ID within the request | ||||||||||||||||||
PSGRNAME |
string |
M |
1 |
Use Russian or English language based on airline rules and journey type. The format is: LastName FirstName PatrName Title DoB
Examples: ИВАНОВ ИВАН ИВАНОВИЧ ГН ПЕТРОВ ФЕДЯ ГН 12ДЕК10 SMITH JULIA MS DOE JANE MS 12FEB13 | ||||||||||||||||||
PASSPORT |
string |
O |
1 |
Passenger passport/ID data (FOID) Please provide if required by the airline. The format is: IDDoc Country IDNum ExpDate IDDoc – document type. Both Sirena/TCH and IATA code sets are supported.Sirena / TCH codes are available in Russian and English. Some useful Sirena / TCH codes are below (complete list available in TAIS CRS documentation).
CC – credit card number CN – confirmation number DL – driving license FF – FQTV number ID – local ID NI – national identity number PP – passport number TN – ticket number Of these, you would normally be using ID or PP.
ПС РФ 1234567890 PS RU 1234567890 PP TR 2387 | ||||||||||||||||||
RESIDENCE |
string |
NA |
1 |
Not used | ||||||||||||||||||
BORDERZONEDOC |
string |
O |
1 |
Border zone entry permission details (free-flow text). Don’t use this element if not sure if it’s needed. | ||||||||||||||||||
ADULTID |
short |
O |
1 |
Reference to the accompanying adult passenger’s PSGRID (for children and infants) |
E2_3) PSGRDISC: Passenger type code.
A passenger can have one or two type codes in TAIS CRS. Standard ATPCO and Airline-specific codes can be used.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference). Specify ‘NEW’ for a new PNR |
PSGRID |
short |
M |
1 |
Reference to the passenger’s PSGRID |
ORDNO |
short |
M |
1 |
Passenger type code sequential number for the given passenger |
PASSCAT |
string |
M |
1 |
Passenger type code. Please use ‘КП’ (‘PTC’ in English) command on TAIS CRS terminal for a complete list. Some commonly used codes are: CNN – child INF – infant INS – infant occupying a seat YTH – youth SRC – senior MIL – military (there are a lot of other codes for military persons) SEA – seaman |
BASEMENTDOC |
string |
O |
1 |
Details of document used as proof of passenger type code application. Free-flow text. Provide if required by the passenger type code settings in TAIS CRS. Normally not required for CNN, INF and INS. Further details are available from TAIS or via experiments on TAIS CRS terminal. You will not be able to ticket a PNR with BASEMENTDOC missing if it’s required |
E2_4) PSGRREF: Reference between passenger (PASSENGER) and other non-segment elements (SSR, OSI, COMMENT, FFPINFO). For example, to establish association between passenger and his/her special meal SSR.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference). Specify ‘NEW’ for a new PNR |
PSGRID |
short |
M |
1 |
Reference to the passenger’s PSGRID |
OBJID |
short |
M |
1 |
Reference to the non-segment element’s unique ID withn the request. Elements that can be passenger-associated are: - SSR. Almost all SSR but a few exceptions (e.g., SSR OTHS) have to be passenger-associated. - OSI. Normally not passenger-associated, but can be. - COMMENT. Normally not passenger-associated, but can be associated to a single passenger - FFPINFO. For this element passenger association is mandatory |
E2_5) AIRSEG: Flight segment.
Attributes: none
Elements:
In this description ‘Mandatory/Optional/Not Available’ data is provided in relation to each segment type (V – regular(confirmed),O – open-date, N – ARNK).
Name |
Type |
V |
O |
N |
RP |
Comment |
LOCATOR |
string |
M |
M |
M |
1 |
PNR locator (unique reference). Specify ‘NEW’ for a new PNR |
SEGID |
short |
M |
M |
M |
1 |
Unique segment ID within the request |
AK |
string |
M |
O |
NA |
1 |
Carrier code |
REIS |
string |
M |
O |
NA |
1 |
Flight number |
DEPGRD |
string |
O |
O |
M |
1 |
Departure city code. Use IATA or STC (TCH) code. |
ARRGRD |
string |
O |
O |
M |
1 |
Arrival city code. Use IATA or STC (TCH) code. |
DEPDATE |
dateTime |
M |
NA |
M |
1 |
Departure date |
RBD |
string |
M |
M |
NA |
1 |
Booking class (RBD). Cyrillic users should use Cyrillic codes. English users, English codes. |
AAS |
string |
NA |
NA |
NA |
1 |
Not used |
DEPARPT |
string |
M |
M |
NA |
1 |
Departure airport code. Use IATA or STC (TCH) code. |
ARRARPT |
string |
M |
M |
NA |
1 |
Arrival airport code. Use IATA or STC (TCH) code. |
DEPTIME |
long |
NA |
NA |
NA |
1 |
Not used |
ARRTIME |
long |
NA |
NA |
NA |
1 |
Not used |
CHECKINTIME |
long |
NA |
NA |
NA |
1 |
Not used |
NOSEATS |
short |
M |
M |
NA |
1 |
Number of seats |
HOLDERGRD |
string |
NA |
NA |
NA |
1 |
Not used |
HOLDERORG |
string |
NA |
NA |
NA |
1 |
Not used |
INVLOCATOR |
string |
NA |
NA |
NA |
1 |
Not used |
SEGTYPE |
string |
M |
M |
M |
1 |
Segment type: V – regular (confirmed) O – open-date N – surface segment (ARNK) |
E2_6) SSR: Special Service Request. Please provide data in compliance with AIRIMP or airline policy (for airline custom SSR).
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference). Specify ‘NEW’ for a new PNR |
SSRID |
short |
M |
1 |
Unique SSR ID within the request |
SSRCODE |
string |
M |
1 |
SSR code. See AIRIMP or ‘ЧТО,,У’ (‘REF,,V’) on TAIS CRS terminal for complete list |
AK |
string |
O |
1 |
Carrier code (IATA or STC (TCH) code set). Use only for non-automated SSR. A non-automated SSR is the one not associated with a flight segment. |
SEGID |
string |
O |
1 |
Reference to the flight segment (AIRSEG.SEGID) within the request. Use only for automated SSR. An automated SSR is the one associated with a flight segment. When one SSR code is needed on several segments, create several SSR elements, each with its own segment reference. Generally, you should create a separate SSR (even if they are identical in all other respects) for each passenger and segment. |
QTY |
string |
M |
1 |
Number of SSR units. In most cases, ‘1’. |
AAS |
string |
NA |
1 |
Not used |
FREETEXT |
string |
M or NA |
1 |
SSR ‘free text’ part. For some SSR this is mandatory, and in some cases subject to strict format requirements. For some SSR, not allowed. See AIRIMP or contact TAIS for details. |
Please pay attention that there’s no explicit passenger reference inside the SSR element! Such reference should be established externally using PSGRREF element E2_4).
For Frequent Flyer data, don’t create an SSR but use the dedicated FFPINFO element (explained below).
E2_7) OSI: Other Service Information.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference). Specify ‘NEW’ for a new PNR |
OSIID |
short |
M |
1 |
Unique OSI ID within the request |
AK |
string |
M |
1 |
Carrier code (IATA or STC (TCH) code set). |
SEGID |
string |
O |
1 |
Reference to the flight segment (AIRSEG.SEGID) within the request. Normally not used. |
FREETEXT |
string |
M |
1 |
Free-flow text (up to 255 characters) |
E2_8) COMMENT: Free Comment / Remark.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference). Specify ‘NEW’ for a new PNR |
CMTID |
short |
M |
1 |
Unique comment ID within the request |
SEGID |
string |
O |
1 |
Reference to the flight segment (AIRSEG.SEGID) within the request. Normally not used. |
FREETEXT |
string |
M |
1 |
Free-flow text (up to 255 characters) |
E2_9) TELEPHONE: Contact information.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | |||||||||||||||||||||||||||
LOCATOR |
string |
M |
1 |
PNR locator (unique reference). Specify ‘NEW’ for a new PNR | |||||||||||||||||||||||||||
PHNID |
short |
M |
1 |
Unique contact ID within the request | |||||||||||||||||||||||||||
PHNTYPE |
string |
M |
1 |
Contact type:
| |||||||||||||||||||||||||||
PHNNUMBER |
string |
M |
1 |
Free-flow text (up to 255 characters) |
E2_10) FFPINFO:Frequent Flyer data. Processing of this element will result in creation of SSR FQTV/FQTR/FQTU in TAIS CRS.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference). Specify ‘NEW’ for a new PNR |
FFPINFOID |
short |
M |
1 |
Unique Frequent Flyer data ID within the request |
INFOTYPE |
string |
M |
1 |
Frequent Flyer data type: V – accrual (will result in SSR FQTV) R – redemption (will result in SSR FQTR) U – upgrade (will result in SSR FQTU) |
AK |
string |
O |
1 |
Carrier code (IATA or STC (TCH) code set). Use if you want non-automated SSR FQTx to be created. A non-automated SSR is the one not associated with a flight segment. |
SEGID |
short |
O |
1 |
Reference to the flight segment (AIRSEG.SEGID) within the request. Use if you want automated SSR FQTx to be created. An automated SSR is the one associated with a flight segment. When one FFP card is needed on several segments (segment-associated), create several FFPINFO elements, each with its own segment reference. |
FFAK |
string |
M |
1 |
Frequent flyer airline code (IATA or STC (TCH) code set). |
FFCARDNMBR |
string |
M |
1 |
Frequent flyer card number |
CARDHOLDER |
string |
O |
1 |
Frequent flyer holder name |
Please pay attention that there’s no explicit passenger reference inside the FFPINFO element! Such reference should be established externally using PSGRREF element E2_4).
Please note that code sets used in the response will depend on your language settings. For Cyrillic users, STC (TCH) Cyrillic codes will be used if available. If not, IATA codes will be used. For English users, the response will always show IATA or legacy English codes.
E2_21) SIRENA.SCIPNR: The root element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
ORDER |
n/a |
M |
1 |
General data. See below E2_22) |
PASSENGER |
n/a |
M |
99 |
Passenger data. See below E2_23) |
PSGRDISC |
n/a |
O |
|
Passenger type code. See below E2_24) |
PSGRSEGINFO |
n/a |
M |
|
Additional information per passenger and segment. See below E2_25) |
PSGRREF |
n/a |
O |
|
Reference between PASSENGER and SSR, OSI, COMMENT, FFPDOC elements. See below E2_26) |
AIRSEG |
n/a |
M |
16 |
Flight segment. See below E2_27) |
MEMBER |
n/a |
O |
|
Information on other hosts (GDS, CRS of interline partners, etc) involved in the booking. See below E2_28) |
SSR |
n/a |
O |
|
Special Service Request. See below E2_29) |
OSI |
n/a |
O |
|
Other Service Information. See below E2_30) |
COMMENT |
n/a |
O |
|
Comment. See below E2_31) |
TELEPHONE |
n/a |
M |
|
Contact. See below E2_32) |
FFPINFO |
n/a |
O |
|
Frequent Flyer data. See below E2_33) |
TST |
n/a |
NA |
|
Not used for PNR creation without pricing |
TSTFLIGHTSEG |
n/a |
NA |
|
Not used for PNR creation without pricing |
TSTSSR |
n/a |
NA |
|
Not used for PNR creation without pricing |
FARECOMPONENT |
n/a |
NA |
|
Not used for PNR creation without pricing |
FARECOMPONENTSEG |
n/a |
NA |
|
Not used for PNR creation without pricing |
TAX |
n/a |
NA |
|
Not used for PNR creation without pricing |
TRANSACTION |
n/a |
M |
1 |
Actor details for the last PNR modification transaction. See below E2_34) |
COMPANYLKP |
n/a |
M |
|
Carrier reference data. For explanation, please refer to the relevant sciWhat section (TBA) |
PLANETYPELKP |
n/a |
M |
|
Equipment Type reference data. For explanation, please refer to the relevant sciWhat section (TBA) |
TOWN |
n/a |
M |
|
Point reference data. For explanation, please refer to the relevant sciWhat section (TBA) |
E2_22) ORDER: General data.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | ||||||||||||||||||||||||||||||
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) | ||||||||||||||||||||||||||||||
ORDTYPE |
string |
M |
1 |
PNR Type: С – non-group PNR G – group PNR | ||||||||||||||||||||||||||||||
ORDRANK |
string |
M |
1 |
PNR Rank (booking source): P – PNR created directly in TAIS CRS (as opposed to PNR created via GDS) | ||||||||||||||||||||||||||||||
ORDNAME |
string |
M |
1 |
PNR name | ||||||||||||||||||||||||||||||
NOPASSENGER |
short |
M |
1 |
Number of Adults | ||||||||||||||||||||||||||||||
NOCHILDREN |
short |
M |
1 |
Number of Children | ||||||||||||||||||||||||||||||
NOINFANTS |
short |
M |
1 |
Number of Infants | ||||||||||||||||||||||||||||||
TAP |
string |
M |
1 |
Booking terminal ID (TID) | ||||||||||||||||||||||||||||||
OPERGRD OPERORG OPEROFFICENO OPERNO |
string |
M |
1 |
Booking office and user codes. For example, KK0001 as office code and 1001 as user code. Here: OPERGRD=’000’ OPERORG=’KK’ OPEROFFICENO=’1’ OPERNO=’1001’ | ||||||||||||||||||||||||||||||
TKTGRD TKTORG |
string string |
O |
1 |
Ticketing organization (agency) code. If omitted, same as booking organization. | ||||||||||||||||||||||||||||||
TKTOFFICENO |
long |
O |
1 |
Ticketing office code (within ticketing organization). If ‘0’, same as booking office code. | ||||||||||||||||||||||||||||||
The below fields relate (down to COUNTRY, included) to a Point of Sale (POS) that effected the LAST PNR modification. | ||||||||||||||||||||||||||||||||||
FORMOWNER |
string |
M |
1 |
Stock provider (Carrier code; IAT – for BSP points of sale; or TCH). Sometimes blank or ‘00’ (not defined). | ||||||||||||||||||||||||||||||
PTNUMBER |
string |
M |
1 |
Point of Sale number, normally referred to as ‘IATA number’ | ||||||||||||||||||||||||||||||
PTTYPE |
string |
M |
1 |
Point of Sale type: N – non-IATA accredited (standard for airline POS) T – IATA-accredited | ||||||||||||||||||||||||||||||
PARTITION |
string |
M |
1 |
TAIS CRS partition in which PNR modification was effected: GDS – distribution system (partition in which agents and agent-like processes work) COD – host (partition in which administrators and system process work) | ||||||||||||||||||||||||||||||
LOCATION |
string |
M |
1 |
Point of Sale location city code | ||||||||||||||||||||||||||||||
COUNTRY |
string |
M |
1 |
Point of Sale location country code | ||||||||||||||||||||||||||||||
CTRLMEMBER |
short |
NA |
1 |
Not used in booking responses | ||||||||||||||||||||||||||||||
ORDPHASE |
string |
M |
1 |
General status of the PNR
| ||||||||||||||||||||||||||||||
TLOWNER |
string |
M |
1 |
Time limit source: U – entered by User S – calculated by System H – received from GDS (happens only with Russian GDS 1M and 1H) | ||||||||||||||||||||||||||||||
TLTYPE1 |
string |
O |
1 |
Type of time limit 1 (a PNR can have two time limits in TAIS CRS): ‘-‘ – no time limit (tickets issued or time limit otherwise cleared) A – automatic М – manual I – immediate ticketing | ||||||||||||||||||||||||||||||
EXPIREDATE1 |
dateTime |
O |
1 |
Expiration time of time limit 1. Local time of the TLPOINT point. | ||||||||||||||||||||||||||||||
TLTYPE2 |
string |
O |
1 |
Type of time limit 2 | ||||||||||||||||||||||||||||||
EXPIREDATE2 |
dateTime |
O |
1 |
Expiration time of time limit 2 | ||||||||||||||||||||||||||||||
TLPOINT |
string |
O |
1 |
Point (location) whose time zone is assumed to be used in EXPIREDATE1 / EXPIREDATE2. | ||||||||||||||||||||||||||||||
ERSPUSERID |
string |
O |
1 |
ERSP user ID | ||||||||||||||||||||||||||||||
ERSPDEPPOINT |
string |
O |
1 |
First departure point (applies only to ERSP) |
E2_23) PASSENGER: Passenger data.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
PSGRID |
short |
M |
1 |
Passenger unique ID within the response |
PSGRNAME |
string |
M |
1 |
Passenger name, including title |
BIRTHDATE |
string |
O |
1 |
Passenger date of birth, DDMMMYY |
PASSPORT |
string |
O |
1 |
Passenger passport/ID data (FOID) except expiry date |
EXPIRYDATE |
dateTime |
O |
1 |
Passenger passport/ID expiry date |
RESIDENCE |
string |
NA |
1 |
Not used |
BORDERZONEDOC |
string |
O |
1 |
Border zone entry permission details (free-flow text) |
AGECAT |
short |
M |
1 |
Age category: 0 – Adult 1 – Child 2 – Infant |
ADULTID |
short |
O |
1 |
Reference to the accompanying adult passenger’s PSGRID (for children and infants) |
PAXID |
long |
M |
1 |
Passenger unique ID in TAIS CRS |
E2_24) PSGRDISC: Passenger type code.
A passenger can have one or two type codes in TAIS CRS. Standard ATPCO and Airline-specific codes can be used.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
PSGRID |
short |
M |
1 |
Reference to the passenger’s PSGRID |
ORDNO |
short |
M |
1 |
Passenger type code sequential number for the given passenger |
PASSCAT |
string |
M |
1 |
Passenger type code. Please use ‘КП,INF’ (‘PTC,INF’ in English) command on TAIS CRS terminal for explanation on specific PTC. Some commonly used codes are: CNN – child INF – infant INS – infant occupying a seat YTH – youth SRC – senior MIL – military (there are a lot of other codes for military persons) SEA – seaman |
BASEMENTDOC |
string |
O |
1 |
Details of document used as proof of passenger type code application. Free-flow text |
E2_25) PSGRSEGINFO: Additional information per passenger and segment (mainly ticket-related).
Newly created PNR are not ticketed and therefore don’t have significant data in this element
E2_26) PSGRREF: Reference between passenger (PASSENGER) and other non-segment elements (SSR, OSI, COMMENT, FFPINFO). For example, to establish association between passenger and his/her special meal SSR.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
PSGRID |
short |
M |
1 |
Reference to the passenger’s PSGRID |
OBJID |
short |
M |
1 |
Reference to the non-segment element’s unique ID withn the response. Elements that can be passenger-associated are: - SSR. Almost all SSR but a few exceptions (e.g., SSR OTHS) have to be passenger-associated. - OSI. Normally not passenger-associated, but can be. - COMMENT. Normally not passenger-associated, but can be associated to a single passenger - FFPINFO. For this element passenger association is mandatory |
E2_27) AIRSEG: Flight segment.
Attributes: none
Elements:
In this description ‘Mandatory/Optional/Not Available’ data is provided in relation to each segment type (V – regular(confirmed),O – open-date, N – ARNK).
Name |
Type |
V |
O |
N |
RP |
Comment | ||||||||||||
LOCATOR |
string |
M |
M |
M |
1 |
PNR locator (unique reference) | ||||||||||||
SEGID |
short |
M |
M |
M |
1 |
Unique segment ID within the response | ||||||||||||
POSINROUTE |
short |
M |
M |
NA |
1 |
Segment sequential number in the route, starting with ‘0’. All segment types count. | ||||||||||||
AK |
string |
M |
M |
NA |
1 |
Carrier code | ||||||||||||
OAK |
string |
O |
NA |
NA |
1 |
Operating carrier code (for code-share flights only) | ||||||||||||
REIS |
string |
M |
O |
NA |
1 |
Flight number | ||||||||||||
MOD |
string |
O |
O |
NA |
1 |
Flight number modifier (obsolete) | ||||||||||||
DEPGRD |
string |
M |
M |
M |
1 |
Departure city code | ||||||||||||
ARRGRD |
string |
M |
M |
M |
1 |
Arrival city code | ||||||||||||
DEPDATE |
dateTime |
M |
M |
M |
1 |
Departure date | ||||||||||||
RBD |
string |
M |
M |
NA |
1 |
Booking class (RBD) | ||||||||||||
SERVCLASS |
string |
M |
M |
NA |
1 |
Service class: П/Б/Э F/C/Y | ||||||||||||
DEPARPT |
string |
M |
M |
M |
1 |
Departure airport code | ||||||||||||
ARRARPT |
string |
M |
M |
M |
1 |
Arrival airport code | ||||||||||||
DEPTERM |
string |
O |
NA |
NA |
1 |
Departure terminal code | ||||||||||||
ARRTERM |
string |
O |
NA |
NA |
1 |
Arrival terminal code | ||||||||||||
DEPTIME |
long |
M |
NA |
NA |
1 |
Departure time. Number of MINUTES after 00:00:00 of DEPDATE | ||||||||||||
ARRTIME |
long |
M |
NA |
NA |
1 |
Arrival time. Number of MINUTES after 00:00:00 of DEPDATE | ||||||||||||
DEPTIMEGMT |
long |
M |
NA |
NA |
1 |
Departure time in GMT/UTC. Number of MINUTES after 00:00:00 of DEPDATE. Can be negative. | ||||||||||||
ARRTIMEGMT |
long |
M |
NA |
NA |
1 |
Arrival time in GMT/UTC. Number of MINUTES after 00:00:00 of DEPDATE. Can be negative. | ||||||||||||
CHECKINTIME |
long |
M |
NA |
NA |
1 |
Check-in start time. Number of MINUTES after 00:00:00 of DEPDATE | ||||||||||||
PLANETYPE |
string |
M |
NA |
NA |
1 |
Equipment type | ||||||||||||
NOLANDINGS |
short |
M |
NA |
NA |
1 |
Number of intermediate stops on this segment | ||||||||||||
TOS |
string |
O |
NA |
NA |
1 |
Type of service:
| ||||||||||||
NOSEATS |
short |
M |
M |
NA |
1 |
Number of seats | ||||||||||||
SEATS |
string |
O |
NA |
NA |
1 |
Not used | ||||||||||||
WEIGHT |
long |
O |
NA |
NA |
1 |
Not used | ||||||||||||
SEGTYPE |
string |
M |
M |
M |
1 |
Segment type: V – regular (confirmed) O – open-date N – surface segment (ARNK) | ||||||||||||
HOLDER |
string |
M |
NA |
M |
1 |
Reference to the MEMBER element 0 – no reference This field will have positive values if the flight is hosted outside TAIS CRS, and TAIS CRS is used as a GDS too book it. For example, for flights of interline partners of TAIS CRS-hosted airlines. | ||||||||||||
BSGGRD |
string |
O |
NA |
NA |
1 |
Allotment city code. This field is provided if flight inventory was pulled from an allotment (a kind of block space PNR in TAIS CRS). | ||||||||||||
BGSORG |
string |
O |
NA |
NA |
1 |
Allotment organization code. This field is provided if flight inventory was pulled from an allotment (a kind of block space PNR in TAIS CRS). | ||||||||||||
AAS |
string |
M |
M |
NA |
1 |
Segment status: HK – confirmed HN – requested HL – waitlisted OP – open-date and other AIRIMP codes | ||||||||||||
AKA |
short |
M |
M |
NA |
|
Booking confirmation from outside host flag: 0 – no confirmation or local inventory 1 – confirmation received This field will can have positive value if the flight booked is hosted outside TAIS CRS, and TAIS CRS is used as a GDS too book it. For example, for flights of interline partners of TAIS CRS-hosted airlines. So it tells if the outside host sent booking confirmation to TAIS CRS. | ||||||||||||
STREAM |
short |
M |
M |
NA |
1 |
Obsolete. If present, always has the value of ‘0’. | ||||||||||||
WLPRTY |
short |
M |
M |
NA |
1 |
Segment priority on the waitlist (only for waitlisted segments). Actual usage will take place after reform of waitlists in TAIS CRS. At the moment, there will be a value of ‘0’ for regular and ‘-1’ for open-date segments. | ||||||||||||
ALTERSEG |
short |
M |
M |
NA |
1 |
Reference to another segment (AIRSEG.SEGID) in the same PNR offering a more desirable alternative for the same departure and arrival airports. ‘0’ if no such segment. A real-life situation is when two segments are booked for the same airport pair in the same direction (AYT -> IST) on the same date (and in the same PNR). One is confirmed (HK), another is waitlisted (HL). The waitlisted segment is considered the better alternative as it was probably booked to get a better price. TAIS CRS knows to automatically cancel the less preferable option once the more preferable one gets confirmed. | ||||||||||||
MARRYNO |
short |
M |
M |
NA |
1 |
Number of ‘married segments’ group. Set to ‘0’ for non-married segments. | ||||||||||||
SUBFLYID |
long |
M |
M |
M |
1 |
Unique flight ID in TAIS CRS (sometimes returned even if the flight does not actually exist) | ||||||||||||
STOPS |
string |
O |
NA |
NA |
1 |
Codes of airports where intermediate stops take place |
E2_28) MEMBER: Information on other hosts (GDS, CRS of interline partners, etc) involved in the booking.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
TAIS CRS PNR locator (unique reference) |
MBRID |
short |
M |
1 |
Unique element ID within the response |
MBRGRD |
string |
M |
1 |
Other host city code (e.g., ‘MUC’) |
MBRORG |
string |
M |
1 |
Other host 2-character code (e.g., ‘1A’) |
MBRTYPE |
string |
M |
1 |
Other host type. Currently always ‘AP’, indicating that the other host supports AIRIMP communication. |
INVLOCATOR |
string |
M |
1 |
Locator of other host PNR. Regardless of whether TAIS CRS acts as GDS or inventory system, the other host will always have its own PNR for the same reservation. These PNR are automatically kept in sync. |
SALEPOINT |
string |
M |
1 |
Point of Sale details as extracted from the inbound AIRIMP message |
SUBHOSTGRD |
string |
M |
1 |
TAIS CRS subhost city code (e.g., ‘IST’). TAIS CRS subhost is the way other systems can identify partition of each airline in TAIS CRS. For example, ‘ISTKK’ is the partition of Atlasjet. This is used, for example, for signing teletype messages. |
SUBHOSTORG |
string |
M |
1 |
TAIS CRS subhost carrier code (e.g., ‘KK’). Please see explanation of subhost above. |
LOCKMOD |
short |
M |
1 |
Obsolete. Currently always ‘0’ |
E2_29) SSR: Special Service Request. Please provide data in compliance with AIRIMP or airline policy (for airline custom SSR).
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference). Specify ‘NEW’ for a new PNR |
SSRID |
short |
M |
1 |
Unique SSR ID within the response |
SSRCODE |
string |
M |
1 |
SSR code. See AIRIMP or ‘ЧТО,,У’ (‘REF,,V’) on TAIS CRS terminal for complete list |
AK |
string |
M |
1 |
Carrier code (IATA or STC (TCH) code set) |
SEGID |
string |
M |
1 |
Reference to the flight segment (AIRSEG.SEGID) within the response. For non-automated SSR, set to ‘0’. |
QTY |
string |
M |
1 |
Number of SSR units |
AAS |
string |
M |
1 |
SSR status: HK – confirmed HN – requested UN/NO – rejected and other AIRIMP codes |
FREETEXT |
string |
O |
1 |
SSR ‘free text’ part. This can also contain explanation for rejected requests. |
Please pay attention that there’s no explicit passenger reference inside the SSR element (but in the PNR it exists in most cases)! Such reference is established externally using PSGRREF element E2_26).
For SSR FQTx (Frequent Flyer data) created in the PNR, there will be no such SSR in the response, but the FFPINFO element (explained below).
E2_30) OSI: Other Service Information.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
OSIID |
short |
M |
1 |
Unique OSI ID within the response |
AK |
string |
M |
1 |
Carrier code |
SEGID |
string |
M |
1 |
Reference to the flight segment (AIRSEG.SEGID) within the response. Normally not used, in which case ‘0’ is returned in the response. |
FREETEXT |
string |
M |
1 |
Free-flow text (up to 255 characters) |
E2_31) COMMENT: Free Comment / Remark.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
CMTID |
short |
M |
1 |
Unique comment ID within the response |
SEGID |
string |
M |
1 |
Reference to the flight segment (AIRSEG.SEGID) within the response. Normally not used, in which case ‘0’ is returned in the response. |
FREETEXT |
string |
M |
1 |
Free-flow text (up to 255 characters) |
E2_32) TELEPHONE: Contact information.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | ||||||||||||||||||
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) | ||||||||||||||||||
PHNID |
short |
M |
1 |
Unique contact ID within the response | ||||||||||||||||||
PHNTYPE |
string |
M |
1 |
Contact type (English for all users!!!):
| ||||||||||||||||||
PHNNUMBER |
string |
M |
1 |
Free-flow text (up to 255 characters) |
E2_33) FFPINFO:Frequent Flyer data. This is based on SSR FQTV/FQTR/FQTU created in the TAIS CRS PNR.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
FFPINFOID |
short |
M |
1 |
Unique Frequent Flyer data ID within the response |
INFOTYPE |
string |
M |
1 |
Frequent Flyer data type: V – accrual (based on SSR FQTV) R – redemption (based on SSR FQTR) U – upgrade (based on SSR FQTU) |
AK |
string |
M |
1 |
Carrier code |
SEGID |
short |
M |
1 |
Reference to the flight segment (AIRSEG.SEGID) within the response. For non-automated SSR, set to ‘0’. |
FFAK |
string |
M |
1 |
Frequent flyer airline code |
FFCARDNMBR |
string |
M |
1 |
Frequent flyer card number |
CARDHOLDER |
string |
M |
1 |
Frequent flyer holder name |
Please pay attention that there’s no explicit passenger reference inside the FFPINFO element! Such reference is established externally using PSGRREF element E2_26).
E2_34) TRANSACTION: Actor details for the last (most recent) PNR modification transaction. Basically, it repeats most elements from the ORDER element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
TRNO |
short |
M |
1 |
Transaction number |
TAP |
string |
M |
1 |
Terminal ID (TID) |
OPERGRD OPERORG OPEROFFICENO OPERNO |
string |
M |
1 |
Office and user codes. For example, KK0001 as office code and 1001 as user code. Here: OPERGRD=’000’ OPERORG=’KK’ OPEROFFICENO=’1’ OPERNO=’1001’ |
FORMOWNER |
string |
M |
1 |
Stock provider (Carrier code; IAT – for BSP points of sale; or TCH). Sometimes blank or ‘00’ (not defined). |
PTNUMBER |
string |
M |
1 |
Point of Sale number, normally referred to as ‘IATA number’ |
PTTYPE |
string |
M |
1 |
Point of Sale type: N – non-IATA accredited (standard for airline POS) T – IATA-accredited |
PARTITION |
string |
M |
1 |
TAIS CRS partition in which PNR modification was effected: GDS – distribution system (partition in which agents and agent-like processes work) COD – host (partition in which administrators and system process work) |
LOCATION |
string |
M |
1 |
Point of Sale location city code |
COUNTRY |
string |
M |
1 |
Point of Sale location country code |
TCC |
strting |
M |
1 |
Transaction end command that was used: SV – ‘E’ (end transaction = save PNR and close) CP – ‘ER’ (end and retrieve = save PNR and don’t close) |
STARTTIME |
dateTime |
M |
1 |
Transaction start time |
ENDTIME |
dateTime |
M |
1 |
Transaction end time |
This is a simple one-way booking for one adult passenger
ЗАКАЗ DOE E5FAIU 15НОЯ/2039 900/KK000005 KK000005 IST(TR) KK(61000900) ПАС=1-0-0-0 НЕ ПРОДАН А/01МАР/0805/МОВ И:ФУП C РВ ДВ ВВ ВП ТС П РЕГ АО Т АН Т БР СТ КМ Е M ЦОД/ЛОКАТОР 1 KK31 01МАР 0905 1035 320 0735 ADA IST Y HK 1 E Ф ФИО/ДОКПАС КП БИЛЕТЫ 1 DOE JANE MRS/PP TR 22234512 П ТЕЛЕФОН 1Т +9023312312312/М П КОММЕНТАРИЙ 1К HELLO IM A COMMENT
PNR DOE E5FAIU 15NOV/2039 900/KK000005 KK000005 IST(TR) KK(61000900) PAX=1-0-0-0 NOT TICKETED A/01MAR/0805/MOW I:NVO S FLT DD DT AT EQP S CKI DA T AA T CL ST QTY E M HOST/LOCATOR 1 KK31 01MAR 0905 1035 320 0735 ADA IST Y HK 1 E N NAME/FOID PTC TICKETS 1 DOE JANE MRS/PP TR 22234512 O PHONE 1P +9023312312312/M O COMMENTS 1C HELLO IM A COMMENT
This is a complex round-trip booking containing as much data as possible
ЗАКАЗ DOE E5FAIX 15НОЯ/2108 900/KK000005 KK000005 IST(TR) KK(61000900) ПАС=2-1-1-0 НЕ ПРОДАН А/01МАР/0805/МОВ И:ФУП C РВ ДВ ВВ ВП ТС П РЕГ АО Т АН Т БР СТ КМ Е M ЦОД/ЛОКАТОР 1 KK31 01МАР 0905 1035 320 0735 ADA IST Y HK 3 E 2 KK30 10МАР 0700 0830 320 0530 IST ADA Y HK 3 E Ф ФИО/ДОКПАС КП БИЛЕТЫ 1 DOE JANE MRS/PP TR 22234512 2 DOE JOHN MR/PP TR 22234513 3 DOE MEDIUM MR 12DEC07-1Ф/ CNN:Р PP TR 22234514 4 DOE SMALL MS 11SEP13-1Ф/PP TR 22234514 INF:М П ТЕЛЕФОН 1Т +9023312312312/М 2Т TEST@TEST.COM/Е П КОММЕНТАРИЙ 1К HELLO IM A SIMPLE COMMENT 2К HELLO IM A PAX ASSOCIATED COMMENT /1Ф У УСЛУГИ 1У SSR PETC KK HN1 DOG/1С/2Ф 2У SSR FQTV KK HK1 KK2255778/1Ф 3У SSR INFT KK HK1 DOE/SMALL MS 11SEP13/1С/1Ф 4У SSR INFT KK HK1 DOE/SMALL MS 11SEP13/2С/1Ф 1И OSI KK THATS OSI
PNR DOE E5FAIX 15NOV/2108 900/KK000005 KK000005 IST(TR) KK(61000900) PAX=2-1-1-0 NOT TICKETED A/01MAR/0805/MOW I:NVO S FLT DD DT AT EQP S CKI DA T AA T CL ST QTY E M HOST/LOCATOR 1 KK31 01MAR 0905 1035 320 0735 ADA IST Y HK 3 E 2 KK30 10MAR 0700 0830 320 0530 IST ADA Y HK 3 E N NAME/FOID PTC TICKETS 1 DOE JANE MRS/PP TR 22234512 2 DOE JOHN MR/PP TR 22234513 3 DOE MEDIUM MR 12DEC07-1N/PP TR 22234514 CNN:C 4 DOE SMALL MS 11SEP13-1N/PP TR 22234514 INF:I O PHONE 1P +9023312312312/M 2P TEST@TEST.COM/E O COMMENTS 1C HELLO IM A SIMPLE COMMENT 2C HELLO IM A PAX ASSOCIATED COMMENT /1N V SERVICE 1S SSR PETC KK HN1 DOG/1S/2N 2S SSR FQTV KK HK1 KK2255778/1N 3S SSR INFT KK HK1 DOE/SMALL MS 11SEP13/1S/1N 4S SSR INFT KK HK1 DOE/SMALL MS 11SEP13/2S/1N 1O OSI KK THATS OSI
TBA
TBA
SciGetPNR request retrieves PNR by record locator.
If unfamiliar with PNR basics in TAIS CRS, it’s strongly recommended that you refer to section 1 of volume 3-1 Booking. Basic Techniques (ftp://ftp.tais.ru/pub/doc/Agents_Manuals_English/volume%203-1%20Booking.%20Basic%20Techniques.doc) first. Russian equivalent is available at (ftp://ftp.tais.ru/pub/doc/Agents_Manuals_Russian/%D2%EE%EC%201%20-%20%D0%D3%CA%CE%C2%CE%C4%D1%D2%C2%CE%20%CF%CE%20%C1%D0%CE%CD%C8%D0%CE%C2%C0%CD%C8%DE.doc).
WSDL for SciCreatePNR is as follows:
WebServiceURL/sigws/SciGetPNR/SIRENA.SCILOCATOR/SIRENA.SCIPNR?WSDL
E4_1) SIRENA.SCILOCATOR: The root element.
Attributes: none
Elements:
Contains exactly one LOCATOR element, which also contains exactly one LOCATOR element. The value of this last LOCATOR element should be the record locator.
Please note that code sets used in the response will depend on your language settings. For Cyrillic users, STC (TCH) Cyrillic codes will be used if available. If not, IATA codes will be used. For English users, the response will always show IATA or legacy English codes.
E4_21) SIRENA.SCIPNR: The root element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
ORDER |
n/a |
M |
1 |
General data. See below E4_22) |
PASSENGER |
n/a |
M |
99 |
Passenger data. See below E4_23) |
PSGRDISC |
n/a |
O |
|
Passenger type code. See below E4_24) |
PSGRSEGINFO |
|
|
|
Additional information per passenger and segment. See below E4_25) |
PSGRREF |
n/a |
O |
|
Reference between PASSENGER and SSR, OSI, COMMENT, FFPDOC elements. See below E4_26) |
AIRSEG |
n/a |
M |
16 |
Flight segment. See below E4_27) |
MEMBER |
|
O |
|
Information on other hosts (GDS, CRS of interline partners, etc) involved in the booking. See below E4_28) |
SSR |
n/a |
O |
|
Special Service Request. See below E4_29) |
OSI |
n/a |
O |
|
Other Service Information. See below E4_30) |
COMMENT |
n/a |
O |
|
Comment. See below E4_31) |
TELEPHONE |
n/a |
M |
|
Contact. See below E4_32) |
FFPINFO |
n/a |
O |
|
Frequent Flyer data. See below E4_33) |
TST |
n/a |
O |
|
General pricing data. See below E4_34) |
TSTFLIGHTSEG |
n/a |
O |
|
Fligth segments as present in pricing data. See below E4_35) |
TSTSSR |
n/a |
n/a |
|
Not used |
FARECOMPONENT |
n/a |
O |
|
Fare component data. See below E4_37) |
FARECOMPONENTSEG |
n/a |
O |
|
Fare component segment. See below E4_38) |
TAX |
n/a |
O |
|
Tax data (per each tax). See below E4_39) |
TRANSACTION |
n/a |
M |
1 |
Actor details for the last PNR modification transaction. See below E2_40) |
COMPANYLKP |
n/a |
M |
|
Carrier reference data. For explanation, please refer to the relevant sciWhat section (TBA) |
PLANETYPELKP |
n/a |
M |
|
Equipment Type reference data. For explanation, please refer to the relevant sciWhat section (TBA) |
TOWN |
n/a |
M |
|
Point reference data. For explanation, please refer to the relevant sciWhat section (TBA) |
E4_22) ORDER: General data.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | ||||||||||||||||||||||||||||||
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) | ||||||||||||||||||||||||||||||
ORDTYPE |
string |
M |
1 |
PNR Type: С – non-group PNR G – group PNR | ||||||||||||||||||||||||||||||
ORDRANK |
string |
M |
1 |
PNR Rank (booking source): P – PNR created directly in TAIS CRS (as opposed to PNR created via GDS)
| ||||||||||||||||||||||||||||||
ORDNAME |
string |
M |
1 |
PNR name | ||||||||||||||||||||||||||||||
NOPASSENGER |
short |
M |
1 |
Number of Adults | ||||||||||||||||||||||||||||||
NOCHILDREN |
short |
M |
1 |
Number of Children | ||||||||||||||||||||||||||||||
NOINFANTS |
short |
M |
1 |
Number of Infants | ||||||||||||||||||||||||||||||
TAP |
string |
M |
1 |
Booking terminal ID (TID) | ||||||||||||||||||||||||||||||
OPERGRD OPERORG OPEROFFICENO OPERNO |
string |
M |
1 |
Booking office and user codes. For example, KK0001 as office code and 1001 as user code. Here: OPERGRD=’000’ OPERORG=’KK’ OPEROFFICENO=’1’ OPERNO=’1001’ | ||||||||||||||||||||||||||||||
TKTGRD TKTORG |
string string |
O |
1 |
Ticketing organization (agency) code. If omitted, same as booking organization. | ||||||||||||||||||||||||||||||
TKTOFFICENO |
long |
O |
1 |
Ticketing office code (within ticketing organization). If ‘0’, same as booking office code. | ||||||||||||||||||||||||||||||
The below fields relate (down to COUNTRY, included) to a Point of Sale (POS) that effected the LAST PNR modification. | ||||||||||||||||||||||||||||||||||
FORMOWNER |
string |
M |
1 |
Stock provider (Carrier code; IAT – for BSP points of sale; or TCH). Sometimes blank or ‘00’ (not defined). | ||||||||||||||||||||||||||||||
PTNUMBER |
string |
M |
1 |
Point of Sale number, normally referred to as ‘IATA number’ | ||||||||||||||||||||||||||||||
PTTYPE |
string |
M |
1 |
Point of Sale type: N – non-IATA accredited (standard for airline POS) T – IATA-accredited | ||||||||||||||||||||||||||||||
PARTITION |
string |
M |
1 |
TAIS CRS partition in which PNR modification was effected: GDS – distribution system (partition in which agents and agent-like processes work) COD – host (partition in which administrators and system process work) | ||||||||||||||||||||||||||||||
LOCATION |
string |
M |
1 |
Point of Sale location city code | ||||||||||||||||||||||||||||||
COUNTRY |
string |
M |
1 |
Point of Sale location country code | ||||||||||||||||||||||||||||||
CTRLMEMBER |
short |
NA |
1 |
Not used in booking responses | ||||||||||||||||||||||||||||||
ORDPHASE |
string |
M |
1 |
General status of the PNR
| ||||||||||||||||||||||||||||||
TLOWNER |
string |
M |
1 |
Time limit source: U – entered by User S – calculated by System H – received from GDS (happens only with Russian GDS 1M and 1H) | ||||||||||||||||||||||||||||||
TLTYPE1 |
string |
O |
1 |
Type of time limit 1 (a PNR can have two time limits in TAIS CRS): ‘-‘ – no time limit (tickets issued or time limit otherwise cleared) A – automatic М – manual I – immediate ticketing | ||||||||||||||||||||||||||||||
EXPIREDATE1 |
dateTime |
O |
1 |
Expiration time of time limit 1. Local time of the TLPOINT point. | ||||||||||||||||||||||||||||||
TLTYPE2 |
string |
O |
1 |
Type of time limit 2 | ||||||||||||||||||||||||||||||
EXPIREDATE2 |
dateTime |
O |
1 |
Expiration time of time limit 2 | ||||||||||||||||||||||||||||||
TLPOINT |
string |
O |
1 |
Point (location) whose time zone is assumed to be used in EXPIREDATE1 / EXPIREDATE2. | ||||||||||||||||||||||||||||||
ERSPUSERID |
string |
O |
1 |
ERSP user ID | ||||||||||||||||||||||||||||||
ERSPDEPPOINT |
string |
O |
1 |
First departure point (applies only to ERSP) |
E4_23) PASSENGER: Passenger data.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
PSGRID |
short |
M |
1 |
Passenger unique ID within the response |
PSGRNAME |
string |
M |
1 |
Passenger name, including title |
BIRTHDATE |
string |
O |
1 |
Passenger date of birth, DDMMMYY |
PASSPORT |
string |
O |
1 |
Passenger passport/ID data (FOID) except expiry date |
EXPIRYDATE |
dateTime |
O |
1 |
Passenger passport/ID expiry date |
RESIDENCE |
string |
NA |
1 |
Not used |
BORDERZONEDOC |
string |
O |
1 |
Border zone entry permission details (free-flow text) |
AGECAT |
short |
M |
1 |
Age category: 0 – Adult 1 – Child 2 – Infant |
ADULTID |
short |
O |
1 |
Reference to the accompanying adult passenger’s PSGRID (for children and infants) |
PAXID |
long |
M |
1 |
Passenger unique ID in TAIS CRS |
E4_24) PSGRDISC: Passenger type code.
A passenger can have one or two type codes in TAIS CRS. Standard ATPCO and Airline-specific codes can be used.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
PSGRID |
short |
M |
1 |
Reference to the passenger’s PSGRID |
ORDNO |
short |
M |
1 |
Passenger type code sequential number for the given passenger |
PASSCAT |
string |
M |
1 |
Passenger type code. Please use ‘КП,INF’ (‘PTC,INF’ in English) command on TAIS CRS terminal for explanation on specific PTC. Some commonly used codes are: CNN – child INF – infant INS – infant occupying a seat YTH – youth SRC – senior MIL – military (there are a lot of other codes for military persons) SEA – seaman |
BASEMENTDOC |
string |
O |
1 |
Details of document used as proof of passenger type code application. Free-flow text |
E4_25) PSGRSEGINFO: Additional information per passenger and segment (mainly ticket-related). The key is (LOCATOR, PSGRID, DEPPOINT,ARRPOINT).
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
PSGRID |
short |
M |
1 |
Reference to the passenger’s PSGRID |
DEPPOINT |
string |
M |
1 |
Departure point (city) code |
ARRPOINT |
string |
M |
1 |
Arrival point (city) code |
SEGID |
short |
M |
1 |
Reference to the AIRSEG (E4_27) element within the response |
NOSEATS |
short |
M |
1 |
Number of seats (normally 1) |
EXTRASEATTYPE |
string |
M |
1 |
Type of extra seats: U or blank – not defined E – for passenger B – for baggage |
SEATS |
string |
O |
1 |
Specific seat numbers (e.g., 1A) |
TICKETID |
long |
M |
1 |
Reference to the ticket description (not present in the response) |
RETURNRECEIPID |
long |
M |
1 |
Reference to the refund receipt description (not present in the response) |
TICKETINGMETHOD |
string |
M |
1 |
Ticket type: U or blank – not defined А – automated М –manual E – electronic |
TICKETNUMBER |
string |
M |
1 |
Ticket number. Can be empty if there is no ticket for the passenger-segment combination. |
TICKETSTATUS |
string |
M |
1 |
Ticket presesnse status: N or blank – no ticket T – ticket present U – ticket used P – ticketing cycle in process |
TSTID |
short |
O |
1 |
Reference to the TST element within the response |
COUPONSTATUS |
string |
O |
1 |
Status of the corresponding ET coupon. Present only when there’s such coupon available. |
E4_26) PSGRREF: Reference between passenger (PASSENGER) and other non-segment elements (SSR, OSI, COMMENT, FFPINFO). For example, to establish association between passenger and his/her special meal SSR.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
PSGRID |
short |
M |
1 |
Reference to the passenger’s PSGRID |
OBJID |
short |
M |
1 |
Reference to the non-segment element’s unique ID withn the response. Elements that can be passenger-associated are: - SSR. Almost all SSR but a few exceptions (e.g., SSR OTHS) have to be passenger-associated. - OSI. Normally not passenger-associated, but can be. - COMMENT. Normally not passenger-associated, but can be associated to a single passenger - FFPINFO. For this element passenger association is mandatory |
E4_27) AIRSEG: Flight segment.
Attributes: none
Elements:
In this description ‘Mandatory/Optional/Not Available’ data is provided in relation to each segment type (V – regular(confirmed),O – open-date, N – ARNK).
Name |
Type |
V |
O |
N |
RP |
Comment | ||||||||||||
LOCATOR |
string |
M |
M |
M |
1 |
PNR locator (unique reference) | ||||||||||||
SEGID |
short |
M |
M |
M |
1 |
Unique segment ID within the response | ||||||||||||
POSINROUTE |
short |
M |
M |
? |
1 |
Segment sequential number in the route, starting with ‘0’. All segment types count. | ||||||||||||
AK |
string |
M |
M |
NA |
1 |
Carrier code | ||||||||||||
OAK |
string |
O |
NA |
NA |
1 |
Operating carrier code (for code-share flights only) | ||||||||||||
REIS |
string |
M |
O |
NA |
1 |
Flight number | ||||||||||||
MOD |
string |
O |
O |
NA |
1 |
Flight number modifier (obsolete) | ||||||||||||
DEPGRD |
string |
M |
M |
M |
1 |
Departure city code | ||||||||||||
ARRGRD |
string |
M |
M |
M |
1 |
Arrival city code | ||||||||||||
DEPDATE |
dateTime |
M |
M |
M |
1 |
Departure date | ||||||||||||
RBD
|
string |
M
|
M |
NA |
1 |
Booking class (RBD) | ||||||||||||
SERVCLASS |
string |
M |
M |
NA |
1 |
Service class: П/Б/Э F/C/Y | ||||||||||||
DEPARPT |
string |
M |
M |
M |
1 |
Departure airport code | ||||||||||||
ARRARPT |
string |
M |
M |
M |
1 |
Arrival airport code | ||||||||||||
DEPTERM |
string |
O |
NA |
NA |
1 |
Departure terminal code | ||||||||||||
ARRTERM |
string |
O |
NA |
NA |
1 |
Arrival terminal code | ||||||||||||
DEPTIME |
long |
M |
NA |
NA |
1 |
Departure time. Number of MINUTES after 00:00:00 of DEPDATE | ||||||||||||
ARRTIME |
long |
M |
NA |
NA |
1 |
Arrival time. Number of MINUTES after 00:00:00 of DEPDATE | ||||||||||||
DEPTIMEGMT |
long |
M |
NA |
NA |
1 |
Departure time in GMT/UTC. Number of MINUTES after 00:00:00 of DEPDATE. Can be negative. | ||||||||||||
ARRTIMEGMT |
long |
M |
NA |
NA |
1 |
Arrival time in GMT/UTC. Number of MINUTES after 00:00:00 of DEPDATE. Can be negative. | ||||||||||||
CHECKINTIME |
long |
M |
NA |
NA |
1 |
Check-in start time. Number of MINUTES after 00:00:00 of DEPDATE | ||||||||||||
PLANETYPE |
string |
M |
NA |
NA |
1 |
Equipment type | ||||||||||||
NOLANDINGS |
short |
M |
NA |
NA |
1 |
Number of intermediate stops on this segment | ||||||||||||
TOS |
string |
O |
NA |
NA |
1 |
Type of service:
| ||||||||||||
NOSEATS |
short |
M |
M |
NA |
1 |
Number of seats | ||||||||||||
SEATS |
string |
O |
NA |
NA |
1 |
Not used | ||||||||||||
WEIGHT |
long |
O |
NA |
NA |
1 |
Not used | ||||||||||||
SEGTYPE |
string |
M |
M |
M |
1 |
Segment type: V – regular (confirmed) O – open-date N – surface segment (ARNK) | ||||||||||||
HOLDER |
string |
M |
NA |
M |
1 |
Reference to the MEMBER element 0 – no reference This field will have positive values if the flight is hosted outside TAIS CRS, and TAIS CRS is used as a GDS too book it. For example, for flights of interline partners of TAIS CRS-hosted airlines. | ||||||||||||
BSGGRD |
string |
O |
NA |
NA |
1 |
Allotment city code. This field is provided if flight inventory was pulled from an allotment (a kind of block space PNR in TAIS CRS). | ||||||||||||
BGSORG |
string |
O |
NA |
NA |
1 |
Allotment organization code. This field is provided if flight inventory was pulled from an allotment (a kind of block space PNR in TAIS CRS). | ||||||||||||
AAS |
string |
M |
M |
NA |
1 |
Segment status: HK – confirmed HN – requested HL – waitlisted OP – open-date and other AIRIMP codes | ||||||||||||
AKA |
short |
M |
M |
NA |
|
Booking confirmation from outside host flag: 0 – no confirmation or local inventory 1 – confirmation received This field will can have positive value if the flight booked is hosted outside TAIS CRS, and TAIS CRS is used as a GDS too book it. For example, for flights of interline partners of TAIS CRS-hosted airlines. So it tells if the outside host sent booking confirmation to TAIS CRS. | ||||||||||||
STREAM |
short |
M |
M |
NA |
1 |
Obsolete. If present, always has the value of ‘0’. | ||||||||||||
WLPRTY |
short |
M |
M |
NA |
1 |
Segment priority on the waitlist (only for waitlisted segments). Actual usage will take place after reform of waitlists in TAIS CRS. At the moment, there will be a value of ‘0’ for regular and ‘-1’ for open-date segments. | ||||||||||||
ALTERSEG |
short |
M |
M |
NA |
1 |
Reference to another segment (AIRSEG.SEGID) in the same PNR offering a more desirable alternative for the same departure and arrival airports. ‘0’ if no such segment. A real-life situation is when two segments are booked for the same airport pair in the same direction (AYT -> IST) on the same date (and in the same PNR). One is confirmed (HK), another is waitlisted (HL). The waitlisted segment is considered the better alternative as it was probably booked to get a better price. TAIS CRS knows to automatically cancel the less preferable option once the more preferable one gets confirmed. | ||||||||||||
MARRYNO |
short |
M |
M |
NA |
1 |
Number of ‘married segments’ group. Set to ‘0’ for non-married segments. | ||||||||||||
SUBFLYID |
long |
M |
M |
M |
1 |
Unique flight ID in TAIS CRS (sometimes returned even if the flight does not actually exist) | ||||||||||||
STOPS |
|
O |
NA |
NA |
1 |
Codes of airports where intermediate stops take place |
E4_28) MEMBER: Information on other hosts (GDS, CRS of interline partners, etc) involved in the booking.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
TAIS CRS PNR locator (unique reference) |
MBRID |
short |
M |
1 |
Unique element ID within the response |
MBRGRD
|
string |
M |
1 |
Other host city code (e.g., ‘MUC’) |
MBRORG |
string |
M |
1 |
Other host 2-character code (e.g., ‘1A’) |
MBRTYPE |
string |
M |
1 |
Other host type. Currently always ‘AP’, indicating that the other host supports AIRIMP communication. |
INVLOCATOR |
string |
M |
1 |
Locator of other host PNR. Regardless of whether TAIS CRS acts as GDS or inventory system, the other host will always have its own PNR for the same reservation. These PNR are automatically kept in sync. |
SALEPOINT |
string |
M |
1 |
Point of Sale details as extracted from the inbound AIRIMP message |
SUBHOSTGRD |
string |
M |
1 |
TAIS CRS subhost city code (e.g., ‘IST’). TAIS CRS subhost is the way other systems can identify partition of each airline in TAIS CRS. For example, ‘ISTKK’ is the partition of Atlasjet. This is used, for example, for signing teletype messages. |
SUBHOSTORG |
string |
M |
1 |
TAIS CRS subhost carrier code (e.g., ‘KK’). Please see explanation of subhost above. |
LOCKMOD |
short |
M |
1 |
Obsolete. Currently always ‘0’ |
E4_29) SSR: Special Service Request. Please provide data in compliance with AIRIMP or airline policy (for airline custom SSR).
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference). Specify ‘NEW’ for a new PNR |
SSRID |
short |
M |
1 |
Unique SSR ID within the response |
SSRCODE |
string |
M |
1 |
SSR code. See AIRIMP or ‘ЧТО,,У’ (‘REF,,V’) on TAIS CRS terminal for complete list |
AK |
string |
M |
1 |
Carrier code (IATA or STC (TCH) code set) |
SEGID |
string |
M |
1 |
Reference to the flight segment (AIRSEG.SEGID) within the response. For non-automated SSR, set to ‘0’. |
QTY |
string |
M |
1 |
Number of SSR units |
AAS |
string |
M |
1 |
SSR status: HK – confirmed HN – responseed UN/NO – rejected and other AIRIMP codes |
FREETEXT |
string |
O |
1 |
SSR ‘free text’ part. This can also contain explanation for rejected responses. |
Please pay attention that there’s no explicit passenger reference inside the SSR element (but in the PNR it exists in most cases)! Such reference is established externally using PSGRREF element E2_26).
For SSR FQTx (Frequent Flyer data) created in the PNR, there will be no such SSR in the response, but the FFPINFO element (explained below).
E4_30) OSI: Other Service Information.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
OSIID |
short |
M |
1 |
Unique OSI ID within the response |
AK |
string |
M |
1 |
Carrier code |
SEGID |
string |
M |
1 |
Reference to the flight segment (AIRSEG.SEGID) within the response. Normally not used, in which case ‘0’ is returned in the response. |
FREETEXT |
string |
M |
1 |
Free-flow text (up to 255 characters) |
E4_31) COMMENT: Free Comment / Remark.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
CMTID |
short |
M |
1 |
Unique comment ID within the response |
SEGID |
string |
M |
1 |
Reference to the flight segment (AIRSEG.SEGID) within the response. Normally not used, in which case ‘0’ is returned in the response. |
FREETEXT |
string |
M |
1 |
Free-flow text (up to 255 characters) |
E4_32) TELEPHONE: Contact information.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | ||||||||||||||||||
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) | ||||||||||||||||||
PHNID |
short |
M |
1 |
Unique contact ID within the response | ||||||||||||||||||
PHNTYPE |
string |
M |
1 |
Contact type (English for all users!!!):
| ||||||||||||||||||
PHNNUMBER |
string |
M |
1 |
Free-flow text (up to 255 characters) |
E4_33) FFPINFO:Frequent Flyer data. This is based on SSR FQTV/FQTR/FQTU created in the TAIS CRS PNR.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
FFPINFOID |
short |
M |
1 |
Unique Frequent Flyer data ID within the response |
INFOTYPE |
string |
M |
1 |
Frequent Flyer data type: V – accrual (based on SSR FQTV) R – redemption (based on SSR FQTR) U – upgrade (based on SSR FQTU) |
AK |
string |
M |
1 |
Carrier code |
SEGID |
short |
M |
1 |
Reference to the flight segment (AIRSEG.SEGID) within the response. For non-automated SSR, set to ‘0’. |
FFAK |
string |
M |
1 |
Frequent flyer airline code |
FFCARDNMBR |
string |
M |
1 |
Frequent flyer card number |
CARDHOLDER |
string |
M |
1 |
Frequent flyer holder name |
Please pay attention that there’s no explicit passenger reference inside the FFPINFO element! Such reference is established externally using PSGRREF element E2_26).
E4_34) TST: General pricing data. All other pricing elements (E4_35 – E4_39) are always related to some TST element and have a reference to it (TSTID).
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | |||||||||||||||
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) | |||||||||||||||
TSTID |
short |
M |
1 |
Unique TST element ID within the response | |||||||||||||||
TOTAL |
double |
M |
1 |
Total amount in the payment currency (CURRENCY) | |||||||||||||||
FARE |
double |
M |
1 |
Fare amount in the payment currency (CURRENCY) | |||||||||||||||
TAX |
double |
M |
1 |
Tax amount in the payment currency (CURRENCY) | |||||||||||||||
CURRENCY |
string |
M |
1 |
Payment currency | |||||||||||||||
AUTOPRICING |
short |
M |
1 |
Automatic pricing flag: 0 – manual pricing 1 – automatic pricing | |||||||||||||||
TIMELIMIT |
dateTime |
M |
1 |
Ticketing time limit (validity of the pricing record). Can be the same as in PNR or different (based on Fare Rules, etc) | |||||||||||||||
ENGNAMEONLY |
short |
M |
1 |
English passenger name flag: 0 – passenger name can be entered in Cyrillic 1 – passenger name must be in English | |||||||||||||||
FORMOWNER |
string |
M |
1 |
Stock provider (Carrier code; IAT – for BSP points of sale; or TCH) | |||||||||||||||
FORMCODE |
string |
M |
1 |
Accouning code and 2 digits of the form code as defined by IATA (e.g.,81824) | |||||||||||||||
VAK |
string |
M |
1 |
Validating carrier | |||||||||||||||
ET |
string |
M |
1 |
ET flag: ET – issuance of electronic ticket is allowed | |||||||||||||||
PAYMETHODS |
string |
M |
1 |
Allowed forms of payment. Can be empty. | |||||||||||||||
EXCFLAG |
short |
O |
1 |
Exchange flag | |||||||||||||||
EXСTYPE |
string |
O |
1 |
Exchange type:
| |||||||||||||||
OLDFARE |
double |
O |
1 |
Amount of the old ticket used as payment for the new ticket (in case of exchange) | |||||||||||||||
ADDCOLLECT |
double |
O |
1 |
Additional collection amount (in case of exchange) | |||||||||||||||
TOURCODE |
string |
O |
1 |
Tour code | |||||||||||||||
LINEARFARECALC |
string |
M |
1 |
Fare calculation line. For PNR ticketed via TAIS CRS it will be empty. It will have values only for PNR created via GDS | |||||||||||||||
FARECUR |
string |
M |
1 |
Fare currency (currency of the ticket ‘Fare’ field selected according to IATA rules). For domestic travel, this is normally the fare publication currency. For international travel, currency of the country of commencement of international travel, or EUR/USD | |||||||||||||||
VALINFARECUR |
string |
M |
1 |
Fare amount in the fare currency (FARECUR) |
E4_35) TSTFLIGHTSEG: Pricing flight segments. This is the amount of data created based mainly on the PNR flight segments (but a separate data set in pricing structures!) and corresponding to itinerary data of ET flight coupons. The key is (LOCATOR,TSTID,SEGNO).
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
TSTID |
short |
M |
1 |
Reference to the TST element within the response |
SEGNO |
short |
M |
1 |
Unique reference to the TSTFLIGHTSEG within the response and the TSTID |
SEGTYPE |
string |
M |
1 |
Segment type: V – regular (confirmed) O – open-date N – surface segment (ARNK) B – passive segment I – arrival/continuation segment |
AK |
string |
M |
1 |
Marketing carrier code |
OAK |
string |
M |
1 |
Operating carrier code |
REIS |
string |
M |
1 |
Flight number |
MOD |
string |
n/a |
1 |
Not used |
DEPGRD |
string |
M |
1 |
Departure city |
ARRGRD |
string |
M |
1 |
Arrival city |
DEPDATE |
dateTime |
M |
1 |
Scheduled departure date |
RBD |
string |
M |
1 |
Booking class (RBD) |
SERVCLASS |
string |
M |
1 |
Service class П/Б/Э F/C/Y |
DEPTIME |
long |
M |
1 |
Departure time. Number of MINUTES after 00:00:00 of DEPDATE |
ARRTIME |
long |
M |
1 |
Arrival time. Number of MINUTES after 00:00:00 of DEPDATE |
DEPTIMEGMT |
long |
O |
1 |
Departure time in GMT/UTC. Number of MINUTES after 00:00:00 of DEPDATE. Can be negative. |
ARRTIMEGMT |
long |
O |
1 |
Arrival time in GMT/UTC. Number of MINUTES after 00:00:00 of DEPDATE. Can be negative. |
CHECKINTIME |
long |
O |
1 |
Check-in start time. Number of MINUTES after 00:00:00 of DEPDATE |
PLANETYPE |
string |
O |
1 |
Equipment type |
STATUS |
string |
O |
1 |
Reservation status (as present in the ticket): OK – confirmed SA – standby (space available) NS – no seat (infant) RQ – open-date for tickets from GDS Galileo (1G) and interline partners OP – open-date for GDS Travelsky (1E) and some other systems (non-standard) blank – open-date for major GDS (standard)
Therefore, it’s better to use SEGTYPE field to identify open date. |
E4_37) FARECOMPONENT: Fare component data. Fare compomens is a part of itinerary that can be priced with OW or RT/2 fare. Pricing element E4_38 (the next one in the manual) is always related to some FARECOMPONENT element and have a reference to it (CMPNO). The key is (LOCATOR,TSTID,CMPNO).
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
TSTID |
short |
M |
1 |
Reference to the TST element within the response |
CMPNO |
short |
M |
1 |
Unique ID of the FARECOMPONENT within the response and the TSTID |
FARECOMPTYPE |
string |
M |
1 |
Fare component type: F – flight S – surface segment |
SIDETRIPNO |
short |
M |
1 |
number of the side-trip to which the fare component is related. 0 – fare component is related to the basic part of the transportation |
ORIG |
string |
M |
1 |
Fare component origin (departure point) |
TARCODE |
string |
M |
1 |
Fare basis code |
UPTKEY |
string |
M |
1 |
Reference to the Fare Rules |
VALINPAYCUR |
long |
M |
1 |
Fare component amount in the payment currency |
E4_38) FARECOMPONENTSEG: Fare component segment. One fare component (E4_37 above) can have several segments in case of a through fare. The key is (LOCATOR,TSTID,CMPNO,CMPSEGNO).
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
TSTID |
short |
M |
1 |
Reference to the TST element within the response |
CMPNO |
short |
M |
1 |
Reference to the FARECOMPONENT within the response and the TSTID |
CMPSEGNO |
short |
M |
1 |
Unique ID of the FARECOMPONENTSEG within the response, TSTID, CMPNO |
SEGTYPE |
string |
M |
1 |
Segment type: F – flight S – surface segment |
AK |
string |
M |
1 |
Carrier code |
DEST |
string |
M |
1 |
Segmet destination (arrival point) |
ISTRANSFER |
short |
M |
1 |
Transfer flag: 0 – there is no transfer at the destination point 1 – there is transfer at the destination point |
NVB |
dateTime |
O |
1 |
‘Not Valid Before’ date |
NVA |
dateTmie |
O |
1 |
‘Not Valid After’ date |
ALLOWTYPE |
string |
M |
1 |
Free baggage allowance type: NO – no free baggage allowance KG – free baggage allowance is set in kilograms. The allowed value is entered in the ALLOWVALUE parameter LB – free baggage allowance is set in pounds. The allowed value is entered in the ALLOWVALUE parameter PC – piece system is used. The allowed value is entered in the ALLOWVALUE parameter EMPTY – free baggage allowance is unknown |
ALLOWVALUE |
short |
M |
1 |
free baggage allowance value |
SIDETRIPNO |
short |
M |
1 |
number of the side-trip beginning at the destination point of the segment. 0 – no side trip |
E4_39) TAX: Tax data (per each tax). The key is (LOCATOR,TSTID,TAXNO).
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | |||||||||||||||||||||
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) | |||||||||||||||||||||
TSTID |
short |
M |
1 |
Reference to the TST element within the response | |||||||||||||||||||||
TAXNO |
short |
M |
1 |
Unique ID of the TAX within the response and TSTID | |||||||||||||||||||||
SEGNO |
string |
M |
1 |
Sequential number of the segment the tax is associated with. Numbering begins with 0, can be blank (in PNR booked via GDS) | |||||||||||||||||||||
TAXSTATUS |
string |
M |
1 |
Tax status:
On newly issued tickets only Н/N will appear. | |||||||||||||||||||||
TKTCODE |
string |
M |
1 |
Tax code | |||||||||||||||||||||
SSRCODE |
short |
n/a |
1 |
Not used | |||||||||||||||||||||
TAXVALUE |
dateTime |
O |
1 |
Tax amount in the payment currency (TST(LOCATOR,TSTID).CURRENCY) |
E4_40) TRANSACTION: Actor details for the last (most recent) PNR modification transaction. Basically, it repeats most elements from the ORDER element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
TRNO |
short |
M |
1 |
Transaction number |
TAP |
string |
M |
1 |
Terminal ID (TID) |
OPERGRD OPERORG OPEROFFICENO OPERNO |
string |
M |
1 |
Office and user codes. For example, KK0001 as office code and 1001 as user code. Here: OPERGRD=’000’ OPERORG=’KK’ OPEROFFICENO=’1’ OPERNO=’1001’ |
FORMOWNER |
string |
M |
1 |
Stock provider (Carrier code; IAT – for BSP points of sale; or TCH). Sometimes blank or ‘00’ (not defined). |
PTNUMBER |
string |
M |
1 |
Point of Sale number, normally referred to as ‘IATA number’ |
PTTYPE |
string |
M |
1 |
Point of Sale type: N – non-IATA accredited (standard for airline POS) T – IATA-accredited |
PARTITION |
string |
M |
1 |
TAIS CRS partition in which PNR modification was effected: GDS – distribution system (partition in which agents and agent-like processes work) COD – host (partition in which administrators and system process work) |
LOCATION |
string |
M |
1 |
Point of Sale location city code |
COUNTRY |
string |
M |
1 |
Point of Sale location country code |
TCC |
strting |
M |
1 |
Transaction end command that was used: SV – ‘E’ (end transaction = save PNR and close) CP – ‘ER’ (end and retrieve = save PNR and don’t close) |
STARTTIME |
dateTime |
M |
1 |
Transaction start time |
ENDTIME |
dateTime |
M |
1 |
Transaction end time |
This is a simple one-way booking already priced
ЗАКАЗ DOE E5FAIU 17ЯНВ/1710 188/99СИР001 KK000005 IST(TR) KK(61000900) ПАС=1-0-0-0 НЕ ПРОДАН А/01МАР/0805/МОВ И:ФУП И C РВ ДВ ВВ ВП ТС П РЕГ АО Т АН Т БР СТ КМ Е M ЦОД/ЛОКАТОР 1 KK31 01МАР 0905 1035 320 0735 ADA IST Y HK 1 E Ф ФИО/ДОКПАС КП БИЛЕТЫ 1 DOE JANE MRS/PP TR 22234512 1П П ТЕЛЕФОН 1Т +9023312312312/М П КОММЕНТАРИЙ 1К HELLO IM A COMMENT
ПАСПОРТ СДЕЛКИ (БЛТ/БЛ) KK ADAIST TRY АИЛ 20ЯНВ14 2250 188/99СИР0001 17JAN14/1910 E5FAIU/IST ## Х ПО АК РЕЙС БР ДВ ВВ СТ КОДТАР НДО НПО БГ 1 ADA KK 31 Y 01MAR 0905 OK Y 20K IST ТАРИФ=70.00EUR/192.00TRY,1EUR=2.73TRY СБОРЫ=44.95TRY ВСЕГО=236.95TRY 1 DOE JANE MRS/PPTR22234512 2 РТ 1 ADA KK IST 70EUR ИТОГО=70.00EUR 3 СБ Н/БЛТ, C1, AB, 15.00EUR/40.95TRY,1EUR=2.73TRY 4 СБ Н/БЛТ, C1, VQ, 4.00TRY *** ВЫКУПИТЬ ДО: 1МАР14/0805/МОВ (ТЛ В PNR) *** ФОРМА БЛАНКА: 61024
PNR DOE E5FAIU 17JAN/1710 188/99SIR001 KK000005 IST(TR) KK(61000900) PAX=1-0-0-0 NOT TICKETED A/01MAR/0805/MOW I:NVO H S FLT DD DT AT EQP S CKI DA T AA T CL ST QTY E M HOST/LOCATOR 1 KK31 01MAR 0905 1035 320 0735 ADA IST Y HK 1 E N NAME/FOID PTC TICKETS 1 DOE JANE MRS/PP TR 22234512 1T O PHONE 1P +9023312312312/M O COMMENTS 1C HELLO IM A COMMENT
TRANSACTION RECORD (TCT/TK) KK ADAIST TRY AIL 20JAN14 2254 188/99СИР0001 17JAN14/1910 E5FAIU/IST ## X DA CC FLT CLS DD DT ST FARE BASIS NVB NVA BAG 1 ADA KK 31 Y 01MAR 0905 OK Y 20K IST FARE=70.00EUR/192.00TRY,1EUR=2.73TRY TAXES=44.95TRY TOTAL=236.95TRY 1 DOE JANE MRS/PPTR22234512 2 FC 1 ADA KK IST 70EUR TOTAL=70.00EUR 3 TX N/TCT, S1, AB, 15.00EUR/40.95TRY,1EUR=2.73TRY 4 TX N/TCT, S1, VQ, 4.00TRY *** PURCHASE BEFORE: 01MAR/0805/MOW (TL IN PNR) *** TICKET FORM: 61024
SciPNRFareQuote creates a pricing record (transaction template) for each passenger type in a PNR. The essential request parameter is record locator (LOCATOR). The response contains pricing details for each passenger type. Pricing calcualtions are handled by TAIS CRS and are based on its Fare, Fare Rule, Tax, Rate, Baggage database.
WSDL for SciPNRFareQuote is as follows:
WebServiceURL/sigws/SciPNRFareQuote/SIRENA.SCIPNRFAREQUOTEQRY/SIRENA.SCIFAREQUOTERPL?WSDL
E5_1) SIRENA.SCIPNRFAREQUOTEQRY: The root element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
PNRFAREQUOTEQRY |
n/a |
M |
1 |
See below E5_2) |
PRICINGOPT |
n/a |
O |
|
See below E5_3) |
E5_2) PNRFAREQUOTEQRY: Record locator and modifiers.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
CURRENCY |
string |
O |
1 |
Pricing (and payment) currency. Use IATA or STC (TCH) code |
SALEDATE |
dateTime |
O |
1 |
Sale date. Default is current date. Sale date affects application of fare data (Fare, Taxes, etc), which often has sale date restrictions |
FLAGS |
string |
O |
1 |
Modifiers of theТП / FQ entry in TAIS CRS. The number of modifiers is significant, but in most cases you need only Е (E in English) – pricing for issuance of an ET. Even so, for most airlines this is enabled by default so you don’t need to use FLAGS. |
E5_3) PRICINGOPT: Additional pricing options.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
OPTKEY |
string |
M |
1 |
Option key (name). Details are available from TAIS upon request. |
OPTVAL |
string |
M |
1 |
Option value. Details are available from TAIS upon request. |
Please note that code sets used in the response will depend on your language settings. For Cyrillic users, STC (TCH) Cyrillic codes will be used if available. If not, IATA codes will be used. For English users, the response will always show IATA or legacy English codes.
E5_21) SCIFAREQUOTERPL: The root element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
FAREQUOTERPL |
n/a |
M |
1 |
General information. See below E5_22) |
FAREQUOTEVAR |
n/a |
M |
|
Fare quote variant (result). Normally there’s only one such element. See below E5_23) |
PAX |
n/a |
M |
|
Passenger type data. See below E5_24) |
FARECOMPONENT |
n/a |
M |
|
Fare component data. See below E5_25) |
FLIGHT |
n/a |
M |
|
See below E5_26) |
FLIGHTAVL |
n/a |
M |
|
See below E5_27) |
COMPANYLKP |
n/a |
M |
|
Carrier reference data. For explanation, please refer to the relevant sciWhat section (TBA) |
PLANETYPELKP |
n/a |
M |
|
Equipment Type reference data. For explanation, please refer to the relevant sciWhat section (TBA) |
TOWNLKP |
n/a |
M |
|
Point reference data. For explanation, please refer to the relevant sciWhat section (TBA) |
E5_22) FAREQUOTERPL: General information.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
CURRENCY |
string |
M |
1 |
Pricing (and payment) currency. Encoding (Cyrillic / English) will depend on your language settings. Can be empty. |
LINKDOWN |
short |
M |
1 |
“Link down” flag for fare queries sent by Sirena to some other hosts 0 – no “link down“ situation occured 1 – “link donw” situation occured |
E5_23) FAREQUOTEVAR: Fare quote variant (results). Contains summary data for all passengers of the PNR.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
VARNO |
string |
M |
1 |
Variant number |
CURRENCY |
string |
M |
1 |
Payment currency |
TOTAL |
double |
M |
1 |
Total amount in the payment currency (CURRENCY) for all passegners (=total price of all tickets to be issued) |
BASECURRENCY |
string |
M |
1 |
Fare currency (currency of the ticket ‘Fare’ field selected according to IATA rules). For domestic travel, this is normally the fare publication currency. For international travel, currency of the country of commencement of international travel, or EUR/USD |
FINALPRICE |
short |
M |
1 |
Final price flag: 0 – the price is not final, some taxes can be missing 1 – the price if final (includes all possible components) |
AUTOPRICING |
short |
M |
1 |
Automatic pricing flag: 0 – manual pricing 1 – automatic pricing |
TIMELIMIT |
dateTime |
M |
1 |
Ticketing time limit (validity of the pricing record). Can be the same as in PNR or different (based on Fare Rules, etc) |
ENGNAMEONLY |
short |
M |
1 |
English passenger name flag: 0 – passenger name can be entered in Cyrillic 1 – passenger name must be in English |
FORMOWNER |
string |
M |
1 |
Stock provider (Carrier code; IAT – for BSP points of sale; or TCH) |
FORMCODE |
string |
M |
1 |
Accouning code and 2 digits of the form code as defined by IATA (e.g.,81824) |
VAK |
string |
M |
1 |
Validating carrier |
ET |
string |
O |
1 |
ET flag: ET – issuance of electronic ticket is allowed |
CRSORG |
string |
M |
1 |
Not used |
PENTYPE |
short |
O |
1 |
Refund conditions: 1 – fare not refundable 2 – fare refundable 3 – fare refundable with penalty 4 – fare refundable, penalty charged in case of late refund 5 – fare refundable, penalty is possible |
INTERFACE |
string |
M |
1 |
Not used |
SHOPENG |
string |
M |
1 |
Not used |
E5_24) PAX: Passenger type data. Contains Fare and Tax data for one passenger type. The key is (VARNO, PTCNO).
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
VARNO |
short |
M |
1 |
Reference to the FAREQUOTEVAR element |
PTCNO |
short |
M |
1 |
ID of the passenger type |
AGECAT |
short |
M |
1 |
Age category: 0 – Adult 1 – Child 2 – Infant |
PCSET |
string |
M |
1 |
Passenger type code. Please use ‘КП’ (‘PTC’ in English) command on TAIS CRS terminal for a complete list. Some commonly used codes are: CNN – child INF – infant INS – infant occupying a seat YTH – youth SRC – senior MIL – military (there are a lot of other codes for military persons) SEA – seaman blank – adult |
COUNT |
short |
M |
1 |
Number of passengers in the PNR belonging to the current passenger type |
FARE |
float |
M |
1 |
Fare amount in the payment currency |
BASEFARE |
float |
M |
1 |
Fare amount in the fare currency (currency of the ticket ‘Fare’ field selected according to IATA rules) |
TAX |
float |
M |
1 |
Tax amount (all taxes) in the payment currency |
TOURCODE |
float |
O |
1 |
Tour code |
E5_25) FARECOMPONENT: Fare component data. Fare compomens is a part of itinerary that can be priced with OW or RT/2 fare. The key is (VARNO,PTCNO,CMPNO). In most cases (when there are no through fares), for each passenger type there will be a number of fare components equal to the number of flight segments.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
VARNO |
short |
M |
1 |
Reference to the FAREQUOTEVAR element |
PTCNO |
short |
M |
1 |
Reference to the PAX element |
CMPNO |
short |
M |
1 |
ID of the FARECOMPONENT element |
TKTNO |
short |
O |
1 |
Ticket sequential number |
SEGNO |
short |
O |
1 |
Sequential number of flight segment on which the fare component starts |
LASTSEGNO |
short |
O |
1 |
Sequential number of flight segment on which the fare component ends |
TARCODE |
string |
M |
1 |
Fare basis code |
UPTKEY |
string |
M |
1 |
Reference to the Fare Rules |
NVB |
dateTime |
O |
1 |
‘Not Valid Before’ date |
NVA |
dateTime |
O |
|
‘Not Valid After’ date |
E5_26) FLIGHT: Schedule and general data for a flight. The key is (VARNO,ORDERNO,POSINROUTE).
Attributes: none.
Elements:
Name |
Type |
ST |
RP |
Comment | ||||||||||||
VARNO |
short |
M |
1 |
Reference to the FAREQUOTEVAR element | ||||||||||||
ORDERNO |
short |
M |
1 |
First part of the unique FLIGHT element reference within the response. The complete reference consists of ORDERNO and POSINROUTE.
When a connection (two or more connecting flights) is returned in the response, all flights of the connection have the same ORDERNO but different POSINROUTE (see below). | ||||||||||||
POSINROUTE |
short |
M |
1 |
Second part of the unique FLIGHT element reference within the response. The complete reference consists of ORDERNO and POSINROUTE.
When a connection (two or more connecting flights) is returned in the response, all flights of the connection have the same ORDERNO but different POSINROUTE (see below). POSINOUTE numbering begins with 1.
For direct flights, this element value is always 0. | ||||||||||||
SECNO |
short |
O |
1 |
Sector number | ||||||||||||
SEGNO |
short |
O |
1 |
Flight segment sequential number | ||||||||||||
AK |
string |
M |
1 |
Marketing carrier code | ||||||||||||
OAK |
string |
O |
1 |
Operating carrier code (for code-share flights only) | ||||||||||||
FLIGHTNO |
string |
M |
1 |
Flight number | ||||||||||||
DEPDATE |
date |
M |
1 |
Departure date | ||||||||||||
TOS |
string |
O |
1 |
Type of service:
| ||||||||||||
PLANETYPE |
string |
M |
1 |
Equipment type | ||||||||||||
DEPARPT |
string |
M |
1 |
Departure airport code | ||||||||||||
DEPTERM |
string |
O |
1 |
Departure terminal code | ||||||||||||
ARRARPT |
string |
M |
1 |
Arrival airport code | ||||||||||||
ARRTERM |
string |
O |
1 |
Arrival terminal code | ||||||||||||
DEPTIME |
long |
M |
1 |
Departure time. Number of seconds after 00:00:00 of DEPDATE | ||||||||||||
ARRTIME |
long |
M |
1 |
Arrival time. Number of seconds after 00:00:00 of DEPDATE | ||||||||||||
CHECKINTIME |
long |
M |
1 |
Check-in start time. Number of seconds after 00:00:00 of DEPDATE | ||||||||||||
DEPTIMEGMT |
long |
M |
1 |
Departure time in GMT/UTC. Number of seconds after 00:00:00 of DEPDATE. Can be negative. | ||||||||||||
ARRTIMEGMT |
long |
M |
1 |
Arrival time in GMT/UTC. Number of seconds after 00:00:00 of DEPDATE. Can be negative. | ||||||||||||
NOSTOPS |
short |
O |
1 |
Number of intermediate stops. This is used only for flights with the same flight number and one or several scheduled landings in the route. Not to be confused with connections, which consist of different flight numbers and therefore are shown as separate FLIGHT elements. | ||||||||||||
MEAL |
string |
O |
1 |
Currently not used | ||||||||||||
INVGRD INVORG |
string string |
O |
1 |
Code of the flight inventory system (e.g., MUC1A). Normally blank for TAIS-hosted airline projects. | ||||||||||||
ACCESSLEVEL |
short |
M |
1 |
Flight inventory access level (for booking): 0 – unavailable 1 – standard (teletype) 2 – interactive 3 – local TAIS CRS host | ||||||||||||
LINKSTATUS |
short |
M |
1 |
Flight availability source link status: 0 – no link 1 – link down 2 – link up 3 – local TAIS CRS host | ||||||||||||
AVLSOURCE |
short |
M |
1 |
Availability source type: 0 – no availability data 1– Segment AVS (offline data based on processing of teletype Availability Status Messages which tell that seats are available but don’t tell how many) 2– Numeric AVS (offline data based on processing of teletype Availability Status Messages which tell how many seats are available) 3 – cached real-time data from airline host 4 – real-time data from airline host |
E5_27) FLIGHTAVL: ‘Booked seats’ data for one booking class (RBD).
Attributes: none.
Elements:
Name |
Type |
ST |
RP |
Comment |
VARNO |
short |
M |
1 |
Reference to the FAREQUOTEVAR element |
ORDERNO |
short |
M |
1 |
First part of the unique reference to the FLIGHT element within the response.
A set of FLIGHTAVL elements with the same unique reference provides availability data for all booking classes of the given FLIGHT. |
POSINROUTE |
short |
M |
1 |
Second part of the unique reference to the FLIGHT element within the response
A set of FLIGHTAVL elements with the same unique reference provides availability data for all booking classes of the given FLIGHT. |
RBD |
string |
M |
1 |
Booking class |
SERVCLASS |
string |
M |
1 |
Service class |
NOSEATS |
string |
M |
1 |
Number of seats booked |
PTCNO |
short |
M |
1 |
Reference to the PAX element |
ПАСПОРТ СДЕЛКИ (БЛТ/БЛ) KK ADAIST TRY АИЛ 22ЯНВ14 1616 188/99СИР0001 22JAN14/1355 E5FAIU/IST ## Х ПО АК РЕЙС БР ДВ ВВ СТ КОДТАР НДО НПО БГ 1 ADA KK 31 Y 01MAR 0905 OK Y 20K IST ТАРИФ=70.00EUR/192.00TRY,1EUR=2.73TRY СБОРЫ=44.95TRY ВСЕГО=236.95TRY 1 DOE JANE MRS/PPTR22234512 2 РТ 1 ADA KK IST 70EUR ИТОГО=70.00EUR 3 СБ Н/БЛТ, C1, AB, 15.00EUR/40.95TRY,1EUR=2.73TRY 4 СБ Н/БЛТ, C1, VQ, 4.00TRY *** ВЫКУПИТЬ ДО: 1МАР14/0805/МОВ (ТЛ В PNR) *** ФОРМА БЛАНКА: 61024
TRANSACTION RECORD (TCT/TK) KK ADAIST TRY AIL 22JAN14 1601 188/99СИР0001 22JAN14/1355 E5FAIU/IST ## X DA CC FLT CLS DD DT ST FARE BASIS NVB NVA BAG 1 ADA KK 31 Y 01MAR 0905 OK Y 20K IST FARE=70.00EUR/192.00TRY,1EUR=2.73TRY TAXES=44.95TRY TOTAL=236.95TRY 1 DOE JANE MRS/PPTR22234512 2 FC 1 ADA KK IST 70EUR TOTAL=70.00EUR 3 TX N/TCT, S1, AB, 15.00EUR/40.95TRY,1EUR=2.73TRY 4 TX N/TCT, S1, VQ, 4.00TRY
ADT
ПАСПОРТ СДЕЛКИ (БЛТ/БЛ) KK ADAADA TRY АИЛ 22ЯНВ14 1606 188/99СИР0001 22JAN14/1402 EANIMV/IST ## Х ПО АК РЕЙС БР ДВ ВВ СТ КОДТАР НДО НПО БГ 1 ADA KK 31 Y 01MAR 0905 OK YRT 20K 2 IST KK 30 Y 10MAR 0700 OK YRT 20K ADA ТАРИФ=140.00EUR/383.00TRY,1EUR=2.73TRY СБОРЫ=85.90TRY ВСЕГО=468.90TRY 1 DOE JANE MRS/PPTR22234512/KK KK2255778 2 DOE JOHN MR/PPTR22234513 3 РТ 1 ADA KK IST 70EUR 2 IST KK ADA 70EUR ИТОГО=140.00EUR 4 СБ Н/БЛТ, C1-2, AB, 2*15.00EUR/40.95TRY,1EUR=2.73TRY 5 СБ Н/БЛТ, C1, VQ, 4.00TRY *** ВЫКУПИТЬ ДО: 1МАР14/0805/МОВ (ТЛ В PNR) *** ФОРМА БЛАНКА: 61024
CNN
ПАСПОРТ СДЕЛКИ (БЛТ/БЛ) KK ADAADA TRY АИЛ 22ЯНВ14 1606 188/99СИР0001 22JAN14/1402 EANIMV/IST ## Х ПО АК РЕЙС БР ДВ ВВ СТ КОДТАР НДО НПО БГ 1 ADA KK 31 Y 01MAR 0905 OK YRT/CN20 20K 2 IST KK 30 Y 10MAR 0700 OK YRT/CN20 20K ADA ТАРИФ=112.00EUR/306.00TRY,1EUR=2.73TRY СБОРЫ=4.00TRY ВСЕГО=310.00TRY 1 DOE MEDIUM MR 12DEC07(CHD)/PPTR22234514,CNN/- 2 РТ 1 ADA KK IST 56EUR 2 IST KK ADA 56EUR ИТОГО=112.00EUR 3 СБ Н/БЛТ, C1, VQ, 4.00TRY *** ВЫКУПИТЬ ДО: 1МАР14/0805/МОВ (ТЛ В PNR) *** КАТЕГОРИЯ ПАССАЖИРА: CNN *** ФОРМА БЛАНКА: 61024
INF
ПАСПОРТ СДЕЛКИ (БЛТ/БЛ) KK ADAADA TRY АИЛ 22ЯНВ14 1607 188/99СИР0001 22JAN14/1402 EANIMV/IST ## Х ПО АК РЕЙС БР ДВ ВВ СТ КОДТАР НДО НПО БГ 1 ADA KK 31 Y 01MAR 0905 NS YRT/IN90 NO 2 IST KK 30 Y 10MAR 0700 NS YRT/IN90 NO ADA ТАРИФ=14.00EUR/39.00TRY,1EUR=2.73TRY ВСЕГО=39.00TRY 1 DOE SMALL MS 11SEP13(INF)/PPTR22234514,INF/- 2 РТ 1 ADA KK IST 7EUR 2 IST KK ADA 7EUR ИТОГО=14.00EUR *** ВЫКУПИТЬ ДО: 1МАР14/0805/МОВ (ТЛ В PNR) *** КАТЕГОРИЯ ПАССАЖИРА: INF *** ФОРМА БЛАНКА: 61024
ADT
TRANSACTION RECORD (TCT/TK) KK ADAADA TRY AIL 22JAN14 1604 188/99СИР0001 22JAN14/1402 EANIMV/IST ## X DA CC FLT CLS DD DT ST FARE BASIS NVB NVA BAG 1 ADA KK 31 Y 01MAR 0905 OK YRT 20K 2 IST KK 30 Y 10MAR 0700 OK YRT 20K ADA FARE=140.00EUR/383.00TRY,1EUR=2.73TRY TAXES=85.90TRY TOTAL=468.90TRY 1 DOE JANE MRS/PPTR22234512/KK KK2255778 2 DOE JOHN MR/PPTR22234513 3 FC 1 ADA KK IST 70EUR 2 IST KK ADA 70EUR TOTAL=140.00EUR 4 TX N/TCT, S1-2, AB, 2*15.00EUR/40.95TRY,1EUR=2.73TRY 5 TX N/TCT, S1, VQ, 4.00TRY *** PURCHASE BEFORE: 01MAR/0805/MOW (TL IN PNR) *** TICKET FORM: 61024
CNN
TRANSACTION RECORD (TCT/TK) KK ADAADA TRY AIL 22JAN14 1604 188/99СИР0001 22JAN14/1402 EANIMV/IST ## X DA CC FLT CLS DD DT ST FARE BASIS NVB NVA BAG 1 ADA KK 31 Y 01MAR 0905 OK YRT/CN20 20K 2 IST KK 30 Y 10MAR 0700 OK YRT/CN20 20K ADA FARE=112.00EUR/306.00TRY,1EUR=2.73TRY TAXES=4.00TRY TOTAL=310.00TRY 1 DOE MEDIUM MR 12DEC07(CHD)/PPTR22234514,CNN/- 2 FC 1 ADA KK IST 56EUR 2 IST KK ADA 56EUR TOTAL=112.00EUR 3 TX N/TCT, S1, VQ, 4.00TRY *** PURCHASE BEFORE: 01MAR/0805/MOW (TL IN PNR) *** PASSENGER TYPE: CNN *** TICKET FORM: 61024
INF
TRANSACTION RECORD (TCT/TK) KK ADAADA TRY AIL 22JAN14 1605 188/99СИР0001 22JAN14/1402 EANIMV/IST ## X DA CC FLT CLS DD DT ST FARE BASIS NVB NVA BAG 1 ADA KK 31 Y 01MAR 0905 NS YRT/IN90 NO 2 IST KK 30 Y 10MAR 0700 NS YRT/IN90 NO ADA FARE=14.00EUR/39.00TRY,1EUR=2.73TRY TOTAL=39.00TRY 1 DOE SMALL MS 11SEP13(INF)/PPTR22234514,INF/- 2 FC 1 ADA KK IST 7EUR 2 IST KK ADA 7EUR TOTAL=14.00EUR *** PURCHASE BEFORE: 01MAR/0805/MOW (TL IN PNR) *** PASSENGER TYPE: INF *** TICKET FORM: 61024
SciTicketIssue creates tickets in the existing and priced PNR. The most essential parameters of the request are:
The response contains details of the documents issued.
WSDL for SciTicketIssue is as follows:
WebServiceURL/sigws/SciTicketIssue/SIRENA.SCITICKETISSUEQRY/SIRENA.SCIDOCSET?WSDL
E6_1) SIRENA.SCITICKETISSUEQRY: The root element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
TICKETISSUEQRY |
n/a |
M |
1 |
Record locator and modifiers. See below E6_2) |
DOCUMENT |
n/a |
M |
|
General data of the document to be issued. See below E6_3) |
PSGRTSTREF |
n/a |
M |
|
Reference to passenger (PSGRID) and pricing (TSTID). See below E6_4) |
PAYMENT |
n/a |
M |
|
Form of payment. See below E6_5) |
PRICINGOPT |
n/a |
O |
|
Additional pricing options. See below E6_6) |
E6_2) TICKETISSUEQRY: Record locator and modifiers.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
CURRENCY |
string |
O |
1 |
Payment currency. Use IATA or STC (TCH) code |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
SALEDATE |
dateTime |
O |
1 |
Sale date. Default is current date. Sale date affects application of fare data (Fare, Taxes, etc), which often has sale date restrictions |
FLAGS |
string |
O |
1 |
Modifiers of the П / T entry in TAIS CRS. The number of modifiers is significant, but in most cases you need only Е (E in English) – issuance of an ET. Even so, for most airlines this is enabled by default so you don’t need to use FLAGS. |
ERSPNUMBER |
string |
O |
1 |
ERSP Number |
E6_3) DOCUMENT: General data of the document to be issued. For issuance of electronic tickets in a PNR, no matter how many passengers there are in the PNR, you need exactly 2 DOCUMENT elemets – one for Ticket, one for Itinerary/Receipt.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | |||||||||
DOCTYPE |
string |
M |
1 |
Document type:
| |||||||||
ISSUEMETHOD |
string |
M |
1 |
Issuance method:
| |||||||||
PRNNAME |
string |
O |
1 |
Not used | |||||||||
FORMCODE |
string |
O |
1 |
Not used |
E6_4) PSGRTSTREF: Reference to passenger (PSGRID) and pricing (TSTID). To get these values, you need to call SciGetPNR. You need to provide one PSGRTSTREF for each passenger you want to ticket.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
PSGRID |
short |
M |
1 |
Reference to the passenger’s PSGRID (from SciGetPNR response) |
TSTID |
short |
M |
1 |
Reference to the TST element’s TSTID (from SciGetPNR response) |
E6_5) PAYMENT: Form of payment. You can use several forms of payment (“mixed FOP”) for issuance: two credit cards, credit card and cash, etc.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | |||||||||
PAYID |
string |
M |
1 |
Unique ID of the PAYMENT element within the request | |||||||||
AMOUNT |
string |
M |
1 |
Payment amount in the TICKETISSUEQRY.CURRENCY currency | |||||||||
FOP |
string |
M |
1 |
Form of payment code. Please see ‘ЧТО,,Д’ / ‘REF,,PD’ on TAIS CRS terminal for complete list. Most commonly used codes are:
| |||||||||
PAYSYSTEM |
string |
O |
1 |
Payment system code, one of VI, CA, AX, JC, DC | |||||||||
CARDNUMBER |
string |
O |
1 |
Credit card number | |||||||||
EXTENDED |
string |
O |
1 |
Addition to credit card number for American Express cards – the E character followed by digits | |||||||||
EXPIREDATE |
datеTime |
O |
1 |
Credit card expiry date (month and year) | |||||||||
APPCODE |
string |
O |
1 |
Approval code | |||||||||
ССOWNER |
string |
O |
1 |
Not used for CASH and CC | |||||||||
CLIENTID |
string |
O |
1 |
Not used for CASH and CC | |||||||||
DOCINFO |
string |
O |
1 |
Not used for CASH and CC | |||||||||
DOCINFO2 |
string |
O |
1 |
Not used for CASH and CC | |||||||||
PAYMENTDATE |
datеTime |
O |
1 |
Not used for CASH and CC | |||||||||
CONTRACTINFO |
string |
O |
1 |
Not used for CASH and CC |
E6_6) PRICINGOPT: Additional pricing options.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
OPTKEY |
string |
M |
1 |
Option key (name). Details are available from TAIS upon request. |
OPTVAL |
string |
M |
1 |
Option value. Details are available from TAIS upon request. |
Please note that code sets used in the response will depend on your language settings. For Cyrillic users, STC (TCH) Cyrillic codes will be used if available. If not, IATA codes will be used. For English users, the response will always show IATA or legacy English codes.
E6_21) SCIDOCSET: The root element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
DOCSET |
n/a |
M |
1 |
General information. See below E6_22) |
DOCUMENT |
n/a |
M |
|
General data of the document issued. See below 6_23) |
FINTRANS |
n/a |
M |
|
Transaction data. See below E6_24) |
E6_22) DOCSET: General information.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
E6_23) DOCUMENT: General data of the document issued.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | |||||||||
DOCNO |
short |
M |
1 |
Unique ID of the DOCUMENT element within the response | |||||||||
DOCTYPE |
string |
M |
1 |
Document type:
| |||||||||
ISSUEMETHOD |
string |
M |
1 |
Issuance method:
| |||||||||
FORMCODE |
string |
M |
1 |
Accouning code and 2 digits of the form code as defined by IATA (e.g.,81824) | |||||||||
DOCNMBR |
string |
M |
1 |
Document number (e.g., ticket number) | |||||||||
VIEWDATA |
string |
M |
1 |
Document screen image | |||||||||
PRNNAME |
string |
O |
1 |
Printer code (normally not used) | |||||||||
PRNDATA |
string |
O |
1 |
Document print image |
E6_24) FINTRANS: Transaction data. Ticket and Itinerary/Receipt are separate transactions.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
FTID |
string |
M |
1 |
Unique financial transaction ID in TAIS CRS |
FTDATA |
string |
M |
1 |
Financial transaction data in the “transaction xml export” format. At the moment, Cyrillic users can review this format at ftp://ftp.tais.ru/pub/doc/Control_Managers_Manuals_Russian/%DD%EA%F1%EF%EE%F0%F2/%DD%EA%F1%EF%EE%F0%F2%20%E4%E0%ED%ED%FB%F5%20%EE%20%F1%E4%E5%EB%EA%E0%F5%20-%20XML.doc. |
SciTicketVoid voids all tickets in the specified PNR.
WSDL for SciTicketVoid is as follows:
WebServiceURL/sigws/SciTicketVoid/SIRENA.SCITICKETVOIDQRY/SIRENA.SCIDOCSET?WSDL
E7_1) SIRENA.SCITICKETVOIDQRY: The root element.
Attributes: none
Elements:
Contains exactly one TICKETVOIDQRY element which in its turn contains exactly one LOCATOR element. Specify the record locator for which you want to void all tickets.
E7_21) SCIDOCSET: The root element.
Attributes: none
Elements:
Contains exactly one DOCSET element which in its turn contains exactly one LOCATOR element. That’s the locator of the PNR in which tickets have been voided.
SciPNRExchangeQuote is the first part of the ticket exchange process. This request makes the exchange calculations and creates exchange pricing records in the PNR. The response contains calculation details (new and old base fares, fare balance, new taxes, paid taxes, penalty, and ticket additional collection).
The simlified process includes the following steps:
The above process has the following restrictions:
Please note that the exact process should be tailored to the logic of your application – one part of it is the search mechanism for the new segment (omitted here).
By “automatic calculation“ we mean the procces when TAIS CRS calculates fare balance, tax balance and penalty without user input. If automatic calculation is impossible, you should provide Old Fare and Penalty values in the request.
It’s strongly advised that you get familiar with ticketing in TAIS CRS before implementing exchange via TCWS.
English: ftp://ftp.tais.ru/pub/doc/Agents_Manuals_English/volume%204%20Ticketing.doc
Russian: ftp://ftp.tais.ru/pub/doc/Agents_Manuals_Russian/%D2%EE%EC%204%20-%20%D2%C8%CA%C5%D2%C8%CD%C3.doc
WSDL for SciPNRExchangeQuote is as follows:
WebServiceURL/sigws/SciPNRExchangeQuote/SIRENA.SCIPNREXCQUOTEQRY/SIRENA.SCIEXCQUOTERPL?WSDL
E8_1) SIRENA.SCIPNREXCQUOTEQRY: The root element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
PNREXCQUOTEQRY |
n/a |
M |
1 |
Record locator and other parameters applicable to all passengers. See below E8_2) |
PAXEXCQUOTE |
n/a |
M |
|
Reference to passenger (PSGRID) and ticket being exchanged (EXCDOCNMBR). See below E8_3) |
E8_2) PNREXCQUOTEQRY: Record locator and other parameters applicable to all passengers.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | ||||||||||||
CURRENCY |
string |
O |
1 |
Payment currency of the new ticket. Use IATA or STC (TCH) code | ||||||||||||
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) | ||||||||||||
FLAGS |
string |
O |
1 |
Modifiers of the ПО / TE entry in TAIS CRS:
| ||||||||||||
EXСTYPE |
string |
O |
|
Exchange type:
| ||||||||||||
FLOWNSEGS |
short |
O |
1 |
Not used | ||||||||||||
EXCTAX |
string |
O |
1 |
Exchange calculation formula for penalty: 15 – 15 percent of the fare of the ticket being exchanged 20TRY – 20 Turkish Lira blank – automatic calculation Please refer to the ticketing manual for more details. | ||||||||||||
OLDFARE |
string |
O |
1 |
Exchange calculation formula for old base fare: 100 – 100 percent of the fare of the ticket being exchanged 300EUR – 300 Euro blank – automatic calculation Please refer to the ticketing manual for more details. |
E8_3) PAXEXCQUOTE: Reference to passenger (PSGRID) and ticket being exchanged (EXCDOCNMBR).
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
PSGRID |
short |
M |
1 |
Reference to the passenger’s PSGRID (from SciGetPNR response) |
EXCDOCNMBR |
string |
M |
1 |
Number of the ticket being exchanged |
Please note that code sets used in the response will depend on your language settings. For Cyrillic users, STC (TCH) Cyrillic codes will be used if available. If not, IATA codes will be used. For English users, the response will always show IATA or legacy English codes.
E8_21) SCIEXCQUOTERPL: The root element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
EXCQUOTERPL |
n/a |
M |
1 |
General information. See below E8_22) |
PAXEXCQUOTE |
n/a |
M |
|
Exchange quote per passenger. See below 8_23) |
E8_22) EXCQUOTERPL: General information.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
CURRENCY |
string |
M |
1 |
Payment currency of the new ticket |
E8_23) PAXEXCQUOTE: Exchange quote per passenger.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
PAXNO |
short |
M |
1 |
Unique ID of the PAXEXCQUOTE element within the response |
PSGRID |
short |
M |
1 |
Reference to the passenger’s PSGRID (from SciGetPNR response and SciPNRExchangeQuote request) |
PSGRNAME |
string |
M |
1 |
Passenger name (including date of birth) |
EXCDOCNMBR |
string |
M |
1 |
Number of the ticket being exchanged |
NEWFARE |
float |
M |
1 |
New base fare amount in Fare currency of the new ticket |
OLDFARE |
float |
M |
1 |
Old base fare amount in Fare currency of the NEW TICKET |
FAREDELTA |
float |
M |
1 |
Balance between NEWFARE and OLDFARE, in the Fare currency of the new ticket |
FARECUR |
string |
M |
1 |
Fare currency (currency of the ticket ‘Fare’ field selected according to IATA rules) of the new ticket. For domestic travel, this is normally the fare publication currency. For international travel, currency of the country of commencement of international travel, or EUR/USD |
EXCHANGERATE |
float |
M |
1 |
Exchange rate used for conversion of the Fare currency of the new ticket to the payment currency of the new ticket |
FAREDELTAINPAYCUR |
float |
M |
1 |
Balance between NEWFARE and OLDFARE, in the payment currency of the new ticket |
NEWTAX |
float |
M |
1 |
Amount of new (=additionally charged) taxes in the payment currency of the new ticket |
OLDTAX |
float |
M |
1 |
Amount of paid taxes (=charged in the new ticket but already paid in the old ticket) in the payment currency of the new ticket |
REFTAX |
float |
M |
1 |
Amount of refunded taxes in the payment currency of the new ticket |
EXCTAX |
float |
M |
1 |
Amount of penalty in the payment currency of the new ticket |
ADDCOLLECT |
float |
M |
1 |
Total additional collection for fare and taxes (penalty excluded!), in the payment currency of the new ticket |
Please see examples for SciTicketExchange, where complete Exchange process is shown.
SciTicketExchange is the final part of the ticket exchange process. Before this request can be used, exchange pricing records should be created in the PNR using the SciPNRExchangeQuote request. SciTicketExchange effects the exchange based on such exchange pricing records. The response contains details of the documents issued (new ticket, penalty document, etc).
The simplified process includes the following steps:
The above process has the following restrictions:
Please note that the exact process should be tailored to the logic of your application – one part of it is the search mechanism for the new segment (omitted here).
By “automatic calculation“ we mean the procces when TAIS CRS calculates fare balance, tax balance and penalty without user input. If automatic calculation is impossible, you should provide Old Fare and Penalty values in the request.
It’s strongly advised that you get familiar with ticketing in TAIS CRS before implementing exchange via TCWS.
English: ftp://ftp.tais.ru/pub/doc/Agents_Manuals_English/volume%204%20Ticketing.doc
Russian: ftp://ftp.tais.ru/pub/doc/Agents_Manuals_Russian/%D2%EE%EC%204%20-%20%D2%C8%CA%C5%D2%C8%CD%C3.doc
WSDL for SciTicketExchange is as follows:
WebServiceURL/sigws/SciTicketExchange/SIRENA.SCITICKETEXCQRY/SIRENA.SCIDOCSET?WSDL
E9_1) SIRENA.SCITICKETEXCQRY: The root element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
TICKETEXCQRY |
n/a |
M |
1 |
Record locator and modifiers. See below E9_2) |
DOCUMENT |
n/a |
M |
|
General data of the document to be issued. See below E9_3) |
PSGRTSTREF |
n/a |
M |
|
Reference to passenger (PSGRID), exchange pricing record (TSTID) and number of the ticket being exchanged (EXCDOCNMBR). See below E9_4) |
PAYMENT |
n/a |
M |
|
Form of payment. See below E9_5) |
E9_2) TICKETEXCQRY: Record locator and modifiers.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | ||||||
CURRENCY |
string |
O |
1 |
Payment currency of the new ticket. Use IATA or STC (TCH) code | ||||||
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) | ||||||
SALEDATE |
dateTime |
O |
1 |
Sale date. Default is current date. Sale date affects application of fare data (Fare, Taxes, etc), which often has sale date restrictions | ||||||
FLAGS |
string |
O |
1 |
Modifiers of the ПО / TE entry in TAIS CRS:
| ||||||
ERSPNUMBER |
string |
O |
1 |
ERSP Number |
E9_3) DOCUMENT: General data of the document to be issued. For exchange of electronic tickets in a PNR, no matter how many passengers there are in the PNR, you need exactly 2 DOCUMENT elemets – one for Ticket, one for Itinerary/Receipt. If there’s penalty, flown segments, etc, then issuance of the related documents will be triggered automatically.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | |||||||||
DOCTYPE |
string |
M |
1 |
Document type:
| |||||||||
ISSUEMETHOD |
string |
M |
1 |
Issuance method:
| |||||||||
PRNNAME |
string |
O |
1 |
Not used | |||||||||
FORMCODE |
string |
O |
1 |
Not used |
E9_4) PSGRTSTREF: Reference to passenger (PSGRID), exchange pricing record (TSTID) and number of the ticket being exchanged (EXCDOCNMBR). To get these values, you need to call SciGetPNR. You need to provide one PSGRTSTREF for each passenger.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
PSGRID |
short |
M |
1 |
Reference to the passenger’s PSGRID (from SciGetPNR response) |
TSTID |
short |
M |
1 |
Reference to the TST element’s TSTID (from SciGetPNR response) |
EXCDOCNMBR |
string |
M |
1 |
Number of the ticket being exchanged |
E9_5) PAYMENT: Form of payment. You don’t need to specify old form of payment as it was in the old ticket. Only form of payment for additional collection and penalty is required (considered to be always the same).
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | |||||||||
PAYID |
string |
M |
1 |
Unique ID of the PAYMENT element within the request | |||||||||
AMOUNT |
string |
M |
1 |
Payment amount in the TICKETEXCQRY.CURRENCY currency | |||||||||
FOP |
string |
M |
1 |
Form of payment code. Please see ‘ЧТО,,Д’ / ‘REF,,PD’ on TAIS CRS terminal for complete list. Most commonly used codes are:
| |||||||||
PAYSYSTEM |
string |
O |
1 |
Payment system code, one of VI, CA, AX, JC, DC | |||||||||
CARDNUMBER |
string |
O |
1 |
Credit card number | |||||||||
EXTENDED |
string |
O |
1 |
Addition to credit card number for American Express cards – the E character followed by digits | |||||||||
EXPIREDATE |
datеTime |
O |
1 |
Credit card expiry date (month and year) | |||||||||
APPCODE |
string |
O |
1 |
Approval code | |||||||||
ССOWNER |
string |
O |
1 |
Not used for CASH and CC | |||||||||
CLIENTID |
string |
O |
1 |
Not used for CASH and CC | |||||||||
DOCINFO |
string |
O |
1 |
Not used for CASH and CC | |||||||||
DOCINFO2 |
string |
O |
1 |
Not used for CASH and CC | |||||||||
PAYMENTDATE |
datеTime |
O |
1 |
Not used for CASH and CC | |||||||||
CONTRACTINFO |
string |
O |
1 |
Not used for CASH and CC |
Please note that code sets used in the response will depend on your language settings. For Cyrillic users, STC (TCH) Cyrillic codes will be used if available. If not, IATA codes will be used. For English users, the response will always show IATA or legacy English codes.
E9_21) SCIDOCSET: The root element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
DOCSET |
n/a |
M |
1 |
General information. See below E9_22) |
DOCUMENT |
n/a |
M |
|
General data of the document issued. See below 9_23) |
FINTRANS |
n/a |
M |
|
Transaction data. See below E9_24) |
E9_22) DOCSET: General information.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
LOCATOR |
string |
M |
1 |
PNR locator (unique reference) |
E9_23) DOCUMENT: General data of the document issued.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | |||||||||||||||||||||
DOCNO |
short |
M |
1 |
Unique ID of the DOCUMENT element within the response | |||||||||||||||||||||
DOCTYPE |
string |
M |
1 |
Document type:
| |||||||||||||||||||||
ISSUEMETHOD |
string |
M |
1 |
Issuance method:
| |||||||||||||||||||||
FORMCODE |
string |
M |
1 |
Accouning code and 2 digits of the form code as defined by IATA (e.g.,81824) | |||||||||||||||||||||
DOCNMBR |
string |
M |
1 |
Document number (e.g., ticket number) | |||||||||||||||||||||
VIEWDATA |
string |
M |
1 |
Document screen image | |||||||||||||||||||||
PRNNAME |
string |
O |
1 |
Printer code (normally not used) | |||||||||||||||||||||
PRNDATA |
string |
O |
1 |
Document print image |
E9_24) FINTRANS: Transaction data. Ticket and Itinerary/Receipt are separate transactions.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
FTID |
string |
M |
1 |
Unique financial transaction ID in TAIS CRS |
FTDATA |
string |
M |
1 |
Financial transaction data in the “transaction xml export” format. At the moment, Cyrillic users can review this format at ftp://ftp.tais.ru/pub/doc/Control_Managers_Manuals_Russian/%DD%EA%F1%EF%EE%F0%F2/%DD%EA%F1%EF%EE%F0%F2%20%E4%E0%ED%ED%FB%F5%20%EE%20%F1%E4%E5%EB%EA%E0%F5%20-%20XML.doc. |
PNR DOE EG9SFT 03APR/1902 188/99SIR001 99SIR001* MOW(RU) KK(61017876) GDS PAX=1-0-0-0 TICKETED ** I:NVO H S FLT DD DT AT EQP S CKI DA T AA T CL ST QTY E M HOST/LOCATOR 1 KK20 21APR 0730 0830 320 0600 IST ADB H HK 1 E N NAME/FOID PTC TICKETS 1 DOE JANE MRS/PP TR 22234512 6102430001166 E O PHONE 1P +9023312312312/M
TRANSACTION RECORD (TCT/TK 1P00CU00) KK ISTADB TRY AIL 03APR14 1903 188/99SIR0001 03APR14/1902 EG9SFT/IST ## X DA CC FLT CLS DD DT ST FARE BASIS NVB NVA BAG 1 IST KK 20 H 21APR 0730 OK HOWKKD 20K ADB FARE=107.00TRY TAXES=27.30TRY TOTAL=134.30TRY 1 DOE JANE MRS/PPTR22234512 2 FC 1 IST KK ADB 107TRY TOTAL=107.00TRY 3 TX N/TCT, S1, YQ, 10.00EUR/27.30TRY,1EUR=2.73TRY 4 FP CASH/134.30TRY *** PURCHASE BEFORE: 21APR/0530/MOW (TL IN PNR) *** TICKET FORM: 61024
8ETKT 6102430001166/ "ATLASJET"(KK) ISTADB TRY AIL FTAK=KK 03APR14 61017876 TAIS/MOSCOW/ 188/99SIR EG9SFT CHECK IN:IST0600 PPTR22234512 FFP: DOE/JANE MRS CTC: +9023312312312 KH AD CC FLT CL DD DT ST FARE BASIS NVB NVA BAG ISS 1 IST KK 020 H 21APR 0730 OK HOWKKD 20K O ADB FARE: TRY107 EQUIV.FARE: TAXES: TRY27.3YQ FARE CALC:IST KK ADB107TRY107END TOTAL: TRY134.3 FOP:CASH
In this example:
SEGID=4 PSGRID=5 TICKETNUMBER=6102430001166
You should be ready that in general case, the PNR will have several segements, several passengers, and that one passenger can have several tickets in a PNR.
We want to change departure date to 22 April. For this date only class D is available, so we rebbok to class D. The new segment should have some SEGID unique in the response.
Omitted to make the example smaller.
The result is ticket ADC of 111TRY and a penalty of 27.3TRY.
In this response TSTID=17, where EXCFLAG=1. Please pay attention that here ADDCOLLECT also includes penalty amount!
PNR DOE EG9SFT 03APR/2002 902/KK000005 99SIR001* MOW(RU) KK(61017876) GDS PAX=1-0-0-0 TICKETED ** I:NVO H S FLT DD DT AT EQP S CKI DA T AA T CL ST QTY E M HOST/LOCATOR 1 KK20 22APR 0730 0830 320 0600 IST ADB D HK 1 E N NAME/FOID PTC TICKETS 1 DOE JANE MRS/PP TR 22234512 6102430001167 E O PHONE 1P +9023312312312/M
TRANSACTION RECORD (TCT/TE 3P00CU00) KK ISTADB TRY AIL 03APR14 2009 902/KK0000005 03APR14/1936 VOLUNT ## X DA CC FLT CLS DD DT ST FARE BASIS NVB NVA BAG 1 IST KK 20 D 22APR 0730 OK DOWKKD 30K ADB FARE-N=218.00TRY FARE-O=107.00TRY FARE-D=111.00TRY TAX-O=27.30TRY TAX-C=27.30TRY TOTAL=138.30TRY 1 DOE JANE MRS/PPTR22234512 EXCHTKT=6102430001166,03APR14-99SIR-61017876-MOW-0188 ORIGTKT=6102430001166,03APR14-99SIR-61017876-MOW-0188 2 FC 1 IST KK ADB 218TRY TOTAL=218.00TRY 3 TX C/PEN, --, 10.00EUR/27.30TRY,1EUR=2.73TRY 27.30TRY(10.00EUR),A 4 RT O/TCT, S1, YQ, 10.00EUR/27.30TRY,1EUR=2.73TRY 5 FP CASH/134.30TRY/O+CASH/111.00TRY 6 FM CASH/27.30TRY *** PURCHASE BEFORE: 21APR/0830/MOW (TL IN PNR) *** TICKET FORM: 61024
8ETKT 6102430001167/ "ATLASJET"(KK) ISTADB TRY AIL FTAK=KK 03APR14 61000900 TEST ARBIT POS/ISTANBUL/ 902/KK000 EG9SFT CHECK IN:IST0600 PPTR22234512 FFP: DOE/JANE MRS CTC: +9023312312312 KH AD CC FLT CL DD DT ST FARE BASIS NVB NVA BAG ISS 1 IST KK 020 D 22APR 0730 OK DOWKKD 30K O ADB FARE: TRY218 EQUIV.FARE: TAXES: TRY27.3YQ FARE CALC:IST KK ADB218TRY218END TOTAL: TRY111A FOP:CASH DE IN EXCHANGE:6102430001166 ORIGINAL ISSUE:6102430001166 03APR14 99SIR 61017876
PNR DOE EG9SFV 03APR/2022 188/99SIR001 99SIR001* MOW(RU) KK(61017876) GDS PAX=1-0-0-0 TICKETED ** I:NVO H S FLT DD DT AT EQP S CKI DA T AA T CL ST QTY E M HOST/LOCATOR 1 KK20 21APR 0730 0830 320 0600 IST ADB H HK 1 E 2 KK21 25APR 1030 1130 320 0900 ADB IST H HK 1 E N NAME/FOID PTC TICKETS 1 DOE JANE MRS/PP TR 22234512 6102430001170 E O PHONE 1P +9023312312312/M
TRANSACTION RECORD (TCT/TK 9P00CU00) KK ISTIST TRY AIL 03APR14 2023 188/99SIR0001 03APR14/2022 EG9SFV/IST ## X DA CC FLT CLS DD DT ST FARE BASIS NVB NVA BAG 1 IST KK 20 H 21APR 0730 OK HOWKKD 20K 2 ADB KK 21 H 25APR 1030 OK HOWKKD 20K IST FARE=214.00TRY TAXES=33.30TRY TOTAL=247.30TRY 1 DOE JANE MRS/PPTR22234512 2 FC 1 IST KK ADB 107TRY 2 ADB KK IST 107TRY TOTAL=214.00TRY 3 TX N/TCT, S1, YQ, 10.00EUR/27.30TRY,1EUR=2.73TRY 4 TX N/TCT, S2, VQ, 6.00TRY 5 FP CASH/247.30TRY *** PURCHASE BEFORE: 21APR/0530/MOW (TL IN PNR) *** TICKET FORM: 61024
First coupons is Flown.
8ETKT 6102430001170/ "ATLASJET"(KK) ISTIST TRY AIL FTAK=KK 03APR14 61017876 TAIS/MOSCOW/ 188/99SIR EG9SFV CHECK IN:IST0600 ADB0900 PPTR22234512 FFP: DOE/JANE MRS CTC: +9023312312312 KH AD CC FLT CL DD DT ST FARE BASIS NVB NVA BAG ISS 1 IST KK 020 H 21APR 0730 OK HOWKKD 20K F 2 ADB KK 021 H 25APR 1030 OK HOWKKD 20K O IST FARE: TRY214 EQUIV.FARE: TAXES: TRY27.3YQ TRY6VQ FARE CALC:IST KK ADB107 KK IST107TRY214END TOTAL: TRY247.3 FOP:CASH
In this example:
SEGID=5 (for the second segment!!!) PSGRID=6 TICKETNUMBER=6102430001170 (for the second segment!!!)
We want to change departure date on the second segment to 26 April. For this date only class D is available, so we rebbok to class D. The new segment should have some SEGID unique in the response.
Omitted to make the example smaller.
The result is ticket ADC of 111TRY and a penalty of 27.3TRY.
In this response TSTID=18, where EXCFLAG=1. Please pay attention that here ADDCOLLECT also includes penalty amount!
PNR DOE EG9SFV 03APR/2037 900/KK000005 99SIR001* MOW(RU) KK(61017876) GDS PAX=1-0-0-0 TICKETED ** I:NVO H S FLT DD DT AT EQP S CKI DA T AA T CL ST QTY E M HOST/LOCATOR 1 KK20 21APR 0730 0830 320 0600 IST ADB H HK 1 E 2 KK21 26APR 1030 1130 320 0900 ADB IST D HK 1 E N NAME/FOID PTC TICKETS 1 DOE JANE MRS/PP TR 22234512 6102430001170 E/S1 6102430001171 E/S2 O PHONE 1P +9023312312312/M
TRANSACTION RECORD (TCT/TE BP00CU00) KK ADBIST TRY AIL 03APR14 2038 900/KK0000005 03APR14/2032 VOLUNT ## X DA CC FLT CLS DD DT ST FARE BASIS NVB NVA BAG 1 ADB KK 21 D 26APR 1030 OK DOWKKD 30K IST FARE-N=325.00TRY FARE-O=214.00TRY FARE-D=111.00TRY TAX-O=6.00TRY TAX-C=27.30TRY TOTAL=138.30TRY 1 DOE JANE MRS/PPTR22234512 EXCHTKT=6102430001170,03APR14-99SIR-61017876-MOW-0188 ORIGTKT=6102430001170,03APR14-99SIR-61017876-MOW-0188 2 FC 1 IST KK ADB 107TRY 2 ADB KK IST 218TRY TOTAL=325.00TRY 3 TX C/PEN, --, 10.00EUR/27.30TRY,1EUR=2.73TRY 27.30TRY(10.00EUR),A 4 RT O/TCT, S1, VQ, 6.00TRY 5 FP CASH/220.00TRY/O+CASH/111.00TRY 6 FM CASH/27.30TRY *** PURCHASE BEFORE: 26APR/1130/MOW (DEPARTURE DATE OF THE FIRST LEG) *** TICKET FORM: 61024
8ETKT 6102430001171/ "ATLASJET"(KK) ISTIST TRY AIL FTAK=KK 03APR14 61000900 TEST ARBIT POS/ISTANBUL/ 900/KK000 EG9SFV CHECK IN:ADB0900 PPTR22234512 FFP: DOE/JANE MRS CTC: +9023312312312 KH AD CC FLT CL DD DT ST FARE BASIS NVB NVA BAG ISS 1 ADB KK 021 D 26APR 1030 OK DOWKKD 30K O IST FARE: TRY325 EQUIV.FARE: TAXES: TRY6VQ FARE CALC:IST KK ADB107 KK IST218TRY325END TOTAL: TRY111A FOP:CASH DE IN EXCHANGE:6102430001170 ORIGINAL ISSUE:6102430001170 03APR14 99SIR 61017876
SciRefundQuote makes the refund calculations for the specified ticket number. The response contains calculation details (refunded fare amount, refunded tax amount, and penalty amount). It DOES NOT actually make the refund.
The complete process includes the following steps:
1. Display PNR (SciGetPNR), Ticket (SciGetTicket), Fare Rules (SciGetUpt) etc as/if required by your process to provide agent with necessary information for the refund.
2. Call SciRefundQuote to make refund calculation. If OK, proceed further. Result is not saved anywhere in TAIS CRS, so the calculation is not guaranteed if there’s significant time difference between SciRefundQuote and SciTicketRefund.
3. Cancel segments in the PNR. Use SciUpdatePNR to cancel some or all segments. Segment cancellation date, time and place are critical for correct calculation.
4. Call SciTicketRefund to make the refund.
The above process has the following restrictions:
By “automatic calculation“ we mean the procces when TAIS CRS calculates fare and tax amounts to be refunded and penalty without user input. If automatic calculation is impossible, you should provide Refunded Fare and Penalty values in the request.
It’s strongly advised that you get familiar with ticketing in TAIS CRS before implementing refund via TCWS.
English: ftp://ftp.tais.ru/pub/doc/Agents_Manuals_English/volume%204%20Ticketing.doc]
Russian: ftp://ftp.tais.ru/pub/doc/Agents_Manuals_Russian/%D2%EE%EC%204%20-%20%D2%C8%CA%C5%D2%C8%CD%C3.doc]
WSDL for SciRefundQuote is as follows:
WebServiceURL/sigws/SciRefundQuote/SIRENA.SCIRFNDQUOTEQRY/SIRENA.SCIRFNDQUOTERPL?WSDL
E10_1) SIRENA.SCIRFNDQOTEQRY: The root element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
RFNDQOTEQRY |
n/a |
M |
1 |
General parameters E10_2) |
DOCRFNDQUOTE |
n/a |
M |
1 |
Reference to the ticket being refunded (RFNDDOCNMBR). See below E10_3) |
PAYMENT |
n/a |
O |
1 |
Form of payment for the penalty. Ignored in SciRefundQuote. |
E10_2) RFNDQOTEQRY: General parameters.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | |||||||||
CURRENCY |
string |
O |
1 |
Refund currency. Use IATA or STC (TCH) code | |||||||||
FLAGS |
string |
O |
1 |
Modifiers of the АФ / RE entry in TAIS CRS. No values at the moment. | |||||||||
RFNDTYPE |
string |
O |
1 |
Refund type:
| |||||||||
SEATXXDATETIME |
dateTime |
M |
1 |
Date and time of segment (seat) cancellation in PNR, according to the time zone of the point specified in the SEATXXLOCATION field (below) | |||||||||
SEATXXLOCATION |
string |
M |
1 |
Point (city) where the segment (seat) cancellation in PNR was effected. Use IATA or STC (TCH) code | |||||||||
PENALTY |
string |
O |
1 |
Calculation formula for penalty: 15 – 15 percent of the fare of the ticket being refunded 20TRY – 20 Turkish Lira blank – automatic calculation Please refer to the ticketing manual for more details. | |||||||||
RFNDFARE |
string |
O |
1 |
Calculation formula for refunded fare amount: 100 – 100 percent of the fare of the ticket being refunded 300EUR – 300 Euro blank – automatic calculation Please refer to the ticketing manual for more details. |
E10_3) DOCRFNDQUOTE: Reference to the ticket being refunded (RFNDDOCNMBR).
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
FTAK |
string |
M |
1 |
Validating carrier’s airline code. Use IATA or STC (TCH) code |
RFNDDOCNMBR |
string |
M |
1 |
Number of the ticket being refunded |
Please note that code sets used in the response will depend on your language settings. For Cyrillic users, STC (TCH) Cyrillic codes will be used if available. If not, IATA codes will be used. For English users, the response will always show IATA or legacy English codes.
E10_21) SCIRFNDQUOTERPL: The root element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
RFNDQUOTERPL |
n/a |
M |
1 |
General information. See below E10_22) |
DOCRFNDQUOTE |
n/a |
M |
|
Refund quote for the ticket. See below 10_23) |
E10_22) RFNDQUOTERPL: General information.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
CURRENCY |
string |
M |
1 |
Refund currency |
E10_23) DOCRFNDQUOTE: Refund quote for the ticket.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
PSGRNAME |
string |
M |
1 |
Passenger name (including date of birth) |
RFNDDOCNMBR |
string |
M |
1 |
Number of the ticket being refunded |
RFNDFARE |
float |
M |
1 |
Refunded fare amount in the refund currency |
RFNDTAX |
float |
M |
1 |
Refunded tax amount in the refund currency |
PENALTY |
float |
M |
1 |
Penalty amount in the refund currency |
ПАСПОРТ СДЕЛКИ (БЛТ/БЛ 8N00CU00) KK ISTADB TRY АИЛ 01АПР14 2005 188/99СИР0001 01APR14/1955 EG467Y/IST ## Х ПО АК РЕЙС БР ДВ ВВ СТ КОДТАР НДО НПО БГ 1 IST KK 20 H 20APR 0730 OK HOWKKD 20K ADB ТАРИФ=107.00TRY СБОРЫ=27.30TRY ВСЕГО=134.30TRY 1 BACK MONEY MR 15DEC66/PPUA23335 2 РТ 1 IST KK ADB 107TRY ИТОГО=107.00TRY 3 СБ Н/БЛТ, C1, YQ, 10.00EUR/27.30TRY,1EUR=2.73TRY 4 ФО CASH/134.30TRY *** ВЫКУПИТЬ ДО: 20АПР14/0530/МОВ (ТЛ В PNR) *** ФОРМА БЛАНКА: 61024
TRANSACTION RECORD (TCT/TK 8N00CU00) KK ISTADB TRY AIL 01APR14 1959 188/99SIR0001 01APR14/1955 EG467Y/IST ## X DA CC FLT CLS DD DT ST FARE BASIS NVB NVA BAG 1 IST KK 20 H 20APR 0730 OK HOWKKD 20K ADB FARE=107.00TRY TAXES=27.30TRY TOTAL=134.30TRY 1 BACK MONEY MR 15DEC66/PPUA23335 2 FC 1 IST KK ADB 107TRY TOTAL=107.00TRY 3 TX N/TCT, S1, YQ, 10.00EUR/27.30TRY,1EUR=2.73TRY 4 FP CASH/134.30TRY *** PURCHASE BEFORE: 20APR/0530/MOW (TL IN PNR) *** TICKET FORM: 61024
ПАСПОРТ СДЕЛКИ (БЛТ/БЛ) KK ISTIST TRY АИЛ 02АПР14 1845 188/99СИР0001 02APR14/1835 EG6ZDU/IST ## Х ПО АК РЕЙС БР ДВ ВВ СТ КОДТАР НДО НПО БГ 1 IST KK 20 H 21APR 0730 OK HOWKKD 20K 2 ADB KK 21 H 27APR 1030 OK HOWKKD 20K IST ТАРИФ=214.00TRY СБОРЫ=33.30TRY ВСЕГО=247.30TRY 1 BACK MONEY MR 15DEC66/PPUA23335 2 РТ 1 IST KK ADB 107TRY 2 ADB KK IST 107TRY ИТОГО=214.00TRY 3 СБ Н/БЛТ, C1, YQ, 10.00EUR/27.30TRY,1EUR=2.73TRY 4 СБ Н/БЛТ, C2, VQ, 6.00TRY 5 ФО CASH/247.30TRY *** ВЫКУПИТЬ ДО: 21АПР14/0530/МОВ (ТЛ В PNR) *** ФОРМА БЛАНКА: 61024
TRANSACTION RECORD (TCT/TK 9O00CU00) KK ISTIST TRY AIL 02APR14 1845 188/99SIR0001 02APR14/1835 EG6ZDU/IST ## X DA CC FLT CLS DD DT ST FARE BASIS NVB NVA BAG 1 IST KK 20 H 21APR 0730 OK HOWKKD 20K 2 ADB KK 21 H 27APR 1030 OK HOWKKD 20K IST FARE=214.00TRY TAXES=33.30TRY TOTAL=247.30TRY 1 BACK MONEY MR 15DEC66/PPUA23335 2 FC 1 IST KK ADB 107TRY 2 ADB KK IST 107TRY TOTAL=214.00TRY 3 TX N/TCT, S1, YQ, 10.00EUR/27.30TRY,1EUR=2.73TRY 4 TX N/TCT, S2, VQ, 6.00TRY 5 FP CASH/247.30TRY *** PURCHASE BEFORE: 21APR/0530/MOW (TL IN PNR) *** TICKET FORM: 61024
SciTicketRefund makes the refund calculations for the specified ticket number AND actually refunds the ticket. The response contains calculation details (refunded fare amount, refunded tax amount, and penalty amount). For a refunded ticket, you will also get this data in SciGetTicket response together with details of agent who performed the refund.
The complete process includes the following steps:
1. Display PNR (SciGetPNR), Ticket (SciGetTicket), Fare Rules (SciGetUpt) etc as/if required by your process to provide agent with necessary information for the refund.
2. Call SciRefundQuote to make refund calculation. If OK, proceed further. Result is not saved anywhere in TAIS CRS, so the calculation is not guaranteed if there’s significant time difference between SciRefundQuote and SciTicketRefund.
3. Cancel segments in the PNR. Use SciUpdatePNR to cancel some or all segments. Segment cancellation date, time and place are critical for correct calculation.
4. Call SciTicketRefund to make the refund.
The above process has the following restrictions:
By “automatic calculation“ we mean the procces when TAIS CRS calculates fare and tax amounts to be refunded and penalty without user input. If automatic calculation is mpossible, you should provide Refunded Fare and Penalty values in the request.
It’s strongly advised that you get familiar with ticketing in TAIS CRS before implementing refund via TCWS.
English: ftp://ftp.tais.ru/pub/doc/Agents_Manuals_English/volume%204%20Ticketing.doc
Russian: ftp://ftp.tais.ru/pub/doc/Agents_Manuals_Russian/%D2%EE%EC%204%20-%20%D2%C8%CA%C5%D2%C8%CD%C3.doc
WSDL for SciTicketRefund is as follows:
WebServiceURL/sigws/SciTicketRefund/SIRENA.SCIRFNDQUOTEQRY/SIRENA.SCIRFNDQUOTERPL?WSDL
E11_1) SIRENA.SCIRFNDQOTEQRY: The root element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
RFNDQOTEQRY |
n/a |
M |
1 |
General parameters E11_2) |
DOCRFNDQUOTE |
n/a |
M |
1 |
Reference to the ticket being refunded (RFNDDOCNMBR). See below E11_3) |
PAYMENT |
n/a |
O |
1 |
Form of payment for the penalty. By default, ticket form of payment is assumed. If ticket has mixed form of payment, this parameter is mandatory. See below E11_4) |
E11_2) RFNDQOTEQRY: General parameters.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | |||||||||
CURRENCY |
string |
O |
1 |
Refund currency. Use IATA or STC (TCH) code | |||||||||
FLAGS |
string |
O |
1 |
Modifiers of the АФ / RE entry in TAIS CRS. No values at the moment. | |||||||||
RFNDTYPE |
string |
O |
1 |
Refund type:
| |||||||||
SEATXXDATETIME |
dateTime |
M |
1 |
Date and time of segment (seat) cancellation in PNR, according to the time zone of the point specified in the SEATXXLOCATION field (below) | |||||||||
SEATXXLOCATION |
string |
M |
1 |
Point (city) where the segment (seat) cancellation in PNR was effected. Use IATA or STC (TCH) code | |||||||||
PENALTY |
string |
O |
1 |
Calculation formula for penalty: 15 – 15 percent of the fare of the ticket being refunded 20TRY – 20 Turkish Lira blank – automatic calculation Please refer to the ticketing manual for more details. | |||||||||
RFNDFARE |
string |
O |
1 |
Calculation formula for refunded fare amount: 100 – 100 percent of the fare of the ticket being refunded 300EUR – 300 Euro blank – automatic calculation Please refer to the ticketing manual for more details. |
E11_3) DOCRFNDQUOTE: Reference to the ticket being refunded (RFNDDOCNMBR).
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
FTAK |
string |
M |
1 |
Validating carrier’s airline code. Use IATA or STC (TCH) code |
RFNDDOCNMBR |
string |
M |
1 |
Number of the ticket being refunded |
E11_4) PAYMENT: Form of payment for the penalty. By default, ticket form of payment is assumed. If ticket has mixed form of payment, this parameter is mandatory. Please pay attention to this parameter if you need the correct form of payment in the penalty document (e.g., EMD).
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment | |||||||||
PAYID |
string |
M |
1 |
Unique ID of the PAYMENT element within the request | |||||||||
AMOUNT |
float |
M |
1 |
Payment amount in the RFNDQOTEQRY.CURRENCY currency | |||||||||
FOP |
string |
M |
1 |
Form of payment code. Please see ‘ЧТО,,Д’ / ‘REF,,PD’ on TAIS CRS terminal for complete list. Most commonly used codes are:
| |||||||||
PAYSYSTEM |
string |
O |
1 |
Payment system code, one of VI, CA, AX, JC, DC | |||||||||
CARDNUMBER |
string |
O |
1 |
Credit card number | |||||||||
EXTENDED |
string |
O |
1 |
Addition to credit card number for American Express cards – the E character followed by digits | |||||||||
EXPIREDATE |
datеTime |
O |
1 |
Credit card expiry date (month and year) | |||||||||
APPCODE |
string |
O |
1 |
Approval code | |||||||||
ССOWNER |
string |
O |
1 |
Not used for CASH and CC | |||||||||
CLIENTID |
string |
O |
1 |
Not used for CASH and CC | |||||||||
DOCINFO |
string |
O |
1 |
Not used for CASH and CC | |||||||||
DOCINFO2 |
string |
O |
1 |
Not used for CASH and CC | |||||||||
PAYMENTDATE |
datеTime |
O |
1 |
Not used for CASH and CC | |||||||||
CONTRACTINFO |
string |
O |
1 |
Not used for CASH and CC |
Please note that code sets used in the response will depend on your language settings. For Cyrillic users, STC (TCH) Cyrillic codes will be used if available. If not, IATA codes will be used. For English users, the response will always show IATA or legacy English codes.
E11_21) SCIRFNDQUOTERPL: The root element.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
RFNDQUOTERPL |
n/a |
M |
1 |
General information. See below E11_22) |
DOCRFNDQUOTE |
n/a |
M |
|
Refund quote for the ticket. See below 11_23) |
E11_22) RFNDQUOTERPL: General information.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
CURRENCY |
string |
M |
1 |
Refund currency |
E11_23) DOCRFNDQUOTE: Refund quote for the ticket.
Attributes: none
Elements:
Name |
Type |
ST |
RP |
Comment |
PSGRNAME |
string |
M |
1 |
Passenger name (including date of birth) |
RFNDDOCNMBR |
string |
M |
1 |
Number of the ticket being refunded |
RFNDFARE |
float |
M |
1 |
Refunded fare amount in the refund currency |
RFNDTAX |
float |
M |
1 |
Refunded tax amount in the refund currency |
PENALTY |
float |
M |
1 |
Penalty amount in the refund currency |
According to the Rules, penalty is 30% of the fare.
ПАСПОРТ СДЕЛКИ (БЛТ/БЛ 8N00CU00) KK ISTADB TRY АИЛ 01АПР14 2005 188/99СИР0001 01APR14/1955 EG467Y/IST ## Х ПО АК РЕЙС БР ДВ ВВ СТ КОДТАР НДО НПО БГ 1 IST KK 20 H 20APR 0730 OK HOWKKD 20K ADB ТАРИФ=107.00TRY СБОРЫ=27.30TRY ВСЕГО=134.30TRY 1 BACK MONEY MR 15DEC66/PPUA23335 2 РТ 1 IST KK ADB 107TRY ИТОГО=107.00TRY 3 СБ Н/БЛТ, C1, YQ, 10.00EUR/27.30TRY,1EUR=2.73TRY 4 ФО CASH/134.30TRY *** ВЫКУПИТЬ ДО: 20АПР14/0530/МОВ (ТЛ В PNR) *** ФОРМА БЛАНКА: 61024
TRANSACTION RECORD (TCT/TK 8N00CU00) KK ISTADB TRY AIL 01APR14 1959 188/99SIR0001 01APR14/1955 EG467Y/IST ## X DA CC FLT CLS DD DT ST FARE BASIS NVB NVA BAG 1 IST KK 20 H 20APR 0730 OK HOWKKD 20K ADB FARE=107.00TRY TAXES=27.30TRY TOTAL=134.30TRY 1 BACK MONEY MR 15DEC66/PPUA23335 2 FC 1 IST KK ADB 107TRY TOTAL=107.00TRY 3 TX N/TCT, S1, YQ, 10.00EUR/27.30TRY,1EUR=2.73TRY 4 FP CASH/134.30TRY *** PURCHASE BEFORE: 20APR/0530/MOW (TL IN PNR) *** TICKET FORM: 61024
ПАСПОРТ СДЕЛКИ (БЛТ/АФ BN00CU00) KK ISTADB TRY АИЛ 01АПР14 2007 900/KK0000005 01APR14/1955 VOLUNT АМ 01APR 1400 MOW (ЗА 450 ЧАСОВ ДО ВВ) ## Х ПО АК РЕЙС БР ДВ ВВ СТ КОДТАР НДО НПО БГ 1 IST KK 20 H 20APR 0730 OK HOWKKD 20K ADB ТАРИФ-В=107.00TRY СБОРЫ-В=27.30TRY СБОРЫ-У=32.10TRY ВСЕГО=102.20TRY 1 BACK MONEY MR 15DEC66/PPUA23335 2 ВТ 107.00(RULE),A 3 ВС В/БЛТ, C1, YQ, 10.00EUR/27.30TRY,1EUR=2.73TRY 4 СБ У/ШТР, --, 32.10TRY 32.10TRY,A 5 ВО CASH/134.30TRY 6 ФМ CASH/32.10TRY
TRANSACTION RECORD (TCT/RE BN00CU00) KK ISTADB TRY AIL 01APR14 2003 900/KK0000005 01APR14/1955 VOLUNT XX 01APR 1400 MOW (450 HRS BFR DT) ## X DA CC FLT CLS DD DT ST FARE BASIS NVB NVA BAG 1 IST KK 20 H 20APR 0730 OK HOWKKD 20K ADB FARE-R=107.00TRY TAX-R=27.30TRY TAX-C=32.10TRY TOTAL=102.20TRY 1 BACK MONEY MR 15DEC66/PPUA23335 2 RF 107.00(RULE),A 3 RT R/TCT, S1, YQ, 10.00EUR/27.30TRY,1EUR=2.73TRY 4 TX C/PEN, --, 32.10TRY 32.10TRY,A 5 RO CASH/134.30TRY 6 FM CASH/32.10TRY
According to the Rules, penalty is 30% of the fare.
ПАСПОРТ СДЕЛКИ (БЛТ/БЛ) KK ISTIST TRY АИЛ 02АПР14 1845 188/99СИР0001 02APR14/1835 EG6ZDU/IST ## Х ПО АК РЕЙС БР ДВ ВВ СТ КОДТАР НДО НПО БГ 1 IST KK 20 H 21APR 0730 OK HOWKKD 20K 2 ADB KK 21 H 27APR 1030 OK HOWKKD 20K IST ТАРИФ=214.00TRY СБОРЫ=33.30TRY ВСЕГО=247.30TRY 1 BACK MONEY MR 15DEC66/PPUA23335 2 РТ 1 IST KK ADB 107TRY 2 ADB KK IST 107TRY ИТОГО=214.00TRY 3 СБ Н/БЛТ, C1, YQ, 10.00EUR/27.30TRY,1EUR=2.73TRY 4 СБ Н/БЛТ, C2, VQ, 6.00TRY 5 ФО CASH/247.30TRY *** ВЫКУПИТЬ ДО: 21АПР14/0530/МОВ (ТЛ В PNR) *** ФОРМА БЛАНКА: 61024
TRANSACTION RECORD (TCT/TK 9O00CU00) KK ISTIST TRY AIL 02APR14 1845 188/99СИР0001 02APR14/1835 EG6ZDU/IST ## X DA CC FLT CLS DD DT ST FARE BASIS NVB NVA BAG 1 IST KK 20 H 21APR 0730 OK HOWKKD 20K 2 ADB KK 21 H 27APR 1030 OK HOWKKD 20K IST FARE=214.00TRY TAXES=33.30TRY TOTAL=247.30TRY 1 BACK MONEY MR 15DEC66/PPUA23335 2 FC 1 IST KK ADB 107TRY 2 ADB KK IST 107TRY TOTAL=214.00TRY 3 TX N/TCT, S1, YQ, 10.00EUR/27.30TRY,1EUR=2.73TRY 4 TX N/TCT, S2, VQ, 6.00TRY 5 FP CASH/247.30TRY *** PURCHASE BEFORE: 21APR/0530/MOW (TL IN PNR) *** TICKET FORM: 61024
ПАСПОРТ СДЕЛКИ (БЛТ/АФ CO00CU00) KK ISTIST TRY АИЛ 02АПР14 1843 901/KK0000005 02APR14/1835 VOLUNT АМ 01APR 1400 MOW (ЗА 621 ЧАСОВ ДО ВВ) ## Х ПО АК РЕЙС БР ДВ ВВ СТ КОДТАР НДО НПО БГ 1 IST KK 20 H 21APR 0730 OK HOWKKD 20K 2 ADB KK 21 H 27APR 1030 OK HOWKKD 20K IST ТАРИФ-В=107.00TRY СБОРЫ-В=6.00TRY СБОРЫ-У=64.20TRY ВСЕГО=48.80TRY 1 BACK MONEY MR 15DEC66/PPUA23335 2 ВТ 107.00(RULE),A 3 ВС И/БЛТ, C1, YQ, 10.00EUR/27.30TRY,1EUR=2.73TRY 4 ВС В/БЛТ, C2, VQ, 6.00TRY 5 СБ У/ШТР, --, 64.20TRY 64.20TRY,A 6 ВО CASH/113.00TRY 7 ФМ CASH/64.20TRY
901/KK0000005 02APR14/1835 VOLUNT XX 01APR 1400 MOW (621 HRS BFR DT) ## X DA CC FLT CLS DD DT ST FARE BASIS NVB NVA BAG 1 IST KK 20 H 21APR 0730 OK HOWKKD 20K 2 ADB KK 21 H 27APR 1030 OK HOWKKD 20K IST FARE-R=107.00TRY TAX-R=6.00TRY TAX-C=64.20TRY TOTAL=48.80TRY 1 BACK MONEY MR 15DEC66/PPUA23335 2 RF 107.00(RULE),A 3 RT I/TCT, S1, YQ, 10.00EUR/27.30TRY,1EUR=2.73TRY 4 RT R/TCT, S2, VQ, 6.00TRY 5 TX C/PEN, --, 64.20TRY 64.20TRY,A 6 RO CASH/113.00TRY 7 FM CASH/64.20TRY