| # | Question | Answer | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | How to access the product environment? |  You can read about it here | |||||||||
| 2 | What types of passengers are used in the API? | 3 types of passengers are used:
| |||||||||
| 3 | What types of payment can be used? | Only one payment method is used - invoice where: MS — payment type code (invoice) IN*A*AGENT_NAME — agent details
| |||||||||
| 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.
| |||||||||
| 7 | How does the standard ticketing scenatio looks? | searchFlight (AirShoppingRQ) → book (OrderCreateRQ) → reprice (ItinReshopRQ) → demandTicket (AirDocIssueRQ)
| |||||||||
| 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 here | |||||||||
| 12 | Can 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. | |||||||||
| 15 | Does 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. |
Book operation questions
| # | Question | Answer |
|---|---|---|
| 1 | What types of documents are used? | PP tyep only, but in the ID field you can enter information about any document: |
| 2 | Can I specify multiple phone numbers and emails? | Yes, but you need to consider the following logic:
|
| 3 | How 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. |
| 4 | What characters are forbidden for input? | You can't use the following characters: ; : * ' " ^ { } [ ] < > & # ! ` = % |
| 5 | What passenger data are required? | Required passenger data:
|
| 6 | Is it possible to change the automatic TTL? | There is no such possibility, the TTL is calculated according to the airline requirements. |
| 7 | Is the automatic time limit matches for the airline fare rules? | Yes. TTL is calculated according to the airline requirements, considering the partner airlines. |
| 8 | In what format are passport data entered (DOCS/FOID)? | In OrderCreateRQ you need to fill the PassengerDocument block. In GDS both SSRs are created. |
| 9 | Why is it necessary to enter the date of passport issuance? | The next filling of the PassengerDocument block is required: ADT, CHD, INF CHD, INF |
| 10 | Why 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. |
| 11 | What do the elements BirthCountry/CountryOfResidence describe? | BirthCountry — сountry of issue CountryOfResidence — citizenship |
| 12 | Will EMD information be displayed in PNR if EMD is issued? | Yes, it will be displayed like ticket information |
| 13 | What SSR codes are implemented? | DOCS FOID CHLD INFT FQTV TKNE XBAG EXST |
| 14 | Why 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. |
| 15 | Does theTTL guarantee automatic cancellation of the reservation? | Yes. Booked seats will be free. |
ChangeBook operation questions
| # | Question | Answer |
|---|---|---|
| 1 | When the document changes, will the information change in both SSRs (DOCS/FOID)? | Yes. |
| 2 | How to buy seats for an existing booking? | Yes.
|
| 3 | Is it possible to book additional services if tickets have already been issued? | Yes.
|
| 4 | Is it possible to change the passport data in the existing booking? | Yes.
|
| 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: ; : * ' " ^ { } [ ] < > & # ! ` = % |
Oops! It will be a link to the documentation here as soon as possible!)DemandTickets operation questions
| # | Question | Answer |
|---|---|---|
| 1 | What 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
ETK Type code - 702 EMD Type code - Y |
| 2 | Is 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. |
| 3 | Is it possible to rуfund ETK/EMD? | No, at the moment, only void operation is implemented for ETK/EMD. |
| 4 | If 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. |
| 5 | How 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.
ETK Type code - 702 EMD Type code - Y |
| 6 | Is 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.
|
In the requests you need to use the following codes:VoidTicket operation questions
| # | Question | Answer |
|---|---|---|
| 1 | I 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. |
| 2 | Are there any features of void operation? |
ETK Type code - 702 EMD Type code - Y |
| 3 | When can I void a ticket? | You can void the ticket until 23:59 of the current day (day of ticket issue).
|
| 4 | If 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. |
