Сторонние форматы обмена поддержаны не в полном объеме. Передача всех реквизитов осуществляется в формате AIF.
В кассовом ПО Artix поддержана работа с форматом Штрих-М версии 1.9. Полное описание формата приведено в документации "Штрих-М: Кассир" (начиная со стр.102). В данном разделе приведено описание особенностей загружаемых справочников и перечень расширений формата для более полного использования функционала Артикс.
Загружаемые справочники
Выполняется загрузка данных только из справочников, которые представлены ниже.
Справочник в формате Штрих-М должен быть записан в кодировке cp1251
.
Загружаемые справочники | |
---|---|
1 | Товары |
2 | Дополнительные штрих-коды |
3 | Дополнительные цены |
4 | Схемы автоматических скидок |
5 | Автоматические скидки |
6 | Дисконтные карты |
7 | Условия накопительных (дисконтных) скидок |
8 | Фиксированные скидки |
9 | Пользователи |
10 | Налоги |
11 | Налоговые группы |
12 | Горячие клавиши |
Краткое описание формата
Для обмена данными в формате Штрих-М используется 2 вида файлов: файл загрузки и файл выгрузки.
Файл загрузки
Файл загрузки служит для загрузки на кассу справочников. Файл состоит из двух частей: шапки файла и непосредственно информации.
Шапка файла состоит из двух строк:
Первая строка – строка инициализации файла «##@@&&» (6 символов).
Вторая строка – признак загрузки данного файла «#» (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 символ). После обработки файла АСТУ символ «#» заменяется на «@», после чего файл продаж будет удален.
- Вторая строка содержит логический номер ККМ.
- Третья строка содержит порядковый номер отчета.
После шапки файла следует информация о продажах товара, инвентаризациях и возвратах товара поставщику.
Отчет о продажах представлен в виде последовательности транзакций. Одна строка текстового файла содержит информацию об одной транзакции. Строка состоит из 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 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 | Секция | Номер документа | Тип документа:
| ||
Зачисление бонусов на карту после оплаты чека | 161 | Номер карты клиента |
| Номер акции (выгружается для дополнительных баллов). Для базовых баллов номер акции равен 0, так как считается общая сумма баллов начисленных на позицию со всех сработавших дополнительных начислений. | Сумма накопленных баллов | |
Оплата позиции бонусами | 162 | Номер карты клиента | Округленный процент скидки (суммы потраченных баллов от суммы чека) | Сумма, оплаченная баллами | ||
Возврат баллов, начисленных покупателю за возвращаемую покупку | 163 | Номер карты клиента | Округленный процент скидки (суммы потраченных баллов от суммы чека) | Сумма, оплаченная баллами (со знаком "-") | ||
Возврат баллов на счет покупателя, которыми он оплатил возвращаемую покупку | 164 | Номер карты клиента |
| Сумма накопленных баллов (со знаком "-") | ||
Платежная карта (Безналичный расчет) | 95 | Код карты | Остаток на карте после операции | Сумма списания (с учетом знака) | ||
Анкетные данные | 165 | Номер карты | Тип данных:
| Код оператора/региона. Правило преобразования: лидирующие нули отбрасываются, полученное число записывается в виде десятичной дроби с точностью до сотых. Например, 911 -> 9.11. | Анкетные данные согласно указанному типу данных:
| |
Добавление товаров с акцизной маркой | 160 | Штрих-код акцизной марки | ||||
Сторнирование товаров с акцизной маркой | 163 | Штрих-код акцизной марки | ||||
X-отчет | 60 | Номер отчета | Логический номер ККМ | Наличность в кассе | Сумма покупюрной ведомости | Сумма выручки |
Разрез характеристики | 20 | Код разреза характеристики | ||||
Продавец позиции | 90 | Код кассира | Номер отдела | |||
Добавление товаров с кодом маркировки | 180 | Код маркировки | Тип маркировки:
| |||
Сторнирование товаров с кодом маркировки | 183 | Код маркировки | Тип маркировки:
| |||
Детализация оплаты сертификатом | 73 | Номер сертификата | Тип сертификата:
| Сумма оплаты | ||
Оплата сертификатом | 122 | Номер сертификата | Код вида оплаты | Номинал сертификата | Код вида сертификата | Сумма оплаты |
При наличии транзакции оплаты бонусами (162) и возврата баллов (164) в чек добавляется пара транзакций 35 и 71.