Blog

Уважаемые агенты,

фиксируем недоступность Баланса S7AgentAPI  с 11:30 MCK, работаем над восстановлением. 

Работа сервиса восстановлена 12:41 MSK


===============================================

Dear agents,

we fix the unavailability of the S7AgentAPI Balance from 11:30 MSK, we are working to solve this problem.

The service has been restored 12:41 MSK

Уважаемые агенты,

фиксировали недоступность Баланса S7AgentAPI.

Время недоступности 

SIT: 2023-06-28 07:49 MSK
RIT: 2023-06-28 09:13 MSK

===============================================

Dear agents,

we fixed the unavailability of the S7AgentAPI Balance.

Unavailable time:

SIT: 2023-06-28 07:49 MSK
RIT: 2023-06-28 09:13 MSK

Dear Agents,

Inform you that the Multiple destinations functionality  is not currently implemented in the S7 Agent API.
Therefore, we cannot guarantee the correct output of multiple destinations on all search methods searchFlightsJourney, searchFlightsBySlice, flightInfo.
Also special scenarios: 3D Agreement functionality, Ministry of Internal Affairs, S7 Profi are not available for calculating discounts on these routes.


=================================================

Уважаемые агенты,

Напоминаем вам, что на текущий момент в S7 Agent API не реализован функционал сложного поиска (составной маршрут).

Поэтому гарантировать корректную выдачу составных маршрутов на всех поисковых методах searchFlightsJourney, searchFlightsBySlice, flightInfo мы не можем.

В частности спец сценарии: функционал 3D Agreement, МВД, S7 Profi не доступны для расчета скидок на сложных (составных) маршрутах.

Dear agents,

We restore ancillaries shopping scenario for paid bags and meals on the QA environment

Specification for ServicePrice operation
servicePrice operation

References for ServicePrice operation
https://conf.s7.ru/display/GAAPI/servicePrice+operation+%7C+References

Scenarios for ancillaries shopping
EMD bag  https://conf.s7.ru/pages/viewpage.action?pageId=1162543166
EMD bag and seat https://conf.s7.ru/pages/viewpage.action?pageId=1163427879
EMD meal https://conf.s7.ru/pages/viewpage.action?pageId=1587511414


Please note, FareFamily, FareBasisCode, RBD and OperatingCarrier are mandatory parameter for request ServicePrice operation

ServicePriceRQ/DataList/FareList/FareGroup/Fare/FareCode/Code - FareFamily*
ServicePriceRQ/DataList/FareList/FareGroup/FareBasisCode/Code - FareBasisCode
ServicePriceRQ/Query/OriginDestination/Flight/ClassOfService/Code - RBD
ServicePriceRQ/Query/OriginDestination/Flight/OperatingCarrier/(AirlineID and FlightNumber) - OperatingCarrier

*Available FareFamily:

  • BASICECONOMY
  • STANDARDECONOMY
  • PLUSECONOMY
  • BASICBUSINESS
  • STANDARDBUSINESS
  • PLUSBUSINESS

This parameters you receive on the SearchMethod


ServicePriceRQ is available for S7 and XT Operating Airline

Besides, we change name for ancillaries services in RQ
baggage - bag
seats - seat
meals - meals

This parameters specify in the RQ
ServicePriceRQ/Parameters/ServiceFilter/GroupCode


If you want to receive all available ancillaries, node ServiceFilter should not be clarified in the RQ
If you want to receive a few group of ancillaries, you should request separate ServiceFilter for each ancillaries

For example

<Parameters>
    <ServiceFilters>
        <ServiceFilter>
            <GroupCode>bag</GroupCode>
        </ServiceFilter>
        <ServiceFilter>
            <GroupCode>meal</GroupCode>
        </ServiceFilter>
    </ServiceFilters>
</Parameters>


Default currency for ServicePrice operation is RUB
If you want receive pricing of ancillaries services in other curency, you need to specify currency in the RQ

For example

