Описание дополнительного функционала

Назначение документа
Подтверждение авиа/жд-билетов
Мультитикет
Комбинированная оплата

4.1 Общий брони целиком
4.2 Оплата брони по частям

Сборы за возврат билета
Получение информации о выписанных документах
Оплата доп.услуг АК
Авиационные справочники

8.1 Дистрибутивные системы
8.2 Типы товаров и услуг
8.3 Системы расчетов
8.4 Типы идентификаторов части брони дистрибутивной системы

Важно! Все исправления/обновления данной документации вносятся в Историю изменений

Описание дополнительного функционала

1. Назначение документа

Данный документ содержит описание дополнительных сервисных функций, ориентированных на потребности ИМ по продаже авиа-, жд- билетов. Описанные ниже возможности ПШ являются не самостоятельными решениями - для понимания и реализации этих дополнительных функций необходимо ознакомится с Описанием базового функционала.

2. Подтверждение авиа/жд-билетов

Для формирования и передачи информации о выполняемой перевозке в международные платежные системы (т.н. длинная запись), в запросе confirm необходимо передавать дополнительные параметы:

items – список элементов заказа состоящий из:
- item – элемент заказа
  - ext – комбинация параметров, необходимая для идентификации части заказа в дистрибутивной системе, состоящая из:
    - number – идентификатор части заказа в дистрибутивной системе
    - typename – тип товара или услуги ( см. п. 8.2)
    - host – дистрибутивная система ( см. п. 8.1)
  - descr – XML c описанием заказа
  - amount – стоимость данного элемента заказа
  - id – идентификатор элемента заказа в системе ПШ
tickets – список оформленных билетов состоящий из:
- ticket – информация об оформленном билете
  - number – номер билета
  - office – идентификатор агенства
  - ref – ссылка на элемент заказа (item.id)

3. Мультитикет.

Для авиа-заказа функционал корзины позволяет в рамках одного заказа агрегировать несколько PNR, и оплатить и оформить оптимальным с точки зрения расчетов и количества платежей образом.

Полный список типов товаров и услуг находится в справочнике: типы товаров и услуг( см. п. 8.1)

Требования: наличие у агента доступа к WEB сервисам используемой GDS, настройка технологических параметров подключения выполняется через заявку.

Для реализации данного кейса ИМ необходимо настроить передачу параметров items блока description, каждый из которых состоит из:

id – номер элемента заказа (например порядковый номер)
ext – комбинация параметров необходимая для идентификации части заказа в дистрибутивной системе, состоящая из:
- number – идентификатор части заказа в дистрибутивной системе (PNR иной номер).
- typename – тип товара или услуги ( см. п. 8.2)
- host – дистрибутивная система ( см. п. 8.1)
amount – стоимость данного элемента заказа

Данный блок параметров заполняется по каждой независимо оформляемой услуге.

Важно! Идентификация услуги идет в первую очередь по параметру number – убедитесь , пожалуйста, в корректной передаче данного параметра. Указанная стоимость элемента корзины должна совпадать со стоимостью товара/услуги в указанной ГДС.

Пример:

  <item>
    <ext>
      <number>0CT2L2</number>
      <typename>airticket</typename>
      <host>sirena</host>
    </ext>
    <amount>
      <currency>RUB</currency>
      <amount>1000</amount>
    </amount>
    <id>123</id>
  </item>

4. Комбинированная оплата

4.1 Общий брони целиком

В случае если оплата части заказа осуществляется с использованием средств на личном счете пользователя или бонусными балами программы лояльности, необходимо указывать параметр parts в блоке description — список элементов, каждый из которых состоит из:

Параметр part включает в себя:

id – идентификатор элемента (например, порядковый номер)
ref - ссылка на элемент заказа (item.id или subitem.id)
paytype – код типа способа оплаты
account – идентификатор счета в системе лояльности
source – сумма в валюте счета программы лояльности
amount – сумма к валюте заказа

