Page History

Children Display

all	true
style	h2
excerptType	rich content

Common questions

#QuestionAnswer1

How to access the product environment?

You can read about it here2

What types of passengers are used in the API?

3 types of passengers are used:

- - adult (ADT) — passengers from 12 years and older
  - child (CHD) — passengers from 2 to 12 years
  - infant (INF) — passengers under 2 years

Note

icon	false

If the passenger is 2 years old, he is a CHD

If the passenger is 12 years old, he is an ADT

3

What types of payment can be used?

Only one payment method is used - invoice

Code Block

language	xml
theme	Confluence
title	Payment type view in ticketing RQ
collapse	true

<Type>
   <Code>MS</Code>
</Type>
<Other>
   <Remarks>
      <Remark>IN*A*AGENT_NAME</Remark>
   </Remarks>
</Other>

where:

MS — payment type code (invoice)

IN*A*AGENT_NAME — agent details

Note

icon	false

Processing of payments isn't on our side.

4

How can I get information about flights commissions and manage agency fees?

You need to contact the sales department.

5

Which endpoints should be used?

#	Enviroment	Endpoint
1	TEST	https://qa-gaia.s7.ru/agent-api/gaia
2	PROD	https://api.s7.ru/agent-api/gaia

6

Is the Multi-City method implemented in API?

Yes.

You can read about it here ( Oops! It will be a link to the documentation here as soon as possible!)

7

How does the standard ticketing scenatio looks?

searchFlight (AirShoppingRQ) → book (OrderCreateRQ) → reprice (ItinReshopRQ) → demandTicket (AirDocIssueRQ)

You can read about it here Scenarios

8

Is it possible to use social categories of passengers - pensioners, youth, sailors, students, etc.?

No. Only 3 types of passengers are used: ADT, CHD, INF.9

Can I get a terminal text vuew of the current PNR data? Or just build a template from an XML response?

No, currently only XML display is available.

10

Can I add DOCO DOCA information?

No, currently only DOCS, FOID and FQTV SSRs are available.

11

How to access the test environment?

You can read about it here12Can I get an S7 route map?There is no such request in API.13

Are all S7 fares branded?

Yes.14

Is the refund method implemented in API?

No, currently the refands are not implemented.15Does the service support queues?In the API all requests are synchronous, queues are not used.16

When we the requests is executed in SoapUI, we get an response: "Unknown operation"

Check HTTP header. It can be see here 17

When I reach on the link: https://qa-gaia.s7.ru/agent-api/wsdl/0.35?wsdl

I get an error: "400 Bad Request. No required SSL certificate was sent."

You must have a certificate and a basic-auth to use our API. How to get them you can see here18

We get an error:

"032 - SI"

Incorrect Agent credentials in Party tag. Contact to S7 API support with used Agent credentials in Party tag.

Search operation questions

#QuestionAnswer1

What does the PenaltyList block mean (AirShoppingRS)?

Fare penalties informarion block.

Penalties types:

NO-SHOW (NS) — a situation, when the passenger fails to show for the flight before the check-in closing and notify the carrier of cancelling the carriage.

PRIOR DEPARTURE (PDE) — penalties if the passenger want before departure to change the conditions of transportation on the previously purchased air ticket.

AFTER DEPARTURE (ADE) — penalties if the passenger want after departure to change the conditions of transportation on the previously purchased air ticket.

You can see the full fare rules application by FareRulesRQ

2What is the difference between LowFare and BrandedFares search methods?

Low Fare search — search for offers with a minimal price. Solutions include information for a whole requested journey (no matter OW or RT).
Branded fares search — solutions include information only for requested slice of journey (only inbound or outbound itinerary). Pricing also divided by fare family and mostly includes 4 or 2 sub solutions (Basic Economy, Flex Economy, Basic Business, Flex Business) for each itinerary solution.

3How to manage parameters in the Travelers block in AirShoppingRQ?

You can add all types of passengers and specify there quantity (from 0 to 9)

Code Block

