Smag-

ukm

Для загрузки справочников в формате smag-ukm необходимо:

• указать название конвертера в секции [UPLOAD]: converter = smag-ukm,
• сконфигурировать секцию загрузки [upload.converter.smag-ukm].

[UPLOAD]
...
; список конвертеров данных, разделенный запятыми (aif, oracle, shtrih, smag-ukm, smag-ukm4, users, crystal, atol)
converter = smag-ukm
... 
[upload.converter.smag-ukm]
; Список файлов-флагов, разделенный запятыми
;flags = /tmp/dict/smag/*.cng, /tmp/dict/smag/*.upd

; Список файлов-справочников, разделенный запятыми
;data = /tmp/dict/smag/*.dat

; Файл в который будет записываться текст последней ошибки конвертирования
;errorDest = /tmp/dict/smag/error.txt

; Кодовая страница данных.
; Примеры кодировок: utf_8, U8, UTF, utf8, cp1251, windows-1251, cp866, 866, IBM866 и др.
; По умолчанию 866
;charset = 866

; Формат данных (dat, dbf)
; По умолчанию dat
;format = dat

; Код роли пользователя по умолчанию
; По умолчанию 3
;defaultRoleCode = 3

; Код дополнительной роли пользователя
; По умолчанию 2
;additionallyRoleCode = 2

; Связывать роль администратора с пользователем по его имени или коду (name, code)
relationRolesBy = code

; Подстрока, которую необходимо искать в имени пользователя, что бы он стал администратором
; По умолчанию Администратор
;substringInAdminName = Администратор

; Список кодов пользователей, которые имеют дополнительные роли, разделенные через запятые
; По умолчанию ''
usersWithAdditionallyRole = 1,2,3

; Устанавливать минимальную цену при отсутствии ограничения по скидке
; По умолчанию True
;setMinPriceIfDiscountRestrictMissing = True

Для указания местоположения справочников используется параметр data, в котором указывается полный путь до файлов-справочников. При перечислении наименования файлов (вместе с путем до каждого справочника) указываются через запятую.

Загрузка справочников производится при наличии файла-флага, указывающего на то, что справочники полностью сформированы и выгружены на кассу. При отсутствии файла-флага загрузка справочников в БД не производится. Список флагов определяется параметром flags, в котором прописывается полный путь до файлов-флагов. При использовании нескольких флагов они перечисляются через запятую (вместе с путем до каждого файла-флага).

При возникновении ошибок конвертирования справочников в формат AIF описание ошибки указывается в файле, заданном параметром errorDest. В параметре указывается полный путь до файла. Файл с ошибкой конвертирования удаляется при следующем запуске процедуры. Если параметр не определен или директория для размещения файла отсутствует, то файл с ошибками не создается.

Связывание роли администратора с пользователем производится по имени или коду. Правила связки определяются параметром relationRolesBy:

• при значении параметра name права администратора назначаются пользователю, указанному в параметре substringInAdminName. Пользователю присваивается роль по умолчанию из параметра defaultRoleCode и дополнительная роль из параметра additionallyRoleCode,
• при значении параметра code права администратора получает пользователь с кодом, указанным в параметре usersWithAdditionallyRole. Пользователю присваивается роль по умолчанию из параметра defaultRoleCode и дополнительная роль из параметра additionallyRoleCode.

Подробнее о ролях пользователей и их взаимодействии можно прочитать в разделе "Роли".

При загрузке справочников товаров можно определять правило установки минимальной цены при отсутствии ограничения по скидке при помощи параметра setMinPriceIfDiscountRestrictMissing:

• при значении параметра true минимальная цена товара принимает значение основной цены,
• при значении параметра false в значение минимальной цены товара устанавливается 0.

Если ограничение по скидке задано, то правило установки минимальной цены игнорируется.

Связка товара с каталогом по коду группы

При загрузке справочников товаров группе товаров с указанным кодом назначаются атрибуты каталога с указанным кодом. Если в связке указать несуществующий каталог, то в БД программы запись tmccatalog не будет добавлена.

[upload.converter.smag-ukm.group2catalog]
; Связать товар с каталогом по коду группы
; Если товар входит в группу 1, а у группы 1 есть связка с каталогом 2, то в tmccatalog будет связка (код товара, код каталога 2)
; <код группы товара> = <код каталога>
;0000.0000.0000.0000.0001 = 1
;0000.0000.0000.0000.0002 = 2

О связке товара с каталогом по коду группы при задании формата обмена на кассовом сервере можно прочитать в статье "SUPERMAG, SUPERMAG4 / Супермаг (КС)".

Smag-ukm-xml

Для загрузки справочников в формате smag-ukm-xml необходимо:

• указать название конвертера в секции [UPLOAD]: converter = smag-ukm-xml,
• сконфигурировать секцию загрузки: [upload.converter.smag-ukm-xml].

Дополнительно можно сконфигурировать секции:

• соответствия кодов единицы измерения [upload.converter.smag-ukm-xml.measureMapper],
• соответствие кодов групп ТН ВЭД типам ШК для реализации маркированного товара [upload.converter.smag-ukm-xml.egaisTypeMapper].

[upload.converter.smag-ukm-xml]
; Список файлов-флагов, разделенный запятыми
flags = /tmp/dict/smag-ukm-xml/pos*.flz

; Список файлов-справочников, разделенный запятыми
data = /tmp/dict/smag-ukm-xml/*.xml

; Файл в который будет записываться текст последней ошибки конвертирования
;errorDest = /tmp/dict/smag-ukm-xml/error.txt

; Маппинг маркированных товаров по кодам ТН ВЭД
; При отключенном маппинге маркированные товары будут выгружены
;mapTnvdCodeToTmcType = False

[upload.converter.smag-ukm-xml.measureMapper]
; <соответствие кодов единицы измерения>
; <код единицы измерения - артикс> = <код единицы измерения - ukm>
1 = шт
2 = кг

[upload.converter.smag-ukm-xml.egaisTypeMapper]
; <соответствие кодов групп ТН ВЭД типам ШК для реализации маркированного товара>
; <код типа ШК - артикс> = <коды групп ТН ВЭД от ukm через запятую>
; маппинг работает для товаров с egaisType 1
; если код ТН ВЭД, указанный у товара, не найден в маппинге, товар будет прогружен с tmcType = 7
;2 = 100,200,1020
;3 = 900,1020,7890

Для указания местоположения справочников используется параметр data, в котором указывается полный путь до файлов-справочников. При перечислении наименования файлов (вместе с путем до каждого справочника) указываются через запятую.

Загрузка справочников производится при наличии файла-флага, указывающего на то, что справочники полностью сформированы и выгружены на кассу. При отсутствии файла-флага загрузка справочников в БД не производится. Список флагов определяется параметром flags, в котором прописывается полный путь до файлов-флагов. При использовании нескольких флагов они перечисляются через запятую (вместе с путем до каждого файла-флага).

При возникновении ошибок конвертирования справочников в формат AIF описание ошибки указывается в файле, заданном параметром errorDest. В параметре указывается полный путь до файла. Файл с ошибкой конвертирования удаляется при следующем запуске процедуры. Если параметр не определен или директория для размещения файла отсутствует, то файл с ошибками не создается.

Возможность загрузки справочников с маркированными товарами определяется параметром mapTnvdCodeToTmcType в секции [upload.converter.smag-ukm-xml]. Соответствие кодов групп ТН ВЭД типам штрих-кодов для реализации маркированных товаров настраивается с помощью маппинга в секции [upload.converter.smag-ukm-xml.egaisTypeMapper]. Если соответствие задано, то загрузка справочников с маркированнами товарами будет происходить следующим образом:

При значении mapTnvdCodeToTmcType:

• 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 значению.

; Маппинг маркированных товаров по кодам ТН ВЭД
mapTnvdCodeToTmcType = true

[upload.converter.smag-ukm-xml.egaisTypeMapper]
3 = 900,2402