API Travelfusion

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

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

Содержание

Процесс подключения к Travelfusion в Nemo.Travel

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

Сопутствующие настройки для начала работы в Nemo.Travel

После завершения конфигурации реквизитов агенту необходимо выполнить также следующие настройки:

Внести необходимые правила для компаний, которые будут выписываться через коннектор Travelfusion в файл ценообразования. Значения комиссий при выписке не передаются поставщику, поэтому можно для всех таких а/к указать нулевое значение комиссии и назначить при необходимости свои агентские сборы. (см. Ценообразование (Авиабилеты))
Добавить шаблон маршрут-квитанции для поставщика Travelfusion (см. Маршрут-квитанция).
Проверить, что заполнены все поля в разделе Настройки Авиа → Профиль агентства в настройках Nemo Connect.
При желании можно реализовать вывод дополнительного информационного текста во всплывающем окне (рядом с чекбоксом согласия с правилами бронирования и публичной оферты на странице заказа в том же блоке). Текст можно ввести в разделе настроек «Управление сайтом» → «Домены и протоколы» → «Дополнительные правила перевозки». Для вывода псевдоссылки на попап с этим текстом нужно изменить в локализации значение языковой переменной new-passinfo-footer__agreementText (см. Локализация), добавив html-код:

Пример

Я ознакомлен и согласен с <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>. Я согласен и подтверждаю согласие третьих лиц, указанных мной в бронировании, на обработку персональных данных, в том числе на их передачу третьим лицам, обеспечивающим или обслуживающим перевозку, а также на трансграничную передачу персональных данных.

Процесс оформления заказа в Nemo.Travel

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

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

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

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

Также, в связи с ориентацией Travelfusion на низкобюджетных поставщиков, билетов после выписки в Nemo.Travel может не быть, часто в Travelfusion есть код бронирования в системе авиакомпании, с которым пассажирам нужно перейти на сайт авиакомпании для выписки. После бронирования в системе авиакомпании Travelfusion его не синхронизирует, соответственно, Nemo.Travel информации об изменениях в рейсах не получает, изменения в рейсах необходимо отслеживать пассажиру.

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

Особенности работы с Travelfusion в Nemo.Travel

На данный момент в системе Nemo.Travel есть возможность работать с Travelfusion только по депозитной схеме расчетов TF Prepay Method: агентство открывает в Travelfusion депозит на определенную сумму, и при оформлении клиентом заказа на сайте с депозита агента списывается стоимость перелета на счет Travelfusion. Далее Travelfusion самостоятельно переводит эти средства на счет конкретной авиакомпании. Внимание! Оплата напрямую в авиакомпанию по карте клиента на данный момент невозможна.
Внимание! На данный момент в системе Nemo.Travel не реализованы:
- поиск по окружным датам (планируется в будущем);
- поиск по окружным аэропортам (планируется в будущем);
- продажа допуслуг (провоз багажа, питание и выбор места);
- поиск сложного маршрута (СТ) — не поддерживается Travelfusion;
- довнесение данных и модификация брони (паспортные и визовые данные, карта лояльности) — не поддерживается Travelfusion;
- аннуляция не выписанной брони и обновление выписанной брони — не поддерживается Travelfusion;
- войдирование, обмен и возврат выписанной брони (не поддерживается Travelfusion). Для этого клиент должен обращаться напрямую в авиакомпанию.
Все тарифы обрабатываются как невозвратные.
Авиакомпании самостоятельно высылают клиенту письмо о подтверждении брони (т.е. свою маршрут-квитанцию) на электронный адрес, который был указан при бронировании. При этом в данной маршрут-квитанции будет указана чистая стоимость перелета, т.е. клиент увидит стоимость без агентских наценок.
В случае изменений в рейсе/расписании после выписки брони измененные данные не отображаются в Travelfusion, т.е. синхронизация после выписки невозможна, и эти данные будут доступны только в авиакомпании напрямую.
На странице заказа для лоукост-перелета по умолчанию отображается надпись «Внимание! Данный перелет предоставляется авиакомпанией-лоукостером. Питание на борту не предоставляется!». Текст данного сообщения можно поменять в локализации, по языковой переменной no_meal_for_LowCost. Полностью скрыть вывод этого сообщения можно с помощью css-стилей.
Пакет реквизитов в Nemo.Travel должен быть настроен на ту же валюту, в которой открыт депозит агента в Travelfusion.
Базовая стоимость перелетов от Travelfusion при поиске может поступать в какой угодно валюте — это зависит от авиакомпании, причем на один перелет в ответе поставщика могут быть цены в разных валютах (тариф в евро, а таксы, например, в долларах). Далее Nemo.Travel запрашивает в Travelfusion курсы валют из их системы и конвертирует всю стоимость перелета согласно этому курсу в валюту агентского пакета реквизитов. Это необходимо для корректного расчета. Пересчет цен на сайте агента в другие валюты будет происходить согласно курсам, настроенным в справочнике валют агентства («Настройки системы» → «Валюты и курсы» → «Справочник валют и курсов», см. Валюта).
От Travelfusion могут приходить как отрицательные значения такс (т.е. это таксы-скидки), так и не приходить вовсе, либо быть уже включенными в стоимость тарифа.
Таймлимит на выписку брони на стороне поставщика равен 15 минут и не может быть больше.
В Travelfusion запрещено бронирование отдельного места для младенца. Предупреждения об этом отображаются на странице выдачи результатов и на странице бронирования в виде надписи: Бронирование отдельного сидячего места для младенца не допускается перевозчиком. Изменить текст предупреждения на странице результатов можно, задав в настройках локализации перевод для переменной flightsGroup__flightWarnings__insBookingNotAllowedBySupplier, на странице бронирования - ins_booking_not_allowed_by_supplier.
Согласно требованию Travelfusion, нужно обязательно настраивать маршрутизацию по их расписанию. См. Фильтр запросов по расписанию авиакомпании
Вместе с адресной информацией из раздела Настройки Авиа → Профиль агентства в настройках Nemo Connect в качестве названия компании в Travelfusion передается название агенства в Nemo Connect. Для изменения названия компании, передаваемого в Travelfusion, необходимо менять название агенства в настройках Nemo Connect. Для этого нужно создать обращение в службу технической поддержки: helpdesk.nemo.travel.

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

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