Просмотр кода страницы API Travelfusion

[[Категория:Поставщики авиабилетов]]
[[Файл:TFLOGO-m.png|right]]

'''Travelfusion''' — один из ведущих агрегаторов контента для ОТА, обеспечивающий прямой доступ к ресурсам многочисленных авиа-, жд- и отельных поставщиков. Помимо функций непосредственно ГРС располагает собственным платежным инструментом для взаиморасчетов (TF.Pay), а также готовыми сервисами (как для В2В, так и В2С моделей) для эффективного управления бизнесом. Специализируется в основном на низкобюджетных поставщиках (лоукостах). 

Компания основана в 2000 г. Штаб-квартира Travelfusion находится в Лондоне (Великобритания), также имеются офисы в Шанхае (Китай). 
Ресурс: около 220 авиакомпаний и железнодорожных перевозчиков. Полный список поддерживаемых поставщиков доступен на официальном сайте Travelfusion: [https://www.travelfusion.com/corporate/supplier]
Дистрибуция: преимущественно Европа. 

== Процесс подключения к Travelfusion в {{NameSystem}} ==

# В системе {{NameSystem}} на данный момент можно реализовать подключение к Travelfusion только для работы с компонентом "Авиабилеты". Для этого агентству необходимо обратиться в отдел продаж Travelfusion и заключить договор. Также в письме необходимо указать, что агентство собирается работать с Travelfusion через {{NameSystem}}. 
# После заключения договора аккаунт-менеджер агента высылает ему файл с реквизитами (логин и пароль) для подключения (Travelfusion Welcome Pack) и форму чеклиста для заполнения. 
# Агентство предоставляет реквизиты техподдержке {{NameSystem}} через тикет в проектном трекере. Сотрудники техподдержки помогают заполнить опросник, и агент отправляет его в Travelfusion.
# После официального подтверждения Travelfusion и разрешения на начало работы сотрудники техподдержки заводят и настраивают пакет реквизитов в {{NameSystem}} для агента.

== Сопутствующие настройки для начала работы в {{NameSystem}} ==
После завершения конфигурации реквизитов агенту необходимо выполнить также следующие настройки:
# Внести необходимые правила для компаний, которые будут выписываться через коннектор Travelfusion в файл ценообразования. Значения комиссий при выписке не передаются поставщику, поэтому можно для всех таких а/к указать нулевое значение комиссии и назначить при необходимости свои агентские сборы. (см. [[Ценообразование (Авиабилеты)]])
# Добавить шаблон маршрут-квитанции для поставщика Travelfusion (см. [[Маршрут-квитанция]]).
# Проверить, что заполнены все поля в разделе '''Настройки Авиа → Профиль агентства'''<!--{{Menu|Настройки Авиа|Профиль агентства}}--> в настройках '''{{NameProject2}}'''. 
# При желании можно реализовать вывод дополнительного информационного текста во всплывающем окне (рядом с чекбоксом согласия с правилами бронирования и публичной оферты на странице заказа в том же блоке). Текст можно ввести в разделе настроек «Управление сайтом» → «Домены и протоколы» → «Дополнительные правила перевозки»<!--{{Menu|Управление сайтом|Домены и протоколы|Дополнительные правила перевозки}}-->. Для вывода псевдоссылки на попап с этим текстом нужно изменить в локализации значение языковой переменной ''new-passinfo-footer__agreementText'' (см. [[Локализация]]), добавив html-код: <br>

<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
<u>'''Пример'''</u>
<div class="mw-collapsible-content">
Я ознакомлен и согласен с <a href="/booking__policy" class="new-ui-pseudoLink js-thickbox__frame__href" data-popup="{title:'Правила бронирования'}">правилами бронирования</a>, <a href="/booking__additional_flight_rules" class="new-ui-pseudoLink js-thickbox__frame__href" data-popup="{title:'нужный вам заголовок'}">правилами предоставления дополнительных услуг</a>, <a href="[%-faresurl-%]" class="new-ui-pseudoLink js-thickbox__frame__href" data-popup="{title:'Условия применения тарифов'}">условиями применения тарифов</a> и <a href="/booking__policypd" class="new-ui-pseudoLink js-thickbox__frame__href" data-popup="{title:'Права субъекта персональных данных'}">правами субъекта персональных данных</a>. Я согласен и подтверждаю согласие третьих лиц, указанных мной в бронировании, на обработку персональных данных, в том числе на их передачу третьим лицам, обеспечивающим или обслуживающим перевозку, а также на трансграничную передачу персональных данных.
</div>
</div>

== Процесс оформления заказа в {{NameSystem}} ==

После выбора перелета Travelfusion и заполнения пассажирских данных на странице заказа в {{NameSystem}} клиент нажимает кнопку «Забронировать». При этом в самой авиакомпании бронь еще не создается. Объект брони создается только в самой системе Travelfusion, но по факту места не резервируются, и данные пассажиров в авиакомпанию не передаются.
После успешной оплаты {{NameSystem}} запускает запрос на выписку билета (в этот момент уже создается бронь в авиакомпании). Но даже после успешной обработки запроса на странице заказа сначала будет отображаться надпись ''«Билеты находятся на оформлении»'', так как в ответе на запрос выписки поставщик изначально не присылает номера билетов, т.к. бронь в авиакомпании подтверждается не сразу. Далее {{NameSystem}} автоматически обновляет заказ (с частотой 1 раз в 7 минут), и в ходе обновления уже получает номер билета от поставщика. Маршрут-квитанция будет автоматически отправлена на почту клиенту.
<br>Текст сообщения ''«Билеты находятся на оформлении»'' можно поменять в локализации, по языковой переменной ''ticketed_without_tickets''.

==Особенности Travelfusion==

* Для списания средств при создании бронирований в авиакомпании необходимо наличие лицевого счета агента на стороне.
* В силу ориентации Travelfusion на низкобюджетных поставщиков, бронирование в авиакомпании создаётся только при выписке в {{NameSystem}}. При бронировании в {{NameSystem}} на стороне Travelfusion создаётся псевдо-бронирование, на стороне авиакомпании при этом ничего не создаётся и места не блокируются. 

{{Attention|В связи с этим, до того как будет выполнена выписка в {{NameSystem}}, нет гарантий, что бронирование будет успешно оформлено. В случае ситуации, когда бронирование сделано, оплата прошла, выписка после запуска не осуществляется, единственный способ выписать бронирование - заново полностью оформить бронирование, начиная с поиска}}.

Также,  в связи с ориентацией Travelfusion на низкобюджетных поставщиков, билетов после выписки в {{NameSystem}} может не быть, часто в Travelfusion есть код бронирования в системе авиакомпании, с которым пассажирам нужно перейти на сайт авиакомпании для выписки.
После бронирования в системе авиакомпании Travelfusion его не синхронизирует, соответственно, {{NameSystem}} информации об изменениях в рейсах не получает, изменения в рейсах необходимо отслеживать пассажиру.
* В силу специфики Travelfusion получения данных от авиакомпаний, на разных стадиях оформления покупки (поиск, актуализация и бронирование в {{NameSystem}}) цена перелёта и бронирования могут отличаться - как правило это происходит из-за погрешностей округления при вычислении итоговых сумм на стороне Travelfusion и {{NameSystem}}.
* Необходимо в обязательном порядке вносить контактные данные клиента, так как при отсутствии контактных данных у пассажиров могут возникнуть проблемы с регистрацией на рейс. По указанным контактным данным высылается важная для агента информация.
* {{NameSystem}} возвращает проблемные статусы, полученные от Travelfusion. В случае проблемных статусов агенту необходимо следовать инструкциям и обращаться в техническую поддержку Travelfusion. 
* В Travelfusion есть защита от дубликатов бронирования, в таких случаях возвращается ошибка. В случае ошибки создание нового бронирования в {{NameSystem}} не выполняется.
* В связи с частым обновлением требований для подключения агентов к Travelfusion, процесс подключения может быть длительным.

== Особенности работы с Travelfusion в {{NameSystem}} ==
# На данный момент в системе {{NameSystem}} есть возможность работать с Travelfusion только по депозитной схеме расчетов TF Prepay Method: агентство открывает в Travelfusion лицевой счет на определенную сумму, и при оформлении клиентом заказа на сайте с баланса агента списывается стоимость перелета на счет Travelfusion. Далее Travelfusion самостоятельно переводит эти средства на счет конкретной авиакомпании. {{Attention|Оплата напрямую в авиакомпанию по карте клиента на данный момент невозможна.}}
# {{Attention|На данный момент в системе {{NameSystem}} не реализованы:}}
#* поиск по окружным датам (планируется в будущем);
#* поиск по окружным аэропортам (планируется в будущем);
#* продажа допуслуг (провоз багажа, питание и выбор места);
#* поиск сложного маршрута (СТ) — не поддерживается Travelfusion;
#* довнесение данных и модификация брони (паспортные и визовые данные, карта лояльности) — не поддерживается Travelfusion;
#* аннуляция не выписанной брони и обновление выписанной брони — не поддерживается Travelfusion;
#* войдирование, обмен и возврат выписанной брони (не поддерживается Travelfusion). Для этого клиент должен обращаться напрямую в авиакомпанию.
# Все тарифы обрабатываются как невозвратные.
# Авиакомпании самостоятельно высылают клиенту письмо о подтверждении брони (т.е. свою маршрут-квитанцию) на электронный адрес, который был указан при бронировании. При этом в данной маршрут-квитанции будет указана чистая стоимость перелета, т.е. клиент увидит стоимость без агентских наценок.
# В случае изменений в рейсе/расписании после выписки брони измененные данные не отображаются в Travelfusion, т.е. синхронизация после выписки невозможна, и эти данные будут доступны только в авиакомпании напрямую.
# На странице заказа для лоукост-перелета по умолчанию отображается надпись ''«Внимание! Данный перелет предоставляется авиакомпанией-лоукостером. Питание на борту не предоставляется!»''. Текст данного сообщения можно поменять в локализации, по языковой переменной ''no_meal_for_LowCost''. Полностью скрыть вывод этого сообщения можно с помощью css-стилей. 
# '''Теперь достаточно в реквизитах к ГДС указать валюту депозита, в пакете это опционально.'''
# Базовая стоимость перелетов от Travelfusion при поиске может поступать в какой угодно валюте — это зависит от авиакомпании, причем на один перелет в ответе поставщика могут быть цены в разных валютах (тариф в евро, а таксы, например, в долларах). Далее {{NameSystem}} запрашивает в Travelfusion курсы валют из их системы и конвертирует всю стоимость перелета согласно этому курсу в валюту реквизитов. Пересчет цен на сайте агента в другие валюты будет происходить согласно курсам, настроенным в справочнике валют агентства ('''«Настройки системы» → «Валюты и курсы» → «Справочник валют и курсов»''', см. [[Валюта]]).
# От Travelfusion могут приходить как отрицательные значения такс (т.е. это таксы-скидки), так и не приходить вовсе, либо быть уже включенными в стоимость тарифа.
# Таймлимит на выписку брони на стороне поставщика равен 15 минут и не может быть больше.
# В Travelfusion запрещено бронирование отдельного места для младенца. Предупреждения об этом отображаются на странице выдачи результатов и на странице бронирования в виде надписи: ''Бронирование отдельного сидячего места для младенца не допускается перевозчиком''. Изменить текст предупреждения на странице результатов можно, задав в настройках локализации перевод для переменной ''flightsGroup__flightWarnings__insBookingNotAllowedBySupplier'', на странице бронирования - ''ins_booking_not_allowed_by_supplier''.
# '''Согласно требованию Travelfusion, нужно обязательно настраивать маршрутизацию по их расписанию.''' См. [[Фильтры_поисковых_запросов_(Авиабилеты)#Фильтр запросов по расписанию авиакомпании|Фильтр запросов по расписанию авиакомпании]]
# Вместе с адресной информацией из раздела '''Настройки Авиа → Профиль агентства'''<!--{{Menu|Настройки Авиа|Профиль агентства}}--> в настройках '''{{NameProject2}}''' в качестве названия компании в Travelfusion передается название агенства в {{NameProject2}}. Для изменения названия компании, передаваемого в Travelfusion, необходимо менять название агенства в настройках {{NameProject2}}. Для этого нужно создать обращение в службу технической поддержки: [http://helpdesk.nemo.travel helpdesk.nemo.travel].
# Одним из требований Travelfusion является наличие параметра	<syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">PointOfSale </syntaxhighlight> в запросах StartRouting и ProcessTerms к поставщику. <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">PointOfSale </syntaxhighlight> предназначен для сертификации и корректной работы. Изменение значения этого параметра происходит в настройках '''{{NameProject2}}''' в поле '''Настройки Авиа → Профиль агентства → Код страны агентства'''<!--{{Menu|Настройки Авиа|Профиль агентства|Код страны агентства}}--> .
# В запросе ProcessTerms используются поля:
#* Название компании - в XML поле <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">Company</syntaxhighlight>
#* Офис - в XML поле <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">Flat</syntaxhighlight>
#* Дом - в XML поле <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">BuildingNumber</syntaxhighlight>
#* Улица - в XML поле <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">Street</syntaxhighlight>
#* Населенный пункт - в XML поле <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">City</syntaxhighlight>
#* Область - в XML поле <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">Province</syntaxhighlight>
#* Почтовый индекс - в XML поле <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">Postcode</syntaxhighlight>
#* Страна - в XML поле <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">CountryCode</syntaxhighlight>

Изменение значений этих параметров происходит в настройках '''Админ. панели Nemo''' в '''Аккаунт менеджмент → Агенты и пользователи → Профили компаний'''

== Возможные ошибки и их причины ==

* '''Your branch cannot perform booking through the TF.Payment Service''' — означает, что у данного агентства не активирован лицевой счет в Travelfusion.<br>
* '''Supplier does not support payments through the TF.Payment Service''' — данная авиакомпания не поддерживает метод оплаты TF.Pay. Отключить выдачу перелетов такой а/к можно на стороне Travelfusion, обратившись к их техподдержке. <br>
* '''Temporary supplier error''' - проблемы на стороне поставщика. Рекомендуется повторить действие позже. Если ошибка продолжает появляться часто, необходимо обратиться в службу техподдержки Travelfusion. <br>
* '''The supplier is too busy''' - аналогично, временные проблемы на стороне поставщика, связанные с высокой нагрузкой на систему Travelfusion.
* '''Internal server error''' - внутренняя ошибка на серверах Travelfusion.
* '''RequestValidationError''' - не заполнен профиль агентства (адрес и контактные данные) в панели администрирования {{NameProject2}}. 
* '''Title missing''' - не включена настройка '''Автоматически добавлять титул пассажира''' в реквизитах бронирования пакета Travelfusion в панели администрирования {{NameProject2}}.
* '''Address post code is required for this journey''' - не внесены адресные данные в раздел '''Настройки Авиа → Профиль агентства'''<!--{{Menu|Настройки Авиа|Профиль агентства}}--> в настройках '''{{NameProject2}}'''.

== Контактная информация ==
* [https://www.travelfusion.com Официальный сайт Travelfusion]
* [https://www.travelfusion.com/corporate/page/contact-us Контакты для обращения]

== См.также ==
* [[ГРС]]
* [[Галилео]]
* [[Sabre]]
* [[Сирена Трэвел]]
* [[Amadeus]]
* [[SITA Gabriel]]

Подпишитесь на письма о ежемесячных обновлениях системы {{NameSystem}}:

[[Изображение:Newsletter-2_small.png|left|link=https://www.nemo.travel/company/contacts.html]]