Экспорт информации об изменении или создании рекламных акций из SetRetail10 в ERP (веб-сервис на стороне ERP)

Описание

Данная возможно позволяет осуществить экспорт информации с сервера SetCentrum/SetRetail об изменении или создании рекламных акций. Такая функциональность позволяет отследить изменения в рекламных акциях на сервере, если они были сделаны на сервере, когда импорт акций из ERP был невозможен, или по другим причинам.

Методы веб-сервиса для экспорта информации о рекламных акциях 

  • Для экспорта информации по рекламным акциям в ERP не требуется размещение отдельного wsdl-файла. 
  • На стороне ERP-системы запускается веб-сервер с возможностью принимать веб-запросы типа POST.
  • Также для проверки или приёма информации о рекламных акциях можно использовать MOCK-сервисы.

Формат данных

Для экспорта данных о рекламных акциях используется такая же XSD-схема и формат данных, что и при импорте:

Список типа экспорта результатов рекламных акций

  • Можно комбинировать результаты.
  • Не поддерживается экспорт одновременно доступного результата экспорта и нет. То есть нельзя произвести экспорт типа, который представлен в списке, и которого нет. Например: если акция содержит результат Скидка на наборы и Сообщение кассиру, то такой результат выгружен не будет.

Поддерживается экспорт только акций со следующими результатами:

  • Каталог фиксированных цен catalog;

  • Скидка на наборы set;

  • Скидки на товары goodsDiscount;

  • Скидки на чек calculation;

  • Скидка бонусами bonus-discount;

  • Бонусы на счёт bonus;

  • Сообщение/Информирование как результат notification;

Проверка экспорта рекламных акций на сервере SetRetail

1. Запустите специальный MOCK-сервис.

Для версий SetRetail10 под ОС Windows, откройте командную строку и введите следующую команду:

В параметре --port укажите любой свободный порт на сервере.

%SET_JAVA_HOME%\bin\java -jar %SET10_HOME%\wiremock\wiremock-standalone-2.19.0.jar --port 9003 --verbose > %SET10_HOME%\wiremock\__files\request.txt

Для версий SetRetail10 под ОС Linux скачайте сервис wiremock c репозитория. 

Если сервер под управление ОС Linux подключен к сети интернет, тогда выполните скачивание командой:

wget https://repo1.maven.org/maven2/com/github/tomakehurst/wiremock-standalone/2.19.0/wiremock-standalone-2.19.0.jar

Выполните команду для запуска сервиса:

java -jar /root/wiremock-standalone-2.19.0.jar --port 9003 --verbose > /root/__files/request.txt

3. Откройте в текстовом редакторе  и проверьте работу MOCK-сервиса.

Наберите адрес в формате http://IP-адрес сервера:ПОРТ/__files/request.txt

4. Настройте в SetRetail параметры интеграции для протокола Протокол Set Retail 10: выгрузка данных в веб-сервис на стороне ERP:

Справочники → Внешние процессинги → Вкладка ERP → Добавьте или откройте из списка протокол Протокол Set Retail 10: выгрузка данных в веб-сервис на стороне ERP:

На вкладке Экспорт данных установите флажки  Рекламные акции выгружаются с периодичностью и  первоначальная выгрузка акции → установите период экспорта.

Введите в поле Рекламные акции адрес MOCK-сервиса в формате http://XXX.XXX.XXX.XXX:ПОРТ/ →  Веб-сервис без обратной связи (совместимость с SAP) → нажмите К списку ERP.

5. Создайте или измените существующие рекламные акции

6. Перейдите в папку, где расположен wiremock и откройте на просмотр файл request.txt:

ОС Windows: {Диск}:\{Папка SetRetail10}\wiremock\__files\request.txt

ОС Linux: /root/__files/request.txt

7. Откройте текстовый файл request.txt в любом текстовом редакторе, например Notepad++ для просмотра информации о созданных или изменённых рекламных акций.