Инструкция.
Бюллетени изменений.
Кассовый модуль. Драйвер выгрузки в систему управления медиаконтентом Супермаг DS.
Базовые настройки интеграции.
В раздел «Структуру магазина/склада» добавлен драйвер «DS XML» для загрузки данных в систему управления медиаконтентом для управления электронными ценниками.
Для работы клиента Кафка надо установить последнюю версию Microsoft OpenJDK из ресурса:
{+}https://docs.microsoft.com/en-us/java/openjdk/download+![]()
Установку надо выполнять со стандартными настройками (обязательно «с опцией для всех пользователей»).
Если сервер Kafka для DS расположен в облачном пространстве yandex и для доступа к нему потребуется сертификат yandex.
Чтобы его получить, необходимо выполнить следующие действия:
Надо запустить командную строку Windows (не PowerShell). Командная строка по умолчанию запускается в рабочем каталоге «C:\Users\ИмяПользователя>» или «C:\Windows\System32», если командная строка запущена от имени администратора. Оба каталога не желательны для размещения сертификата (каталог текущего пользователя может быть недоступен для службы кассового модуля, а каталог System32 для доступа на запись требует прав администратора). Чтобы задать другой каталог для размещения сертификата, необходимо изменить текущий каталог командной строки, например, командой «cd», либо указать полный путь к каталогу в командах ниже. Затем надо выполнить следующие команды (каталог $HOME\.kafka может быть заменен на любой другой каталог и может быть создан средствами проводника):
mkdir $HOME\.kafka;
curl.exe -o $HOME\.kafka\YandexInternalRootCA.crt https://storage.yandexcloud.net/cloud-certs/CA.pem![]()
В каталоге, например, C:\Windows\System32\$HOME\.kafka должен появиться файл YandexInternalRootCA.crt
Затем надо выполнить следующую команду:
keytool.exe -importcert -alias YandexCA -file $HOME\.kafka\YandexInternalRootCA.crt -keystore $HOME\.kafka\ssl -storepass <пароль хранилища сертификатов> -noprompt
Пароль должен содержать не менее 6 символов.
При корректном выполнении команды появится сообщение:
Certificate was added to keystore
После установки сертификата необходимо заполнить атрибуты драйвера для доступа к Кафка:
Если используется сервер Kafka, не принадлежащий Yandex Cloud, сертификат необходимо запросить у курирующего менеджера.
Полученный файл сертификата следует сохранить в доступном каталоге и указать путь к нему в поле «Путь к SSL сертификату» в окне настроек драйвера «DS XML».
Заполняем данные брокера, куда, собственно, и подключаемся (при настройке интеграции, эти данные можно уточнить у курирующего менеджера):
-адрес и порт брокера
-логин партнёра
-пароль партнёра
-id партнёра
Для интеграции «СуперМаг Плюс» и «СуперМаг DS» может использоваться выделенный кластер Apache Kafka.
Для обеспечения отказоустойчивости кластер будет развёрнут в нескольких зонах доступности, а доступ к нему организован через несколько точек входа (bootstrap-серверы).
Таким образом, в поле «Адрес и порт брокера» разрешено указывать не один адрес, а перечень адресов и портов кластера «Кафка» через запятую. Например:
rc1a-f4rio9m1fnk5h1ad.mdb.yandexcloud.net:9091,rc1a-n5d3fnivdkckv41n.mdb.yandexcloud.net:9091,rc1a-s1q211pllioml3cq.mdb.yandexcloud.net:9091
Перечень адресов выдаётся сервисом предоставляющим услуги развертывания серверов и виртуальных машин;
такой набор адресов образует кластер брокеров. Библиотека, используемая для работы с Kafka в «СуперМаг Плюс», изначально спроектирована для работы с кластером: она поддерживает подключение к нескольким брокерам, балансировку нагрузки и отказоустойчивость. Дополнительных действий при указании нескольких адресов не требуется — драйвер сам распределяет подключение между доступными брокерами.
Формирование выгрузки данных для ПО СуперМаг DS.
Изначально предполагалось, что каждая торговая точка будет самостоятельно выгружать свой состав данных на сервер DS. Однако при одновременной выгрузке с нескольких точек система передаёт в DS множество файлов с дублирующейся информацией (справочник товаров, классификатор, места хранения). Это создаёт избыточную нагрузку на конвертер DS и увеличивает время обработки и доставки данных до потребителей (электронных ценников).
В связи с этим механизм обмена модернизирован: разрешена централизованная выгрузка — единая выгрузка из центральной базы СМ+ с использованием места хранения «Центральный офис».
В структуре магазина/склада для места хранения «Центральный офис» разрешены настройка и использование кассы с типом DS. В настройках драйвера появилось поле «Обслуживаемые места хранения», в котором пользователь указывает перечень МХ, для которых необходимо производить такую выгрузку.
При выгрузке в центральный офис файлы, общие для всех мест хранения, выгружаются однократно — дублирование между торговыми точками устраняется.
Если указано «Создавать архив выгрузки», то при передаче данных в Кафку дубликаты передаваемых файлов выгружаются в указанный каталог.
Наименование и структура выгружаемых данных.
Именование и структура формируемых файлов с некоторыми отличиями аналогичны тем, которые выгружаются драйвером УКМ4 XML.
Для выгрузки файла itemInfo с данными о PLU весовых товаров в структуре магазина / склада надо отметить флаг «Весы торгового зала» для того отдела, в котором размещено описание весов торгового зала.
Примечание: Все весы торгового зала должны иметь единый список PLU для поиска товара по PLU, указанному в ценнике. Структура торгового зала позволяет разместить весы в нескольких отделах, однако в случае использования единого торговго зала все весы торгового зала следует помещать в один отдел. Только вэтом случае у них гаранитровано будет единый спиок PLU весовых товаров.
Категория и дизайн ценников для системы управления медиаконтентом Супермаг DS.
В справочнике «Категория ценников» поле «Только для мобильного принтера» заменено полем «Применение» с возможностью выбора области применения ценника:
- для стандартного принтера,
- для мобильного принтера,
- для DS
Примечание: опция «Обязательна для печати» действует только при выборе применения «для стандартного принтера».
Выбор применения «для DS» означает, что ценники этой категории предполагается использовать в системе управления медиаконтентом Супермаг DS, и они будут воспроизводиться только в этой системе.
В справочнике «Дизайн ценников» поле «Файл ценника» получило название «Файл или код DS ценника». Для ценников с применением «для стандартного принтера» или «для мобильного принтера» в это поле по-прежнему надо заносить название файла ценника, для ценников «для DS» в это поле надо заносить код ценника, известный системе Супермаг DS (может иметь только целое натуральное число):
Разным группам товаров и разным артикулам можно задавать разные дизайны ценников для DS так же, как для печати на бумажном носителе. Также можно назначать разные дизайны ценников для DS для артикулов, участвующих в тех или иных маркетинговых акциях.
Источником данных для акционных ценников будут выступать документы «Маркетинговая акция».
Следует учитывать, что у данного документа имеются следующие атрибуты, значение которых напрямую может оказывать влияние на цену товара, и как следствие цену на ценнике СуперМаг DS. К атрибутам относится:
•Планируемая дата начала акции.
•Планируемая дата окончания акции.
•Статус «Исполняется». (Статус указывает, что акция стартовала).
•Фактическая дата окончания акции.
Описание процесса выгрузки данных кассовым модулем
Выгрузка данных осуществляется кассовым модулем, в функционал которого заложена возможность автоматического выполнения операций согласно предварительно настроенному расписанию. Помимо этого, предусмотрен режим ручного запуска выгрузки через интерфейс администратора кассового модуля. В обоих случаях доступны два основных типа выгрузки: полная и инкрементальная (частичная).
Полная выгрузка
предполагает формирование исчерпывающего перечня файлов с данными, которые создаются в строго регламентированной последовательности. Данный порядок обеспечивает корректную обработку и загрузку информации на стороне DS.
Последовательность формирования файлов выглядит следующим образом:
- Справочник магазинов (store);
- Классификатор товаров (classif);
- Артикулы (updateItems);
- Цены (storePrices);
- Цены акционные (priceTagInfo);
- PLU (itemInfo).
Пример формируемого пакета файлов при полной выгрузке:
classif_[15409]_[F]_part1.xml (17 КБ);
itemInfo_[3][15409][F]_part1.xml (2 КБ);
priceTagInfo_[3][15409][F]_part1.xml (2 КБ);
store_[15409]_[I]_part1.xml (3 КБ);
storePrices_[3][15409][F]_part1.xml (499 КБ);
updateItems_[15409]_[F]_part1.xml (404 КБ);
updateItems_[15409]_[F]_part2.xml (504 КБ);
updateItems_[15409]_[F]_part3.xml (258 КБ).
Инкрементальная выгрузка.
Сценарии инкрементальной выгрузки
Для наглядности рассмотрим несколько практических сценариев, демонстрирующих работу инкрементального механизма выгрузки.
Сценарий 1: Изменение названия товара, не участвующего в маркетинговой акции.
При изменении названия карточки товара, которое не задействовано в маркетинговых мероприятиях, и последующем запуске инкрементальной выгрузки формируются файлы, содержащие данные исключительно по измененному артикулу. В данном случае создаются следующие файлы:
storePrices_[3][15413][1]_part1.xml (1 КБ);
updateItems_[15413]_[1]_part1.xml (1 КБ).
Сценарий 2: Изменение цены товара, не участвующего в маркетинговой акции.
Если производится изменение цены для такой же карточки товара, структура выгрузки остается аналогичной предыдущему сценарию. Формируются файлы с данными только по измененному артикулу:
storePrices_[3][15415][1]_part1.xml (1 КБ);
updateItems_[15415]_[1]_part1.xml (1 КБ).
Сценарий 3: Изменение названия товара, участвующего в маркетинговой акции.
В случае изменения названия карточки товара, которая участвует в маркетинговой акции, инкрементальная выгрузка формирует файлы, относящиеся только к измененному артикулу. При этом в пакет включаются данные об акции и PLU (при условии, что их выгрузка активирована). Пример набора файлов:
itemInfo_[3][15411][I]_part1.xml (1 КБ);
priceTagInfo_[3][15411][I]_part1.xml (1 КБ);
storePrices_[3][15411][I]_part1.xml (1 КБ);
updateItems_[15411]_[I]_part1.xml (1 КБ).
Сценарий 4: Завершение маркетинговой акции.
При завершении маркетинговой акции цена артикула возвращается к своему прежнему значению. В этом случае формируется следующий набор файлов:
itemInfo_[3][15417][I]_part1.xml (1 КБ);
storePrices_[3][15417][I]_part1.xml (1 КБ);
updateItems_[15417]_[I]_part1.xml (1 КБ).
Особенности формирования цен при установленном признаке «Ценники за 0,1 единицы»
Важно отметить, что при активированном признаке «Ценники за 0,1 единицы» в системе происходит автоматический пересчет выгружаемой цены. В частности, значение цены делится на 10. Данная настройка влияет на итоговые данные, передаваемые в DS, и требует учета при анализе выгружаемых файлов.
Пример влияния настройки:При установленной розничной цене 160,00 (согласно таблице видов цен) в файле выгрузки storePrices_[3][15419][I]part1.xml значение цены будет указано как 16. При этом в файле updateItems[15419]_[I]_part1.xml в описании товара может быть указано «Цена за 100 грамм», что соответствует логике пересчета для весового товара.
Примеры фалов полной выгрузки
Описания полей конвертера
https://manual.retail-soft.pro/x/XYGHC


