<Parameters>
    <CurrCodes>
        <CurrCode>USD</CurrCode>
    </CurrCodes>
</Parameters>


You need be certificated to use the functionality in the production environment of S7AgentAPI

Certification include execution of service scenarios that you planning use in the production


For example,

Agent want to issue EMD for meal and bag product


Agent create task to technical support by Kaiten for start certification process

Execute test-cases (you might issue all ancillaries in one PNR or separately)

Attach logs (xml-files of all requests and responses of S7AgentAPI) and specify PNR’s and ticket/EMD-numbers for verification

Specify agent offices that will use ancillaries scenarios in the production environment


You can ask your questions about ancillaries functionality to our technical support by Kaiten
We will inform you about turn on this functionality on the PROD environment




Уважаемые агенты,

В сервисе S7AgentAPI восстановлено оформление услуги платного предварительного бронирования платного багажа и питания в тестовой среде


Описание операции ServicePrice
https://conf.s7.ru/display/GAAPI/servicePrice+operation

Описание параметров запроса/ответа операции ServicePrice
https://conf.s7.ru/display/GAAPI/servicePrice+operation+%7C+References

Сценарии оформления дополнительных услуг
EMD багаж https://conf.s7.ru/pages/viewpage.action?pageId=1162543166
EMD багаж и место https://conf.s7.ru/pages/viewpage.action?pageId=1163427879
EMD питание https://conf.s7.ru/pages/viewpage.action?pageId=1587511414

Обратите внимание, что FareFamily, FareBasisCode, RBD и OperatingCarrier являются обязательными параметрами в запросе операции ServicePrice

ServicePriceRQ/DataList/FareList/FareGroup/Fare/FareCode/Code - FareFamily*
ServicePriceRQ/DataList/FareList/FareGroup/FareBasisCode/Code - FareBasisCode
ServicePriceRQ/Query/OriginDestination/Flight/ClassOfService/Code - RBD
ServicePriceRQ/Query/OriginDestination/Flight/OperatingCarrier/(AirlineID and FlightNumber) - OperatingCarrier


*Доступные FareFamily:

  • BASICECONOMY
  • STANDARDECONOMY
  • PLUSECONOMY
  • BASICBUSINESS
  • STANDARDBUSINESS
  • PLUSBUSINESS

Эти параметры возвращаются в ответе поискового метода


ServicePriceRQ доступен для оперирующих перевозчиков а/к S7 и XT (Globus LLC)


Кроме того, изменились названия групп дополнительных услуг в запросе к сервису
baggage - bag
seats - seat
meals - meals


Группы услуг можно передать в запросе:
ServicePriceRQ/Parameters/ServiceFilter/GroupCode


Если вы хотите получить все доступные дополнительные услуги, узел ServiceFilter можно не передавать в запросе
Если вы хотите получить несколько групп дополнительных услуг, потребуется передать узел ServiceFilter для каждого типа

<Parameters>
    <ServiceFilters>
        <ServiceFilter>
            <GroupCode>bag</GroupCode>
        </ServiceFilter>
        <ServiceFilter>
            <GroupCode>meal</GroupCode>
        </ServiceFilter>
    </ServiceFilters>
</Parameters>


По умолчанию, стоимость дополнительных услуг указывается в RUB валюте
Если вы хотите получать стоимость в отличной от рублей валюте, потребуется указать валюту в запросе

<Parameters>
    <CurrCodes>
        <CurrCode>USD</CurrCode>
    </CurrCodes>
</Parameters>

Для использования функционала в продуктивной среде потребуется пройти сертификацию

Сертификация включает в себя выполнение сценариев назначения услуги в тестовой среде
В ходе сертификации необходимо указать, какие именно сценарии вы планируете использовать в продуктивной среде


Ниже описан процесс прохождения сертификации

