При задании настроек форматов обмена в веб-интерфейсе кассового сервера необходимо задать:

  • название,
  • тип объекта,
  • параметры обмена.
Наименование
Тип данных
Возможные значения
Описание
Примечания
Названиестроковый
  • SUPERMAG
  • SUPERMAG4

  • SUPERMAG_XML

Идентификатор типа обмена Для выгрузки продаж используется только формат SUPERMAG.
Тип объектастроковый
  • справочники
  • продажи

Объект, определяющий вид обмена:

  • загрузку справочников из АСТУ в БД КС,
  • выгрузку продаж из БД КС в АСТУ.

Загрузка справочников (SUPERMAG)

Загрузка справочников инициируется товароучетной системой, которая формирует файл-справочник и файл-флаг и передает их на КС. Загрузка справочников начинается сразу при обнаружении файла-флага в исходной директории.

По умолчанию для настройки загрузки справочников в формате SUPERMAG доступны следующие параметры:

Параметры для обмена справочниками в формате SUPERMAG:

ОписаниеТип данныхВозможные значенияПримечания
Кодировка файластроковый
  • utf_8
  • cp1251
  • cp866

По умолчанию 866


Директория для резервного копирования справочниковстроковый
Указывается полный путь до директории. Возможно использование макросов
Подстрока, которую необходимо искать в имени пользователя, чтобы он стал администраторомстроковыйПо умолчанию Администратор
Код каталогастроковый
Группе товаров с кодом groupBindCode будут назначены атрибуты каталога catalogBindCode
Формат данныхстроковый
  • dat
  • dbf

По умолчанию dat


Код роли пользователя по умолчаниючисловойПо умолчанию 3
Список кодов пользователей, имеющих дополнительные роличисловой

