Для настройки форматов обмена в веб-интерфейсе кассового сервера необходимо задать:
- название,
- тип объекта,
- параметры обмена.
Наименование | Тип данных | Возможные значения | Описание |
|---|---|---|---|
| Название | строковый |
| Идентификатор типа обмена |
| Тип объекта | строковый | справочники | Объект, определяющий загрузку справочников из АСТУ в БД КС |
Загрузка справочников (SUPERMAG)
Загрузка справочников инициируется товароучетной системой, которая формирует файл-справочник и файл-флаг и передает их на КС. Загрузка справочников начинается сразу при обнаружении файла-флага в исходной директории.
По умолчанию для настройки загрузки справочников в формате SUPERMAG доступны следующие параметры:
Параметры для обмена справочниками в формате SUPERMAG:
| Описание | Тип данных | Возможные значения | Примечания |
|---|---|---|---|
| Кодировка файла | строковый |
| По умолчанию 866 |
| Директория для резервного копирования справочников | строковый | Возможно использование макросов. По умолчанию | |
| Подстрока, которую необходимо искать в имени пользователя, чтобы он стал администратором | строковый | По умолчанию Администратор | |
| Код каталога | строковый | Группе товаров с кодом По умолчанию значение не задано | |
| Формат данных | строковый |
| По умолчанию dat |
| Код роли пользователя по умолчанию | числовой | По умолчанию 3 | |
| Список кодов пользователей, имеющих дополнительные роли | числовой | По умолчанию значение не задано | |
| Код дополнительной роли пользователя | числовой | По умолчанию 2 | |
| Список файлов-флагов, разделенный запятыми | строковый | В параметре указывается наименование файла-флага и полный путь до него. Наличие файла-флага в исходной директории указывает на то, что справочники полностью сформированы и могут быть загружены. Если файл-флаг отсутствует, то загрузка справочников не выполняется. Возможно использование макросов По умолчанию | |
| Директория для сохранения информации о прогрузке справочников | строковый | По умолчанию значение не задано | |
| Файл записи ошибок конвертирования | строковый | По умолчанию значение не задано | |
| Код группы | строковый | Группе товаров с кодом groupBindCode будут назначены атрибуты каталога catalogBindCode | |
| Устанавливать минимальную цену при отсутствии ограничения по скидке | логический |
| По умолчанию true |
| Связывать роль администратора с пользователем по его имени или коду | строковый |
| По умолчанию значение не задано |
| Связка товара с каталогом по коду группы ([код группы товара] - [код каталога]) | строковый | Формат значения параметра: Пример {"0000.0000.0000.0000.0001":"1", “0000.0000.0000.0000.0002”:”2”}
| |
| Директория для файлов-справочников | строковый | По умолчанию |
Загрузка справочников (SUPERMAG4)
Загрузка справочников инициируется товароучетной системой, которая формирует файл-справочник и файл-флаг и передает их на КС. Загрузка справочников начинается сразу при обнаружении файла-флага в исходной директории.
По умолчанию для настройки загрузки справочников в формате SUPERMAG4 доступны следующие параметры:
Параметры для обмена справочниками в формате SUPERMAG4:
| Описание | Тип данных | Возможные значения | Примечания |
|---|---|---|---|
| Кодировка файла | строковый |
| По умолчанию 866 |
| Директория для резервного копирования справочников | строковый | По умолчанию значение не задано | |
| Подстрока, которую необходимо искать в имени пользователя, чтобы он стал администратором | строковый | По умолчанию Администратор | |
| Код каталога | строковый | По умолчанию значение не задано | |
| Код роли пользователя по умолчанию | числовой | По умолчанию 3 | |
| Режим дисконтной системы | строковый |
| По умолчанию modern |
| Список кодов пользователей, имеющих дополнительные роли | числовой | По умолчанию значение не задано | |
| Код дополнительной роли пользователя | числовой | ||
| Список файлов-флагов, разделенный запятыми | строковый | В параметре указывается наименование файла-флага и полный путь до него. Наличие файла-флага в исходной директории указывает на то, что справочники полностью сформированы и могут быть загружены. Если файл-флаг отсутствует, то загрузка справочников не выполняется. Возможно использование макросов. По умолчанию | |
| Директория для сохранения информации о прогрузке справочников | строковый | По умолчанию значение не задано | |
| Файл записи ошибок конвертирования | строковый | По умолчанию значение не задано | |
| Код группы | строковый | Группе товаров с кодом groupBindCode будут назначены атрибуты каталога catalogBindCode | |
| Связывать роль администратора с пользователем по его имени или коду | строковый |
| По умолчанию значение не задано |
| Связка товара с каталогом по коду группы | строковый | Формат значения параметра: Пример {"0000.0000.0000.0000.0001":"1", “0000.0000.0000.0000.0002”:”2”}
| |
| Директория для файлов-справочников | строковый | По умолчанию |
Загрузка справочников (SUPERMAG_XML)
Загрузка справочников инициируется товароучетной системой, которая формирует файл-справочник и файл-флаг и передает их на КС. Загрузка справочников начинается сразу при обнаружении файла-флага в исходной директории.
По умолчанию для настройки загрузки справочников в формате SUPERMAG_XML доступны следующие параметры:
Параметры для обмена справочниками в формате SUPERMAG_XML:
| Описание | Тип данных | Примечания |
|---|---|---|
| Директория для резервного копирования справочников | строковый | Возможно использование макросов. По умолчанию |
| Список файлов-флагов, разделенный запятыми | строковый | В параметре указывается наименование файла-флага и полный путь до него. Наличие файла-флага в исходной директории указывает на то, что справочники полностью сформированы и могут быть загружены. Если файл-флаг отсутствует, то загрузка справочников не выполняется. По умолчанию/tmp/dict/smag-ukm-xml/%(shopcode)s/pos*.flz |
| Директория для сохранения информации о прогрузке справочников | строковый | По умолчанию значение не задано |
| Файл записи ошибок конвертирования | строковый | В параметре указывается полный путь до файла, в который записывается текст последней ошибки конвертирования. Если директория файла не создана, то запись ошибки не производится. Файл удаляется при следующем запуске конвертирования. По умолчанию значение не задано |
| Соотнесение кодов единиц измерения Artix и наименований единиц измерения SuperMag UKM | строковый | Задается в формате Пример {"1":"шт","2":"кг"}
|
| Директория с изображениями товаров, входящих в состав пиклиста | строковый |
|
| Список справочников, для которых нужно учитывать флаг очистки, разделенный запятыми | строковый | По умолчанию значение не задано |
| Соотнесение наименований единиц измерения и опций количества товара | строковый |
|
| Соотнесение кодов групп товаров и свойств товара/штрих-кода | строковый |
|
| Список файлов-справочников, разделенный запятыми | строковый | В параметре указывается наименование файлов-справочников и полный путь до них. По умолчанию |
Перед каждым конвертированием товаров на КС загружаются товары из БД artxcsAll.tmcgroupsTemp. Если в настройках ограничений для группы товаров ничего не указано, то заполняются ограничения из родительской группы. Если у родительской группы ограничения не указаны, то они заполняетются из ее родительской и т.д.
На КС есть 3 группы товаров с иерархией и ограничениями:
- Группа 1, ограничение: маркированный товар.
- Группа 2, ограничение: табачный товар.
- Группа 3, ограничение: алкогольная продукция.
- Группа 2, ограничение: табачный товар.
После загрузки товаров на КС для преобразования формата обмена товаров конвертор начинает проверку ограничений у загруженный товаров. У группы товаров "Группа 3" указано ограничение: алкоголбьная продукция. Так как "Гуппа 3" имеет ограничение, ограничение родительской группы "Группа 2" не распространяется на дочернюю группу "Группа 3".
Итог:
- Группа 1, ограничение: маркированный товар.
- Группа 2, ограничение: табачный товар.
- Группа 3, ограничение: алкогольная продукция.
- Группа 2, ограничение: табачный товар.
На КС есть 3 группы товаров с иерархией и ограничениями:
- Группа 1, ограничение: маркированный товар.
- Группа 2, ограничение: табачный товар.
- Группа 3, нет ограничений.
- Группа 2, ограничение: табачный товар.
После загрузки товаров на КС для преобразования формата обмена товаров конвертор начинает проверку ограничений у загруженный товаров. У группы товаров "Группа 3" ограничений нет. На нее распространяет ограничение родительская группа товаров "Группа 2", поэтому у группы товаров "Группа 3" есть ограничение: табачный товар.
Итог:
- Группа 1, ограничение: маркированный товар.
- Группа 2, ограничение: табачный товар.
- Группа 3, ограничение: табачный товар.
- Группа 2, ограничение: табачный товар.
На КС есть 3 группы товаров с иерархией и ограничениями:
- Группа 1, ограничение: маркированный товар.
- Группа 2, нет ограничений.
- Группа 3, нет ограничений.
- Группа 2, нет ограничений.
После загрузки товаров на КС для преобразования формата обмена товаров конвертор начинает проверку ограничений у загруженный товаров. У группы товаров "Группа 3" ограничений нет. На нее распространяет ограничение родительская группа "Группа 2", но она тоже не имеет ограничений. На группу товаров "Группа 2" распространяет ограничение ее родительская группа "Группа 1", поэтому группе товаров "Группа 2" присваивается ограничение: маркированный товар. Так как "Группа 2" всё таки имеет ограничение, она распростаняет его на группу товаров "Группа 3". Поэтому у группы товаров "Группа 3" есть ограничение: маркированный товар.
Итог:
- Группа 1, ограничение: маркированный товар.
- Группа 2, ограничение: маркированный товар.
- Группа 3, ограничение: маркированный товар.
- Группа 2, ограничение: маркированный товар.
При загрузке справочника с единицами измерения могут быть добавлены опции количества товара. Для этого необходимо задать соотнесение наименований единиц измерения и опций количества товара.
Пусть необходимо добавить следующие опции для штук:
- enabledefaultquantity – "Использовать количество по умолчанию из товара",
- enablequantitymanual – "Разрешить ввод количества вручную".
Пусть необходимо добавить следующие опции для килограммов:
- enabledefaultquantity – "Использовать количество по умолчанию из товара",
- enablequantitybarcode – "Разрешить установку количества из штрих-кода".
Тогда соотнесение примет вид
{'шт':'enabledefaultquantity,enablequantitymanual','кг':'enabledefaultquantity,enablequantitybarcode'}}
Существует возможность загрузки справочников с маркированными товарами, данная возможность может задаваться как в настройках кассы, так и в настройках Artix Control Center.
При загрузке справочников для алкогольной, табачной продукции и остальных маркированных товаров могут быть добавлены свойства товара/штрих-кода. Для этого необходимо задать соотнесение кодов групп товаров и свойств товара/штрих-кода. Для группы/групп товаров может быть задан собственный набор свойств.
Пусть есть группы товаров с кодами 123, 456, abc и marked.
Для алкогольной продукции
123,456 = {"tmctype": 1, "age": 18, "alcoholpercent": 40.0, "ageverify": 1, "requiresalerestrict": 1, "egaisverify": 1}
Для табачной продукции
abc = {"tmctype": 3, "age": 18, "ageverify": 1, "requiresalerestrict": 1, "tobacco": 1}
Для любых маркированных товаров
marked = {"tmctype": 7}
Загрузка пиклистов (многоуровневых каталогов) с изображениями товаров
Существует возможность загрузки пиклистов (многоуровневых каталогов), данная возможность может задаваться только в настройках Artix Control Center. Загруженные пиклисты сохраняются в БД Dictionaries магазина в таблице PicklistTemp.
Изображения для товаров, входящих в состав пиклиста, должны быть предварительно загружены в директорию, указанную в настройке "Директория с изображениями товаров, входящих в состав пиклиста". Изображения, загруженные из директории, сохраняются в БД Dictionaries таблице Picklist в поле image.
Для корректной загрузки изображения должны соответствовать следующим требованиям:
формат:
pngилиjpeg/jpg,наименование: код товара из пиклиста + расширение. Например:
10.png, где10– код товара,размер: рекомендуется 48 КБ.
Если размер изображения превышает указанное значение, то загрузка изображения может работать некорректно.