#GroupQuestionAnswer
1Application

How to specify endpoints of internal systems (e.g., portal for a call center, mobile application)?

If your system have no domain name, you should use IP address. In case it's not public, please, ask your account manager for further details.

(question) B2B решение? Вместо домена указать IP? — Marina Kharchenko 

2ApplicationIt would be nice to know what data will be needed to fill out the application in advance

Check out blank application form added to Quick Start page.

(question) Пример заявки, добавить скриншот в Quick Start — Marina Kharchenko 

3ApplicationWhat does testing under the supervision of S7 technologists include before proceeding to production?Currently we working on it with our technologists. All scenarios will be described in Scenarios page.
4Application

It would be better to share with you credentials to our sites and test environments to bring to you our needs

Provide this information to your account manager or send credentials as a feature request to our technical support by JIRA

(question) Мы можем добавить это в анкету? — Marina Kharchenko 
(question) Может сделаем рассылку всем текущим агентам? — Danil Trefilov

5JIRA

Using one account for all integration specialists isn't suitable for us. Why you do not group accounts to make all issues that we have done were visible to all our specialists?

Our account policy has been changed which allows using multiple user accounts per agent instead only one for everyone.
New agents should mention all emails of specialists in the application form, the old ones should create a task for our technical support by JIRA

(question) Это можно делать через группы. Нужно расписать, что делать в такой ситуации им — Danil Trefilov 
(question) Нужно учесть это в Application — Marina Kharchenko

6JIRA

How to make requests for a new feature?

All JIRA request types specified in Support section, as for feature requests — check it out and let us know your needs!

(question) Нужно добавить новый тип задач в Jira для чендж реквестов — Danil Trefilov

7SupportIs there any plan to launch operational 24/7 support for the production environment? 

Yes, but these plans will be announced later

8Notification

It's not clear if the environment is updated

We've just launched the blog to notify you about all environment updates. Stay tuned!

9Notification

How we can be notified of environment downtime?

All possible downtimes will be published at the blog that we recently launched. Keep updated!

10NotificationWhere we can check system availability?We've added this feature to our backlog and hope you'll soon be able to easily check the health status of environments
11Documentation

We faced a lack of examples. Please, add: request for fare details, ticket void, multi-segment flights

Documentation will be up to date until

12DocumentationWhen can we expect the next update of the API's documentation? How often will this happen?We have no exact schedule for that, but plan to deliver small updates every week
13Documentation

We do not observe documentation updates as a result of JIRA issues resolving

Not all questions are grabbed for insertion into documentation, only the most common or critical
Updates according JIRA issues will be posted once per two weeks primarily in FAQ and operations overview

14DocumentationThe API's documentation does not describe the following operations: voidTicket, demandTicket, changeBook

DemandTickets operation is already specified in API's documentation, check it out!
As for voidTicket and changeBook operations — they will be available until  

15DocumentationAre all possible values for API's requests specified in the documentation?Check out References page with detailed explanation of I/O parameters (incl. possible values) and probable errors
16Documentation

Published roadmap with launch dates will help us better plan our development. Especially if you plan to add new features and operations

Due to agile methodology we can't post exact launch dates of versions. Check priority lists of features in the Road Map
For a better understanding all of them divided into operations and approximately into quarters
17DeploymentHow long will the old versions be available after the release of the new ones?We have no strong deprecation policy, so it'd be available until everyone stops using old versions.
At the moment that we have to deactivate the old version until, we'll notify each user individually.
18DeploymentHow much time do we have to move to the new versions?There's no time limits. All older versions will be available as new ones at the same time.
19DeploymentIs it possible I/O formats of version be changed over time?No, all I/O enhancements will be introduced only by a new version of the API.
We can update old versions to apply hot fixes for urgent bugs, but they'll never change I/O too.
20DeploymentCan the version of the NDC schema be updated only for one of the operations?If we decide to move to a new version of the NDC schema, then this will be done at a time for the all operations by releasing a new version
21DeploymentWhen will the next version be released? How often will they go out?

We going to keep the pace approx. one release in three months but only for test environment.
Production environment will be updated only if someone will be ready and notifies our technical support by JIRA.
Check Quick Start for more details about moving to production.

22Non-functionalHas the API been stress tested?Not yet
23Non-functionalHow was the value of high availiability calculated? It would be better to publish downtime statistics.This value based on our internal statistics. From now you can check the blog for all possible downtimes
24Non-functional

What are the min, max and mid response time for each operation? Also there's no info about timeouts

We posted selected statistics of response time for each operation to make it more transparent
25Non-functionalIs there a load distribution depending on the agent? Do you limit the number of requests for each agent individually?No, we do not limit the agents and we do not prioritize traffic
26Fares

