Описание

В данном разделе производится настройка интеграции с внешними ERP-системами по импорту и экспорту данных.

• Плагины интеграции – информационный раздел о внешних плагинах интеграции SetRetail10.
• Импорт/Экспорт – подключение импорта и экспорта данных для внешних ERP-систем товарного учета. 
• Внешние процессинги – подключение обмена данными с внешними процессингами лояльности и другими типами данных.
• Отклоненные товары – информация о товарах, не загруженных в результате импорта из ERP.

Плагины интеграции

Для просмотра информации по плагинам интеграции кликните по разделу Плагины интеграции.

Кликните  на соответствующий плагин для просмотра подробной информации по нему.

Откроется страница с описанием плагина интеграции.

Для просмотра информации на сайте вендора, кликните по логотипу → нажмите .

Кликните  для возврата на страницу экспорта/импорта.

Импорт/Экспорт

В этом разделе настраивается обмен данными с ERP-системой.

Возможна настройка следующих способов обмена данными:

• Экспорт данных о продажах в веб-сервис на стороне ERP
• Экспорта данных о продажах с помощью файлов во внешнюю ERP
  • Настройку экспорта данных о продажах с помощью веб-сервиса на стороне SetRetail10 производить не нужно.
• Импорт данных товарного справочника с помощью файлов

Добавление и настройка способа импорта/экспорта

В разделе Импорт/Экспорт нажмите  для добавления способа импорта/экспорта.

Отметьте  необходимый способ обмена → нажмите .

Способы обмена будут добавлены в список.

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

Установите необходимые параметры → нажмите .

Поиск способа экспорта/импорта

Введите текст в строку для поиска необходимого из списка добавленных способов экспорта/импорта.

Удаление способа экспорта/импорта

Нажмите кнопку  для удаления способа экспорта/импорта.

Также удалить способ экспорта/импорта можно, нажав на  внутри него.

Настройки способов экспорта импорта

Интерфейс внутренних настроек отсутствует для следующих способов импорта/экспорта:

• Выгрузка в ESB;
• Протокол Set Retail 10: веб-сервисы.

Выгрузка в ESB

Настройка выключена по умолчанию.

Включение возможности способа обмена с интеграционной шиной обмена данными SetESB.

Примеры внедрения:

• Первые магазины Fix Price в Узбекистане открылись на российском ПО;
• «Глобус» запустил новые инструменты для бизнеса в российских магазинах.

Протокол 585

Настройка выключена по умолчанию.

Используется для торговой сети 585. Настраивается индивидуально.

Протокол Set Retail 10: веб-сервисы

Данный протокол используется для обмена данными между сервером и ERP-системой по запросу во внутренние веб-сервисы SetRetail10 от ERP экспорта и импорта данных.

Настройка включена (добавлена в список способов обмена) по умолчанию.

Веб-сервисы при взаимодействии с ERP работают согласно описаниям в интеграционной документации:

• Веб-сервисы импорта данных из ERP в SetRetail10
• Веб-сервисы экспорта (на стороне SetRetail10)

Протокол Set Retail 10: выгрузка данных в веб-сервис на стороне ERP

Обеспечивается экспорт данных о продажах во внешний веб-сервис (установлен внешний WSDL-файл на стороне ERP) на сторону ERP.

Настройка выключена по умолчанию.

Экспорт данных осуществляется согласно интеграционной документации:

• Веб-сервисы экспорта (на стороне ERP)
• Схемы экспорта при топологиях:
  • Set Centrum (в центральном офисе) ↔ Кассы (в магазинах)
  • Set Centrum (в центральном офисе) ↔ Set Retail (в магазинах) ↔ Кассы (в магазинах)

На вкладке ЭКСПОРТ ДАННЫХ установите периодичность экспорта данных во внешнюю ERP в минутах для следующих параметров:

•  Чеки выгружаются с периодичностью - периодичность экспорта чеков;
• Аннулированные чеки выгружаются с периодичностью - периодичность экспорта аннулированных чеков;
•  Z-отчеты выгружаются с периодичностью - периодичность экспорта Z-отчетов;
  •  Выгружать отчеты только для зеленых смен - экспорт отчетов только по сменам, которые закрыты корректно и без расхождений;
  •  Оборот по типам товаров - включать данные по оборотам товаров;
•  Внесения выгружаются с периодичностью - периодичность экспорта данных по внесениям;
•  Изъятия выгружаются с периодичностью - периодичность экспорта данных по изъятиям;
•  Рекламные акции выгружаются с периодичностью - периодичность экспорта рекламных акций, которые были изменены на сервере;
  •  Первоначальная выгрузка акций - выгружать акции с периодичностью после создания на сервере.