Агент хочет выписывать EMD для багажа и питания
Агенту необходимо создать заявку в сервисе технической поддержки Kaiten для начала сертификации,
выполнить тестовые сценарии (допустимо назначить все услуги в одном бронировании или отдельно),
приложить логи со всеми выполненными xml-запросами к сервису и указать номера оформленных бронирований, билетов и EMD для проверки на соответствие схемам сервиса и технологиям оформления
указать идентификаторы офисов, которые будут проводить выписку в продуктивной среде


Вопросы, которые возникнут в ходе тестирования функционала, просим направлять в адрес нашей технической поддержки Kaiten

О включении функционала в продуктивной среде сервиса сообщим дополнительно

Dear agents,

Wednesday, 26of May, 2023 since 12:30 DME time zone PROD environment is unstable.
You will receive errors on Search methods

We are currently working on that problem
Update: The problem was solved at 14:00 Moscow time limit.




Уважаемые агенты,

26 мая с 12:30 по московскому времени возможны трудности в работе продуктивной среды, на запросы могут возвращаться ошибки при использовании поисковых методов.

В настоящее время мы работаем над решением проблемы.

Обновление: Проблема решена в 14:00 по Москве.

Dear agents,

Wednesday, 25of May, 2023 since 14:45 DME time zone PROD environment is unstable.
You will receive errors on Search methods

We are currently working on that problem

Update: The problem was solved at 15:45 Moscow time limit.



Уважаемые агенты,

25 мая с 14:45 по московскому времени возможны трудности в работе продуктивной среды, на запросы могут возвращаться ошибки при использовании поисковых методов.

В настоящее время мы работаем над решением проблемы.

Обновление: Проблема решена в 15:45 по Москве.

Dear agents,

We restore ancillaries shopping scenario for free and paid seats (0B5).

You need be certificated to use the functionality in the production environment of S7AgentAPI
Certification include execution of service scenarios that you planning use in the production

Available scenarios:
Paid seat assignment
Free seat for PNR with child and infant passengers
Free seat for 3D client
Free seat by farefamily (PLUSECONOMY and BUSINESS tariffs)

For example,
Agent want to use 3 scenarios:
paid seat assignment
free seat for PNR with child
free seat for 3D client

Agent create task to technical support by Kaiten for start certification process
Execute test-cases (one booking for one scenario)
Attach logs (xml-files of all requests and responses of S7AgentAPI) and specify PNR’s and ticket/EMD-numbers for verification
Specify agent offices that will use ancillaries scenarios in the production environment

Test scenarios are available in our technical Blog and Documentation
S7AgentAPI. Test. Ancillaries shopping scenario 0B5
S7AgentAPI. Test. Ancillaries shopping scenario free seat 0B5




Уважаемые агенты,
В сервисе S7AgentAPI восстановлено назначение услуги предварительного бронирования мест 0B5
Доступно оформление платных и бесплатных мест

Для использования функционала в продуктивной среде потребуется пройти сертификацию


Сертификация включает в себя выполнение сценариев назначения услуги в тестовой среде
В ходе сертификации необходимо указать, какие именно сценарии вы планируете использовать в продуктивной среде

Доступные сценарии:
Платное назначение мест
Бесплатное назначение мест для бронирований с детьми
Бесплатное назначение мест для 3D клиентов

Назначение бесплатных мест в соответствии с тарифом (PLUSECONOMY и тарифы кабины BUSINESS)

Ниже описан процесс прохождения сертификации

Агент хочет использовать 3 сценария:
Платное назначение мест
Бесплатное назначение мест для бронирований с детьми
Бесплатное назначение мест для 3D клиентов

Агенту необходимо создать заявку в сервисе технической поддержки Kaiten для начала сертификации,
выполнить тестовые сценарии (одно бронирование на каждый сценарий оформления),
приложить логи со всеми выполненными xml-запросами к сервису и указать номера оформленных бронирований, билетов и EMD для проверки на соответствие схемам сервиса и технологиям оформления
указать идентификаторы офисов, которые будут проводить выписку в продуктивной среде