Сумма всех элементов part.amount должна быть равна стоимости заказа. При использовании функционала корзины сумма необходимо заполнять поле part.ref. Сумма элементов part.amount с указанным ref должна быть равна стоимости элемента заказа для которых item.id == ref.

Один из основных примеров использования данного функционала – оплата заказа со скидкой.

Важно! Необходимо понимать, что предоставляемая клиенту скидка оплачивается за счет средств предприятия.

Пример: оплата билета стоимостью 1000 руб. с скидкой 10%

  <parts>
    <PaymentPart>
      <amount>
        <currency>RUB</currency>
        <amount>900</amount>
      </amount>
      <id>0</id>
      <paytype>card</paytype>
    </PaymentPart>
    <PaymentPart>
      <amount>
        <currency>RUB</currency>
        <amount>100</amount>
      </amount>
      <id>0</id>
      <paytype>discount</paytype>
    </PaymentPart>
  </parts>

4.2 Оплата брони по частям

Если оплата комбинированная форма оплаты применяется к части брони, например к одному пассажиру или одной категории пассажиров необходимо, в дополнение к перечисленным в пункте п. 4.1 параметрам, заполнить список подэлементов элемента заказа (subitems).

subitem состоит из:
- id – идентификатор подэлемента (например порядковый номер в рамках заказа)
- code – идентификатор элемента в дистрибутивной системе
- ctype - тип идентификатора в дистрибутивной системе
- amount - стоимость подэлемента оплаты

Сумма вложенных элементов subitem.amount должна быть равна item.amount элемента родителя. Сумма элементов part.amount с указанным ref должна быть равна стоимости элемента заказа для которых subitem.id == ref.

5. Сборы за возврат билета

Механизм взимания данного сбора может быть реализован 2-мя способами. Сами схемы реализации равнозначны, выбор той или иной схемы зависит от возможностей ПО ИМ.

«Дробление» суммы к оплате за билет. В этом случае, при возврате услуги АК возвращает клиенту только часть стоимости оплаченного билета, оставшаяся часть поступает на счет агентства (владельца ИМ), оказавшего услугу продажи. Таким образом агентство получает возможность управления этой суммой, и может как вернуть ее полностью клиенту, так и вернуть только ее часть, удержав при этом свой сбор за возврат.

Требования: наличие прямого договора с банком на эквайринг

Для реализации данной схемы, ИМ направляет запрос на регистрацию заказа, который должен содержать в себе и параметр item и параметр part, содержащиеся в блоке description (сервис order метод register).

Рассмотрим на примере корзины, состоящей из бронирования(1000 руб.) и сбора за возврат(130 руб.).

Пример заполнения параметра item:

      <item>
        <ext>
          <number>PNR1234</number>
          <typename>airticket</typename>
          <host>идентификатор ГДС</host>
        </ext>
        <amount>
          <currency>RUB</currency>
          <amount>1000</amount>
        </amount>
        <id>0</id>
        <clearing>выбранная схема расчетов</clearing>
      </item>
      <item>
        <ext>
          <number>PNR1234</number>
          <typename>airticket</typename>
          <host>идентификатор ГДС</host>
        </ext>
        <amount>
          <currency>RUB</currency>
          <amount>130</amount>
        </amount>
        <id>1</id>
        <clearing> </clearing>
      </item>

Пример заполнения параметра part:

      <parts>
        <PaymentPart>
          <amount>
            <currency>RUB</currency>
            <amount>1000</amount>
          </amount>
          <id>0</id>
          <paytype>card<paytype>
        </PaymentPart>
        <PaymentPart>
          <amount>
            <currency>RUB</currency>
            <amount>130</amount>
          </amount>
          <id>1</id>
          <paytype>card</paytype>
        </PaymentPart>
      </parts>

