ПОДПИСЫВАЙТЕСЬ НА НАШ ТЕЛЕГРАМ-КАНАЛ @nemo_travel_official

Выгрузка заказов

Материал из Центр поддержки системы бронировании
Перейти к навигации Перейти к поиску

Выгрузка заказов — это экспорт данных заказа или заказов для различных компонентов системы Nemo.travel.

Описание

Модуль позволяет внешней системе получать данные по заказам для дальнейшей обработки.

Процесс выгрузки

Схематично процесс выгрузки заказов представлен на блок-схеме.

ВыгрузкаСофиИНемо.png

Внимание!

  • Выгрузка заказа в формате СОФИ при синхронизации произойдет, только если в заказе произошли изменения.
  • Выгрузка заказа в формате СОФИ при аннуляции произойдет только в том случае, если в заказе имеются аннулированные допуслуги.

Настройки

Настройка процесса выгрузки заказов для авиабилетов

Настройки выгрузки заказов доступны в разделе Настройки системы → Интеграция → Выгрузка заказов.

  • Экспортировать заказы в формате — настройка определяет один из доступных форматов выгрузки заказов:
    • Nemo — внутренний формат системы Nemo.Travel, доступен по умолчанию.
    • Софи — дополнительный формат, становится доступным при включении модуля «Выгрузка заказов Софи».
    • Nemo Backoffice — возможность экспорта заказов в формате JSON, который предоставляет более полный и актуальный объем данных, использует международные стандарты формата данных, является усовершенствованной версией протокола экспорта данных в формате Nemo.
  • Адрес для отправки нотификаций об изменении заказа — если задан, то при получении изменений в ходе актуализации отправляется GET-запрос на данный адрес (Пример http://127.0.0.1/?booking_id=ORDER_ID&nemo_id=NEMO_CONNECT_ORDER_ID&locator=LOCATOR). Формат значения поддерживает переменные LOCATOR, ORDER_ID, NEMO_CONNECT_ORDER_ID - (LOCATOR - идентификатор услуги в системе поставщика услуг, ORDER_ID - идентификатор заказа в системе NEMO, NEMO_CONNECT_ORDER_ID - идентификатор заказа в системе NEMO Connect).
  • Url скрипта для выгрузки в формате Nemo — URL, на который будет производиться выгрузка данных.
  • Url скрипта для выгрузки в формате СОФИ — URL, на который будет производиться выгрузка данных.

Cистема Nemo.Travel отправляет файлы выгрузки на указанный в этом поле http-адрес через POST-запрос (см. https://ru.wikipedia.org/wiki/POST_(HTTP) ). Скрипт для обработки получаемых данных должен быть написан на стороне самого клиента. Задача скрипта — принять данные и корректно их обработать. Все данные, которые можно получить через браузер, также можно получить и альтернативными программными средствами (автоматизируя процесс выгрузки). Рекомендуется к использованию библиотека CURL (см. https://ru.wikipedia.org/wiki/CURL) Готовые примеры скриптов сотрудники Nemo.Travel не предоставляют.
Если у субагента указан свой Url скрипта для выгрузки, отличный от URL корневого агенства, то выгрузка по заказам этого субагента будет идти на оба адреса. Главный агент получает информацию по всем заказам всех субагентов, субагент получает выгрузку только своих заказов.

  • Адрес для выгрузки в Nemo Backoffice — URL, на который будет производиться выгрузка данных.
  • Ключ безопасности для выгрузки в Nemo Backoffice — значение, которое задается самостоятельно агентством на стороне принимающего запрос сервера.
  • Код сайта в системе Софи — идентификатор агентства на стороне СОФИ. Код нужен для связки агентства в СОФИ и в Nemo.Travel. Если агентство заведено в СОФИ, то его код указывается в этом поле. Тогда в выгрузке СОФИ будет идентифицировать заказы от указанного агентства.
  • Повторная отправка в случае неудачи — настройка позволяет производить повторные попытки экспорта заказа через определенный интервал времени (максимум 3 попытки).
  • Список адресов для уведомлений (разделяется запятыми) — настройка позволяет определить один или более адресов электронной почты, на которые будет отправлено уведомление о проблемном заказе, в случае, если все попытки выгрузки заказа закончатся неудачно.
  • Экспортировать после оплаты — настройка позволяет дополнительно производить выгрузку заказов после события оплаты заказа (поддерживается для выгрузки в формате Nemo и Backoffice).
  • Экспортировать код доступа к заказу — настройка включает отображение кода доступа в выгрузке. Поддерживается строго в формате Nemo.
  • Отправлять нотификацию о необходимости установки кода валидатора в реквизитах — настройка позволяет автоматически отправлять нотификацию при выгрузке заказа в Софи без кода валидатора.
  • E-mail для отправки нотификации о необходимости установки кода валидатора в реквизитах
  • Временная зона для дат — настройка позволяет менять временную зону в выгрузке Софи.
    Настройка "Временная зона для дат"
    • Использовать временную зону системных настроек, через которую будет использоваться часовой пояс указанный в "Настройках системы".
    • Использовать временную зону реквизитов — часовой пояс подтягивается индивидуально от каждого пакета реквизитов подключения к ГДС.
    • Выбрать другую временную зону дает возможность выбирать временную зону независимо от других настроек.

Форматы выгрузки заказов

Система поддерживает выгрузку заказов в форматах Nemo, Софи и JSON. Рекомендуется использовать функционал выгрузки JSON.

Компоненты, поддерживающие выгрузку заказов

Авиабилеты Отели ЖД
Формат Nemo + +
Формат Софи +
Формат JSON + + +

События, поддерживающие выгрузку заказов

Авиабилеты Бронирование Оплата* Синхронизация** Выписка Войдирование Аннуляция*** Обмен/Возврат**** Импорт PNR*****
Формат Nemo + + + + + + + +
Формат Софи - - + + + +
Формат JSON + + + + + + + +
Отели Бронирование Оплата* Синхронизация** Выписка Войдирование Аннуляция
Формат JSON + + + войдирование отсутствует +
ЖД Бронирование Оплата Синхронизация** Выписка Войдирование Аннуляция
Формат Nemo + + + + + +
Формат JSON + + + + + +

*  Выгрузка заказа в формате Nemo при оплате произойдет, только если включена настройка «Экспортировать после оплаты» в разделе Настройки системыИнтеграцияВыгрузка заказов.
** Выгрузка заказа при синхронизации произойдет только если в заказе произошли изменения.
***  Выгрузка заказа в формате СОФИ при аннуляции произойдет только в том случае, если в заказе имеются аннулированные допуслуги.
****  Выгрузка заказа при обмене или возврате произойдет при завершении работы с заявкой (при пропуске импорта PNR).
*****  Выгрузка заказа при импорте PNR в рамках работы модуля Импорт PNR.

Статусы выгрузки заказа

Коды статусов выгрузки заказа соответствуют кодам состояния HTTP. Фактически указывается последний полученный код состояния HTTP, полученный при выгрузке данных по адресу, указанному в настройках выгрузки. Коды относятся к серверу, на который происходит выгрузка заказов.

Код Описание
0 Неизвестный ответ. Адрес для выгрузки не доступен.
200 OK — успешный запрос.
301 Запрошенный документ был окончательно перенесен на новый URI, указанный в поле Location заголовка.
403 Сервер понял запрос, но он отказывается его выполнять из-за ограничений в доступе для клиента к указанному ресурсу.
404 Сервер понял запрос, но не нашёл соответствующего ресурса по указанному URI.
422 Unprocessable Entity — сервер успешно принял запрос, может работать с указанным видом данных, в теле запроса XML-документ имеет верный синтаксис, но имеется какая-то логическая ошибка, из-за которой невозможно произвести операцию над ресурсом.
500 Любая внутренняя ошибка сервера.
503 Служба недоступна. Ошибка из-за временной перегрузки или отключения на техническое обслуживание сервера.

Выгрузка заказа для компонента «Авиабилеты»

Для компонента «Авиабилеты» доступна выгрузка заказов в форматах Nemo и/или Софи (при включенном модуле «Выгрузка заказов Софи»).

развернуть

Формат Nemo

развернуть

Формат Nemo для составных броней (MultiOW)

развернуть

Формат Софи

Выгрузка заказа для компонента «Отели»

Для компонента «Отели» доступна выгрузка заказов в форматах Nemo и/или JSON.

Выгрузка заказа для компонента «ЖД»

Для компонента «ЖД» доступна выгрузка заказов в форматах Nemo и/или JSON.

развернуть

Формат Nemo

Пакетный экспорт заказов в формате Nemo

Сервис выгрузки заказов позволяет экспортировать необходимые выборки по заказам в формате XML, XLS(X). Например, можно выбрать заказы по дате бронирования и получить информацию по ним в нужном формате. Экспорт в формате XLS(X) единовременно выгружает не более 1000 заказов. Если требуется выгрузка большего количества заказов (для получения полной статистики по всем заказам), то нужно выгружать заказы за последовательные периоды.

При выгрузке данных по заказам в формате XLS(X) ценовые параметры конвертируются в валюту агентства по курсам, зафиксированным на момент оплаты конкретного заказа.

Панель выгрузки всегда доступна для менеджеров и экспертов.

Экспорт заказов под авторизованным пользователем (в личном кабинете)

Фильтры пакетного экспорта заказов в личном кабинете

Псевдоссылка Показать панель экспорта раскрывает форму, позволяющую экспортировать заказы в файл формат XML, XLS или XLSX.

Выгружаются заказы выбранного пользователя/компании и принадлежащих к ним субагентов/пользователей с учетом примененных параметров фильтра.

Запрос на выгрузку данных по заказам отобразится в системе логирования с XML файлом, содержащим данные выгрузки.

Для экспорта отложенных заказов в формате XLS(X) нужно в фильтрах заказов установить параметр «Статус бронирования» в значение «Отложен».

В данный момент установлен лимит на количество выгружаемых единовременно заказов, равный 1000. В случае, если требуется выгрузка большего количества заказов (для получения полной статистики по всем заказам), это возможно сделать, выгружая заказы за определенные периоды.

Параметры пакетной выгрузки

Параметр XLS - выгрузка свернутьXML -выгрузка
Номер билета нет Passengers->Passenger->Tickets->Ticket->Num
Маршрут service_summary OrderInfo
Дата выписки ticketing_date Common->TicketingDateTime
Дата вылета date_begin OrderInfo->Info->StartDate,StartTime
Тариф в валюте сайта (по каждому билету) только суммарно за всех пассажиров нет
Таксы в валюте сайта (по каждому билету) только суммарно за всех пассажиров нет
Тариф в валюте выписки (по каждому билету) нет нет
фамилия пассажира (по каждому билету) нет Passengers->Passenger->lastname

Повторная выгрузка заказов

Если выгрузка заказа прошла неуспешно, в системе предусмотрена возможность выгрузить его повторно. Для этого менеджеру агентства необходимо на странице проблемного заказа перейти в раздел «Служебная информация», где расположена ссылка «Выгрузить заказ повторно», после нажатия на которую заказ будет выгружен повторно.

Причем в случае, если в разделе настроек Настройки системы → Интеграция → Выгрузка заказов включена настройка Выгрузка одновременно и Nemo и Софи, повторная выгрузка будет выполнена и в формате Nemo, и в формате СОФИ.

Также, доступна повторная выгрузка заказов через Личный кабинет. Для этого разделе «Заказы», для нужного заказа в колонке «Действия» требуется нажать на ссылку «Выгрузить заказ повторно».



См. также