Service

Базовая услуга

Каждая из базовых и дополнительных услуг наследуется от класса BaseService и содержит следующие поля:

  • ID — идентификатор данной услуги в рамках данного объекта (брони/заказа). Тип данных — целое 32-битное число.
  • SupplierID — идентификатор данной услуги в системе поставщика услуг. Тип данных — строка.
  • IsOffline — признак оффлайн-услуги. Тип данных — булевский.
  • Status — статус услуги в системе поставщика. Тип данных — перечисление PNRStatus, возможные значения:
    • Booked;
    • Canceled;
    • Ticketed;
    • AwaitingTicketing — ожидает выписки — в основном возникает в случаях с чартерами, когда бронь отправили в очередь на выписку билетов авиакомпании;
    • Partial — части брони/заказа находится в одном состоянии, остальная в другом (к примеру частично выписанная бронь, или у разных услуг разные статусы);
    • Requested;
    • Rejected;
    • Problematic — проблемная бронь/заказ/услуга, при наличии данного статуса в подстатусах указывается, какая именно проблема.
  • SubStatus - содержит информацию о подстатусе.
    • SubStatus.Status — подстатус, уточняющий текущее состояние услуги. Тип данных — перечисление, возможные значения:
      • InvalidSegmentStatus
      • SegmentStatusForManualConfirmation — если в силу каких-то причин не удалось автоматически подтвердить сегменты (имеются в виду TK/KK статусы);
      • HaveNotStoredTickets — выписанный активный билет не попал PNR;
      • NotActualTicketStatus — один из билетов в PNR'е имеет неактуальный статус — специфично для тестовой среды различных GDS и Galileo после войдирования;
      • NoValidFare — у PNR'а в GDS нет активной и валидной цены (специфика GDS Galileo);
      • UnremovedVoidedTicketElements — специфично в GDS Amadeus;
      • PaidBook — PNR оплачен через платежный шлюз GDS Sirena, но ещё не выписан;
      • FailedToActualizePrice — не удалось получить актуальную цены для брони;
      • TicketingFailed — ошибка при выполнении запроса Ticket для поставщика авиа контента Travelfusion;
      • UnconfirmedInfant — неподтвержденный младенец, требуется ручная обработка;
      • DuplicateBooking — наличие дубликата брони в системе поставщика, актуально только для поставщика авиа контента Travelfusion;
      • UnconfirmedBooking — не удалось получить подтвержденный статус брони, актуально только для поставщика авиа контента Travelfusion;
      • UnconfirmedLoyaltyCard — неподтвержденная карточка лояльности;
      • NeedRefundRSVR — необходимо вернуть RSVR EMD;
      • FailedRefundRSVR — ошибка при возврате RSVR EMD;
      • FailedExchange — ошибка при выполнении обмена билетов;
      • AncillariesWithoutPrice — в брони присутствуют дополнительные услуги авиакомпании, для которых отсутствует цена;
      • NoAirlineLocator - отсутствует локатор от авиакомпании.
      • ExchangedTicketWithoutNew — произведен обмен билета, но не получена информация о новом билете;
      • SupplierDoNotKnowEdState — от поставщика вернулся статус Z для билета, в данный момент актуально только для поставщика авиа контента Travelport.
      • SupplierDidNotFoundOrder - от поставщика вернулась ошибка "Order not found", связанная с временными проблемами на его стороне, на данный момент актуально только для поставщика авиа контента S7NDC.
      • NoTotalFareForTicket - не удалось получить общую стоимость заказа/брони. Актуально для поставщика SITAGabriel.

В случае наличия статуса NoAirlineLocator выписка невозможна. Перед тем, как отправить запрос Ticket, нужно повторить запрос UpdateBook несколько раз, то тех пор, пока этот статус не пропадет. Статус NoAirlineLocator появляется в связи с тем, что данные о локаторе бронирования в системе авиакомпании могут быть получены на стороне GDS (и, соответственно, появиться в нашей системе) спустя некоторое время после создания бронирования.

  • TravellerRef — ссылка на пассажиров, к которым относится данная услуга. Если услуга применяется для всех путешественников, то элемент не указывается. Тип данных — массив RefList.
  • TravellerRef.Ref — ссылка на конкретного пассажира в рамках брони/заказа. Тип данных — целое 32-битное число.

Авиа услуга

Описание данных перелёта

