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

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