Сторонние форматы обмена поддержаны не в полном объеме. Передача всех реквизитов осуществляется в формате AIF.

В кассовом ПО Artix поддержана работа с форматом Штрих-М версии 1.9. Полное описание формата приведено в документации "Штрих-М: Кассир" (начиная со стр.102). В данном разделе приведено описание особенностей загружаемых справочников и перечень расширений формата для более полного использования функционала Артикс.

Начиная с версии Artix 4.6.43 и 4.5.7-510 реализована возможность загрузки реквизитов алкогольной продукции в формате Штрих-М. Подробнее о загрузке дополнительных реквизитов товара можно прочитать на официальном сайте.

Загружаемые справочники

Выполняется загрузка данных только из справочников, которые представлены ниже. 

Справочник в формате Штрих-М должен быть записан в кодировке cp1251.

Загружаемые справочники
1Товары
2Дополнительные штрих-коды
3Дополнительные цены
4Схемы автоматических скидок
5Автоматические скидки
6Дисконтные карты
7Условия накопительных (дисконтных) скидок
8Фиксированные скидки
9Пользователи
10Налоги
11Налоговые группы
12Горячие клавиши
Фиксированные скидки применяются только по карте. Не поддерживаются выбор из списка и скидка по кнопке.

Краткое описание формата

Для обмена данными в формате Штрих-М используется 2 вида файлов: файл загрузки и файл выгрузки.

Файл загрузки

Файл загрузки служит для загрузки на кассу справочников. Файл состоит из двух частей: шапки файла и непосредственно информации. 
Шапка файла состоит из двух строк: 

  1. Первая строка – строка инициализации файла «##@@&&» (6 символов).

  2. Вторая строка – признак загрузки данного файла «#» (1 символ).

После того, как файл успешно загружен программой рабочего места кассира признак загрузки файла меняется с «#» на «@». После шапки файла следует информация о реквизитах товара и управляющие команды. В одной строке файла записывается информация об одном товаре. Реквизиты товара разделяются «;». 

Служебные команды

Кроме данных для загрузки файл загрузки может содержать служебные команды, необходимые для корректной загрузки данных. Служебные команды располагаются в первой или последней строке файла загрузки и начинаются с символов «$$$».

Вместе с командой $$$CLR допустимы следующие команды (должны содержаться в той же строке, что и $$$CLR): 

  • {NO_TOV} – очистка справочника товаров не производится,
  • {ZAPR} – очистка ограничений продаж по времени,
  • {UNITS} – очистка справочника единиц измерения,
  • {KIT} – очистка комплектов (наборов товаров),
  • {CAT} – очистка каталогов (таблицы catalog, tmccatalog),
  • {AUT_S} – очистка дисконтных схем,
  • {ACC_S} – очистка накопительных скидок,
  • {DIS_C} – очистка справочника дисконтных карт,
  • {USR} – очистка справочника пользователей,
  • {FIX_S} – очистка справочника фиксированных скидок,
  • {HOT_K} – очистка справочника горячих клавиш,
  • {COM_GR_GF} – очистка справочника схем разрезов (таблица aspectscheme) и справочника значений разрезов (таблица aspectvalueset),
  • {GOOD_F} – очистка справочника характеристик разрезов и их параметров (таблица aspect), и справочника значений характеристик разрезов (таблица aspectvalue),
  • {TOV_F} – очистка справочника разрезов товара (таблица aspectvaluesetvalues).

Файл выгрузки продаж

Файл отчета о продажах товара состоит из двух частей: шапки файла и информации о продажах, проведенных инвентаризациях и возвратах товара поставщику.
Шапка файла состоит из трех строк: 

  1. Первая строка – признак обработки данного файла товароучетной программой «#» (1 символ). После обработки файла АСТУ символ «#» заменяется на «@», после чего файл продаж будет удален. 
  2. Вторая строка содержит логический номер ККМ. 
  3. Третья строка содержит порядковый номер отчета. 

После шапки файла следует информация о продажах товара, инвентаризациях и возвратах товара поставщику.

Отчет о продажах представлен в виде последовательности транзакций. Одна строка текстового файла содержит информацию об одной транзакции. Строка состоит из 12 полей с данными, поля разделяются символом «;». Назначения полей приведены в официальной документации Штрих-М.

Пример - файл выгрузки продаж, содержащий одну продажу
#
1
11
1100001;12.03.2018;16:02:13;11;1;1;4;1;1;15.20;1.0;15.20;
1100002;12.03.2018;16:02:14;40;1;1;4;0;;0;1.0;15.20;
1100003;12.03.2018;16:02:16;55;1;1;4;0;0;0;0.0;15.20;
1100004;12.03.2018;16:02:19;61;1;2;4;11;0;15.20;0.0;15.20;

Выгрузка документов инвентаризации и возврата поставщику

Документы инвентаризации и возврата поставщику записываются в файл выгрузки продаж в виде строки транзакции и тега Document.

Строка транзакции содержит информацию о выполненной операции – инвентаризации или возврате поставщику, и состоит из 12 полей, аналогичных полям транзакций отчета о продажах.

Тег Document описывает состав документа и выглядит следующим образом:

