Для настройки форматов обмена в веб-интерфейсе кассового сервера необходимо задать:
- название,
- тип объекта,
- параметры обмена.
Наименование | Тип данных | Возможные значения | Описание |
|---|---|---|---|
| Название | строковый |
| Идентификатор типа обмена |
| Тип объекта | строковый | справочники | Объект, определяющий загрузку справочников из АСТУ в БД КС |
Загрузка справочников (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":"кг"}
|
| Директория с изображениями товаров, входящих в состав пиклиста | строковый |
|
| Список соответствия типов штрих-кодов artix (tmcType) – кодам ТН ВЭД ukm | строковый | {} При использовании параметра необходимо загружать файл-справочник с ТН ВЭД кодами. |
| Список справочников, для которых нужно учитывать флаг очистки, разделенный запятыми | строковый | По умолчанию значение не задано |
Соотнесение наименований единиц измерения и опций количества товара | строковый |
|
| Соотнесение кодов групп товаров и свойств товара/штрих-кода | строковый |
При обновлении КС объект |
| Список файлов-справочников, разделенный запятыми | строковый | В параметре указывается наименование файлов-справочников и полный путь до них. По умолчанию |
Перед каждым конвертированием товаров на КС загружаются товары из БД artxcsAll.tmcgroupsTemp. При загрузке товаров определяется поле tmctype объекта массива barcodes с назначением свойств в зависимости от (в порядке приоритета – от меньшего к большему):
- ограничений, заданных для кодов групп товаров,
- значений поля
egaisType, заданных в файле-справочнике, - ТН ВЭД кода, заданного в файле-справочнике.
Если параметры не заданы, то в поле tmctype будет записано значение 0.
Если в настройках ограничений для группы товаров ничего не указано, то заполняются ограничения из родительской группы. Если у родительской группы ограничения не указаны, то они заполняются из ее родительской и т.д.
На КС есть 3 группы товаров с иерархией и ограничениями:
- Группа 1, ограничение: маркированный товар.
- Группа 2, ограничение: табачный товар.
- Группа 3, ограничение: алкогольная продукция.
- Группа 2, ограничение: табачный товар.
После загрузки товаров на КС при преобразовании форматом обмена товаров конвертор начинает проверку ограничений у загруженных товаров. У группы товаров "Группа 3" указано ограничение: алкогольная продукция. Так как "Группа 3" имеет ограничение, ограничение родительской группы "Группа 2" не распространяется на дочернюю группу "Группа 3".
Итог:
- Группа 1, ограничение: маркированный товар.
- Группа 2, ограничение: табачный товар.
- Группа 3, ограничение: алкогольная продукция.
- Группа 2, ограничение: табачный товар.
На КС есть 3 группы товаров с иерархией и ограничениями:
- Группа 1, ограничение: маркированный товар.
- Группа 2, ограничение: табачный товар.
- Группа 3, нет ограничений.
- Группа 2, ограничение: табачный товар.
После загрузки товаров на КС при преобразовании форматом обмена товаров конвертор начинает проверку ограничений у загруженных товаров. У группы товаров "Группа 3" ограничений нет. На группу товаров "Группа 3" распространяется ограничение родительской группы "Группа 2". Группе товаров "Группа 3" присваивается ограничение: табачный товар.
Итог:
- Группа 1, ограничение: маркированный товар.
- Группа 2, ограничение: табачный товар.
- Группа 3, ограничение: табачный товар.
- Группа 2, ограничение: табачный товар.
На КС есть 3 группы товаров с иерархией и ограничениями:
- Группа 1, ограничение: маркированный товар.
- Группа 2, нет ограничений.
- Группа 3, нет ограничений.
- Группа 2, нет ограничений.
После загрузки товаров на КС при преобразовании форматом обмена товаров конвертор начинает проверку ограничений у загруженных товаров. У группы товаров "Группа 2" и "Группа 3" ограничений нет. На группу товаров "Группа 2" распространяется ограничение родительской группы "Группа 1". Группе товаров "Группа 2" присваивается ограничение: маркированный товар. На группу товаров "Группа 3" распространяется наследованное ограничение родительской группы "Группа 2".
Итог:
- Группа 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 КБ.
Если размер изображения превышает указанное значение, то загрузка изображения может работать некорректно.