Ability of combining fares is still not clear represented in documentation. Why we able to book an itinerary with uncombinable fares via Gabriel and can not do the same via the API?

According to S7 technology it's prohibided to use uncombinable fare for a single ticket
To check legality of your case, please, provide examples to our technical support by JIRA

27FaresWhy subsidized fares are not available still?

According to requirements of The Ministry of Transport of the Russian Federation it's prohibided for online sales

28FaresWhen will be available shopping with interline flights?Check priority lists of features in the Road Map
Due to agile methodology we can't post exact launch dates, but features divided into approximately into quarters
29FaresWhat are the limitations of the 3D Agreement basic shopping scenario? What about discounts combinations?

All limitations for 3D Agreement basic shopping scenario already specified in documentation:

  • This functionality is for adult passengers only
  • You can use only one cabin type (Economy or Business) on the whole itinerary (both slices)
  • You can't combine different discounts in one itinerary
  • Discounts are available for S7 flights only
  • Discounts are available for Branded Fares Search only
30Fares

What is the best way to book a journey to avoid round trip fares and to keep ability to use non-combinable fares for each slice separately?

According to S7 technology it's prohibided for online sales. The only way to make it happen is to proceed separated flows fo those parts of journey.

31GeneralIs there an updates of the current versions? If so, where can we find out about these updates?Yes, but these hot fixes are only for urgent bugs and they're never change I/O. We also add info to Release notes of versions that have been fixed
32General

What is the main scenario for API using?

Discover from simplest flows to the best practices at Scenarios page of API's documentation

33General

Should we track look-to-book ratio?

We do not fix this value in the contract and only recommend that the value should not exceed 200-1

34General

Currently API returns the same error code in all fault cases. Could you divide it into different codes and provide instructins how to manage with it?

We already changed error responses from 0.35 version and going to reassign all API errors in the near future
35searchFlights
(feature request)		We need a param in the request to limit the number of solutions in the response — there are too many of themWe added the feature request to the Road Map
Check it out and stay tuned for our updates by release notes and the launched blog
36searchFlights

Deprecation of LowFare search isn't a good idea. Could you update it and keep it alive?

It wasn't update for a long time because we going to deprecate this type of search.
We returned it back to our Road Map 
37searchFlights

In same cases we need to search only for basic or flex fares. Could you add filter on your side?

We added the feature request to the Road Map
38searchFlights

The API's documentation does not explain combining of fares and difference between search types?

Search — returns many solutions for each day. Solutions include itinerary and pricing information.
  1. Low fare search — 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.
    1. For a first slice — requires itinerary criteria and passenger types count. Returns unique reference for each solution.
    2. For subsequent slices — requires only selected solution reference from previous search results.
  3. Fares are combined by family. I. e. you can combine fares from only one fare family - FLEX (FlexEconomy and FlexBusiness) or BASIC (BasicEconomy and BasicBusiness)

(lightbulb) Check searchFlights operation for more information

39searchFlights

We expected stopovers in the searchFlights operation response, but diidn't find them. Is it deployed?

(question) Valeriya Shishkova
40searchFlights

On route SLY-OVB we expected to get basic fare family, but searchFlights returned only flex. What happed?

Generally you recieve all of four fare families for all domestic flights.
You have to provide additional examples to our technical support by JIRA to invistigate this case.

41searchFlightsFlex

Are days after and days before params mandatory for this operation?

No, if you do no set them you recieve result only for one day
42searchFlightsFlex

What diferrence between searchFlights and searchFlightsFlex operations?

  1. searchFlights
    1. RQ — search flights for the only specified date
    2. RS
      1. solutions for specified day with itinearary, pricing and fare details
      2. to get info about next slice — send selected solution reference of a previous slice (second request)
  2. searchFlightsFlex (warning) Valeriya Shishkova вставить ссылку
    1. RQ — the same, but you may specified, e.g. +/-15 days from specified date
    2. RS
      1. only one solution per day with the minimal price and no itineary, pricing and fare details
      2. you recieve total priceper solution for the whole journey (for all requested slices)
43seatMap

The response of seatMap operation does not contain details such as: exit row, extra space, seats for infants in a lap, etc.

We preparing a huge update for this operation already.
Stay tuned for our updates by release notes and the launched blog

44book

If incompatible fares are prohibited anyway, could you add additional validation for that in book operation?