•  Группы продаж выгружаются по расписанию - выгрузка всех существующих групп продаж производится в заданное время, по умолчанию ежедневно в 7-00.
•  Группы продаж выгружаются при изменении - данные выгружаются при каждом изменении состава группы продаж (товар добавляется в группу продаж или удаляется из группы продаж).
• Типы выгружаемых групп продаж
  • Группы продаж Лояльности
  • Группы продаж Меню
  • Весовые группы продаж

На вкладке АДРЕСА ВЕБ-СЕРВИСА настройте адреса по которым располагаются wsdl-файлы приема данных на стороне ERP.

В полях укажите адрес веб-сервиса, например: http://XXX.XXX.XXX.XXX:8088/mockSet10PurchasesPortBinding?wsdl. В данном случае приведен пример для тестирования веб-сервиса на стороне ERP с помощью SOAP UI. Адрес расположения wsdl-файла на стороне ERP в реальных условиях может быть другим.

• Чеки - адрес веб-сервиса wsdl-файла для экспорта чеков;
• Аннулированные чеки - адрес веб-сервиса wsdl-файла для экспорта аннулированных чеков;
• Z-отчеты - адрес веб-сервиса wsdl-файла для экспорта чеков;
• Внесения - адрес веб-сервиса wsdl-файла для экспорта внесений;
• Изъятия - адрес веб-сервиса wsdl-файла для экспорта изъятий;
• Рекламные акции - адрес REST или MOCK веб-сервера для приема обычных POST-запросов;
• Группы продаж - адрес REST или MOCK веб-сервера для приема обычных POST-запросов;
• HTTP авторизация - учетная запись для доступа к веб-сервисам на стороне ERP для приема данных из SetRetail10;
  • Имя пользователя;
  • Пароль;
• Веб-сервис с обратной связью - использовать специальный веб-сервис запроса обратной связи для проверки статуса пакета на стороне SetRetail10 для отправки во внешнюю систему;
• Веб-сервис без обратной связи (совместимость с SAP) - тип экспорта данных во внешнюю систему без TI-идентификатора пакета. Данные просто отправляются во внешнюю систему без проверки статуса доставки.

После ввода всех параметров нажмите .

Перезагружать службу сервера после сохранения параметров не нужно.

Протокол Set Retail 10: файлы

Настройка выключена по умолчанию.

Настройка импорта и экспорта данных из, и во внешнюю ERP-систему в виде XML-файлов.

Обмен данными через файлы, работает согласно описаниям в интеграционной документации и соответствует формату данных для веб-сервисов на стороне SetRetail10:

• Формат импорта данных в SetRetail10 из ERP
• Форматы экспорта данных из SetRetail10 в ERP

На вкладке ИМПОРТ ДАННЫХ установите папки, в которые будут сохраняться XML-пакеты сообщений из ERP-системы.

Настройте любую папку, которая необходима для обработки XML-пакетов. По умолчанию включена обработка папок импорта 1 раз в 60 секунд.

По умолчанию настроены следующие папки:

• ОС Linux:
  • Каталог для импорта данных кассиров: /var/lib/jboss/cashiers/
  • Каталог для импорта данных карт: /var/lib/jboss/cards/
  • Каталог для импорта данных товаров: /var/lib/jboss/products/
• ОС Windows:
  • Каталог для импорта данных кассиров: {Диск установки SetRetail}:/cashiers/
  • Каталог для импорта данных карт: {Диск установки SetRetail}:/cards/
  • Каталог для импорта данных товаров: {Диск установки SetRetail}:/products/

На вкладке экспорта данных настройте папку в которую будут сохраняться XML-пакеты для экспорта в ERP, а также периодичность их сохранения.

• Каталог для экспорта результатов продаж:
  
  • Папка по умолчанию:
    • ОС Linux: /var/lib/jboss/reports/
    • ОС Windows: /var/lib/jboss/reports/
• Экспортируемые данные - указывается периодичность сохранения XML-пакетов в папку экспорта в минутах;
  •  Чеки выгружаются с периодичностью - периодичность создания XML-пакета в папке с данными по экспорту чеков;
  •  Аннулированные чеки - периодичность создания XML-пакета в папке с данными по экспорту аннулированных чеков;
  •  Z-отчеты выгружаются с периодичностью - периодичность создания XML-пакета в папке с данными по экспорту Z-отчетов;
    •  Оборот по типам товаров - включать данные по оборотам товаров.
  •  Рассчитанные скидки выгружаются с периодичностью - периодичность создания XML-пакета в папке с данными по экспорту отчета по скидкам;
  •  Реализация выгружается с периодичностью - периодичность создания XML-пакета в папке с данными по экспорту отчета по реализации;
  •  Изъятия и внесения выгружаются с периодичностью - периодичность создания XML-пакета в папке с данными по экспорту изъятий и внесений.

