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