Versions Compared

Old Version 2

changes.mady.by.user Pavel A. Smirnov (Deactivated)

Saved on

compared with

New Version 3

changes.mady.by.user Pavel A. Smirnov (Deactivated)

Saved on

Key

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

...

Only one payment method is used - invoice

Excerpt


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
#QuestionAnswer
1

How to access the product environment?

(lightbulb)You can read about it here2

What types of passengers are used in the API?

Note
iconfalse

(lightbulb) If the passenger is 2 years old, he is a CHD

(lightbulb) If the passenger is 12 years old, he is an ADT

3

What types of payment can be used?

Code Block
languagexml
themeConfluence
titlePayment type view in ticketing RQ
collapsetrue
<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
iconfalse

(lightbulb) 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?

If you are newbie, just follow the steps, which provides a simplest way to quickly get an access to API

Or you already adopted your systems to our test environment? Notify our technical support by JIRA for final testing under the supervision of our technologists and proceed to signing of the contract of EDS

2

How to access the test environment?

Follow steps to quickly get an access to API

3

Which endpoints should be used?

Explore the ways of submitting requests:

Excerpt Include
Submitting requests
Submitting requests

4

How does the standard ticketing scenario looks?

Simple operation flow: searchFlights (AirShoppingRQ) → book (OrderCreateRQ) → reprice (ItinReshopRQ) → demandTickets (AirDocIssueRQ)

Discover more scenarios from simplest flows to best practices

5

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

No, only 3 types of passengers are available:

  • adult (ADT)
  • child (CHD)
  • infant (INF)
6

What types of passengers are available in the API?

3 types of passengers are available:
  • adult (ADT) —  passengers 12 years old and older
  • child (CHD) — passengers between 2 (inclusive) and 12 years old (exclusive)
    • 2-year-old passenger is a child
    • 12-year-old passenger is an adult
  • infant (INF) —  passengers under 2 years
7

What types of payment can be used?

Only one payment method is used — invoice

Code Block
languagexml
themeConfluence
titlePayment type view in ticketing RQ
collapsetrue
<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
iconfalse

Processing of payments isn't on our side


8

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

For any financial questions you have to contact S7's sales department or your account manager via at vm@s7.ru

9

Is the Multi-City method implemented in API?

Yes, check searchFlights operation overview to find out. Samples will be available soon!

10

Is the refund method implemented in API?

No, the refunds are not implemented11Can I get an S7 route map?There is no such request in API12

Are all S7 fares branded?

Yes.13

Can I get a terminal text view

#EnviromentEndpoint
1TESThttps://qa-gaia.s7.ru/agent-api/gaia
2PRODhttps://api.s7.ru/agent-api/gaia
6

Is the Multi-City method implemented in API?

Yes.

(lightbulb)You can read about it here ((tongue) 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)

(lightbulb)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 only XML display is available.

1014

Can I add DOCO DOCA information?

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

11

How to access the test environment?

(lightbulb)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.

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 using of correct HTTP header of your requests:

  • X-API-Version — e.g. 0.35 or other
  • SOAPAction — e.g. "http://api.s7.ru/Reprice" or other
  • Content-Type: text/xml

Also you can find out how to handle with unsuccessful result and common access errors

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 here

didn't use a right SSL certificate to download API's WSDL. 

Check that you used certificate for the test environment (not for production).

If it seems ok to you, contact to S7 API support with attached request body and headers

In case you never heard about access credentials to API, just follow the steps, which provides a simplest way to quickly get an access to API

Also you can find out how to handle with unsuccessful result and common access errors

18

We get an error: 

"032 - SI"

Incorrect Agent credentials in Party tag

. Contact

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

.

Also you can find out how to handle with unsuccessful result and common access errors


Book operation questions

#QuestionAnswer
1

What types of documents are used?

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

Code Block
languagexml
themeConfluence
titlePassport
collapsetrue
<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
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>


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

    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>


  • both types

    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?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
languagexml
themeConfluence
titlePassport
collapsetrue
<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

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.
15Does theTTL guarantee automatic cancellation of the reservation?Yes. Booked seats will be free.

...