После ввода всех параметров нажмите .

Перезагружать службу сервера после сохранения параметров не нужно.

Протокол Set Retail 5

Настройка выключена по умолчанию.

Данный протокол используется для тех клиентов, кто производит миграцию на SetRetail10, но при этом еще остается работающий сервер на SetRetail5 согласно отдельной логике интеграции.

На вкладке ЭКСПОРТ ДАННЫХ установите периодичность экспорта данных в SetRetail5/6, в минутах для следующих параметров:

•  Чеки выгружаются с периодичностью - периодичность экспорта чеков;
•  Z-отчеты выгружаются с периодичностью - периодичность экспорта Z-отчетов;
  •  Оборот по типам товаров - включать данные по оборотам товаров;
•  Изъятия выгружаются с периодичностью - периодичность экспорта данных по изъятиям;
•  Счета-фактуры выгружаются с периодичностью - периодичность экспорта данных по счетам-фактурам;
•  Банковские транзакции выгружаются с периодичностью - периодичность экспорта данных по банковский транзакциям;
•  Опросы кассиров выгружаются с периодичностью - периодичность экспорта данных отчета об очередях.
•  Сессии кассиров выгружаются с периодичностью - периодичность экспорта данных о времени работы кассиров.

На вкладке НАСТРОЙКИ СЕРВЕРА установите параметры подключения к базе данных SES сервера SetRetail5/6:

• Адрес сервера - указывается IP-адрес сервера SetRetail5/6;
• Имя базы данных - в большинстве случаем база данных всегда SES.
• Имя пользователя - логин подключения к базе данных Microsoft SQL Server.
• Пароль - пароль пользователя для подключения к базе данных Microsoft SQL Server.

После ввода всех параметров, нажмите  → нажмите .

Перезагружать службу сервера после сохранения параметров не нужно.

Протокол Shop Evolution

Настройка выключена по умолчанию.

Включите  использование сервиса, установите настройки → нажмите  → нажмите .

• Папка для выгрузки товаров - устанавливается папка для выгрузки товаров для импорта в систему самостоятельного сканирования;
• ОС Linux: /var/lib/jboss/reports/set10wsclient/products - по умолчанию;
• ОС Windows: {Диск SetRetail10]:\\reports\\export\\set10wsclient\\products - по умолчанию;
• Префикс для файлов выгрузки товаров - префикс наименования файла при экспорте из SetRetail10;
  • По умолчанию: ItemsImport
• Размер пачки для выгрузки - количество выгружаемых товаров в одном файле экспорта;
• Период выгрузки товаров - периодичность формирования файлов экспорта.

Внешние процессинги 

В этом разделе добавляется любая стыковка с внешними процессингами лояльности и обработчиками данных из SetRetail10.

Настройка привилегий

Для управления внешними процессингами пользователь должен обладать привилегией Администрирование внешних систем.

Действия с процессингами

Добавление процессингов

В разделе Внешние процессинги нажмите  для добавления внешнего процесcинга.

Выберите тип или процессинг → кликните по  флажку рядом с названием процессинга → нажмите .

Процессинг появится в списке.

После добавления процессинга настройте или измените его параметры.

Изменение параметров

Для входа в настройки процессинга нажмите  рядом с требуемым.

Установите настройки внешнего процессинга → нажмите .

•  Настраивается в магазине - (только на SetCentrum) если флажок установлен, то процессинг нужно настроить на каждом из серверов магазинов в топологии SetCentrum ↔ SetRetail ↔ Касса. При отключенном флажке настройки внешнего процессинга устанавливаются только на сервере SetCentrum, и в этом случае изменение настроек процессинга в карточке на сервере SetRetail будет заблокировано.
• Магазины - устанавливается список магазинов или всех объектов, на которые будут отправлены настройки внешнего процессинга.

Кликая на каждый магазин открывается его индивидуальная карточка настройки внешнего процессинга.

Удаление процессингов

Для удаления внешнего процессинга кликните  → нажмите .

Также удалить внешний процессинг можно из его карточки. Кликните  → нажмите .

Поиск и фильтр внешних процессингов

Для поиска внешнего процессинга из списка введите значение в поле.