We added the feature request to the Road Map
Check it out and stay tuned for our updates by release notes and the launched blog
45bookCan we make reservations without passenger details or with a fake? We want to avoid situations when flight became sold out while passenger inputs his details for booking.You can't skip passenger's name, surname and contact for making reservation. Also you can't modify name and surname after.
46bookКакие будут начеты по фейковым броням?(question) Valeriya Shishkova
47bookПроверки при CodeShare/SPA?
Сможем ли выписать билет, в случае если не будет подтверждение от партнера (статус сегмента и локатор патнера)?		Сейчас нет, но будут: Перезачитка пнр, получение статусов и пр
48bookВоенно перевозочные документыв обозримом будущем - НЕТ
49changeBookИзменение имя и фамилию пассажира? Это можно? Полностью все?Нельзя.
50changeBookЛюди забывают добавит детей:Нельзя
51reprice

Замена тарифа при репрайсе — по какой причине?
Нужно добавить пример с заменой тарифа на репрайсе
Как на это реагировать? Какие ситуации могут быть?

(question) Valeriya Shishkova
52repriceПосле бронирования не должно быть изменения RBD, так? Нужно прояснить(question) Valeriya Shishkova
53repriceПри изменении цены в репрайсе, увеличенная часть на какой участок? Хотят знать в ответе
Цена сейчас послайсевая		(question) Valeriya Shishkova
54reprice

Вопрос про общие таксы. Нельзя увидеть таксы по слайсам. Агент хотел бы увидеть подробную разбивку такс по слайсам.

(question) Valeriya Shishkova
55repriceГДС предоставляет время жизни цен, может ли апи предоставлять эту дату?
В жиру поточнее сформулируют задачу		Нет такой технической возможности пока
56repriceWhy do we need to use reprice operation to get the same price as from searchFlights?

Only reprice operation returns the final price for itinerary solution and it may be changed at the moment.

(question) Надо как-то на пальцах объяснить почему —  Pavel A. Smirnov (Deactivated)

57servicePriceПрайсинг животных?Будет в ближайшее вресмя
58servicePriceСноуборды и прочее?Будет в ближайшее вресмя
59voidTicketПро правила войдированияуже есть в факе
60retrieveTicketНет статуса, применился 3D или нет
3D. Агент не увидел инфо о применении скидки		Будет в ближайшее вресмя
61retrieveTicketретрив броней созданных вручнуюТеперь все, что получили, то и отрисовали
62demandTicketВыписка животных?Да, будет
63demandTicketОдновременно выписка билетов и EMD?Да, будет
64agentPaymentФасилитейдет букинг для агентовБудет доступно, но позже, дополнительно объявим
65New featureВарианты тарифов для конкретного перелета.
Те сначала поиск идет бейсика, вторым шагом смотреть все 4 тарифа как опции для текущего выбранного перелета		flightPrice
66New featureОчереди важны (нотификации о рейсе и прочие)
Получение списка локаторов в очереди
Удаление из списка очереди локаторов		Больше инфы, не в этом году
67New featureПарсинг тарифов инфоБольше инфы, не в этом году
68New feature

Информация о семействе брендов. Многие берут непосредственно с сайта s7.ru и возможно ли через API получать эту инфу?

Ок, но нужны примеры


  • Среднее время выполнения запросов; Максимальная нагрузка на сервис: кол-во допустимых запросов, в зависимости от площадки; Объяснить 99,7% доступности сервиса;
  • Возможность видимости задач в AAS, открытых сотрудниками одной компании;
  • Информирование о проблемах на стендах: выбрать площадку, уведомлять о неполадках/плановых работах;
  • ШОППИНГ
  • Причесать SeatAvailabilityRQ; Явным образом отображать карту мест (exit row, extra space) согласно борту, выполняющему рейс.
  • Возможность создания бронирования с двумя билетами разных семейств брэнда (FLEX + BASIC), Сейчас так можно сделать руками.
  • Военно перевозочные документы, Животные. Возможность поддержки, примерные сроки реализации.
  • Субсидированные тарифы
  • На определённых рейсах нет BASIC причём на глубокую выдачу. Агент говорит, что не видел на маршруте SLY-OVB. 
  • Выложить Roadmap по операциям.
  • Интерлайны. Когда реализуем?
  • ItinReshopRQ. Вопрос про общие таксы. Нельзя увидеть таксы по слайсам. Агент хотел бы увидеть подробную разбивку такс по слайсам.
  • Анонсировать доп. услуги. Что изменилось? Как работает?
  • Очереди. Крупные агенты ожидают внедрения очередей. Возможно ли реализовать? Если да, то какие сроки?
  • Описать флексиблдэйт. Что за метод? Как пользоваться? В чём отличие?
  • Сроки новой документации, релиза.
  • 3D. Агент не увидел инфо о применении скидки в AirDocDisplayRQ.
  • Проверить стоповер.
  • Информация о семействе брендов. Многие берут непосредственно с сайта s7.ru и возможно ли через API получать эту инфу?