...
Примечание. Несмотря на то что в интерфейсе УКМ 4 данные XML-конвертеры носят название Супермаг Плюс, их можно использовать не только для интеграции УКМ 4 с продуктом СуперМаг Плюс компании Сервис плюс, но и с любыми внешними системами. Передача данных из внешней системы в УКМ 4 и из УКМ 4 во внешнюю систему осуществляется через раздельные каталоги. Набор каталогов един для всех магазинов, зарегистрированных на одном сервере. В одном файле формата XML передается только один тип данных. Конвертер непрерывно дорабатывается для поддержки передачи новых типов данных по запросам пользователей, однако, уже доступные теги и свойства не удаляются.
Принципы обмена данными между УКМ 4 и внешней системой
- Процесс передачи данных между УКМ 4 и внешней системой исключает дублирующие потоки информации. Сервер УКМ 4 получает всю информацию о товарах из сервера внешней системы. Другими словами, в случае наличия центрального сервера внешней системы и сервера главного офиса УКМ 4, информация о товарах будет загружаться и на сервер главного офиса (СГО) и на сервера магазинов. Соответственно, в УКМ 4 репликация товарных справочников с СГО на сервера магазинов будет заблокирована.
- При настройке передачи данных из внешней системы в УКМ 4 необходимо учитывать, что все магазины в УКМ 4 работают с одной номенклатурой. Если настройка сделана неверно, то в УКМ 4 будет использована одна из номенклатур (выбор номенклатуры произойдет случайным образом). Ограничение отслеживается административными методами.
- В России налоги обычно не загружаются на кассы. На Украине и в Белоруссии налог один, и ставка его одинакова на всей территории страны. Таким образом, функционал налоговых регионов во внешних системах фактически не используется. Поэтому выгружать из внешней системы информацию о связке <налоговая группа – товар> предлагается только для региона Россия.
Передача информации из внешней системы в УКМ 4
Типы передаваемой информации:
...
Тип информации
...
Имя файла и головного тега
...
Тип выгрузки
...
Общая информация (одинаковая для всех магазинов)
...
1
...
Справочник свойств товаров
...
properties
...
всегда полная
...
2
...
Справочник налогов
...
taxes
...
всегда полная
...
3
...
Справочник отделов магазинов
...
stocks
...
всегда полная
...
4
...
Товарный классификатор
...
classif
...
всегда полная
...
5
...
Товары (включая штрихкоды и дополнительные характеристики товаров)
...
updateItems
...
полная/частичная
...
6
...
Наборы
...
kit
...
всегда полная
...
7
...
Скидка по дисконтным картам
...
discountPersonal
...
полная/частичная
...
8
...
Скидки на товарную группу
...
classifDiscount
...
всегда полная
...
9
...
Скидка на чек (по времени и сумме)
...
receiptDiscount
...
всегда полная
...
10
...
Скидка на количество товара
...
quantityDiscount
...
всегда полная
...
11
...
Список заблокированных дисконтных карт
...
blockCard
...
полная/частичная
...
Информация для магазинов (в одном файле может находиться информация только для одного магазина)
...
12
...
Цены на товары
...
storePrices
...
полная/частичная
...
13
...
Продавцы
...
storeSellers
...
всегда полная
...
14
...
Привязка товаров к отделам магазина
...
itemStoreStock
...
всегда полная
...
15
...
Кассиры
...
storeCashier
...
всегда полная
Версионность
Каждый файл с данными в начале должен содержать тег «version="MJ.MN»1.0», описывающий версию формата данных соответствующего типа информации. Номера представляются в виде целого положительного числа (например, «version="1.0»1.0»).
Здесь MJ означает номер «мажорной» версии, MN означает номер «минорной» версии.
Логика изменения номеров версий заключается в следующем:
– если в новой версии формата данных произошли изменения, в результате которых новый формат данных стал несовместим с прежним форматом, то номер «мажорной» версии увеличивается на 1;
- если изменения совместимы с прежним форматом, то увеличивается номер «минорной» версии.
На практике это означает, что при изменении MJ-номера формата, версия конвертора, работающая с прежним форматом, не будет обрабатывать файлы с новым форматом и, наоборот, версия конвертора с новым форматом не будет обрабатывать файлы со старым форматом.
Если изменился MN-номер (но не изменилась MJ-номер), то файлы будут обрабатываться, но «незнакомые» для конвертора теги будут пропущены.
Принципы обмена данными между УКМ 4 и внешней системой
- Процесс передачи данных между УКМ 4 и внешней системой исключает дублирующие потоки информации. Сервер УКМ 4 получает всю информацию о товарах из сервера внешней системы. Другими словами, в случае наличия центрального сервера внешней системы и сервера главного офиса УКМ 4, информация о товарах будет загружаться и на сервер главного офиса (СГО) и на сервера магазинов. Соответственно, в УКМ 4 репликация товарных справочников с СГО на сервера магазинов будет заблокирована.
- При настройке передачи данных из внешней системы в УКМ 4 необходимо учитывать, что все магазины в УКМ 4 работают с одной номенклатурой. Если настройка сделана неверно, то в УКМ 4 будет использована одна из номенклатур (выбор номенклатуры произойдет случайным образом). Ограничение отслеживается административными методами.
- В России налоги обычно не загружаются на кассы. На Украине и в Белоруссии налог один, и ставка его одинакова на всей территории страны. Таким образом, функционал налоговых регионов во внешних системах фактически не используется. Поэтому выгружать из внешней системы информацию о связке <налоговая группа – товар> предлагается только для региона Россия.
Передача информации из внешней системы в УКМ 4
Типы передаваемой информации:
Тип информации | Имя файла и головного тега | Тип выгрузки | |
Общая информация (одинаковая для всех магазинов) | |||
1 | Справочник свойств товаров | properties | всегда полная |
2 | Справочник налогов | taxes | всегда полная |
3 | Справочник отделов магазинов | stocks | всегда полная |
4 | Товарный классификатор | classif | всегда полная |
5 | Товары (включая штрихкоды и дополнительные характеристики товаров) | updateItems | полная/частичная |
6 | Наборы | kit | всегда полная |
7 | Скидка по дисконтным картам | discountPersonal | полная/частичная |
8 | Скидки на товарную группу | classifDiscount | всегда полная |
9 | Скидка на чек (по времени и сумме) | receiptDiscount | всегда полная |
10 | Скидка на количество товара | quantityDiscount | всегда полная |
11 | Список заблокированных дисконтных карт | blockCard | полная/частичная |
Информация для магазинов (в одном файле может находиться информация только для одного магазина) | |||
12 | Цены на товары | storePrices | полная/частичная |
13 | Продавцы | storeSellers | всегда полная |
14 | Привязка товаров к отделам магазина | itemStoreStock | всегда полная |
15 | Кассиры | storeCashier | всегда полная |
Имена файлов
TAGNAME_ [Object]_ [Number]_[P]_[Error].xml
...
- каталог, куда внешняя система выгружает информацию;
- выгружать или не выгружать : скидки, продавцов и отделы (если не выгружать отделы, то справочник отделов и привязка товаров к отделам не будут выгружены).
...
- Создать каталог, куда внешняя система будет выгружать информацию.На сервере УКМ 4 создать маркетинговую схему и рекламную акцию, в которую должна выгружаться информация по скидкам.
Чтобы подключить конвертер, перейдите в раздел веб-интерфейса Настройка сервера и оборудования/Конвертеры. В открывшемся окне нажмите кнопку +Добавить. Далее выберите из списка конвертер и нажмите +Создать:
...
- Все справочники, кроме товаров (артикулов) , цен и содержимого скидки Персональная на классификатори цен, выгружаются из внешней системы полностью (если в них произошли изменения во внешней системе с момента предыдущей выгрузки). Если изменений во внешней не было, то файлы соответствующих типов не создаются.
- Удаления записей о товарах (артикулах) и ценах в рамках протокола обмена информацией не предусмотрено. Удаление товара (запись в прайс-листе) производится через интерфейс УКМ 4.
- Удаления записей в скидке Персональная на классификатор с помощью конвертора не предусмотрено. При необходимости удаления записей, следует удалить на сервере УКМ 4 саму скидку (или скидки) и сделать полную выгрузку всех скидок из внешней системы. Конвертер создаст недостающие скидки заново.
- Выгрузка информации о скидках производится на центральном сервере внешней системы (в СГО). В случае настройки загрузки скидок на серверах магазинов, в УКМ 4 не гарантируется целостность информации, при условии одновременной настройки других скидок на СГО.
- Удаления записей о товарах (артикулах) в рамках протокола не предусмотрено. При большой необходимости удалить товар можно через интерфейс УКМ 4.
- Если файл с ценами имеет флаг полной выгрузки, то УКМ 4 предварительно удаляет текущее содержимое прайс-листа для магазина и затем загружает его содержание из файла. Удаляются только цены на артикулы, цены на штрихкоды не изменяются.
- Если в выгруженной записи о цене пропущено её значение (есть только теги <price></price>), то УКМ 4 удаляет запись о цене для данного товара из текущего прайс-листа.
...
- Ставка Не облагается будет автоматически использоваться УКМ 4 при пустом справочнике налогов для добавления товаров в чек. Актуально для пользователей с неосновной системой налогообложения, которые не выгружают налоги в УКМ 4 с любыми конвертерами.
- Ставка Не облагается будет использоваться УКМ 4 для объектов пользователя с неосновной системой налогообложения во всех случаях: даже если эта ставка не загружена в справочник налогов УКМ 4, не выбрана для товаров, и справочник налогов не пуст. Актуально для пользователей, которые в одной системе УКМ 4 поддерживают работу как магазинов с основной системой налогообложения, так и магазинов с любой неосновной системой налогообложения (например, ЕНДВ).
Комментарий к секции <gift> – процедура выдачи подарков определяется в УКМ 4 и не требует предварительной выгрузки товаров-подарков из внешней системы. Один и тот же товар может быть продан и в составе чека (за какую-то стоимость) и в то же время, может быть выдан как подарок.
Соответствие значений тега <programType> и скидок в Супермаг Плюс:
...
programType
...
Название скидки в Супермаг Плюс
...
2
...
Скидки по группам
...
4
...
Количество товара
...
1
...
Скидки по ДК
...
108
...
- магазинов с основной системой налогообложения, так и магазинов с любой неосновной системой налогообложения (например, ЕНДВ).