API Travelfusion: различия между версиями

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску
(Особенности работы с Travelfusion в {{NameSystem}})
(См.также)
 
(не показано 6 промежуточных версий 1 участника)
Строка 72: Строка 72:
 
# Вместе с адресной информацией из раздела '''Настройки Авиа → Профиль агентства'''<!--{{Menu|Настройки Авиа|Профиль агентства}}--> в настройках '''{{NameProject2}}''' в качестве названия компании в Travelfusion передается название агенства в {{NameProject2}}. Для изменения названия компании, передаваемого в Travelfusion, необходимо менять название агенства в настройках {{NameProject2}}. Для этого нужно создать обращение в службу технической поддержки: [http://helpdesk.nemo.travel helpdesk.nemo.travel].
 
# Вместе с адресной информацией из раздела '''Настройки Авиа → Профиль агентства'''<!--{{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|Настройки Авиа|Профиль агентства|Код страны агентства}}--> .
 
# Одним из требований 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, в массиве Address при бронировании в Travelfusion. В запросе ProcessTerms было добавлено поле "Область" (в коде - <syntaxhighlight lang="text" enclose="none" style="font-size: 1.2em; padding: 0 3px; background: #F0F0F0; border: 1px dashed #2F6FAB;">Province</syntaxhighlight>). Изменение значения этого параметра происходит в настройках '''Nemo Connect''' в поле '''Настройки Авиа → Профили → Профиль агентства → Область'''. Помимо области, в массиве Address также содержится информация о следующих координатах агентства:  
+
# В запросе 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 Connect в '''Настройки Авиа → Профили → Профиль агентства'''
+
 
#* В Nemo 1 в '''Аккаунт менеджмент → Агенты и пользователи → Профили компаний'''
+
Изменение значений этих параметров происходит в настройках '''Админ. панели Nemo''' в '''Аккаунт менеджмент → Агенты и пользователи → Профили компаний'''
#* По умолчанию информация о профиле агентства берется из п.1, однако для того, чтобы настройки подтягивались из п.2, необходимо включить чекбокс '''Загружать профиль компании в авиа сервере с Nemo 1''' в настройках Nemo 1 '''Для техподдержки → Nemo Connect Вебсервисы → Настройки взаимодействия'''. Настройку можно включать как для корневого агентства, так и для менеджера. Важно заметить, что данный параметр не наследуется, т.е. при включении на корневое агентство он не будет активен для менеджера корневого агентства, и наоборот.
 
  
 
== Возможные ошибки и их причины ==
 
== Возможные ошибки и их причины ==
Строка 107: Строка 106:
 
* [[Amadeus]]
 
* [[Amadeus]]
 
* [[SITA Gabriel]]
 
* [[SITA Gabriel]]
 +
 +
Подпишитесь на письма о ежемесячных обновлениях системы {{NameSystem}}:
 +
 +