language	xml
theme	Confluence
title	Manage by quantity
collapse	true

 <ns3:Travelers>
   <ns3:Traveler>
      <ns3:AnonymousTraveler>
         <ns3:PTC Quantity="1">ADT</ns3:PTC>
      </ns3:AnonymousTraveler>
   </ns3:Traveler>
      <ns3:Traveler>
      <ns3:AnonymousTraveler>
         <ns3:PTC Quantity="0">CHD</ns3:PTC>
      </ns3:AnonymousTraveler>
   </ns3:Traveler>
      <ns3:Traveler>
      <ns3:AnonymousTraveler>
         <ns3:PTC Quantity="0">INF</ns3:PTC>
      </ns3:AnonymousTraveler>
   </ns3:Traveler>
 </ns3:Travelers>

You can specify only the required types

Code Block

language	xml
theme	Confluence
title	Manage by PTC
collapse	true

 <ns3:Travelers>
   <ns3:Traveler>
      <ns3:AnonymousTraveler>
         <ns3:PTC Quantity="1">ADT</ns3:PTC>
      </ns3:AnonymousTraveler>
   </ns3:Traveler>
 </ns3:Travelers>

4Is it possible to search flights with the option +- 1 day?No.5Is it possible to search for a complex route, or OW/RT only?

Yes.

You can read about it here ( Oops! It will be a link to the documentation here as soon as possible!)

6Is it possible to search for a partner flights (COdeShare/SPA)?

Yes.

You can read about it here Scenarios

7Can I request only direct flights?

Yes. It's necessary to specify the following search parameter:

Envelope /Body /AirShoppingRQ /Preferences /Preference /FlightPreferences /Characteristic /DirectPreferences="Preferred"

Code Block

language	xml
theme	Confluence
title	Direct flight parameter
collapse	true

Preferences>
   <Preference>
      <FlightPreferences>
         <Characteristic>       
		    <DirectPreferences>Preferred</DirectPreferences>
         </Characteristic>
      </FlightPreferences>
   </Preference>
</Preferences>

8Why in the AirShoppingRS we don't receive the Ticket Designator for CHD and INF PTC (CH25, IN00)

You can see this parameter in the ItinReshopRS.

You can see an example here OW + 2xADT 2xCHD 2xINF + Transfer + SPA | v0.35 | reprice operation

9Do S7 have transit flights (for example technical stops without flight number changing)?

Yes, but you can see information about trasits only in AirShoppingRS. In other RQ/RS trasits information isn't displayed.

You can see an example here OW + 1xADT + Transit + S7 | v0.35 | searchFlight operation

10Is it possible to receive a ticketing time limit in AirShoppingRS?No. You can receive it only in OrderViewRS (RS to booking request).11Will we get in response flights that end later than the date specified in the search?Yes.

Book operation questions

#QuestionAnswer1

What types of documents are used?

PP tyep only, but in the ID field you can enter information about any document:

Code Block

language	xml
theme	Confluence
title	Passport
collapse	true

<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>

Code Block

language	xml
title	birth certificate
collapse	true

<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>

2Can I specify multiple phone numbers and emails?

Yes, but you need to consider the following logic:

e-mails — for each e-mail created a separate Contact element

Code Block

language	xml
theme	Confluence
title	e-mails
collapse	true

<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 block

Code Block

language	xml
theme	Confluence
title	phoneContact
collapse	true

<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>

both types

Code Block

language	xml
theme	Confluence
title	both types
collapse	true

<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?The TTL is calculated automatically. It's possible to enter it manually, but we recommend not using this functionality, as it will be closed soon.4What characters are forbidden for input?

You can't use the following characters:

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

5What passenger data are required?

Required passenger data:

Surname
Given
Age
Contacts
PassengerDocument

6Is it possible to change the automatic TTL?There is no such possibility, the TTL is calculated according to the airline requirements.7Is the automatic time limit matches for the airline fare rules?Yes. TTL 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.

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

language	xml
theme	Confluence
title	Passport
collapse	true

<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

language	xml
title	birth certificate
collapse	true

<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

