Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Excerpt


#QuestionAnswer
1

What types of documents are used?

PP type only, but you can enter any document identifier in the ID tag :

Code Block
languagexml
themeConfluence
linenumberstrue
<ns3:PassengerDocument>
    <ns3:Type>PP</ns3:Type>
    <ns3:ID>rbrtrtvgb123456</ns3:ID>
    <ns3:BirthCountry>RU</ns3:BirthCountry>
    <ns3:DateOfIssue>2008-06-06</ns3:DateOfIssue>
    <ns3:DateOfExpiration>2028-06-06</ns3:DateOfExpiration>
    <ns3:CountryOfResidence>RU</ns3:CountryOfResidence>
</ns3:PassengerDocument>

Check operation references for obtainable values for a request 

2Can I specify multiple phone numbers and emails?

Yes, but you have to follow instructions below:

  • e-mails — for each e-mail create a separate Contact tag

    Code Block
    languagexml
    themeConfluence
    titlee-mails
    collapsetrue
    <ns3:Contacts>
        <ns3:Contact>
            <ns3:EmailContact>
                <ns3:Address>l.conelly@mail.ru</ns3:Address>
            </ns3:EmailContact>
        </ns3:Contact>
        <ns3:Contact>
            <ns3:EmailContact>
                <ns3:Address>l.ercrvev@mail.ru</ns3:Address>
            </ns3:EmailContact>
        </ns3:Contact>
    </ns3:Contacts>


  • phoneContact — you can specify several phone numbers in one PhoneContact tag

    Code Block
    languagexml
    themeConfluence
    titlephoneContact
    collapsetrue
    <ns3:Contacts>
        <ns3:Contact>
            <ns3:PhoneContact>
                <ns3:Number CountryCode="+375" AreaCode="29">3277438</ns3:Number>
                <ns3:Number CountryCode="+375" AreaCode="29">44444444</ns3:Number>
                <ns3:Number CountryCode="+375" AreaCode="29">66666666</ns3:Number>
                <ns3:Number CountryCode="+375" AreaCode="29">77777777</ns3:Number>
            </ns3:PhoneContact>
        </ns3:Contact>
    </ns3:Contacts>


  • using both:

    Code Block
    languagexml
    themeConfluence
    titleboth types
    collapsetrue
    <ns3:Contacts>
        <ns3:Contact>
            <ns3:PhoneContact>
                <ns3:Number CountryCode="+375" AreaCode="29">3277438</ns3:Number>
                <ns3:Number CountryCode="+375" AreaCode="29">44444444</ns3:Number>
                <ns3:Number CountryCode="+375" AreaCode="29">66666666</ns3:Number>
                <ns3:Number CountryCode="+375" AreaCode="29">77777777</ns3:Number>
            </ns3:PhoneContact>
            <ns3:EmailContact>
                <ns3:Address>l.conelly@mail.ru</ns3:Address>
            </ns3:EmailContact>
        </ns3:Contact>
        <ns3:Contact>
            <ns3:EmailContact>
                <ns3:Address>l.ercrvev@mail.ru</ns3:Address>
            </ns3:EmailContact>
        </ns3:Contact>
    </ns3:Contacts>
3How to specify TTL?

Ticket time limit is calculated automatically

(warning) We do not recommend enter it manually, as it will be deprecated soon


Explore book operation overview to the best practices. Reference and samples are also available

4What characters are forbidden for input?

You can't use the following characters:

Code Block
; : * ' " ^ { } [ ] < > & # ! ` = %

Check operation references for obtainable values for a request tags to avoid errors

5What passenger data are required?

Required data for each passenger:

  • Given name
  • Surname
  • Date of birth
  • Document identifier

Also required for lead passenger (the first adult):

  • E-mail (at least one)
  • Phone number (at least one)

All mandatory fields are marked in book operation references.

9Why is it necessary to enter the date of passport issuance?

It will be deprecated soon. Stay tuned for new releases

11What do the BirthCountry and CountryOfResidence mean?
  • BirthCountry — Country of issue
  • CountryOfResidence — Citizenship

Check book operation references and samples for more info about passenger's document info