Также воспользуйтесь фильтром.

Установите флажок  для критериев отбора.

Нажмите  для того, чтобы скрыть панель фильтров, если требуется отобразить полный вид таблицы со списком процессингов.

Панель фильтров будет скрыта.

Бонусные процессинги

Бонусные карты Plas-tek

Подробнее: Plas-Tek (бонусный процессинг).

• Только включение процессинга. Без карточки внутренних настроек.
• При добавлении на SetCentrum отправляется на все магазины без возможности привязки к определённым экземплярам.

Спасибо от Сбербанка

Подробнее: "Спасибо от Сбербанка" (бонусный процессинг).

Внешние процессинги лояльности

Manzana Loyalty

Подробнее: Manzana Loyalty.

Set Loyalty Services, Сервис ограничений РА

Подробнее: /wiki/spaces/SR10SUPPORT/pages/1243480230.

Set Loyalty Services, Сервис счётчиков

Подробнее: /wiki/spaces/SR10SUPPORT/pages/1242759481.

ЕГАИС

ЕГАИС

Подробнее: SetRetail10 ▪️ ЕГАИС ◾️ Настройка и использование ЕГАИС.

Сервер валидации ver. 1.0

Подробнее: SetRetail10 ▪️ ЕГАИС ◾️ Интеграция со сторонним сервером валидации акцизных марок.

Кассовые сервисы

Кассовый сервер

Используется для проверки касс SetMobile.

Без внутренних настроек.

Мягкие чеки

Служба мягких чеков SetKit

Старая версия настроек. Для настройки интеграции с SetKit используйте Служба мягких чеков SetKit X.

Служба мягких чеков SetKit X

Подробнее: SetKit ◾️ Установка и настройка. Обновление (Ubuntu, CentOS).

Подарочные карты

Подарочные карты внешний WebService

Возможность указания полного URL-адреса для внешнего процессинга подарочных карт.

Адрес процессинга будет использоваться на кассах при выполнении следующих операций:

• Продажи ПК (активация ПК);

• Отмена продажи ПК (отмена активации ПК);

• Оплата чека ПК (гашение ПК);

• Отмена оплаты ПК (отмена гашения ПК, при аннулировании чека);

• Статус по ПК (статус и информация по ПК);

• Замена ПК (замена старой ПК на новую).

Укажите адрес WSDL-внешнего процессинга.

Подарочные карты ЦФТ

Подробнее: /wiki/spaces/SR10SUPPORT/pages/439386835. 

Электронные подарочные сертификаты ЦФТ

Подробнее: Электронный подарочный сертификат ЦФТ.

Призма

Set:Prisma

Подробнее: SetRetail10 ◾️ Стыковка с SetPrisma по новому протоколу с использованием данных в JSON-формате (начиная с версии 10.2.23)

Протокол Гифтоман

Настройки подключения к сервису Гифтоман

Подробнее: SetRetail10 ◾️ Гифтоман.

Процессинги товаров

Плагин Столото

Подробнее: Столото ◾️ Настройки SetRetail10.

Сервисы валидации маркированных товаров

Внешний сервер валидации

Специальный внешний сервер валидации для маркированных товаров:

Сервер валидации SetMark

Подробнее: SetMark ◾️ Настройка подключения кассы к сервису.

Сервер чеков Set10

Использовать для валидации марок сервер SetRetail10.

Сервисы информирования

Сервис информирования и управления быстрыми операциями через чат-бот (SetGalya)

Подробнее: SetGalya ◾️ Настройка и использование сервиса.

Сервисы оплаты по QR-коду

Плати QR Сбербанк

Подробнее: Оплата QR-кодом: Плати QR Сбербанк (Сбербанк.Онлайн)

Райффайзенбанк (СБП)

Подробнее: Оплата QR-кодом: Raiffeisen СБП (Система Быстрых Платежей).

Складские остатки

Сервис запроса складских остатков 1C:Предприятие

Подробнее: SetRetail10 ▪️ Клавиатурная касса ◾️ Запрос остатков из 1С на кассе.

SMS-сервисы

SMS-сервис верификации номера телефона покупателя

Подробнее: SetRetail10 ◾️ Работа с дисконтной картой через СМС-авторизацию.

Предупреждения перед сохранением изменений в процессингах

Начиная с версии 10.3.16.0 любые изменения во внешних процессингах сопровождаются подтверждение от пользователя о сделанных изменениях.

Отклоненные товары

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

Пример:

• <bar-code code="123WQRWW">
• <price-entry price="8389.2600">