Изменения

Перейти к навигации Перейти к поиску

Сирена Трэвел

15 104 байта добавлено, 16:28, 3 октября 2023
Подключение к Сирена Трэвел
== Описание ==
Система бронирования [http://www.nemo.travel {{NameSystem}}] поддерживает продажу авиабилетов на сайте агентства через глобальную распределительную систему Sirena Travel (Sirena 2000).
 
[[Изображение:Nemo-goto.png|center|link=http://nemo.travel]]
== Основные возможности ==
<div class="mw-collapsible-content">
* Поиск по окружным датам — условно[[#FAQ по GDS/ГРС/API Sirena Travel|<sup>[1]</sup>]]
* Поиск по ближайшим аэропортам — позволяет осуществлять поиск перелетов не только в аэропорт выбранного города, но и в аэропорты соседних городов; примеру, включать в результаты поиска варианты перелетов с прилетом в аэропорт Шарджи при поиске перелетов в Дубай. Работает автоматически, если опция подключена на стороне ГРС Сирена Трэвел. При необходимости нужно направить запрос в ГРС на подключение к своему ClientID. {{Attention|Список аэропортов задается на стороне ГРС Сирена Трэвел.}}
* Поиск по публичные + приватные тарифы[[#FAQ по GDS/ГРС/API Sirena Travel|<sup>[2]</sup>]]
* Поиск приватных тарифов[[#FAQ по GDS/ГРС/API Sirena Travel|<sup>[2]</sup>]]
Для реализации своего интернет-пункта продажи [[агентство]] должно иметь либо свой договор с ЗАО «Сирена Трэвел», либо быть субагентом агентства, уже имеющего такой договор.
В заявке на подключение нового ClientID нужно указать разрешенные IP-адреса .Netсерверов (в комментариях к заявке указать "Список адресов NEMO" -серверовтак админы будут понимать, что провайдером будет Немо):{| class="wikitable"| '''188.235.129.232''' <br/>'''5.188.163.245'''<br/>'''5.188.163.242'''<br/>'''37.200.71.162'''<br/>'''37.200.71.164||Первый сервер .Net|-'''<br/>| '''95.213.141.253||Второй сервер '''<br/>'''95.Net|}213.141.254'''<br/>
Такой договор позволяет заключить дополнительное соглашение с ЗАО «Сирена Трэвел» на использование программного средства «Операционный шлюз системы бронирования "WS-Gate"» с необходимым агентству количеством сеансов (под сеансом подразумевается либо нейтральный сеанс (ТКП), либо сеанс авиакомпании) для работы с одним сайтом (вопрос работы с несколькими сайтами, а именно с сайтами субагентств, решается отдельно). Текст дополнительного соглашения, включающий в себя основную часть, техническое задание, описание регламентов, процедур, ссылки на документацию по XML, можно найти в агентском разделе на [http://www.sirena-travel.ru сайте] или получить в ЗАО «Сирена Трэвел». По завершении разработки агентство должно направить в ЗАО «Сирена Трэвел» запрос на тестирование работы интернет-пункта продажи и письмо о переводе в боевой режим сеансов, указанных в договоре.
# Возможна ситуация, когда при стандартном прайсинге в Сирене возвращаются не наиболее дешевые тарифы АК по данному направлению, а тарифы, которые являются маршрутными, а потому более приоритетными. Под маршрутными понимаются тарифы, заданные для направления, в котором имеются промежуточные пункты перелета. При этом при бронировании таких перелетов, возвращается более дешевый тариф и цена заказа уменьшается. Это стандартное поведение системы бронирования, на которое никак не влияет производится ли процесс непосредственно в терминальном режиме или через вебсервисы.
# Возможна ситуация, когда от Сирены приходит ответ по ряду авиакомпаний на отсутствия рейда (маршрут и информация о багаже). В этом случай в системе {{NameSystem}} есть проверочный запрос. Перед бронированием система отсылает справочный запрос в Сирену и получает информацию, доступны ли рейды у данной авиакомпании. Если доступны, то запрашивает рейды и выводит информацию о маршруте и багаже. В случае если не доступны, то в созданном бронировании такой информации не будет.
# {{Attention|При чтении рейда Сирена возвращает не всегда корректную информацию Информацию о норме провоза багажа. Наиболее корректная информация о норме провоза багажа содержится в маршрутной квитанции через вебсервисы Сиреныгарантированно можно получить по умолчанию только после бронирования.}} Для получения информации Чтобы данные о допустимой мере бесплатного багажа используется запрос raidinfo. Информация в raidinfo попадает из картотеки ресурсов РЕСбагаже приходили на этапе поиска и актуализации перелета, которую заводит авиакомпания, когда создает рейс надо запрашивать в базе данных Сирены. Тарифы и норму ГРС для конкретного client_id включение опции отображения багажа авиакомпания регистрирует в ТАР-Лайн. Часто авиакомпания меняет информацию по норме багажа в ТАР-Лайне, но забывает менять в картотеке РЕСпараметре baggage для запросов pricing и pricing_flight соответственно.
# Системой в ответ на запрос может отдаваться разное количество вариантов. В любом случае будет отдано количество вариантов, указанных в min_results. Но до max_results может не дойти, если сработает внутрисистемное ограничение. Если какое-либо ограничение срабатывает и отдаются не все варианты, в ответе будет указано: «cut».
# Возможна ситуация, что видно перелеты в терминале, но на сайте они не отображаются поскольку заведены как чартерные тарифы. Как правило стоимость таких тарифов нулевая, но не всегда. Может быть категория пассажира — ЗРА. Такие перелеты невозможно получить в онлайн.
# Если есть необходимость комбинировать подклассы в перелете, необходимо в разделе: «Авиабилеты» → «Реквизиты подключения к GDS» — отметить поле '''«Комбинировать подклассы на сегментах по маршруту перевозки»'''.
 === Выписка в Сирене ГРС Сирена Трэвел===
Выписка билетов в Сирена Трэвел осуществляется после приема оплаты. Для каждой формы оплаты [[турагентство]] может установить свое время на оплату, обратившись в службу поддержки по почте webhelp@sirena-travel.ru или по телефону +7 (499)724-39-66, доб. 155. По умолчанию для всех форм оплаты установлено время 15 минут.
1.9. При получении Извещения с отказом в выдаче бланков и предоставлении квот электронных билетов агентство устраняет причины, указанные в Извещении, и уведомляет ТКП об этом, после чего Заявка заново рассматривается в ТКП в установленном порядке. 1.10. При предоставлении агентству квот электронных билетов ТКП размещает в ЦЭБ информацию о предоставленных агентству квотах электронных билетов. 1.11. Если в течение 10-ти дней после направления агентству Извещения представитель агентства не прибыл в ТКП для получения бланков, Заявка считается аннулированной в части бланков. В случае наличия в агентстве потребности в бланках на предстоящий период агентство представляет в ТКП новую Заявку.
 
=== Получение перелетов с пересадками в разных аэропортах ===
 
В ГРС Сирена Трэвел есть возможность получения перелетов с пересадками в разных аэропортах без использования сложного маршрута (пример: Екатеринбург - Домодедово, Москва; Внуково, Москва - Фергана).
Функциональность подключается администратором системы {{NameSystem}}. Для ее включения необходимо оставить заявку в проектном трекере [http://helpdesk.nemo.travel helpdesk.nemo.travel]
 
{{Attention|Для подключения новой функциональности необходимо подписание дополнительного соглашения между агентом и ГРС "Сирена Трэвел".}}
==Платежные шлюзы Сирена Трэвел==
Помимо процессинга банковских карт (VISA, MasterCard, JCB) компания осуществляет маршрутизацию платежей, осуществляемых при помощи электронных денег (Яндекс деньги, Web Money), различных платежных систем (Рапида, Элекснет, Qiwi) и оплат, осуществляемых через крупнейшие сети приема платежей (Евросеть, Связной).
=== Платежный шлюз Сирена Трэвел МПС (2-я версияEgoPay) - EgoPay ===
Платежное решение Сирена Трэвел (2-я версия), позволяет оплачивать билеты не только ТКП, но и BSP. Причем поддерживает прямой процессинг в БСП.
{{Attention|Сумма со скидкой не будет списана со счета клиента, но разницу агентство должно самостоятельно компенсировать при расчетах с АК.}}
=== Настройки {{Attention|При заказе shop_id на стороне МПС необходимо учесть, что МПС по умолчанию устанавливает настройку для shop_id rebook и reprice PNR. Если данная настройка включена на shop_id, то может возникнуть ситуация в случае выписки МПС, если заказ в статусе attempted, и бронирование в ГРС Сирена Тревел живое, то МПС добавляет таймлимит 15 минут к текущему времени. То есть переданный Nemo таймлимит не совпадет с таймлимитом на стороне МПС, что может привести к аннуляции заказа на стороне Nemo, и выписке заказа на стороне МПС. Рекомендуем отключить данную настройку на стороне МПС на shop_id.}} {{Attention|При переключении авиакомпании с формы оплаты через платежный шлюз Сирена Трэвел ПК (2-я версияпо умолчанию) ===на ПП ПК может возникнуть проблема с выпиской, если оплата произошла до перехода. Для открытия формы оплаты ПП ПК агенту необходимо своевременно отправить заявку в ТКП.}}
==== Настройки оплаты через платежный шлюз Сирена Трэвел (2-я версия) ==== Настройки для данного способа оплаты на стороне {{NameSystem}} находятся в разделе '''«Способы оплаты» «Финансы и платежи» → «Платежные методы» → «Управление шлюзами» → «Сирена 2».'''
* '''«Боевой режим»''' — отвечает за перевод данного способа оплаты в боевой режим.
* '''«Использовать оплату с фискализацией»''' — при включении настройки в платежную систему передается необходимая информация для формирования фискального чека. <span style="background-color:#fff0f5;">'''<span style="color:#ff0000;">Внимание!</span> Убедитесь, что на стороне МПС для вашего shop_id включена оплата с фискализацией.</span>
* '''«Параметры фискализации»''' — опция регулирует список параметров, передаваемых в чеке. Если ни одна позиция не выбрана, то по умолчанию будут переданы все позиции, а именно: авиабилет, аэроэкспресс, страхование, сервисный пакет, услуги агентства, сервисный сбор и комиссия за оплату.
* '''«Таксы, подлежащие фискализации»''' — необходимо указать коды такс (и ставку НДС), которые должны быть переданы при оплате в качестве сбора. Например: ZZ-10;XX-18.
* '''«Использовать source из хоста»''' — при включении настройки данные о налогах предоставляются поставщиком Сирена Трэвел. Источник данных о налогах Сирена Трэвел может быть только у авиабилетов из сирены, аэроэкспресса сирены и дополнительных услуг авиакомпании, полученных из Сирена Трэвел. Для остальных поставщиков данные о налогах предоставляет либо системой Nemo, либо МПС. В первую очередь настраиваем источник данных о налогах Сирена Трэвел в МПС, а затем уже в Nemo.
* '''«Отправлять source = ips для выбранных ГДС»''' - источник данных о налогах МПС. Настройка позволяет выбрать ГДС, для которых ставка НДС будет взята из настроек на стороне МПС. Услуги, на которые распространяется эта настройка: авиабилеты и дополнительные услуги авиакомпаний, т.е. то что приходит от ГДС. В первую очередь настраиваем источник данных о налогах ips в МПС, а затем уже в Nemo.
* '''«Логин»''' — предоставляется сотрудниками Сирена Тревел.
* '''«Пароль»''' — предоставляется сотрудниками Сирена Тревел.
* '''«Идентификатор магазина BSP»''' — предоставляется сотрудниками Сирена Тревел.
* '''«Идентификатор магазина TKP»''' — предоставляется сотрудниками Сирена Тревел.
* '''«Префикс к коду оплаты»''' — согласуется с платежным шлюзом и используется для формирования платежного кода. Пример значения: 123
* '''«Время до автоматической отмены платежа в минутах ( рекомендуется 10)»''' — регулирует таймлимит на оплату для платежной сессии.
* '''«Переопределение наценки для GDS–процессинга (пусто - отсутствует)»''' — наценка за проведение оплаты через GDS–процессинг.
* '''«Предпочитаемая валюта»''' — валюта оплаты.
* '''«Способ оплаты»''' — варианты проведения оплаты, доступные в платежной системе.
* '''«Текст для офлайновых способов оплаты»''' — сообщение, отображается покупателю если выбран способ оплаты оффлайн (Евросеть, QIWI, Rapida).
* '''«Высота платежного фрэйма»''' — необходимо задать значение, определяющее высоту фрэйма, в пикселях.
* '''«Отображать фрэйм со страницей оплаты на странице информации о заказе»''' — при включенной настройке, на форме бронирования 2.0 будет фрэйм с платежным шлюзом.
* '''«Краткая информация о квитанции для отображения пользователю»''' — здесь можно добавить краткое описание платежного метода для отображения его в блоке ПШ при выборе способа оплаты.
* '''«Шаблон квитанции для печати»''' — здесь можно задать вид квитанции к печати.
* '''«Использовать GDS-процессинг»''' — опция отвечает за проведение оплаты через GDS-процессинг. (по умолчанию включена)
* '''«Передавать источник (host) заказа»''' — включает передачу информации о GDS в МПС. Не рекомендуется включать параметр, если GDS, для которой используется этот платёжный метод, отлична на Сирена Тревел. При выключенном параметре выписать заказ МПС не может, выписка будет запускаться со стороны Немо.
* '''Значение clearing для авиабилетов''' — настройка позволяет выбрать тип системы расчётов. Доступные значения:
** '''На основании настройки в реквизите'''
** '''tch'''
** '''bsp'''
** '''card'''
** '''Пустое значение'''
* '''«Оформление заказа выполняется на стороне шлюза»''' — запрещает выписку авиабилетов и дополнительных услуг на стороне Nemo.travel, в случае, если произведена успешная оплата и выполняется оформление услуг на стороне платежной системы.
* '''«Оформлять чек на основе данных Nemo Connect»''' — При включении данной настройки все данные, необходимые для составления фискального чека, будут передаваться из системы Nemo. Настройка необходима в случаях, когда при использовании шлюза МПС перелет обрабатывается не ГРС "Сирена". {{Attention|Для включения этой опции агенту нужно запросить у МПС активацию sourсe «shop_on_confirm»}}.
В реквизитах ПШ Сирена предусмотрен параметр ''' Время до автоматической отмены платежа в минутах ( рекомендуется 10)''' регулирует таймлимит на оплату для платежной сессии в EgoPay. ==== Транзакции в платежном шлюзе Сирена ====
Взаимодействие с платежным шлюзом происходит в 3 этапа:
* подтверждение оплаты или возврат денег.
==== БСП- и ТКП-варианты оплаты ====
В данном платежном шлюзе возможны БСП- и ТКП-варианты оплаты. Техническое отличие в том, что при ТКП-варианте оплаты выписка билета происходит автоматически в Сирене и {{NameSystem}} не инициирует выписку, а только получает информацию о выписанных билетах. Это происходит при попытке выписки со стороны {{NameSystem}}.
==== Создание транзакции ====
При создании транзакции определяется компонент бронирования и составляется соответствующее описание заказа. Описание заказа существенно только для авиаперевозок. Также, если компонент бронирования — авиаперевозки, определяется, возможен ли ТКП-сеанс оплаты (через e-commerce ТКП) для данного авиаперелета и используются соответствующие реквизиты. Если ТКП-оплата возможна, но не задан реквизит «Идентификатор магазина TKP», используется реквизит «Идентификатор магазина BSP». При отсутствии ключевых реквизитов (Идентификатор магазина BSP, Логин, Пароль ) запрос не будет отправлен и появится соответствующая ошибка.
==== Запрос о состоянии транзакции ====
Данный запрос повторяется по расписанию раз в 5 минут с момента создания транзакции в Сирене, а так же по факту перенаправления пользователя Сиреной в {{NameSystem}}. При создании транзакции указывается время ее жизни. Соответственно, после истечения этого времени или по факту оплаты или отмены платежа состояние транзакции фиксируется в {{NameSystem}} и запросы прекращаются.
==== Подтверждение платежа ====
Запрос на подтверждение отправляется системой {{NameSystem}} в автоматическом режиме. Для авиаперелетов — после выписки билета в {{NameSystem}}. Для всех остальных компонентов — либо сразу после успешного запроса о статусе транзакции (для прямой оплаты) или после бронирования (для предоплаты). Для авиаперелетов в случае ошибки при отправке запроса или получения недостаточных данных запрос ставится в очередь и повторяется раз в сутки. Для остальных компонентов запрос ставится в очередь только после получения ошибки на него со стороны Сирены.
 
====Автоматический возврат средств при аннуляции заказа====
 
Чтобы включить автоматический возврат средств, но ''не выписанных'' заказов, включите опцию '''Автоматически вернуть деньги после отмены заказа (только Личный счет и МПС)''' в разделе '''Финансы и платежи → Платежные методы → Устаревшая версия → Платежные шлюзы'''. <br>
Опция активирует автоматический возврат средств при аннуляции заказов, оплаченных через МПС или по личному счету.
 
Доступ к отмене оплаченного заказа имеет только менеджер или эксперт главного агентства. Только под этими пользователями можно провести автоматический возврат средств при аннуляции заказа. Остальные пользователи отправляют заявку на аннуляцию заказа.
 
==Ошибки при взаимодействии с GDS/ГРС/API Sirena Travel==
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; margin-bottom:12px;">
== '''Ошибки при взаимодействии с GDS/ГРС/API Sirena Travel=='''
<div class="mw-collapsible-content">
''' Ошибки при поиске '''
|-
|}
 
''' Ошибки при обмене '''
{| class="wikitable"
|-
! align="center" width="50%"|«ОШИБКА: СУММЫ ПО ОЦЕНКЕ И ПРИ АВТОРИЗАЦИИ ОТЛИЧАЮТСЯ»
|Данная ошибка возникает потому, что при бронировании не был указан номер Платёжного Поручения. Необходимо указывать номер ПП при бронировании.
|-
|}
 
</div>
</div>
* Максимальное количество символов для фамилии и имени в сумме – 54.
* Максимальное количество символов для фамилии, имени и отчества в сумме – 53.
 
== Авиа+ ==
«Авиа+» - функциональность ГРС Сирена Трэвел, предоставляющая возможность доступа к расширенному авиаконтенту, включающему в себя варианты тарификации авиаперевозок, полученных из ГРС Сирена Трэвел и GDS Travelport в рамках одной учетной записи клиента в ГРС Сирена Трэвел (client_id) без использования дополнительных запросов.
 
Функциональность подключается администратором системы {{NameSystem}}. Для ее включения необходимо оставить заявку в проектном трекере [http://helpdesk.nemo.travel helpdesk.nemo.travel]
 
{{Attention|Для подключения новой функциональности необходимо подписание дополнительного соглашения между агентом и ПАО «ТКП».}}
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; margin-bottom:12px;">
'''Поддерживаемый Авиа+ функционал'''
<div class="mw-collapsible-content">
*Поиск
*Получение УПТ для перелёта и брони
*Актуализация перелёта
*Работа с брендированными семействами
*Бронирование перелёта
*Обновление брони
*Отмена брони
*Выписка брони
*Войдирование
*Импорт брони
*Получение истории ПНРа
*Довнесение данных в бронь (через SSR)
*Модификация данных в брони (через SSR)
*Добавление брони в очередь
*Чтение очередей
*Удаление брони из очереди
</div>
</div>
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px; margin-bottom:12px;">
'''Неподдерживаемый Авиа+ функционал'''
<div class="mw-collapsible-content">
*Подбор доступной для брони цены при недоступности полученной при поиске
*Создание брони перелёта без паспортных и контактных данных пассажира с их последующим довнесением
*Модификация паспортных и контактных данных пассажира в брони
*Поиск по окружным датам
*Работа с небрендированными семействами
*Снятие мест для выписанной брони (подготовка к возврату)
*Сплит (разделение) ПНРа
*Допуслуги а/к
*Автовозвраты
*Автообмены
</div>
</div>
== См. также ==

Навигация

'