Требования к SQL SERVER:
Интеграция заработает только на SQL 2016 и выше.
На версиях ниже 2016 возникнут ошибки при запуске скрипта: «Authorization_SAMOSALE_GeneralScript.sql»
Файлы для интеграции доступны по ссылке https://support.samosale.ru/knowledge_base/item/329581?sid=70699
В свойствах базы данных, уровень совместимости должен быть не ниже: SQL SERVER 2016(130)
Настройка
1) На базе сегмента запустить скрипт из файла:
«Authorization_SAMOSALE _GeneralScript.sql»
Скрипт создает необходимые для работы интеграции таблицы, процедуры и функции.
Примечание: На базе сегмента запустить скрипт - это выполнить скрипт в MS SQL Management Studio, выбрав базу данных, на которой работает клиент (каждый клиент по-своему ее называет при установке). Это стандартная операция в MS SQL Management Studio, занимает минуту. Обычно сисадмин на объекте это делает.
2) Импортировать из файла: «Пакет объектов для интеграции c SAMOSALE.tpxl_exp» следующие объекты:
3) В прейскурант добавить служебные элементы
«Списание бонусов»
Параметр продажи должен позволять изменять поле «Количество», в данное поле будет указываться количество списываемых клиентом бонусов.
«Подтверждение списания»
Данный ЭП используется для подтверждения списания бонусов. Добавление его в счет инициирует проверку, подтверждения клиентом списания.
Предварительно, нужно определиться какой сервис прейскуранта будет использоваться при создании данных ЭП. Можно использовать уже существующий или создать новый в справочнике «Сервисы прейскуранта».
Сервис должен быть добавлен в соответствующую настройку продаж, для отображения его на ПОСе.
4) На основе импортированного типа программы лояльности (ТПЛ): «Программа лояльности SAMOSALE» создать программу лояльности(ПЛ).
В фильтре (ПЛ) выбирается устройство авторизации, которое будет создано в п.5. Само устройство авторизации еще не создано, поэтому можно создать ПЛ с пустым фильтром.
Обязательно нужно выбрать в спецификации ПЛ все ЭП и группы в разрезе которых будет отрабатывать ПЛ.
Создаем привилегию, например, с названием «SAMOSALE».
Создаем правило продажи(ПП), в свойствах ПП выбираем программу лояльности, созданную выше. В спецификацию добавляем интервал и привязываем его к привилегии SAMOSALE. Добавляем типы дней.
5) Создать устройство авторизации на основе программного модуля: «Авторизация SAMOSALE».
Раздел «Параметры», изменять не нужно.
Заполнить нужно только поля в разделе «Настройки SAMOSALE»:
Привилегия – указываем привилегию, созданную в п.4;
ЭП для списания бонусов – указываем ЭП из п. 3;
Токен – токен предоставляется менеджером компании SAMOSALE;
Торговая точка(подразделение) – выбор подразделения, на котором будет работать система SAMOSALE.
ЭП для подтверждения списания бонусов – указываем ЭП из п. 3;
После создания устройства авторизации необходимо добавить его в фильтр программы лояльности п.4.
6) Добавить устройство авторизации (п.5) в карточку «Подразделения» в раздел
«Настройки».
Если этого не сделать, то на ПОСе данная авторизация будет недоступна.
7) Создать задачу на основе типа задачи: «Отправка оплаты и подтверждения в систему SAMOSALE».
В параметрах задачи указывается устройство «Авторизация SAMOSALE», созданное в п.5.
Задача срабатывает по событию: Гостевой счет. Поэтому настраивать расписание НЕ НУЖНО!
8) Создать задачу на основе типа задачи: «Отправка возврата покупки SAMOSALE».
В параметрах задачи указывается устройство «Авторизация SAMOSALE», созданное в п.5.
Задача срабатывает по событию: Гостевой счет. Поэтому настраивать расписание НЕ НУЖНО!
9) На основе типа программы лояльности: «Чистка служебных данных(SAMOSALE)» необходимо создать программу лояльности и правило продажи. Привилегию создавать не нужно!
В спецификации правила продажи выбрать пункт «Независимо от привилегии»
В параметрах программы лояльности указать устройство «Авторизации SAMOSALE», созданное в п.5.
Обязательно! после всех вышеперечисленных настроек необходимо перезапустить сервер приложения, выполнив поочередно команды(tpsrv_stop\tpsrv_start) на базе сегмента где происходила настройка:
Tpsrv_stop
Ждем пока команда выполниться
Tpsrv_start
В редких случаях, если команда tpsrv_stop выполняется дольше 2-3 минут, то рекомендуется отменить выполнение запроса «Alt+Break» и запустить tpsrv_stop еще раз. Если и после второго раза сервер приложений не остановится, то нужно перезапускать полностью SQL SERVER.
Мониторинг
Информация по каждому запросу в систему SAMOSALE логируется в служебную таблицу: EXTERNAL_log. Логи хранятся 30 дней.
Также оперативные данные о результате отправке сохраняются в заметках карточки гостевого счета:
Статусы транзакций:
1 - оплата
2 - возврат
3 - расчет скидки
4 - создание клиента
5 - создание чека
999 - транзакция не прошла