Описание формата

  • Type — тип перелёта. Тип данных — перечисление, возможные значения:
    • Regular
    • Charter
    • LowCost
  • DirectionType — тип направления перелёта. Тип данных — перечисление (аналогично DirectionType в Flight), возможные значения:
    • OW — перелёт в одну строну;
    • RT — перелет туда и обратно;
    • CT — сложный маршрут;
    • SingleOJ — одинарный Open Jaw;
    • DoubleOJ — двойной Open Jaw;
    • hRT — RT/2;
    • mOW — перелёт является возможным плечом мультиOW перелёта.
  • Segments — сегменты перелёта. Тип данных — массив элементов FlightSegment.
    • FlightSegment — сегмент перелёт. Тип данных — массив.
    • FlightSegment.ID — идентификатор сегмента в рамках данного перелёта. Тип данных — целое 32-битное число.
    • FlightSegment.DepatureAirport — информация об аэропорте отправления. Тип данных — TripPointInformation:
    • FlightSegment.DepatureAirport.Code — код аэропорта. Тип данных — строка.
    • FlightSegment.DepatureAirport.SubPointCode — код терминала. Тип данных — строка.
    • FlightSegment.DepatureAirport.CityCode — код города, при наличии агрегации аэропортов. Тип данных — строка.
    • FlightSegment.DepatureAirport.UTC — часовой пояс. Тип данных — дробное число.
    • FlightSegment.ArrivalAirport — информация об аэропорте прибытия. Тип данных — TripPointInformation. Формат аналогичен FlightSegment.DepatureAirport.
    • FlightSegment.StopPoints — точки остановки на данном сегменте. Тип данных — массив элементов StopPoint:
    • FlightSegment.StopPoints.StopPoint — точка остановки на данном сегменте. Тип данных — массив, наследник TripPointInformation.
    • FlightSegment.StopPoints.StopPoint.Code - код аэропорта. Тип данных — строка.
    • FlightSegment.StopPoints.StopPoint.CityCode - код города, при наличии агрегации аэропортов. Тип данных — строка.
    • FlightSegment.StopPoints.StopPoint.UTC - часовой пояс. Тип данных — дробное число.
    • FlightSegment.StopPoints.StopPoint.ArrDateTime — дата и время прилёта в точку остановки. Тип данных — строка, формат yyyy-mm-ddthh:mm:ss.
    • FlightSegment.StopPoints.StopPoint.DepDateTime — дата и время вылета из точки остановки. Тип данных — строка, формат yyyy-mm-ddthh:mm:ss.
    • FlightSegment.StopPoints.StopPoint.PassengerLanding — признак высадки пассажиров из самолёта. Тип данных — булевский.
    • FlightSegment.DepatureDateTime — дата и время вылета сегмента, местное для аэропорта вылета. Тип данных — yyyy-mm-ddthh:mm:ss.
    • FlightSegment.ArrivalDateTime — дата и время прилёта сегмента, местное для аэропорта прибытия. Тип данных — yyyy-mm-ddthh:mm:ss.
    • FlightSegment.FlightTime — суммарное время в пути на данном сегменте. Тип данных — целое 32-битное число.
    • FlightSegment.FlightNumber — номер рейса. Тип данных — строка.
    • FlightSegment.AircraftType — код типа воздушного судна. Тип данных — строка.
    • FlightSegment.OperatingAirline — код авиакомпании, чей самолёт выполняет перевозку пассажиров. Тип данных — строка.
    • FlightSegment.MarketingAirline — код авиакомпании, которая выполняет продажу мест на данный рейс. Тип данных — строка.
    • FlightSegment.Charterer — фрахтователь продаваемых мест. Тип данных — строка.
    • FlightSegment.ETicket — сегменты перелёта. Тип данных — булевский.
    • FlightSegment.BookingClassCode — литера класса бронирования да данном сегменте. Тип данных — строка.
    • FlightSegment.Status — статус сегмента. Тип данных — перечисление, возможные значения:
      • Confirmed;
      • NeedConfirmation;
      • NotConfirmed;
      • Canceled;
      • Flew;
      • OnRequest;
      • Rejected.
    • FlightSegment.StatusCode — индустриальный код статуса сегмента. Тип данных — строка.
    • FlightSegment.SupplierRef — идентификатор брони сегмента в инвенторной системе авиакомпании. Тип данных — строка.
    • FlightSegment.RequestedSegment — ссылка на сегмента из запроса пользователя. Тип данных — целое 32-битное число.
    • FlightSegment.FlightDistance — численное значение дальности полёта в милях (актуально для GDS Amadeus). Тип данных — целое 32-битное число.
    • FlightSegment.CO2Emission — выброс CO2 в кг/м (актуально для GDS Amadeus). Тип данных — целое 32-битное число.
  • BusinessRules - информация о бизнес-правилах для данного перелёта. Тип данных — массив элементов Rule.
    • BusinessRules.Rule - информация о бизнес-правиле, сработавшего для данного перелёта. Тип данных — BusinessRule.
    • BusinessRules.Rule.Id - идентификатор сработавшего для данного перелёта бизнес-правила. Тип данных - строка.
    • BusinessRules.Rule.AdditionalParameters - дополнительная информация о параметрах бизнес-правила, сработавшего для данного перелёта. Тип данных — массив.

Пример

