Обмен через текстовые файлы по протоколу Штрих-М кассир.
Формат даты — ДД.ММ.ГГ
Формат времени — ЧЧ:ММ:СС
Разделитель целой и дробной части — «.»
Используемые обозначения:
«Строка X» — строка в кодировке Win1251, длина до X символов.
«Дробное X.Y» — тип поля «Дробное», длина (X + Y + 1), где X — количество целых разрядов, Y — количество дробных разрядов.
Файл загрузки
Файл служит для загрузки в рабочее место информации о пользователях, справочника товаров, справочника скидок. Файл состоит из двух частей: шапки файла и непосредственно информации.
Шапка файла состоит из двух строк:
• Первая строка — строка инициализации файла «##@@&&» (6 символов) и управляющие команды. Управляющие команды располагаются в первой строке файла загрузки и начинаются с символов «$$$». Допускаются следующие служебные команды:
«$$$ADD» — добавление или изменение товара;
«$$$CLR» — очистка справочника товаров перед загрузкой;
«$$$DEL» — выборочное удаление.
• вторая строка — признак загрузки данного файла «#» (1 символ).
После того, как файл успешно загружен программой признак загрузки меняется с «#» на «@».
Ниже шапки файла следует информация о реквизитах товара. В одной строке файла записывается информация об одном товаре. Реквизиты товара разделяются «;» и располагаются в порядке приведенном в таблице ниже:
№ поля |
Тип |
Назначение
для товара |
Назначение
для группы |
1 |
Число 13 |
Код |
Код |
2 |
Строка 13 |
Штрихкод |
Не используется |
3 |
Строка 100 |
Наименование для кассы |
Наименование |
4 |
Не используется |
Не используется |
Не используется |
5 |
Число 15.2 |
Цена |
Не используется |
6 |
Не используется |
Не используется |
Не используется |
7 |
Не используется |
Не используется |
Не используется |
8 |
Число 1.0 |
Контроль продажи дробного количества |
Не используется |
9 |
Не используется |
Не используется |
Не используется |
10 |
Число 5.1 |
Макс. процент скидки |
Не используется |
11 |
Число 8.0 |
Код налоговой схемы |
Не используется |
12 |
Не используется |
Не используется |
Не используется |
13 |
— |
Не используется |
Не используется |
14 |
— |
Не используется |
Не используется |
15 |
— |
Не используется |
Не используется |
16 |
Строка 13 |
Код род. группы |
Код род. группы |
17 |
Число 1.0 |
Товар или группа: для товара “1” |
Товар или группа: для группы “0” |
Для загрузки единиц измерения товаров (упаковки, пачки и т.п.), имеющих свой штрих-код, строка начинается со знака «#», а формат строки следующий:
№ поля |
Тип |
Назначение |
1 |
Число 13 |
Код товара |
2 |
Число 13 |
Штрих-код |
3 |
Строка 100 |
Наименование единицы |
4 |
Не используется |
Не используется |
5 |
Число 15.2 |
Цена |
6 |
Не используется |
7 |
Не используется |
8 |
Не используется |
9 |
Не используется |
10 |
Число 17.3 |
Коэффициент |
Для загрузки информации об алкогольной продукции используется следующий формат:
— 22 «Вид алкогольной продукции» ЗначениеРеквизита (Формат: Целое число 3 знака)
— 23 «Ёмкость тары» ЗначениеРеквизита (Емкость алкогольной продукции в литрах. Формат: Число 2.4)
— 24 «Подакцизный товар» ЗначениеРеквизита («0» — акцизный, «1» – неакцизный. По этому полю определяется нужно сканировать марку или нет.)
— 27 «Содержание спирта» ЗначениеРеквизита (Формат: Число 2.1)
Code – код товара
Пример товара бренди:
<goods_attr id=»Code» attr_id=»22″>280</goods_attr>
<goods_attr id=»Code» attr_id=»23″>0.500</goods_attr>
<goods_attr id=»Code» attr_id=»24″>0</goods_attr>
Пример товара пиво:
<goods_attr id=»Code» attr_id=»22″>500</goods_attr>
<goods_attr id=»Code» attr_id=»23″>0.480</goods_attr>
<goods_attr id=»Code» attr_id=»24″>1</goods_attr>
<goods_attr id=»Code» attr_id=»27″>4.7</goods_attr>
В УТМ отправляются товары, для которых заданы поля «Код вида алкогольной продукции» и «Емкость тары».
Коды видов алкогольной продукции http://fsrar.ru/Declaring/klassifikator-vidov-produkcii
Для загрузки фиксированных скидок строка начинается со знака «^», а формат строки следующий:
№ поля |
Тип |
Назначение |
1 |
Число 5.0 |
Код скидки |
2 |
Строка 25 |
Название скидки |
3 |
Число 1.0 |
Тип скидки (1-скидка, 2-надбавка) |
4 |
Число 1.0 |
Вид скидки (1-процентная, 2-суммовая) |
5 |
Число 15.2 |
Размер скидки |
6 |
Строка 30 |
Текст для чека |
7 |
Строка 24 |
Префикс карты |
8 |
Число 1.0 |
Флаг применения на чек |
9 |
Число 1.0 |
Флаг применения на позицию |
10 |
Число 1.0 |
Флаг применения только по карте |
Для загрузки пользователей строка начинается со знака «&», а формат строки следующий:
№ поля |
Тип |
Назначение |
1 |
Число 2.0 |
Код пользователя |
2 |
Строка 17 |
Имя пользователя |
3 |
Число 5.0 |
Код набора прав |
4 |
Строка 24 |
Пароль пользователя |
Код набора прав: 0-администратор, 1-старший продавец, 2-продавец.
Формат файлов выгрузки операций и транзакций
Файл операций и файл транзакций имеют одинаковую структуру, но должны иметь разное имя.
Файл состоит из двух частей: шапки файла и непосредственно информации о продажах.
Шапка файла состоит из трех строк:
1. Первая строка — признак обработки данного файла товароучетной программой «#» (1 символ). После того, как файл будет обработан АСТУ, символ «#» должен быть заменен на «@» для возможности выгружать другие отчеты в файл с тем же именем.
2. Вторая строка содержит логический номер Системы.
3. Третья строка содержит порядковый номер отчета (пустое значение).
После шапки файла следует информация о товарах. Одна строка текстового файла содержит информацию об одной транзакции. Данные в строке разделяются «;».
Назначение первых семи полей фиксированное, а остальных зависит от типа транзакции и приводится в таблице ниже.
Название |
Тип |
Назначение полей |
8 |
9 |
10 |
11 |
12 |
Регистрация |
Регистрация |
11 (1) |
Код |
Секция (1) |
Цена |
Количество |
Цена * Количество |
Сторно |
12 |
Код |
Секция (1) |
Цена |
Количество |
Цена * Количество — Сумма скидки + Сумма надбавки |
Возврат |
13 |
Код |
Секция (1) |
Цена |
Количество |
Цена * Количество |
Итоговые скидки/надбавки на позицию |
Скидка суммой |
15 |
Код |
Секция (1) |
— |
Сумма скидки |
Сумма скидки |
Надбавка суммой |
16 |
Код |
Секция (1) |
— |
Сумма надбавки |
Сумма надбавки |
Скидка % |
17 |
Код |
Секция (1) |
— |
Процент скидки |
Сумма скидки |
Надбавка % |
18 |
Код |
Секция (1) |
— |
Процент скидки |
Сумма надбавки |
Ограничение скидки |
19 |
Код |
Секция (1) |
Сумма скидки без ограничения |
Процент скидки |
Сумма ограничения |
Детализация скидок/надбавок |
Детализация скидки на позицию |
70 |
Параметр скидки 1 |
Вид скидки |
Параметр скидки 2 |
Процент скидки |
Сумма скидки |
Детализация скидки на чек |
71 |
Параметр скидки 1 |
Вид скидки |
Параметр скидки 2 |
Параметр скидки 3 |
Сумма скидки |
Дополнительные |
Оплата |
40 |
Код платежн. карты |
0-фискальная;
1–не фискальная |
Сумма сдачи |
Номер вида оплаты |
Сумма оплаты |
Закрытие чека |
55 |
Штрихкод чека |
— |
— |
— |
Сумма чека |
Отмена чека |
56 |
— |
— |
— |
— |
Сумма чека |
Просмотр товара |
66 |
Код товара |
— |
— |
— |
— |
Возврат по номеру чека |
80 |
Дата чека продажи |
— |
Сумма чека продажи |
№ транзакции возвращаемого чека |
Номер возвращаемого чека |
Итоговые скидки/надбавки на чек |
Скидка суммой |
35 |
— |
— |
— |
Сумма скидки |
Сумма скидки |
Надбавка суммой |
36 |
— |
— |
— |
Сумма надбавки |
Сумма надбавки |
Скидка % |
37 |
— |
— |
— |
Процент скидки |
Сумма скидки |
Надбавка % |
38 |
— |
— |
— |
Процент надбавки |
Сумма надбавки |
Продавцы |
Авторизация |
155 |
Код кассира |
— |
— |
— |
— |
Расшифровка параметров:
(1) Вид скидки: 1 – фиксированная скидка, 3 – скидка по дисконтной карте;
(2) Параметр скидки 1 = код дисконтной карты в случае скидки по дисконтной карте;
(3) Параметр скидки 2 = сумма чека в случае скидки по дисконтной карте при скидке на чек в 71 транзакции.