Пример - тег Document
<Document store="N" name1="value1">
...
</Document>

Атрибут store записывается для всех документов. Он содержит номер отдела товара, записанный в БД Documents таблица goodsitem поле deptcode. Если в одном документе содержатся товары из разных отделов, то для каждого отдела запишется собственная связка из строки транзакции и тега Document.

Атрибут name1 записывается только для документов инвентаризации и имеет значение "excisemark", указывающее на то, что для акцизных товаров будет выгружена акцизная марка.

В тело тега записывается состав документа. Каждая строка в теге является позицией документа и состоит из полей, разделяемых символом ";".

№ поляНазначениеПримечания
1Код товара в документе
2Количество товара в документе
3Акцизная марка товараИспользуется только для документа инвентаризации, заполняется для акцизных товаров
Пример - документ инвентаризации с товарами из разных отделов, где один из товаров - акцизный
21400004;12.03.2018;17:45:33;300;1;2;4;;0;14002;4.0;0;
<Document store="0" name1="excisemark">
105;1.000;22N000008XSG44YGEUT0P7T70424001006364JZKW012VT5XOLTCW4IJ9VGEOP44FTB3
</Document>
21400005;12.03.2018;17:45:33;300;1;2;4;;1;14002;4.0;0;
<Document store="1" name1="excisemark">
1;1.000;
</Document>
Пример - документ возврата поставщику с товарами из разных отделов
22000005;13.03.2018;15:59:11;300;1;2;4;;5;20002;7.0;0;
<Document store="5">
10;1.000
</Document>
22000006;13.03.2018;15:59:11;300;1;2;4;;7;20002;7.0;0;
<Document store="7">
1;1.000
</Document>

Дополнительные транзакции в выгрузке продаж

Название

 

Тип

Назначение полей

8

9

10

11

12

Документ (Возврат поставщику)

308Номер по АСТУ (если документ загружался из DCM-файла)СекцияНомер документа



Документ (Инвентаризация)302
СекцияНомер документа



Документ300
СекцияНомер документа

Тип документа:

  • 4 – инвентаризация,
  • 7 – возврат поставщику.

Зачисление бонусов на карту после оплаты чека

161Номер карты клиента
  • 0 – основные баллы,
  • 1 – дополнительные баллы.

Номер акции (выгружается для дополнительных баллов).

Для базовых баллов номер акции равен 0, так как считается общая сумма баллов начисленных на позицию со всех сработавших дополнительных начислений.


Сумма накопленных баллов
Оплата позиции бонусами162Номер карты клиента

Округленный процент скидки (суммы потраченных баллов от суммы чека)Сумма, оплаченная баллами
Возврат баллов, начисленных покупателю за возвращаемую покупку163Номер карты клиента

Округленный процент скидки (суммы потраченных баллов от суммы чека)Сумма, оплаченная баллами (со знаком "-")
Возврат баллов на счет покупателя, которыми он оплатил возвращаемую покупку164Номер карты клиента
  • 0 – основные баллы,
  • 1 – дополнительные баллы.


Сумма накопленных баллов (со знаком "-")
Платежная карта (Безналичный расчет)95Код карты
Остаток на карте после операции
Сумма списания (с учетом знака)
Анкетные данные165Номер карты

Тип данных:

  • 0 – номер телефона,
  • 1 – дата рождения,
  • 2 – пол.

Код оператора/региона. Правило преобразования: лидирующие нули отбрасываются, полученное число записывается в виде десятичной дроби с точностью до сотых. 

Например, 911 -> 9.11.


Анкетные данные согласно указанному типу данных:

  • Номер телефона. Правило преобразования: лидирующие нули отбрасываются, полученное число записывается в виде десятичной дроби с точностью до тысячных. 
    Например, 0319367 -> 319.367 или 3696737 -> 3696.737
  • Дата рождения сохраняется в формате YYYYMMDD. Правило преобразования: лидирующие нули отбрасываются, полученное число записывается в виде десятичной дроби с точностью до тысячных.
    Например, 1985.03.07 – > 19850,307.
  • Пол: 1- мужчина, 2 – женщина.

Добавление товаров с акцизной маркой160Штрих-код акцизной марки



Сторнирование товаров с акцизной маркой163Штрих-код акцизной марки



X-отчет60Номер отчетаЛогический номер ККМНаличность в кассеСумма покупюрной ведомостиСумма выручки
Разрез характеристики20

Код разреза характеристики





Продавец позиции90Код кассираНомер отдела


Добавление товаров с кодом маркировки180Код маркировки

Тип маркировки:

  • 5 – табачная продукция,
  • 1520 – обувь.


Сторнирование товаров с кодом маркировки183Код маркировки

Тип маркировки:

  • 5 – табачная продукция,
  • 1520 – обувь.


Детализация оплаты сертификатом73Номер сертификата

Тип сертификата:

  • 0 – не погашен,
  • 1 – погашен
Сумма оплаты
Оплата сертификатом122Номер сертификатаКод вида оплатыНоминал сертификатаКод вида сертификатаСумма оплаты

При наличии транзакции оплаты бонусами (162) и возврата баллов (164) в чек добавляется пара транзакций 35 и 71.

  • No labels