API Travelfusion: различия между версиями
(→Особенности работы с Travelfusion в {{NameSystem}}) |
(→Особенности работы с Travelfusion в {{NameSystem}}) |
||
Строка 73: | Строка 73: | ||
# Одним из требований 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, в массиве 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 также содержится информация о следующих координатах агентства: | ||
− | #* Название компании | + | #* Название компании |
− | #* Офис | + | #* Офис |
− | #* Дом | + | #* Дом |
− | #* Улица | + | #* Улица |
− | #* Населенный пункт | + | #* Населенный пункт |
− | #* Почтовый индекс | + | #* Почтовый индекс |
− | #* Страна | + | #* Страна |
# Профиль агентства настраивается в двух местах: | # Профиль агентства настраивается в двух местах: | ||
#* В Nemo Connect в '''Настройки Авиа → Профили → Профиль агентства''' | #* В Nemo Connect в '''Настройки Авиа → Профили → Профиль агентства''' |
Версия 20:25, 11 ноября 2020
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-стилей.
- Теперь достаточно в реквизитах к ГДС указать валюту депозита, в пакете это опционально.
- Базовая стоимость перелетов от 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.
- Одним из требований Travelfusion является наличие параметра
PointOfSale
в запросах StartRouting и ProcessTerms к поставщику.PointOfSale
предназначен для сертификации и корректной работы. Изменение значения этого параметра происходит в настройках Nemo Connect в поле Настройки Авиа → Профиль агентства → Код страны агентства . - Область как часть адреса агентства и, в целом, сам адрес используется в запросе ProcessTerms, в массиве Address при бронировании в Travelfusion. В запросе ProcessTerms было добавлено поле "Область" (в коде -
Province
). Изменение значения этого параметра происходит в настройках Nemo Connect в поле Настройки Авиа → Профили → Профиль агентства → Область. Помимо области, в массиве Address также содержится информация о следующих координатах агентства:- Название компании
- Офис
- Дом
- Улица
- Населенный пункт
- Почтовый индекс
- Страна
- Профиль агентства настраивается в двух местах:
- В Nemo Connect в Настройки Авиа → Профили → Профиль агентства
- В Nemo 1 в Аккаунт менеджмент → Агенты и пользователи → Профили компаний
- По умолчанию информация о профиле агентства берется из п.1, однако для того, чтобы настройки подтягивались из п.2, необходимо включить чекбокс Загружать профиль компании в авиа сервере с Nemo 1 в настройках Nemo 1 Для техподдержки → Nemo Connect Вебсервисы → Настройки взаимодействия. Настройку можно включать как для корневого агентства, так и для менеджера. Важно заметить, что данный параметр не наследуется, т.е. при включении на корневое агентство он не будет активен для менеджера корневого агентства, и наоборот.
Возможные ошибки и их причины
- 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.