Мастер-Тур(15):Синхронизация номера путевки из ПК Мастер-Тур с внешней системой (API CRM)

Материал из Megatec
Перейти к: навигация, поиск

Версия статьи от 26-08-2025.

Поддерживаемые версии ПК «Мастер-Тур»:
Начиная с 15.9 версии


Введение

Плагин позволяет связать между собой номер путевки, оформленной в МТ – с номером путевки из внешней CRM системы. Для этого при переходе в оформление клиентов ПК Мастер-Тур передается параметр в url номера путевки из CRM системы. А после бронирования путевки, на адрес CRM системы обратно отправляется информация о номере путевки из МТ

Установка

Специальных действий для установки не требуется. Всё работает в стандартной поставке приложения.

Работа в системе

Новый плагин расположен по пути Администрирование → Плагины → API CRM.

Настройки API CRM

Экран содержит следующую информацию:

  • API адрес – URL веб‑сервиса CRM, принимающего POST‑запрос с данными о путевке.
  • Сохранить – сохранить указанный адрес API в базу данных приложения.
  • Отменить – закрыть окно без сохранения.
Предупреждение
Авторизационные данные не требуются — интеграционный сервис со стороны CRM работает анонимно.



Общий порядок работы

  Пример URL: http://localhost:9000/TourPrograms/RegistrationClients?crm=00012345(где 00012345 — номер заявки из CRM)
  • Оператор в Мастер‑Тур вручную заполняет все данные путевки: откуда, куда, состав туристов, услуги и т. п.
  • После успешного бронирования и обработки заявки Мастер‑Тур вызывает API к CRM, указанный в плагине, и передает JSON с информацией о путевке.
  • Во время отправки отображается лоадер. По завершении выводится сообщение о результате (успех/ошибка; при наличии — с текстом, возвращенным внешней системой).

Передаваемые данные (тело POST‑запроса, JSON): 

{
  "CRM_NUM": "{Номер в CRM}",
  "MasterTourId": "{номер заявки в Мастер-Тур}"
}

Для корректной работы должны быть выполнены:

  • В настройках плагина заполнен корректный API адрес CRM (полный URL конечной точки).
  • Оформление клиентов открыто по ссылке с параметром crm.

Ограничения:

  • При переходе в Оформление клиентов по ссылке из CRM данные в форме не заполняются автоматически. Все поля (откуда, куда, туристы, услуги и т. п.) необходимо выбрать и заполнить вручную.
  • Отправка данных в CRM выполняется только при наличии параметра crm в URL.
  • Если передача не удалась, пользователю будет показано сообщение об ошибке (если внешний сервис возвращает текст ошибки).

Логирование интеграции

Для диагностики работы плагина в службе MasterTourService предусмотрен отдельный логгер: 

<Logger level="ALL" name="Crm" console="true" />

Настройка логгера позволяет отследить:

  • передачу данных о созданных путёвках в CRM;
  • ошибки при взаимодействии (например, неверный API-адрес или отклонение запроса внешней системой).

Подробнее см. Настройка логирования службы MasterTourService.

Источник — «http://wiki.megatec.ru/index.php?title=Мастер-Тур(15):Синхронизация_номера_путевки_из_ПК_Мастер-Тур_с_внешней_системой_(API_CRM)&oldid=32867»