Со сценариями оформления вы можете ознакомиться в техническом блоге
https://conf.s7.ru/display/GAAPI/2023/04/20/S7AgentAPI.+Test.+Ancillaries+shopping+scenario+0B5
https://conf.s7.ru/display/GAAPI/2023/05/09/UPD%21+Unstable+Search+PROD+environment+10MAY23


Dear agents,
We restore ancillaries shopping scenario for free seats (0B5) on the QA environment
You can find service scenarious below:

1. Free seat according to the farefamily

PLUSECONOMY - standard, preferential, comfortable category of seats available for free
BASICBUSINESS - business category of seats available for free
STANDARDBUSINESS - business category category of seats available for free
PLUSBUSINESS - business category of seats available for free

2. Free seat for bookings with CHD and INF passengers

OW + 1xADT + 1xCHD + Direct + S7 flight | v0.52 | seatMap

Ancillaries shopping scenario | v0.52 | OW + 1xADT +1xCHD + Direct + S7 flight + free seat

3. Free seats for 3D client

OW + 1xADT + free seat for 3d client | v0.52 | seatMap

1ADT+RT+DIRECT+free seat for 3d client | v0.52 | demandTickets operation


You can ask your questions about ancillaries functionality to
 our technical support by Kaiten


Уважаемые агенты,

В сервисе S7AgentAPI восстановлено бесплатное назначение услуги предварительного бронирования мест 0B5
Функционал доступен для тестирования на тестовом стенде 

C примерами сценариев оформления вы можете ознакомиться ниже:

1. Бесплатное место по тарифу

PLUSECONOMY - места категории standard, preferential, comfortable 
BASICBUSINESS - места категории business
STANDARDBUSINESS - места категории business
PLUSBUSINESS - места категории business


2. Бесплатное место для бронирований с детьми
для бесплатного назначения доступны места категории  standard
OW + 1xADT + 1xCHD + Direct + S7 flight | v0.52 | seatMap
Ancillaries shopping scenario | v0.52 | OW + 1xADT +1xCHD + Direct + S7 flight + free seat

3. Бесплатное место для бронирования, оформленных по программе 3D Corporate

для бесплатного назначения доступны места категории standard

OW + 1xADT + free seat for 3d client | v0.52 | seatMap
1ADT+RT+DIRECT+free seat for 3d client | v0.52 | demandTickets operation

Вопросы, которые возникнут в ходе тестирования функционала, просим направлять в адрес нашей технической поддержки Kaiten



Dear agents,

Wednesday, 10of Mat, 2023 since 11:44 a.m DME time zone PROD environment is unstable.
You will receive errors on Search methods

We are currently working on that problem
Update: The problem was solved at 1:00 p.m. Moscow time limit.



Уважаемые агенты,

10 мая с 11:33 по московскому времени возможны трудности в работе продуктивной среды, на запросы могут возвращаться ошибки при использовании поисковых методов.

В настоящее время мы работаем над решением проблемы.

Обновление: Проблема решена в 13:00 по Москве.

Dear agents,
We restore ancillaries shopping scenario for paid seats (0B5) on the QA environment

Scenario for testing
Ancillaries shopping scenario | v0.52 | OW + 1xADT + Direct + S7 flight + EMD seat
OW + 1xADT + Direct + S7 flight | v0.52 | seatMap

Please note FareFamily is mandatory parameter for request SeatMap operation
SeatAvailabilityRQ/DataList/FlightSegmentList/FlightSegment/ClassOfService/MarketingName

Available FareFamily:

  • BASICECONOMY
  • STANDARDECONOMY
  • PLUSECONOMY
  • BASICBUSINESS
  • STANDARDBUSINESS
  • PLUSBUSINESS

This parameter you receive on the SearchMethod 

We will also prepare a scenario for free seats assignment and add a parameter to the response of SeatMap method,
which will allow you to receive the basic and sale price for seat after applying the discount 

