Изменения

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

API Travelfusion

10 617 байт добавлено, 17:58, 17 ноября 2020
Особенности работы с Travelfusion в {{NameSystem}}
== Процесс подключения к Travelfusion в {{NameSystem}} ==
# В системе {{NameSystem}} на данный момент можно реализовать подключение к Travelfusion только для работы с компонентом "Авиабилеты". Для этого агентству необходимо обратиться в отдел продаж Travelfusion и заключить договор. Также в письме необходимо указать, что агентство собирается работать с Travelfusion через {{NameSystem}}.
# После заключения договора аккаунт-менеджер агента высылает ему файл с реквизитами (логин и пароль) для подключения (Travelfusion Welcome Pack) и форму чеклиста для заполнения.
# Агентство предоставляет реквизиты техподдержке {{NameSystem}} через тикет в проектном трекере. Сотрудники техподдержки помогают заполнить опросник, и агент отправляет его в Travelfusion.
# Внести необходимые правила для компаний, которые будут выписываться через коннектор Travelfusion в файл ценообразования. Значения комиссий при выписке не передаются поставщику, поэтому можно для всех таких а/к указать нулевое значение комиссии и назначить при необходимости свои агентские сборы. (см. [[Ценообразование (Авиабилеты)]])
# Добавить шаблон маршрут-квитанции для поставщика Travelfusion (см. [[Маршрут-квитанция]]).
# Проверить, что заполнены все поля в разделе '''Настройки Авиа → Профиль агентства'''<!--{{Menu|Настройки Авиа|Профиль агентства}}--> в настройках '''{{NameProject2}}'''.
# При желании можно реализовать вывод дополнительного информационного текста во всплывающем окне (рядом с чекбоксом согласия с правилами бронирования и публичной оферты на странице заказа в том же блоке). Текст можно ввести в разделе настроек «Управление сайтом» → «Домены и протоколы» → «Дополнительные правила перевозки»<!--{{Menu|Управление сайтом|Домены и протоколы|Дополнительные правила перевозки}}-->. Для вывода псевдоссылки на попап с этим текстом нужно изменить в локализации значение языковой переменной ''new-passinfo-footer__agreementText'' (см. [[Локализация]]), добавив html-код: <br>
После успешной оплаты {{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, т.е. синхронизация после выписки невозможна, и эти данные будут доступны только в авиакомпании напрямую.
# На странице заказа для лоукост-перелета по умолчанию отображается надпись ''«Внимание! Данный перелет предоставляется авиакомпанией-лоукостером. Питание на борту не предоставляется!»''. Текст данного сообщения можно поменять в локализации, по языковой переменной ''no_meal_for_LowCost''. Полностью скрыть вывод этого сообщения можно с помощью css-стилей.
# Пакет реквизитов '''Теперь достаточно в {{NameSystem}} должен быть настроен на ту же реквизитах к ГДС указать валютудепозита, в которой открыт депозит агента в Travelfusionпакете это опционально.'''# Базовая стоимость перелетов от Travelfusion при поиске может поступать в какой угодно валюте — это зависит от авиакомпании, причем на один перелет в ответе поставщика могут быть цены в разных валютах (тариф в евро, а таксы, например, в долларах). Далее {{NameSystem}} запрашивает в Travelfusion курсы валют из их системы и конвертирует всю стоимость перелета согласно этому курсу в валюту агентского пакета реквизитов. Это необходимо для корректного расчета. Пересчет цен на сайте агента в другие валюты будет происходить согласно курсам, настроенным в справочнике валют агентства ('''«Настройки системы» → «Валюты и курсы» → «Справочник валют и курсов»{{Menu|Настройки системы|Валюты и курсы|Справочник валют и курсов}}''', см. [[Валюта]]).
# От 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}}'''.
== Контактная информация ==
53
правки

Навигация

'