Код дополнительной роли пользователячисловойПо умолчанию 2
Список файлов-флагов, разделенный запятымистроковыйПо умолчанию /tmp/dict/smag/*.cng, /tmp/dict/smag/*.updВ параметре указывается наименование файла-флага и полный путь до него. Наличие файла-флага в исходной директории указывает на то, что справочники полностью сформированы и могут быть загружены. Если файл-флаг отсутствует, то загрузка справочников не выполняется. Возможно использование макросов
Директория для сохранения информации о прогрузке справочниковстроковый

Файл записи ошибок конвертированиястроковый

Код группыстроковый
Группе товаров с кодом groupBindCode будут назначены атрибуты каталога catalogBindCode
Устанавливать минимальную цену при отсутствии ограничения по скидкелогический
  • true
  • false

По умолчанию true


Связывать роль администратора с пользователем по его имени или кодустроковый
  • name
  • code

Связка товара с каталогом по коду группы ([код группы товара] - [код каталога])строковый

Формат значения параметра: [код группы товара] - [код каталога]:

Пример
{"0000.0000.0000.0000.0001":"1", “0000.0000.0000.0000.0002”:”2”}
Директория для файлов-справочниковстроковый
В параметре указывается полный путь до файлов-справочников. Возможно использование макросов

Загрузка справочников (SUPERMAG4)

Загрузка справочников инициируется товароучетной системой, которая формирует файл-справочник и файл-флаг и передает их на КС. Загрузка справочников начинается сразу при обнаружении файла-флага в исходной директории.

По умолчанию для настройки загрузки справочников в формате SUPERMAG4 доступны следующие параметры:

Параметры для обмена справочниками в формате SUPERMAG4:

ОписаниеТип данныхВозможные значенияПримечания
Кодировка файластроковый
  • utf_8
  • cp1251
  • cp866

По умолчанию 866


Директория для резервного копирования справочниковстроковый
Указывается полный путь до директории. Возможно использование макросов
Подстрока, которую необходимо искать в имени пользователя, чтобы он стал администраторомстроковыйПо умолчанию Администратор
Код каталогастроковый

Код роли пользователя по умолчаниючисловойПо умолчанию 3
Режим дисконтной системыстроковыйПо умолчанию modern
Список кодов пользователей, имеющих дополнительные роличисловой

Код дополнительной роли пользователячисловой

Список файлов-флагов, разделенный запятымистроковыйПо умолчанию /tmp/dict/smag/*.cng, /tmp/dict/smag/*.upd

В параметре указывается наименование файла-флага и полный путь до него. Наличие файла-флага в исходной директории указывает на то, что справочники полностью сформированы и могут быть загружены. Если файл-флаг отсутствует, то загрузка справочников не выполняется. Возможно использование макросов

Директория для сохранения информации о прогрузке справочниковстроковый

Файл записи ошибок конвертированиястроковый

Код группыстроковый
Группе товаров с кодом groupBindCode будут назначены атрибуты каталога catalogBindCode
Связывать роль администратора с пользователем по его имени или кодустроковый
  • name
  • code

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

Формат значения параметра: [код группы товара] - [код каталога]:

Пример
{"0000.0000.0000.0000.0001":"1", “0000.0000.0000.0000.0002”:”2”}
Директория для файлов-справочниковстроковый
В параметре указывается полный путь до файлов-справочников. Возможно использование макросов

Загрузка справочников (SUPERMAG_XML)

Загрузка справочников инициируется товароучетной системой, которая формирует файл-справочник и файл-флаг и передает их на КС. Загрузка справочников начинается сразу при обнаружении файла-флага в исходной директории.

По умолчанию для настройки загрузки справочников в формате SUPERMAG_XML доступны следующие параметры:

Параметры для обмена справочниками в формате SUPERMAG_XML:

ОписаниеТип данныхВозможные значенияПримечания
Устанавливать tmcType для подакцизных товаров в соответстии с маппингом кодов ТН ВЭДлогический
  • true
  • false

По умолчанию false

Cписок соответствия типов штрих-кодов artix (tmcType) - кодам ТН ВЭД ukmстроковый

Формат значения параметра: [ключ] - [значение]:

Пример
{"2":"100,200,1020", “3”:”900,1020,7890”}

Параметр работает только при включенном параметре "Устанавливать tmcType для подакцизных товаров в соответстии с маппингом кодов ТН ВЭД".

По умолчанию {}

Директория для резервного копирования справочниковстроковый

Указывается полный путь до директории. Возможно использование макросов.

По умолчанию /tmp/backup/dicts/%(shopcode)s

Список файлов-флагов, разделенный запятымистроковый
По умолчанию /tmp/dict/smag-ukm-xml/%(shopcode)s/pos*.flz
Директория для сохранения информации о прогрузке справочниковстроковый

Файл записи ошибок конвертированиястроковый

Cписок соответствия кодов единиц измерения artix - кодам единиц измерения ukmстроковый

Формат значения параметра: [ключ] - [значение]:

Пример
{"1":"шт", “2”:”кг”}
Список файлов-справочников, разделенный запятымистроковый

В параметре указывается наименование файла-флага и полный путь до него. Наличие файла-флага в исходной директории указывает на то, что справочники полностью сформированы и могут быть загружены. Если файл-флаг отсутствует, то загрузка справочников не выполняется. Возможно использование макросов.

По умолчанию /tmp/dict/smag-ukm-xml/%(shopcode)s/pos*.xml

Существует возможность загрузки справочников с маркированными товарами, данная возможность может задаваться как в настройках кассы, так и в настройках 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 должно быть уникальным среди всех товаров и штрих-кодов в справочнике.

Пример загрузки справочника с маркированным товаром с egaistype=3

Заданы настройки:

Параметр "Устанавливать tmcType для подакцизных товаров в соответстии с маппингом кодов ТН ВЭД" включен в положение true.

"Cписок соответствия типов штрих-кодов artix (tmcType) - кодам ТН ВЭД ukm" настроен следующим образом:

{"3":"900,2402"}

Загрузка справочника с товаром с egaistype=3 осуществляется следующим образом:

  1. Если у товара в справочнике значение поля 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>

  2. По значению поля TNVDcode в справочнике ТН ВЭД будет получено значение поля id (в данном случае <id>1</id>). После этого будет определено значение кода группы найденного товара в поле code (в данном случае <code>2402</code>).

    Содержимое справочника ТН ВЭД
    <group>
<id>1</id>
<code>2402</code>
<name>Сигары, сигары с обрезанными концами, сигариллы и сигареты из табака или его заменителей</name>
</group>
  3. По значению поля <code>2402</code> будет осуществлен поиск типа товара, заданного в маппинге (в параметре "Cписок соответствия типов штрих-кодов artix (tmcType) - кодам ТН ВЭД ukm"). Значения должны совпасть.
    В данном случае значения совпали, значение типа товара будет загружено в БД Dictionaries в таблицу Barcodes в поле tmctype при загрузке штрих-кодов данного товара (в данном случае tmctype=3, что означает табачную продукцию).
  • No labels