12Will EMD information be displayed in PNR if EMD is issued?Yes, it will be displayed like ticket information13What 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.15Does theTTL guarantee automatic cancellation of the reservation?Yes. Booked seats will be free.

ChangeBook operation questions

#QuestionAnswer1When the document changes, will the information change in both SSRs (DOCS/FOID)?Yes.2How to buy seats for an existing booking?

Yes.

You can read about it here ( Oops! It will be a link to the documentation here as soon as possible!)

3Is it possible to book additional services if tickets have already been issued?

Yes.

You can read about seats here ( Oops! It will be a link to the documentation here as soon as possible!)

You can read about bags here ( Oops! It will be a link to the documentation here as soon as possible!)

4Is it possible to change the passport data in the existing booking?

Yes.

You can read about it here ( Oops! It will be a link to the documentation here as soon as possible!)

5

When the OrderChangeRQ is executed, we get an error:

<ns3:Error Type="LOC" Tag="Property change_book_request can not be empty" RecordID="CHNG_BOOK_RQ_IS_EMPTY"/>.

It's forbidden to use the following symbols: ; : * ' " ^ { } [ ] < > & # ! ` = %

DemandTickets operation questions

#QuestionAnswer1What is the difference between a ETK and a EMD?

ETK - Electronic Ticket. Document confirming the payment of the itinerary.

EMD - Electronic Miscellaneous Document. Document confirming the payment of services

Note

icon	false

In the requests you need to use the following codes:

ETK Type code - 702

EMD Type code - Y

2Is the ticket issued for each segment of the flight?No, the ticket is issued for the whole itinerary, but for each passenger in the booking.3Is it possible to rуfund ETK/EMD?No, at the moment, only void operation is implemented for ETK/EMD.4If there are booked extra services in the booking, is the ticket issued at the same time as the EMD or is it not important?EMDs are issued only after the ticket is issued.5How can we get a terminal view of ETK/EMD?

Issue of terminal type of ETK/EMD is not implemented. You can read the issued ETK/EMD using the operation AirDocDisplayRQ.

You can read about it here ( Oops! It will be a link to the documentation here as soon as possible!)

Note

icon	false

In the requests you need to use the following codes:

ETK Type code - 702

EMD Type code - Y

6Is the Remarc parameter mandatory in the Payment block and, if so, what is its format?

Yes, this is a mandatory parameter. Corresponds to RMK type in Gabriel - text field.

It's forbidden to use the following symbols: ; : * ' " ^ { } [ ] < > & # ! ` = %

Code Block

language	xml
theme	Confluence
title	Payment block example
collapse	true

                        <Payment>
                            <Type>
                                <Code>MS</Code>
                            </Type>
                            <Other>
                                <Remarks>
                                    <Remark>IN*QUW1725</Remark>
                                </Remarks>
                            </Other>
                        </Payment>

VoidTicket operation questions

#QuestionAnswer1I can't void a ticket.What could be the reason?Voided the ticket can only use the same validator, under which the ticket was issued. Make sure you use the same validator.2Are there any features of void operation?

You can void the ticket until 23:59 of the current day (day of ticket issue).

Time in 0 time zone (0UTC).

Voided the ticket can only use the same validator, under which the ticket was issued. Make sure you use the same validator.
In the requests you need to use the following codes:

ETK Type code - 702

EMD Type code - Y

3When can I void a ticket?

You can void the ticket until 23:59 of the current day (day of ticket issue).

Time in 0 time zone (0UTC).

4If the ticket is issued on the day of departure, can I void it after departure or only until? If we can't void the ticket after departure, then for what time before we need to void it?The main thing isn't to allow a NO-SHOW (NS) — a situation, when the passenger fails to show for the flight before the check-in closing and notify the carrier of cancelling the carriage. You can void the ticket after departure until 23:59 of the current day (If the ticket is not used), but it is better to void the ticket before departure.

Table of contents:

Table of Contents

Page tree

Versions Compared

Old Version 19

New Version 20

Key

Common questions

Search operation questions

Book operation questions

ChangeBook operation questions

DemandTickets operation questions

VoidTicket operation questions