Схема использования агентского API (workflow)
Версия от 18:55, 5 июня 2017; Кирилл Фимченко (обсуждение | вклад) (→Рекомендуемая схема работы API)
Агентский API Авиабилеты интегрирует ваши приложения с модулями системы Nemo.Travel по поиску перелетов в Глобальных Распределительных Системах (ГРС), последующему бронированию, оформлению электронных билетов, возврату и обмену оформленных авиабилетов, синхронизации бронирований в ГРС. Подробнее об API см. Агентский интерфейс прикладного программирования (Агентский API), Агентский API Авиабилеты.
Рекомендуемая схема работы API
Nemo.Travel рекомендует агентам для оформления заказов онлайн в компоненте Авиа строить последовательность АПИ-запросов к системе следующим образом:
- Поиск перелетов. Запрос SearchFlights.
- Создание отложенного заказа - после получения результатов поиска следует создать отложенный заказ с указаннием нужного номера перелета, так же рекомендуется в запросе на создание отложенного заказа EmptyBook применить дополнительные операции GareFareFamilies (получение перелетов с тарифными семействами) и ActualizeFlight (актуализация перелета в гдс).
- Получение семейств тарифов и актуализация перелета (альтернативный вариант без создания отложенного заказа) - в случае использования семейств тарифов необходимо после получения ответа на запрос SearchFlights сначала выполнить запрос получения семейств тарифов для определенного перелета GetFareFamilies, затем выбрать нужный перелет среди полученных в ответе на данный запрос. Далее необходимо выполнить запрос AirAvail с указанием полученного в ответе на запрос GetFareFamilies ID перелета.
- Бронирование — запрос выполняется после ввода данных пассажиров. Запрос BookFlight. В случае использования семейств тарифов в запросе бронирования необходимо использовать ID перелета, полученный в ответе на запрос GetFareFamilies.
- Оплата заказа:
- Если пользователь переходит к оплате заказа позднее, чем через 5 минут после бронирования, то прежде чем перенаправить пользователя на страницу оплаты, необходимо выполнить синхронизацию заказа с ГРС для актуализации информации о заказе. Помогает предотвратить возможную оплату недоступного заказа, заказов с аннулированными со стороны авиакомпании сегментами, а так же оплату заказа с изменившейся ценой по старой стоимости. Запрос UpdateBook.
- Оплата заказа. Запрос PayOrder.
- Выписка билетов:
- Синхронизация заказа с ГРС — проверка статуса оплаты и актуализация информации о заказе перед выпиской. Запрос UpdateBook.
- Выписка билетов. Запрос Ticketing.
- При необходимости можно выполнить отмену выписанной брони.
- Если время на войдирование не истекло (зависит от ГДС), то:
- Выполните запрос войдирования VoidTicket.
- Выполните запрос аннуляции брони CancelBook.
- Если время на войдирование истекло, то необходимо выполнить возврат, для этого:
- Запросите сумму к возврату на всех пассажиров GetRefundData.
- Выполните запрос на возврат RefundTicket.
- Если время на войдирование не истекло (зависит от ГДС), то:
Рекомендуемая схема работы API Авиабилеты |