Versions Compared

Key

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


Excerpt


#QuestionAnswer
1

How to access the product environment?

(lightbulb)You can read about it here
2

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

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

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



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

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

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

...

What does the PenaltyList block mean (AirShoppingRS)?

...

Fare penalties informarion block.

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

(lightbulb)You can see the full fare rules application by FareRulesRQ

...

  1. Low Fare search — search for offers with a minimal price. Solutions include information for a whole requested journey (no matter OW or RT).
  2. 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.

...

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

Code Block
languagexml
themeConfluence
titleManage by quantity
collapsetrue
 <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
languagexml
themeConfluence
titleManage by PTC
collapsetrue
 <ns3:Travelers>
   <ns3:Traveler>
      <ns3:AnonymousTraveler>
         <ns3:PTC Quantity="1">ADT</ns3:PTC>
      </ns3:AnonymousTraveler>
   </ns3:Traveler>
 </ns3:Travelers>

...

Yes.

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

...

Yes.

(lightbulb)You can read about it here Scenarios

...

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

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

Code Block
languagexml
themeConfluence
titleDirect flight parameter
collapsetrue
Preferences>
   <Preference>
      <FlightPreferences>
         <Characteristic>       
		    <DirectPreferences>Preferred</DirectPreferences>
         </Characteristic>
      </FlightPreferences>
   </Preference>
</Preferences>

...

You can see this parameter in the ItinReshopRS.

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

...

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

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

...

.


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.

...