You can ask your questions about ancillaries functionality to our technical support by Kaiten
We will inform you about turn on this functionality on the PROD environment



Уважаемые агенты,

В сервисе S7AgentAPI восстановлено оформление услуги платного предварительного бронирования мест 0B5
Сценарий оформления дополнительной услуги доступен на тестовом стенде

Сценарий покупки билета с местом
Ancillaries shopping scenario | v0.52 | OW + 1xADT + Direct + S7 flight + EMD seat

Карта мест
OW + 1xADT + Direct + S7 flight | v0.52 | seatMap

Обратите внимание, что при запросе карты мест (SeatMap) обязательным условием стала передача семейства тарифа: SeatAvailabilityRQ/DataList/FlightSegmentList/FlightSegment/ClassOfService/MarketingName

Доступные семейства тарифов ниже:

  • BASICECONOMY
  • STANDARDECONOMY
  • PLUSECONOMY
  • BASICBUSINESS
  • STANDARDBUSINESS
  • PLUSBUSINESS

Этот параметр возвращается в ответе поискового метода

В ближайшее время подготовим сценарий оформления бесплатного назначения мест и добавим в карту мест параметр,
который позволит получать базовую и итоговую стоимость услуги после применения скидки

Вопросы, которые возникнут в ходе тестирования функционала, просим направлять в адрес нашей технической поддержки Kaiten
О включении функционала в продуктивной среде сервиса сообщим дополнительно



Dear Agents,
We should inform you that 28 of March, 2023 in the on PROD environment ticketing with Balance will be not available due to technical works.


Start time: 02:00 a.m. MOW time zone.

End time: 03:30 a.m. MOW time zone



Уважаемые Агенты,
Информируем вас о том, что 28.03.2023 в продуктивной среде (PROD) будет недоступна выписка для Балансовых агентов в связи с плановыми техническими работами.

Время начала работ: 02:00 по МСК.

Время окончания работ: 03:30 по МСК

Dear agents,

Wednesday, 14of March, 2023 since 11:30 a.m DME time zone PROD environment is unstable.
You will receive error on Book operation 'КОД БРОНИРОВАНИЯ ЗАКРЫТ ИЛИ НЕТ МЕСТ'

We are currently working on that problem

Update: The problem was solved at 14:00 Moscow time limit.




Уважаемые агенты,

14 марта с 11:30 по московскому времени возможны трудности в работе продуктивной среды, на запросы могут возвращаться ошибки на операции бронирования Book 'КОД БРОНИРОВАНИЯ ЗАКРЫТ ИЛИ НЕТ МЕСТ'

В настоящее время мы работаем над решением проблемы.

Обновление: Проблема решена в 14:00 по Москве.


Dear Agents,
We should inform you that 20 of February, 2023 in the on PROD environment errors are possible due to engineering works.

Start time: 12:30 p.m. MOW time zone.

End time: 15:30 p.m. MOW time zone



Уважаемые Агенты,
Информируем вас о том, что 20.02.2023 возможны ошибки в продуктивной среде (PROD) в связи с плановыми техническими работами.

Время начала работ: 12:30 по МСК.

Время окончания работ: 15:30 по МСК

Dear Agents,
We should inform you that 13 of February, 2023 in the on QA environment errors are possible due to engineering works.

Start time: 1:00 p.m. MOW time zone.


Уважаемые Агенты,
Информируем вас о том, что 13.02.2023 возможны ошибки в тестовой среда (QA) в связи с плановыми техническими работами.

Время начала работ: 13:00 по МСК.

Dear Agents,
We should inform you that 4th of February, 2023 the QA environment is unavailable due to engineering works.

Start time: 09:00 a.m. MOW time zone.
End time: 21:00 p.m. MOW time zone


Уважаемые Агенты,
Информируем вас о том, что 04.02.2023 тестовая среда недоступна (QA) в связи с плановыми техническими работами.

Время начала работ: 09:00 по МСК.
Время окончания работ: 21:00 по МСК