1382
правки
Изменения
Перейти к навигации
Перейти к поиску
м
→Рекомендуемая схема для работы с заказом через API
'''Агентский API [[Авиабилеты_(компонент)|Авиабилеты]]''' интегрирует ваши приложения с модулями системы [http://www.nemo.travel Nemo.Travel] по [[Поиск_(Авиабилеты)|поиску]] перелетов в Глобальных Распределительных Системах ([[ГРС]]), последующему [[Бронирование_(Авиабилеты)|бронированию]], [[Выписка|оформлению электронных билетов]], [[Обмен_и_возврат_авиабилетов|возврату и обмену]] оформленных авиабилетов, [[Синхронизация_заказов|синхронизации бронирований в ГРС]]. Подробнее об API см. [[Агентский интерфейс прикладного программирования (Агентский API)]], [[Агентский API Авиабилеты]].
==Рекомендуемая схема для работы с заказом через API==
{{NameSystem}} рекомендует агентам для оформления заказов онлайн в компоненте Авиа строить последовательность АПИ-запросов к системе следующим образом:
# '''Поиск перелетов'''. — Запрос [http://support.nemo.travel/ru/%D0%92%D0%B5%D0%B1-%D1%81%D0%BB%D1%83%D0%B6%D0%B1%D0%B0_%D0%BF%D0%BE%D0%B8%D1%81%D0%BA%D0%B0_%D0%B0%D0%B2%D0%B8%D0%B0%D0%B1%D0%B8%D0%BB%D0%B5%D1%82%D0%BE%D0%B2 SearchFlights].#'''Получение семейств тарифов''' — выполнить запрос получения семейств тарифов для определенного перелета''' - в случае использования запроса [http://support.nemo.travel/ru/%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5_%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D1%8B_%D0%90%D0%9F%D0%98_%D0%B0%D0%B2%D0%B8%D0%B0%D0%B1%D0%B8%D0%BB%D0%B5%D1%82%D0%BE%D0%B2#.D0.9F97.D0.B0.D0.BF.D1.80.D0.BE.D0D1.B281_.D0.B5BD.D1D0.80B0_.D0.BABF.D0.B0_BE.D0.BDBB.D0D1.B0_83.D0D1.B487.D0.BEB5.D1D0.81BD.D0.B8.D0.B5_.D1.8281.D1D0.83B5.D0.BFBC.D0.BDB5.D0.BEB9.D1.81.D1.82.D1D0.B2.8C AirAvail] при использовании семейств тарифов необходимо после получения ответа на запрос [http://supportD0.B0_.D1.nemo82.travel/ru/%D0%92%.B0.D1.80.D0%B5%D0%B1-%.B8.D1%81%.84.D0%BB%D1%83%.BE.D0%B6%.B2_.D0%B1%.B4.D0%B0_%.BB.D1.8F_.D0%BF%D0%.BE%.D0%B8%.BF.D1%81%.80.D0%BA%.B5.D0%B0_%.B4.D0%B0%.B5.D0%B2%.BB.D0%B8%.B5.D0%B0%.BD.D0%B1%.BD.D0%B8%.BE.D0%BB%.B3.D0%B5%.BE_.D0.BF.D0.B5.D1%82%.80.D0%BE%.B5.D0%B2 SearchFlights.BB.D0.B5.D1.82.D0.B0 GetFareFamilies] сначала выполнить запрос получения . Если были найдены семейства тарифов, то для их применения необходимо использовать выбранный FlightId из результатов поиска семейств тарифов для определенного перелета [.#'''Создание отложенного заказа''' — запрос [http://support.nemo.travel/ru/%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5_%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D1%8B_%D0%90%D0%9F%D0%98_%D0%B0%D0%B2%D0%B8%D0%B0%D0%B1%D0%B8%D0%BB%D0%B5%D1%82%D0%BE%D0%B2#.D0.97A1.D0.B0BE.D0.BFB7.D1D0.80B4.D0.BE.D1.81_B0.D0.BD.D0.B0_B8.D0.BFB5_.D0.BE.D1.82.D0.BB.D1D0.83BE.D1D0.87B6.D0.B5.D0.BD.D0.B8BD.D0.B5_BE.D1D0.81B3.D0.B5BE_.D0.BCB7.D0.B5B0.D0.B9BA.D1D0.81.D1.82B0.D0.B2B7.D0.B0_.D1.82.D0.B0B2_.D1.8081.D0.B8.D1.8481.D0D1.BE82.D0.B2_B5.D0.B4BC.D0.BBB5_Nemo EmptyBook] создаст в системе Nemo заказ, который еще не забронирован в ГРС.D1В запросе рекомендуется применить дополнительную операцию ActualizeFlight (актуализация перелета в гдс), которая позволит убедиться в доступности перелета для бронирования.8F_#'''Актуализация перелета без создания отложенного заказа''' — имеется возможность выполнить проверку доступности без создания отложенного заказа в системе Nemo [http://support.D0.BEnemo.travel/ru/%D0%94%D0%BE%D0.%BF.D1.80.%D0.B5.D0.B4.%BE%D0.B5.D0.%BB.%D0.B5.D0.%BD.%D0.BD.%B8%D1%82%D0.BE.%B5%D0.B3.%BB%D1%8C%D0.BE_.%BD%D1%8B%D0.%B5_%D0%B7%D0%B0%D0%BF.D0.B5.%D1.%80.%D0.B5.%BE%D1%81%D1%8B_%D0.BB.%90%D0.B5.D1.82.%9F%D0.B0 GetFareFamilies], затем выбрать нужный перелет среди полученных в ответе на данный запрос. Далее необходимо выполнить запрос [http://support.nemo.travel/ru/%98_%D0%94B0%D0%BEB2%D0%BFB8%D0%BEB0%D0%BBB1%D0%BDB8%D0%B8%D1%82BB%D0%B5%D0%BB%D1%8C82%D0%BD%D1%8BBE%D0%B5_%B2#.D0%B7%D0%B0%D0%BF%.9F.D1%.80%.D0%.BE%.D0.B2.D0.B5.D1%81%D1%8B_%.80.D0%90%.BA.D0%9F%.B0_.D0%98_%.BD.D0%B0%.B0_.D0%B2%.B4.D0%B8%.BE.D1.81.D1.82.D1.83.D0%B0%.BF.D0%B1%.BD.D0%B8%D0%BB%D0%B5%D1%82%D0%BE%D0%B2#.D0.9F.D1.80.D0.BE.D0.B2.D0.B5.D1.80.D0.BA.D0.B0_.D0.BD.D0.B0_.D0.B4.D0.BE.D1.81.D1.82.D1.83.D0.BF.D0.BD.D0.BE.D1.81.D1.82.D1.8C AirAvail] с указанием полученного в ответе на запрос [http://support.nemo.travel/ru/%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5_%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D1%8B_%D0%90%D0%9F%D0%98_%D0%B0%D0%B2%D0%B8%D0%B0%D0%B1%D0%B8%D0%BB%D0%B5%D1%82%D0%BE%D0%B2#.D0.97.D0.B0.D0.BF.D1.80.D0.BE.D1.81_.D0.BD.D0.B0_.D0.BF.D0.BE.D0.BB.D1.83.D1.87.D0.B5.D0.BD.D0.B8.D0.B5_.D1.81.D0.B5.D0.BC.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B0_.D1.82.D0.B0.D1.80.D0.B8.D1.84.D0.BE.D0.B2_.D0.B4.D0.BB.D1.8F_.D0.BE.D0.BF.D1.80.D0.B5.D0.B4.D0.B5.D0.BB.D0.B5.D0.BD.D0.BD.D0.BE.D0.B3.D0.BE_.D0.BF.D0.B5.D1.80.D0.B5.D0.BB.D0.B5.D1.82.D0.B0 GetFareFamilies] ID перелета.# '''Проверка доступности перелета''' — определяет доступность и актуальность выбранного пользователем перелета, прежде чем открыть форму бронирования для ввода пассажиром своих данных. Запросы [http://support.nemo.travel/ru/%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5_%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D1%8B_%D0%90%D0%9F%D0%98_%D0%B0%D0%B2%D0%B8%D0%B0%D0%B1%D0%B8%D0%BB%D0%B5%D1%82%D0%BE%D0%B2#.D0.9F.D1.80.D0.BE.D0.B2.D0.B5.D1.80.D0.BA.D0.B0_.D0.BD.D0.B0_.D0.B4.D0.BE.D1.81.D1.82.D1.83.D0.BF.D0.BD.D0.BE.D1.81.D1.82.D1.8C AirAvail] или [http://support.nemo.travel/ru/%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5_%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D1%8B_%D0%90%D0%9F%D0%98_%D0%B0%D0%B2%D0%B8%D0%B0%D0%B1%D0%B8%D0%BB%D0%B5%D1%82%D0%BE%D0%B2#.D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BE.D1.82.D0.BB.D0.BE.D0.B6.D0.B5.D0.BD.D0.BD.D0.BE.D0.B3.D0.BE_.D0.B7.D0.B0.D0.BA.D0.B0.D0.B7.D0.B0_.D0.B2_.D1.81.D0.B8.BE.D1.81.D1.82.D0D1.B58C AirAvail].D0.BC.D0.B5_Nemo EmptyBook] (создаёт отложенный заказ в системе {{NameSystem}})
# '''Бронирование''' — запрос выполняется после ввода данных пассажиров. Запрос [http://support.nemo.travel/ru/%D0%92%D0%B5%D0%B1-%D1%81%D0%BB%D1%83%D0%B6%D0%B1%D0%B0_%D0%B1%D1%80%D0%BE%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F BookFlight]. В случае использования семейств тарифов в запросе бронирования необходимо использовать ID перелета, полученный в ответе на запрос [http://support.nemo.travel/ru/%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5_%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D1%8B_%D0%90%D0%9F%D0%98_%D0%B0%D0%B2%D0%B8%D0%B0%D0%B1%D0%B8%D0%BB%D0%B5%D1%82%D0%BE%D0%B2#.D0.97.D0.B0.D0.BF.D1.80.D0.BE.D1.81_.D0.BD.D0.B0_.D0.BF.D0.BE.D0.BB.D1.83.D1.87.D0.B5.D0.BD.D0.B8.D0.B5_.D1.81.D0.B5.D0.BC.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B0_.D1.82.D0.B0.D1.80.D0.B8.D1.84.D0.BE.D0.B2_.D0.B4.D0.BB.D1.8F_.D0.BE.D0.BF.D1.80.D0.B5.D0.B4.D0.B5.D0.BB.D0.B5.D0.BD.D0.BD.D0.BE.D0.B3.D0.BE_.D0.BF.D0.B5.D1.80.D0.B5.D0.BB.D0.B5.D1.82.D0.B0 GetFareFamilies].
# '''Оплата заказа''':
## '''Оплата заказа'''. Запрос [[Агентский API Оплата#Фиксации оплаты через Агентский АПИ|PayOrder]].
# '''Выписка билетов''':
#* В случае, если используется автовыписка заказа после успешной оплаты:
## '''Обновление заказа''' — обновление заказа для получения номеров выписанных билетов. Запрос [http://support.nemo.travel/ru/%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5_%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D1%8B_%D0%90%D0%9F%D0%98_%D0%B0%D0%B2%D0%B8%D0%B0%D0%B1%D0%B8%D0%BB%D0%B5%D1%82%D0%BE%D0%B2#.D0.97.D0.B0.D0.BF.D1.80.D0.BE.D1.81_.D0.BD.D0.B0_.D0.BE.D0.B1.D0.BD.D0.BE.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D0.B5_.D0.B7.D0.B0.D0.BA.D0.B0.D0.B7.D0.B0 UpdateBook].
#* В случае, если ''не'' используется автовыписка заказа после успешной оплаты:
## '''Синхронизация заказа с ГРС''' — проверка статуса оплаты и актуализация информации о заказе перед выпиской. Запрос [http://support.nemo.travel/ru/%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5_%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D1%8B_%D0%90%D0%9F%D0%98_%D0%B0%D0%B2%D0%B8%D0%B0%D0%B1%D0%B8%D0%BB%D0%B5%D1%82%D0%BE%D0%B2#.D0.97.D0.B0.D0.BF.D1.80.D0.BE.D1.81_.D0.BD.D0.B0_.D0.BE.D0.B1.D0.BD.D0.BE.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D0.B5_.D0.B7.D0.B0.D0.BA.D0.B0.D0.B7.D0.B0 UpdateBook].
## '''Выписка билетов'''. Запрос [http://support.nemo.travel/ru/%D0%92%D0%B5%D0%B1-%D1%81%D0%BB%D1%83%D0%B6%D0%B1%D0%B0_%D0%B2%D1%8B%D0%BF%D0%B8%D1%81%D0%BA%D0%B8 Ticketing].