<?xml version="1.0"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body>
    <UpdateBook_2_0Response xmlns="http://nemo-ibe.com/Avia">
      <UpdateBook_2_0Result xmlns:a="http://nemo-ibe.com/STL" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:RequestID>11857720319</a:RequestID>
        <a:ResponseBody>
          <a:ID>1039532</a:ID>
          <a:OwnerID>30330</a:OwnerID>
          <a:DateInfo/>
          <a:PossibleActions/>
          <a:Travellers/>
          <a:Services>
            <a:Service i:type="a:FlightService">
              <a:ID>0</a:ID>
              <a:SupplierID>Y1SW3B</a:SupplierID>
              <a:Status>Booked</a:Status>
              <a:SubStatus>
                <a:Status>NoValidFare</a:Status>
              </a:SubStatus>
              <a:Type>Regular</a:Type>
              <a:DirectionType>CT</a:DirectionType>
              <a:Segments>
                <a:FlightSegment>
                  <a:ID>0</a:ID>
                  <a:DepatureAirport>
                    <a:Code>IST</a:Code>
                    <a:SubPointCode>I</a:SubPointCode>
                    <a:CityCode>IST</a:CityCode>
                    <a:UTC>3</a:UTC>
                  </a:DepatureAirport>
                  <a:ArrivalAirport>
                    <a:Code>AUH</a:Code>
                    <a:SubPointCode>3</a:SubPointCode>
                    <a:CityCode>AUH</a:CityCode>
                    <a:UTC>4</a:UTC>
                  </a:ArrivalAirport>
                  <a:DepatureDateTime>2017-09-04T14:15:00</a:DepatureDateTime>
                  <a:ArrivalDateTime>2017-09-04T19:55:00</a:ArrivalDateTime>
                  <a:FlightNumber>96</a:FlightNumber>
                  <a:OperatingAirline>EY</a:OperatingAirline>
                  <a:MarketingAirline>EY</a:MarketingAirline>
                  <a:ETicket>true</a:ETicket>
                  <a:BookingClassCode>W</a:BookingClassCode>
                  <a:Status>Confirmed</a:Status>
                  <a:StatusCode>HK</a:StatusCode>
                  <a:SupplierRef>TPWLLN</a:SupplierRef>
                  <a:RequestedSegment>0</a:RequestedSegment>
                </a:FlightSegment>
                <a:FlightSegment>
                  <a:ID>1</a:ID>
                  <a:DepatureAirport>
                    <a:Code>AUH</a:Code>
                    <a:SubPointCode>3</a:SubPointCode>
                    <a:CityCode>AUH</a:CityCode>
                    <a:UTC>4</a:UTC>
                  </a:DepatureAirport>
                  <a:ArrivalAirport>
                    <a:Code>KUL</a:Code>
                    <a:SubPointCode>M</a:SubPointCode>
                    <a:CityCode>KUL</a:CityCode>
                    <a:UTC>8</a:UTC>
                  </a:ArrivalAirport>
                  <a:DepatureDateTime>2017-09-04T22:30:00</a:DepatureDateTime>
                  <a:ArrivalDateTime>2017-09-05T10:10:00</a:ArrivalDateTime>
                  <a:FlightNumber>418</a:FlightNumber>
                  <a:OperatingAirline>EY</a:OperatingAirline>
                  <a:MarketingAirline>EY</a:MarketingAirline>
                  <a:ETicket>true</a:ETicket>
                  <a:BookingClassCode>W</a:BookingClassCode>
                  <a:Status>Confirmed</a:Status>
                  <a:StatusCode>HK</a:StatusCode>
                  <a:SupplierRef>TPWLLN</a:SupplierRef>
                  <a:RequestedSegment>0</a:RequestedSegment>
                </a:FlightSegment>
                <a:FlightSegment>
                  <a:ID>2</a:ID>
                  <a:DepatureAirport>
                    <a:Code>KUL</a:Code>
                    <a:SubPointCode>M</a:SubPointCode>
                    <a:CityCode>KUL</a:CityCode>
                    <a:UTC>8</a:UTC>
                  </a:DepatureAirport>
                  <a:ArrivalAirport>
                    <a:Code>HKT</a:Code>
                    <a:UTC>7</a:UTC>
                  </a:ArrivalAirport>
                  <a:DepatureDateTime>2017-09-05T13:10:00</a:DepatureDateTime>
                  <a:ArrivalDateTime>2017-09-05T13:20:00</a:ArrivalDateTime>
                  <a:FlightNumber>2751</a:FlightNumber>
                  <a:OperatingAirline>MH</a:OperatingAirline>
                  <a:MarketingAirline>EY</a:MarketingAirline>
                  <a:ETicket>true</a:ETicket>
                  <a:BookingClassCode>W</a:BookingClassCode>
                  <a:Status>Confirmed</a:Status>
                  <a:StatusCode>HK</a:StatusCode>
                  <a:SupplierRef>TPWLLN</a:SupplierRef>
                  <a:RequestedSegment>0</a:RequestedSegment>
                </a:FlightSegment>
              </a:Segments>
            </a:Service>
          </a:Services>
          <a:Price/>
          <a:DataItems/>
        </a:ResponseBody>
      </UpdateBook_2_0Result>
    </UpdateBook_2_0Response>
  </s:Body>
</s:Envelope>