Авторизация новой суммы. В этом случае ИМ вызывает метод refund сервиса order, при этом указывая часть (или полную величину) суммы с положительным значением и сумму по сбору за возврат – с отрицательным. Сумма возврата с положительным значением вернется на карту клиента в стандартные сроки возврата. На сумму с отрицательным значением ПШ формирует новый авторизационный запрос. Однако, на карте клиента в момент попытки списания суммы за возврат услуги может не быть достаточного количества средств. Для того, чтобы избежать возникновение подобной ситуации, функционал ПШ позволяет автоматически включить механизм повторных списаний до тех пор пока на карте клиента не окажется необходимой суммы к списанию.

Требования: наличие прямого договора с банком на эквайринг рекуррентных платежей. 

      <items>
        <OrderItem>
          <number>PNR1234</number>
          <host>идентификатор ГДС</host>
          <clearing> выбранная схема расчетов</clearing>
          <cost>870</cost>
          <typename>airticket</typename>
        </OrderItem>
        <OrderItem>
          <number>PNR1234</number>
          <host />
          <clearing>выбранная схема расчетов</clearing>
          <cost>-130</cost>
          <typename>service</typename>
        </OrderItem>
      </items>

Важно! Полное описание параметров метода refund описано в (п. 5.4)) базового протокола. Описанные в нем параметры payment_id и txn_id являются обязательными для выполнения данного запроса.

6. Получение информации о выписанных документах.

Метод get_tickets сервиса ticket позволяет получить данные о выписанных билетах в рамках выбранного заказа, а именно: номер документа, тип оказанной услуги, код ГДС (в которой произошла выписка), номер заказа.

Параметры запроса:

order – идентификатор заказа, состоящий из:
- number – уникальный идентификатор заказа в ИМ
- shop_id – идентификатор магазина в ПШ

7. Оплата доп.услуг АК

Для оплаты доп. услуг, заведенных в ГРС, и корректного оформления документов (EMD) необходимо: 1. добавить услугу в ПНР согласно протоколу работы с доп. услугами через XML-шлюз АРС Сирена-Трэвел; 2. добавить в запрос на регистрацию заказа - несколько элементов Item с типом svc; - один элемент Item с типом svc и общей стоимостью всех доп. услуг, которые были добавлены в ПНР;

Важно: Номер элемента заказа должен совпадать с номеров бронирования в ГДС. Важно: Провайдер услуги (host = sirena) также должен быть указан.

8. Авиационные справочники

8.1 Дистрибутивные системы

Сокращение	Расшифровка
sirena	Сирена-Трэвел
sabre	Sabre
amadeus	Amadeus
travelport	TravelPort
hrs	HRS
galileo	Galileo
navitaire	Navitaire
farelogix	Farelogix
s7_ndc	NDC S7

8.2. Типы товаров и услуг

Сокращение	Расшифровка
airticket	авиабилеты
insurance	страхование
aezh	аэроэкспресс
service	сервисный сбор
hotel	отель
good	товары
contract	договор
svc	доп. услуга

8.3 Системы расчетов

Сокращение	Расшифровка
tch	расчет через Транспортно клириновую палату
tchcard	расчет через Транспортно клирингую палату
bsp	расчеты через IATA Billing Settlement Plan
dummy	без расчетов, платеж не проводится
card	расчет через банк предприятия
не задано	расчет через банк предприятия

8.4 Типы идентификаторов части брони дистрибутивной системы

Система	Код типа	Пример кода
sirena	passenger-id	1
sirena	passenger-rbm	ADT
sabre	namenumber	01.01
sabre	passengertype	ADT
amadeus	reference	20
amadeus	passengertype	INF

История изменений

Дата	Версия	Краткое описание внесенных исправлений
30.12.2015	1.1	подготовлена базовое описание
19.01.2016	1.2	описан вариант оплаты бронирования по частям
16.12.2016	1.2	описан функционал оплаты доп. услуг, заведенных в ГРС