8What passport data format is required for input (DOCS or FOID)?

Both SSRs are created by API regarding Document tag values

The Document tag is mandatory to fill for a Passenger in book operation request

Check book operation references and samples for more info about Document tag

13What SSR codes are implemented?

The following SSR codes are accepted:

  • DOCS
  • FOID
  • CHLD
  • INFT
  • FQTV
  • TKNE
  • XBAG
  • EXST

Check book operation references for obtainable values for a request 

14Why there is no possibility to enter DOCO (visa) or DOCA (residental address) SSRs?S7 do not require visa details for booking and ticketing. It's required for check-in only
3How to specify TTL?

Ticket time limit is calculated automatically

(warning) We do not recommend enter it manually, as it will be deprecated soon. Stay tuned for new releases 

6Is it possible to change the automatic TTL?

There is no such possibility,

the TTL is

a ticket time limit is calculated according to the airline requirements

(warning) We do not recommend enter it manually, as it will be deprecated soon. Stay tuned for new releases 

7Is the automatic time limit matches TTL matches for the airline fare rules?Yes.  TTL is Ticket time limit is calculated according to the airline requirements, considering the partner airlines.
8In what format are passport data entered (DOCS/FOID)?

In OrderCreateRQ you need to fill the PassengerDocument block.

In GDS both SSRs are created.

15Does TTL guarantee automatic cancellation of the reservation?Yes. Booked seats will be free
10Why there is no link between an infant and an adult?

API creates links between adults and infants in a lap automatically

In case you have to specify infants to exact adults you can enter adult's ObjectKey in PassengerAssociation tag of infant's Passenger tag, e.g.:

9Why is it necessary to enter the date of passport issuance?

The next filling of the PassengerDocument block is required:

ADT, CHD, INF

Code Block
languagexml
themeConfluence
titlePassport
collapsetrue
linenumberstrue
<Passengers>
	<Passenger ObjectKey="SH1">
		<PTC Quantity="1">ADT</PTC>
<ns3:PassengerDocument> <ns3:Type>PP</ns3:Type> <ns3:ID>131231231222</ns3:ID>

    
<ns3:BirthCountry>RU</ns3:BirthCountry>
    
<ns3:DateOfIssue>2008-06-06</ns3:DateOfIssue>
...
    
<ns3:DateOfExpiration>2028-06-06</ns3:DateOfExpiration> <ns3:CountryOfResidence>RU</ns3:CountryOfResidence> </ns3:PassengerDocument>

CHD, INF

Code Block
languagexml
titlebirth certificate
collapsetrue
<ns3:PassengerDocument>
    <ns3:Type>PP</ns3:Type>
    <ns3:ID>rbrtrtvgb123456</ns3:ID>
    <ns3:BirthCountry>RU</ns3:BirthCountry>
    <ns3:DateOfIssue>2008-06-06</ns3:DateOfIssue>
    <ns3:DateOfExpiration>2028-06-06</ns3:DateOfExpiration>
    <ns3:CountryOfResidence>RU</ns3:CountryOfResidence>
</ns3:PassengerDocument>
10Why there is no link between an infant and an adult?The link exists, but is used only at the stage of issuing the ticket for infant.
11What do the elements BirthCountry/CountryOfResidence describe?

BirthCountry — сountry of issue

CountryOfResidence — citizenship

</Passenger>
	<Passenger ObjectKey="SH2">
		<PTC Quantity="1">INF</PTC>
		<PassengerAssociation>SH2</PassengerAssociation>
        ...
    </Passenger>
</Passengers>



12Will EMD details 12Will EMD information be displayed in PNR if EMD is issued?

Yes, it will be displayed

like ticket information
13What SSR codes are implemented?

DOCS

FOID

CHLD

INFT

FQTV

TKNE

XBAG

EXST

14Why there is no possibility to enter DOCA and DOCO SSRs?At the stages of booking and ticketing, we don't require visa data. Visa is required on check-in.

as a ticket information

To recieve EMD info use read operation (documentation will be available soon)

15Does theTTL guarantee automatic cancellation of the reservation?Yes. Booked seats will be free.