Обмен через текстовые файлы по протоколу Штрих-М кассир.

Формат даты — ДД.ММ.ГГ
Формат времени — ЧЧ:ММ:СС
Разделитель целой и дробной части — «.»
Используемые обозначения:
«Строка 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 транзакции.