[[Изображение:Newsletter-2_small.png|left|link=https://www.nemo.travel/company/contacts.html]]

Текущая версия на 11:23, 14 октября 2022

TFLOGO-m.png

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

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

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

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

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

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

  1. Внести необходимые правила для компаний, которые будут выписываться через коннектор Travelfusion в файл ценообразования. Значения комиссий при выписке не передаются поставщику, поэтому можно для всех таких а/к указать нулевое значение комиссии и назначить при необходимости свои агентские сборы. (см. Ценообразование (Авиабилеты))
  2. Добавить шаблон маршрут-квитанции для поставщика Travelfusion (см. Маршрут-квитанция).
  3. Проверить, что заполнены все поля в разделе Настройки Авиа → Профиль агентства в настройках Nemo Connect.
  4. При желании можно реализовать вывод дополнительного информационного текста во всплывающем окне (рядом с чекбоксом согласия с правилами бронирования и публичной оферты на странице заказа в том же блоке). Текст можно ввести в разделе настроек «Управление сайтом» → «Домены и протоколы» → «Дополнительные правила перевозки». Для вывода псевдоссылки на попап с этим текстом нужно изменить в локализации значение языковой переменной 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

  1. На данный момент в системе Nemo.Travel есть возможность работать с Travelfusion только по депозитной схеме расчетов TF Prepay Method: агентство открывает в Travelfusion лицевой счет на определенную сумму, и при оформлении клиентом заказа на сайте с баланса агента списывается стоимость перелета на счет Travelfusion. Далее Travelfusion самостоятельно переводит эти средства на счет конкретной авиакомпании. Внимание! Оплата напрямую в авиакомпанию по карте клиента на данный момент невозможна.
  2. Внимание! На данный момент в системе Nemo.Travel не реализованы:
    • поиск по окружным датам (планируется в будущем);
    • поиск по окружным аэропортам (планируется в будущем);
    • продажа допуслуг (провоз багажа, питание и выбор места);
    • поиск сложного маршрута (СТ) — не поддерживается Travelfusion;
    • довнесение данных и модификация брони (паспортные и визовые данные, карта лояльности) — не поддерживается Travelfusion;
    • аннуляция не выписанной брони и обновление выписанной брони — не поддерживается Travelfusion;
    • войдирование, обмен и возврат выписанной брони (не поддерживается Travelfusion). Для этого клиент должен обращаться напрямую в авиакомпанию.
  3. Все тарифы обрабатываются как невозвратные.
  4. Авиакомпании самостоятельно высылают клиенту письмо о подтверждении брони (т.е. свою маршрут-квитанцию) на электронный адрес, который был указан при бронировании. При этом в данной маршрут-квитанции будет указана чистая стоимость перелета, т.е. клиент увидит стоимость без агентских наценок.
  5. В случае изменений в рейсе/расписании после выписки брони измененные данные не отображаются в Travelfusion, т.е. синхронизация после выписки невозможна, и эти данные будут доступны только в авиакомпании напрямую.
  6. На странице заказа для лоукост-перелета по умолчанию отображается надпись «Внимание! Данный перелет предоставляется авиакомпанией-лоукостером. Питание на борту не предоставляется!». Текст данного сообщения можно поменять в локализации, по языковой переменной no_meal_for_LowCost. Полностью скрыть вывод этого сообщения можно с помощью css-стилей.
  7. Теперь достаточно в реквизитах к ГДС указать валюту депозита, в пакете это опционально.
  8. Базовая стоимость перелетов от Travelfusion при поиске может поступать в какой угодно валюте — это зависит от авиакомпании, причем на один перелет в ответе поставщика могут быть цены в разных валютах (тариф в евро, а таксы, например, в долларах). Далее Nemo.Travel запрашивает в Travelfusion курсы валют из их системы и конвертирует всю стоимость перелета согласно этому курсу в валюту реквизитов. Пересчет цен на сайте агента в другие валюты будет происходить согласно курсам, настроенным в справочнике валют агентства («Настройки системы» → «Валюты и курсы» → «Справочник валют и курсов», см. Валюта).
  9. От Travelfusion могут приходить как отрицательные значения такс (т.е. это таксы-скидки), так и не приходить вовсе, либо быть уже включенными в стоимость тарифа.
  10. Таймлимит на выписку брони на стороне поставщика равен 15 минут и не может быть больше.
  11. В Travelfusion запрещено бронирование отдельного места для младенца. Предупреждения об этом отображаются на странице выдачи результатов и на странице бронирования в виде надписи: Бронирование отдельного сидячего места для младенца не допускается перевозчиком. Изменить текст предупреждения на странице результатов можно, задав в настройках локализации перевод для переменной flightsGroup__flightWarnings__insBookingNotAllowedBySupplier, на странице бронирования - ins_booking_not_allowed_by_supplier.
  12. Согласно требованию Travelfusion, нужно обязательно настраивать маршрутизацию по их расписанию. См. Фильтр запросов по расписанию авиакомпании
  13. Вместе с адресной информацией из раздела Настройки Авиа → Профиль агентства в настройках Nemo Connect в качестве названия компании в Travelfusion передается название агенства в Nemo Connect. Для изменения названия компании, передаваемого в Travelfusion, необходимо менять название агенства в настройках Nemo Connect. Для этого нужно создать обращение в службу технической поддержки: helpdesk.nemo.travel.
  14. Одним из требований Travelfusion является наличие параметра PointOfSale в запросах StartRouting и ProcessTerms к поставщику. PointOfSale предназначен для сертификации и корректной работы. Изменение значения этого параметра происходит в настройках Nemo Connect в поле Настройки Авиа → Профиль агентства → Код страны агентства .
  15. В запросе ProcessTerms используются поля:
    • Название компании - в XML поле Company
    • Офис - в XML поле Flat
    • Дом - в XML поле BuildingNumber
    • Улица - в XML поле Street
    • Населенный пункт - в XML поле City
    • Область - в XML поле Province
    • Почтовый индекс - в XML поле Postcode
    • Страна - в XML поле CountryCode

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

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

  • 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.

Контактная информация

См.также

Подпишитесь на письма о ежемесячных обновлениях системы Nemo.Travel:

Newsletter-2 small.png