При задании настроек форматов обмена в веб-интерфейсе кассового сервера необходимо задать:
- название,
- тип объекта,
- параметры обмена.
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
Название | строковый |
| Идентификатор типа обмена | Для выгрузки продаж используется только формат SUPERMAG . |
Тип объекта | строковый |
| Объект, определяющий вид обмена:
|
Загрузка справочников (SUPERMAG)
Загрузка справочников инициируется товароучетной системой, которая формирует файл-справочник и файл-флаг и передает их на КС. Загрузка справочников начинается сразу при обнаружении файла-флага в исходной директории.
По умолчанию для настройки загрузки справочников в формате SUPERMAG
доступны следующие параметры:
Параметры для обмена справочниками в формате SUPERMAG
:
Описание | Тип данных | Возможные значения | Примечания |
---|---|---|---|
Кодировка файла | строковый |
По умолчанию | |
Директория для резервного копирования справочников | строковый | Указывается полный путь до директории. Возможно использование макросов | |
Подстрока, которую необходимо искать в имени пользователя, чтобы он стал администратором | строковый | По умолчанию Администратор | |
Код каталога | строковый | Группе товаров с кодом groupBindCode будут назначены атрибуты каталога catalogBindCode | |
Формат данных | строковый |
По умолчанию | |
Код роли пользователя по умолчанию | числовой | По умолчанию 3 | |
Список кодов пользователей, имеющих дополнительные роли | числовой | ||
Код дополнительной роли пользователя | числовой | По умолчанию 2 | |
Список файлов-флагов, разделенный запятыми | строковый | По умолчанию /tmp/dict/smag/*.cng , /tmp/dict/smag/*.upd | В параметре указывается наименование файла-флага и полный путь до него. Наличие файла-флага в исходной директории указывает на то, что справочники полностью сформированы и могут быть загружены. Если файл-флаг отсутствует, то загрузка справочников не выполняется. Возможно использование макросов |
Директория для сохранения информации о прогрузке справочников | строковый | ||
Файл записи ошибок конвертирования | строковый | ||
Код группы | строковый | Группе товаров с кодом groupBindCode будут назначены атрибуты каталога catalogBindCode | |
Устанавливать минимальную цену при отсутствии ограничения по скидке | логический |
По умолчанию | |
Связывать роль администратора с пользователем по его имени или коду | строковый |
| |
Связка товара с каталогом по коду группы ([код группы товара] - [код каталога]) | строковый | Формат значения параметра: Пример {"0000.0000.0000.0000.0001":"1", “0000.0000.0000.0000.0002”:”2”} | |
Директория для файлов-справочников | строковый | В параметре указывается полный путь до файлов-справочников. Возможно использование макросов |
Загрузка справочников (SUPERMAG4)
Загрузка справочников инициируется товароучетной системой, которая формирует файл-справочник и файл-флаг и передает их на КС. Загрузка справочников начинается сразу при обнаружении файла-флага в исходной директории.
По умолчанию для настройки загрузки справочников в формате SUPERMAG4
доступны следующие параметры:
Параметры для обмена справочниками в формате SUPERMAG4
:
Описание | Тип данных | Возможные значения | Примечания |
---|---|---|---|
Кодировка файла | строковый |
По умолчанию | |
Директория для резервного копирования справочников | строковый | Указывается полный путь до директории. Возможно использование макросов | |
Подстрока, которую необходимо искать в имени пользователя, чтобы он стал администратором | строковый | По умолчанию Администратор | |
Код каталога | строковый | ||
Код роли пользователя по умолчанию | числовой | По умолчанию 3 | |
Режим дисконтной системы | строковый | По умолчанию modern | |
Список кодов пользователей, имеющих дополнительные роли | числовой | ||
Код дополнительной роли пользователя | числовой | ||
Список файлов-флагов, разделенный запятыми | строковый | По умолчанию /tmp/dict/smag/*.cng , /tmp/dict/smag/*.upd | В параметре указывается наименование файла-флага и полный путь до него. Наличие файла-флага в исходной директории указывает на то, что справочники полностью сформированы и могут быть загружены. Если файл-флаг отсутствует, то загрузка справочников не выполняется. Возможно использование макросов |
Директория для сохранения информации о прогрузке справочников | строковый | ||
Файл записи ошибок конвертирования | строковый | ||
Код группы | строковый | Группе товаров с кодом groupBindCode будут назначены атрибуты каталога catalogBindCode | |
Связывать роль администратора с пользователем по его имени или коду | строковый |
| |
Связка товара с каталогом по коду группы | строковый | Формат значения параметра: Пример {"0000.0000.0000.0000.0001":"1", “0000.0000.0000.0000.0002”:”2”} | |
Директория для файлов-справочников | строковый | В параметре указывается полный путь до файлов-справочников. Возможно использование макросов |
Загрузка справочников (SUPERMAG_XML)
Загрузка справочников инициируется товароучетной системой, которая формирует файл-справочник и файл-флаг и передает их на КС. Загрузка справочников начинается сразу при обнаружении файла-флага в исходной директории.
По умолчанию для настройки загрузки справочников в формате SUPERMAG_XML
доступны следующие параметры:
Параметры для обмена справочниками в формате SUPERMAG_XML
:
Описание | Тип данных | Возможные значения | Примечания |
---|---|---|---|
Устанавливать tmcType для подакцизных товаров в соответстии с маппингом кодов ТН ВЭД | логический |
| По умолчанию |
Cписок соответствия типов штрих-кодов artix (tmcType) - кодам ТН ВЭД ukm | строковый | Формат значения параметра: [ Пример {"2":"100,200,1020", “3”:”900,1020,7890”} Параметр работает только при включенном параметре "Устанавливать tmcType для подакцизных товаров в соответстии с маппингом кодов ТН ВЭД". По умолчанию | |
Директория для резервного копирования справочников | строковый | Указывается полный путь до директории. Возможно использование макросов. По умолчанию | |
Список файлов-флагов, разделенный запятыми | строковый | По умолчанию /tmp/dict/smag-ukm-xml/%(shopcode)s/pos*.flz | |
Директория для сохранения информации о прогрузке справочников | строковый | ||
Файл записи ошибок конвертирования | строковый | ||
Cписок соответствия кодов единиц измерения artix - кодам единиц измерения ukm | строковый | Формат значения параметра: [ Пример {"1":"шт", “2”:”кг”} | |
Список файлов-справочников, разделенный запятыми | строковый | В параметре указывается наименование файла-флага и полный путь до него. Наличие файла-флага в исходной директории указывает на то, что справочники полностью сформированы и могут быть загружены. Если файл-флаг отсутствует, то загрузка справочников не выполняется. Возможно использование макросов. По умолчанию |
Существует возможность загрузки справочников с маркированными товарами, данная возможность может задаваться как в настройках кассы, так и в настройках Artix Control Center. В настройках Artix Control Center такая возможность определяется параметром "Устанавливать tmcType для подакцизных товаров в соответстии с маппингом кодов ТН ВЭД". Соответствие кодов групп ТН ВЭД типам штрих-кодов для реализации маркированных товаров настраивается с помощью параметра "Cписок соответствия типов штрих-кодов artix (tmcType) - кодам ТН ВЭД ukm".
Если соответствие задано, то загрузка справочников с маркированнами товарами будет происходить следующим образом:
При значении параметра "Устанавливать tmcType для подакцизных товаров в соответствии с маппингом кодов ТН ВЭД":
-
true
еслиegaisType
> 1, то поиск группы товаров будет осуществляться по соответствию значения поляTNVDcode
из справочника товаров значению поляID
из справочника ТН ВЭД. Код группы товаров, полученный по полюID
, сравнивается со значениями, заданными в маппинге:- если код группы товаров найден в маппинге, то при загрузке штрих-кодов товара в БД
Dictionaries
в таблицуBarcodes
будет загружен соответствующий тип товара в полеtmctype
, - если код группы товаров не найден в маппинге, то при загрузке штрих-кодов товара в БД
Dictionaries
в таблицуBarcodes
будет загружен тип маркированного товара(7)
в полеtmctype
.
- если код группы товаров найден в маппинге, то при загрузке штрих-кодов товара в БД
false
:- если
egaisType=3
илиegaisType=4
, то при загрузке штрих-кодов товара в БДDictionaries
в таблицуBarcodes
будет загружен тип маркированного товара(7)
в полеtmctype
, - если
egaisType
принимает любое другое значение (например,egaisType=10
), то при загрузке штрих-кодов товара в БДDictionaries
в таблицуBarcodes
будет загружен тип товара в полеtmctype
, который соответствует заданному вegaisType
значению.
- если
egaisType=1
) при любом значении настройки mapTnvdCodeToTmcType
считываются и загружаются в справочниках с признаком акцизного алкоголя tmctype=1
.Значение поля article
должно быть уникальным среди всех товаров и штрих-кодов в справочнике.
Заданы настройки:
Параметр "Устанавливать tmcType для подакцизных товаров в соответстии с маппингом кодов ТН ВЭД" включен в положение true
.
"Cписок соответствия типов штрих-кодов artix (tmcType) - кодам ТН ВЭД ukm" настроен следующим образом:
{"3":"900,2402"}
Загрузка справочника с товаром с egaistype=3
осуществляется следующим образом:
Если у товара в справочнике значение поля
egaisType>1
(в данном случае<egaisType>3</egaisType>
), то будет получено значение поляTNVDcode
(в данном случае<TNVDcode>1</TNVDcode>
).Содержимое справочника товаров<item> <article>000019</article> <name>СИГАРИЛЛЫ КАФЕ КРЕМ 1/10 ШТ</name> <measure>шт</measure> <measprec>1</measprec> <groupId>6521</groupId> <egaisType>3</egaisType> <TNVDcode>1</TNVDcode> <taxgroupId>4</taxgroupId> <barcode> <id>8720400246144</id> <quantity>1</quantity> </barcode> <barcode> <id>8720400000210</id> <quantity>1</quantity> </barcode> <SubExcise>1</SubExcise> </item>
По значению поля
TNVDcode
в справочнике ТН ВЭД будет получено значение поляid
(в данном случае<id>1</id>
). После этого будет определено значение кода группы найденного товара в полеcode
(в данном случае<code>
2402</code>
).Содержимое справочника ТН ВЭД<group> <id>1</id> <code>2402</code> <name>Сигары, сигары с обрезанными концами, сигариллы и сигареты из табака или его заменителей</name> </group>
- По значению поля
<code>
2402</code>
будет осуществлен поиск типа товара, заданного в маппинге (в параметре "Cписок соответствия типов штрих-кодов artix (tmcType) - кодам ТН ВЭД ukm"). Значения должны совпасть.
В данном случае значения совпали, значение типа товара будет загружено в БДDictionaries
в таблицуBarcodes
в полеtmctype
при загрузке штрих-кодов данного товара (в данном случаеtmctype=3
, что означает табачную продукцию).