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

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

  • No labels