Инструкция по программированию ККТ Пирит 2Ф ФФД 1.2

Список изменений

Дата Изменение
24.03.2023 Реализация КИЗ меховых изделий осуществляется через команду 0x24
В команде 0х79 (валидация КМ через ГИС МТ) запрещена передача КИЗ (ТЕГ 1307)
Передача КИЗ меховых изделий в команду 79х01, 79х02 и 79х15 запрещена
08.02.2023 Добавлен раздел «Примеры для разработчиков». Добавлен тестовый проект примера интеграции на Java
01.12.2022 Откорректированы возвращаемые параметры команды 78
30.11.2022 Описаны ограничения по передаче КМ в команду 24 в ФФД 1.2
04.10.2022 Добавлен режим 2 в команду 79/1

Описание протокола

Формат протокола передачи команд

Связь контрольно-кассовой техники (далее ККТ) с компьютером осуществляется по интерфейсу RS232 или USB в режиме виртуального COM порта (при наличии модуля возможна работа по WiFi - настройка осуществляется командами 0x85/0x86). Параметры COM порта по умолчанию - 57600,n,8,1. Взаимодействие между кассовой программой (далее КП) инициируется со стороны КП: КП посылает командное сообщение (команду), а ККТ всегда посылает ответное сообщение (ответ). Взаимодействие КП с ККТ может осуществляться в двух режимах: синхронном и асинхронном. В синхронном режиме компьютер посылает команду и ждет ответ на него. После получения ответа компьютер посылает следующую команду. Взаимодействие в синхронном режиме может осуществляться без использования линий аппаратного квитирования (DTR/DSR, CTS/RTS). В асинхронном режиме компьютер посылает командные сообщения и принимает ответные сообщения в произвольной последовательности. Взаимодействие в этом режиме должно осуществляться с использованием линий аппаратного квитирования CTS/RTS. Взаимодействие ККТ с техническими средствами ОФД (далее ТС ОФД) осуществляется по протоколу TCP/IP. Инициатором отправки фискальных данных в ТС ОФД всегда выступает ККТ. Взаимодействие ККТ с ТС ОФД подробно изложено в описании протокола взаимодействия между ККТ и информационной (автоматизированной) системой оператора фискальных данных, введенной в действие ФНС России 01.04.2016

Пакет команды со стороны КП

1 2 3 4 5 6 7
STX Пароль связи ID пакета Код команды Данные ETX CRC

Пакет ответа со стороны КП

1 2 3 4 5 6 7
STX ID пакета Код команды Код ошибки Данные ETX CRC

Специальные команды.

Специальные команды протокола состоят из одного байта в двоичном формате, без заголовка, концовки и контрольной суммы.

1.2.1 Проверка связи с ККТ

Для проверки связи с ККТ существует специальная команда: 0x05 (ENQ) – проверка связи. Ответ состоит тоже из одного байта: 0x06 (ACK) – ККТ на связи. Если в момент проверки связи ККТ передает данные в ответ на другую команду, то ответ может быть получен только после завершения этой передачи.

1.2.3 Промотка бумаги

Для промотки бумаги в ККТ существует специальная команда: 0x0A (LF) – промотать бумагу на одну строку.

Времена ожидания

В протоколе обмена данными между ККТ и КП предусмотрены следующие времена ожидания: 1. Время ожидания приема между байтами пакета информации – 200 мс. По истечении данного промежутка времени возвращается код ошибки передачи. 2. Время ожидания ответа от ККТ - зависит от выполняемой ККТ в данный момент операции. Для принятия решения о неисправности ККТ (коммуникационного порта или кабеля передачи данных) необходимо использовать команду “Проверка связи с ККТ”. 3. Таймер ФН Период издания Клиентом ККТ события «Таймер ФН». Значение длительности таймера может находится в пределах от 0 секунд (непрерывный программный цикл) до 60 секунд. Длительность таймера – фиксированная и составляет 30 секунд. 4. Таймер С! В этом состоянии Клиент ККТ взводит таймер на ожидание повторной попытки установления соединения транспортного уровня (событие «Таймер С»). Период издания Клиентом ККТ события «Таймер С» устанавливается в диапазоне от 0 секунд (непрерывный программный цикл) до 3600 секунд. Длительность таймера составляет 60 секунд.

Основные типы передаваемых параметров

Строка

Любая последовательность символов, с кодами от 0x20 до 0xF0. Длина конкретной строки зависит от значения передаваемого параметра. Может иметь нулевую длину (пустая строка). Для печати символов на русском языке необходимо использовать кодировку CP866.

Дата

Строка длиной 6 символов вида «ddmmyy», где: dd - день месяца; mm - номер месяца в году; yy - последние две цифры года. Все числа передаются с точностью до 2-х цифр, если число меньше 10-ти, то добавляется старший ноль.

Дата8

Применяется в случаях, когда значение года может быть меньше 2000.

Строка длиной 8 символов вида «ddmmyyyy», где: dd - день месяца; mm - номер месяца в году; yyyy - год.

Время

Строка длиной 6 символов вида «hhmmss», где: hh - часы; mm - минуты; ss - секунды. Все числа передаются с точностью до 2-х цифр, если число меньше 10-ти, то добавляется старший ноль.

Целое число

Строка состоящая только из цифр, и представляющей собой целое число в десятеричной системе исчисления. Пустая строка интерпретируется как ноль. Используется для передачи номеров, индексов, битовых масок(полей) и т.д.

Дробное число

Строка состоящая из цифр, десятичной точки и знака «-». Пустая строка интерпретируется как ноль. Используется для передачи суммы, количества и процентных ставок. Рекомендуется передавать суммы с точностью 2 знака после десятичной точки (с точностью до копейки), процентные ставки с точностью до 4-х знаков после десятичной точки и количество до 9-ти знаков после десятичной точки.

Имя оператора (тег 1021 “Кассир” в соответствии с ФФД)

Строка размером 0...64 символа. Если необходимо передать ИНН оператора, то его следует передать первыми и отделить символом '&', например:

112233445566&Васильева О.Е.

Описание команд ККТ

Запрос флагов статуса ККТ (0x00)

Описание

Команда возвращает статус фатального состояния ККТ, статус текущих флагов ККТ и статус документа.

Входные параметры

Нет

Ответные параметры

Дополнительная информация

Статус фатального состояния ККТ

Номер бита Пояснение
0 Неверная контрольная сумма NVR
1 Неверная контрольная сумма в конфигурации
2 Нет связи с ФН
3 Зарезервировано
4 Зарезервировано
5 ККТ не авторизовано
6 Фатальная ошибка ФН
7 Зарезервировано

При установке любого бита статуса фатального состояния блокируются все функции ККТ, за исключением битов 6 и 7, при установке которых доступны команды закрытия смены.

Статус текущих флагов ККТ

Номер бита Пояснение
0 Не выполнена команда “Начало работы”
1 Нефискальный режим
2 Смена открыта
3 Смена больше 24 часов
4 Архив ФН закрыт
5 ФН не зарегистрирован
6 Зарезервировано
7 Зарезервировано
8 Не было завершено закрытие смены, необходимо повторить операцию

Статус документа

Номер бита Пояснение
0..3 Тип текущего открытого документа (см. ниже)
4..7 Состояние документа (см. ниже)

Тип текущего открытого документа

Значение Пояснение
0 документ закрыт
1 сервисный документ
2 чек на продажу (приход)
3 чек на возврат (возврат прихода)
4 внесение в кассу
5 инкассация
6 чек на покупку (расход)
7 чек на возврат покупки (возврат расхода)
9 чек корр. приход
10 чек корр. расход
11 чек корр. возврат прихода
12 чек корр. возврат расхода

Состояние документа

Значение Пояснение
0 документ закрыт
1 устанавливается после команды "открыть документ" (Для типов документа 2 и 3 можно добавлять товарные позиции)
2 Устанавливается после первой команды "Подытог"
3 Устанавливается после второй команды "Подытог" или после начала команды "Оплата" (Можно только производить оплату различными типами платежных средств)
4 Расчет завершен, требуется закрыть документ
8 Документ закрыт в ФН, но чек не допечатан. Аннулирование документа невозможно, необходимо еще раз выполнить команду закрытия документа

Запрос сменных счетчиков и регистров (0x01)

Описание

Эта команда позволяет получать различные значения сменных счетчиков и регистров ККТ.

Входные параметры

Ответные параметры

Номер запроса (DEC) Наименование Запроса Формат возвращаемых данных Комментарии
1 Вернуть номер текущей смены Целое число
2 Вернуть номер следующего чека Целое число Возвращается правильный номера чека только при автоматической нумерации чеков средствами самой ККТ.
3 Вернуть суммы продаж по типам платежа Дробное число * 16 Возвращается 16 значений – по максимально возможному количеству типов платежей
4 Вернуть количество оплат по продажам Целое число * 16
5 Вернуть суммы возвратов по типам платежа Дробное число * 16
6 Вернуть количество оплат по возвратам Целое число * 16
7 Вернуть количество оформленных чеков по типам операций Целое число *6 Возвращается 6 значений – количество чеков продажи, возврата, аннулированных, отложенных, чеков внесения и изъятия
8 Вернуть суммы по оформленным чекам Дробное число * 4 Возвращается 4 значения – суммы по аннулированным и отложенным чекам, чекам внесения и изъятия
9 Вернуть суммы по скидкам Дробное число * 4 Возвращает 4 значения - сумма скидок по продажам, 0, сумма скидок по возвратам, 0.
10 Вернуть суммы налогов по продажам Дробное число * 6
11 Вернуть суммы налогов по возвратам Дробное число *6
12 Вернуть данные по последнему X отчету или отчету о закрытии смены Строка, Целое число, Дробное число, Целое число, Дробное число, Целое число, Дробное число, Целое число, Дробное число, Целое число, Дробное число, Целое число, Дробное число текущий операционный счетчик, номер документа, сумма в кассе, кол-во продаж (кол-во приходов), сумма продаж (сумма приходов), кол-во возвратов (возвратов прихода), сумма возвратов (возвратов прихода), количество аннулированных, сумма аннулированных, количество внесений, сумма внесений, количество изъятий, сумма изъятий
13 Вернуть суммы по секциям/отделам по продажам Дробное число * 16 Возвращается 16 значений – по максимально возможному количеству секций/отделов
14 Вернуть суммы по секциям/отделам по возвратам Дробное число * 16 Возвращается 16 значений – по максимально возможному количеству секций/отделов
15 Вернуть количество оформленных чеков по типам операций Целое число, Целое число кол-во чеков покупок (расходов), кол-во чеков возвратов покупок (возвратов расхода)
16 Вернуть суммы покупок по типам платежа Дробное число * 16 Возвращается 16 значений – по максимально возможному количеству типов платежей.
17 Вернуть суммы возвратов покупок по типам платежа Дробное число * 16 Возвращается 16 значений – по максимально возможному количеству типов платежей.
18 Вернуть данные по коррекциям Целое число, Дробное число * 5 Количество коррекций, Суммы коррекций наличными, безналичными, авансом, кредитом, иной формой оплаты

Запрос сведений о ККТ (0x02)

Описание

Эта команда позволяет получать разнообразную информацию о ККТ.

Входные параметры

Ответные параметры

Номер запроса (DEC) Наименование Запроса Формат возвращаемых данных Комментарии
1 Вернуть заводской номер ККТ Строка
2 Вернуть идентификатор прошивки Целое число
3 Вернуть ИНН Строка
4 Вернуть регистрационный номер ККТ Строка
5 Вернуть дату и время последней фискальной операции Дата, Время
6 Вернуть дату регистрации / перерегистрации Дата
7 Вернуть сумму наличных в денежном ящике Дробное число
8 Вернуть номер следующего документа Целое число
9 Вернуть номер смены регистрации Целое число
10 Вернуть номер следующего X отчета Целое число
11 Вернуть текущий операционный счетчик Строка
12 Вернуть нарастающий итог Дробное число, Дробное число, Дробное число, Дробное число Продажа (приход), Возврат (возврат прихода), Покупка (расход), Возврат покупки (возврат расхода)
14 Вернуть дату окончания временного ресурса ФН Дата, Целое число Дата окончания, количество дней до окончания временного ресурса ФН
15 Вернуть тип прошивки Целое число 0 - стандартная прошивка, 1 - отладочный комплект
16 Вернуть размер бумаги текущего дизайна Целое число 0 - 80мм, 1 - 57мм
17 Вернуть дату и время открытия смены Дата, Время
21 Вернуть модель устройства Целое число 8 - Пирит 2Ф
23 Вернуть систему налогообложения и режим работы и ФН Целое число, Целое число, Целое число Система налогообложения, Режим работы, Дополнительный режим работы
24 Вернуть максимальное количество дополнительных строк в начале и в конце чека Целое число, Целое число Максимальное количество строк в начале чека, Максимальное количество строк в конце чека
70 Вернуть рабочий идентификатор прошивки Строка Формат x.y.z, где x,y,z - числа до 3х знаков

Запрос данных по чеку (0x03)

Описание

Эта команда позволяет получать данные по чеку.

Входные параметры

Ответные параметры

Номер запроса (DEC) Наименование Запроса Формат возвращаемых данных Комментарии
1 Вернуть счетчики текущего документа Дробное число * 3 Возвращается 3 значения - сумма чека, сумма скидки по чеку, 0
2 Вернуть данные по последнему закрытому чеку Целое число, Строка, Целое число, Целое число, Дробное число, Дробное число, Дробное число, Строка, Целое число тип чека (для аннулиров. = 0), текущий операц. счетчик, внутренний номер чека, внутренний номер документа, сумма чека, сумма скидки по чеку, 0, строка ФП (фиск. признак), Номер ФД

Запрос состояния печатающего устройства (ПУ) (0x04)

Описание

Эта команда позволяет получать состояние печатающего устройства.

Входные параметры

Нет

Ответные параметры

Дополнительная информация

Статус печатающего устройства

Номер бита Пояснение
0 Принтер не готов
1 В принтере нет бумаги
2 Открыта крышка принтера
3 Ошибка резчика принтера
7 Нет связи с принтером

Запрос сервисной информации (0x05)

Описание

Эта команда позволяет получать разнообразную сервисную информацию о ККТ.

Входные параметры

Ответные параметры

Номер запроса (DEC) Наименование Запроса Формат возвращаемых данных Комментарии
1 Вернуть напряжение питания (мВ) Целое число Возвращается значение в милливольтах
2 Вернуть температуру термоголовки Целое число Возвращается значение в градусах
3 Вернуть количество отрезов резчика Целое число
4 Вернуть ресурс термоголовки Целое число Возвращается значение в мм
5 Обнулить количество отрезов резчика -
6 Обнулить ресурс термоголовки -
7 Вернуть напряжение на батарейке (мВ) Целое число Возвращается значение в милливольтах (при падении ниже 2.5В будет напечатано предупреждение)
8 Вернуть количество отрезов резчика (необнуляемое) Целое число
9 Вернуть ресурс термоголовки (необнуляемый) Целое число Возвращается значение в мм

Запрос расширенной информации об ошибках (0x06)

Описание

Эта команда позволяет получать дополнительные данные по ошибкам ФН и ККТ.

Входные параметры

Ответные параметры

Номер запроса (DEC) Наименование Запроса Формат возвращаемых данных Комментарии
1 Вернуть расширенный код ошибки Целое число Возвращается код, указывающий на причину возникновения ошибки (01h) “Функция невыполнима при данном статусе ККТ”
2 Вернуть статус блокировок по ФН Целое число Возвращается битовая маска, значения бит указаны в соответствующей таблице

Дополнительная информация

Расширенный код ошибки (0x01)

Номер ошибки (DEC) Условия возникновения
0 Дополнительная информация об ошибке отсутствует
1 Не была вызвана функция “Начало работы”
2 Нефискальный режим
3 Архив ФН закрыт
4 ФН не зарегистрирован
5 ФН уже зарегистрирован
6 Передача кода товара не разрешена
7 Нет изменений для перерегистрации ФН
8 Документ не был открыт
9 Предыдущий документ не закрыт
11 Состояние документа не равно 1 (документ открыт, ввод позиций/печать текста)
12 Состояние документа не равно 1 или 2 (см. выше + была дана команда «Подытог»)
13 Состояние документа не равно 1 или 2 или 3 (см. выше + была дана вторая команда «Подытог» либо начата оплата)
14 Состояние документа не равно 4 (расчёт завершён)
15 Документ закрыт в ФН
16 Документ не является продажей (приходом) или возвратом (возвратом прихода)
17 Документ не является внесением или изъятием
18 Документ не является сервисным
19 Документ является сервисным
20 Смена не открыта
21 Фатальная ошибка ФН
22 ФН не в режиме получения документа для ОФД
23 Не задан адрес сайта ФНС
24 Не задано наименование ОФД
25 Не задан ИНН ОФД
26 Нулевой итог документа
27 Не задано место расчетов
28 Не задан номер автомата
29 Попытка добавить больше одного предмета расчета с признаком способа расчёта "Оплата кредита"
30 Не задан email отправителя чека
33 Не задано имя оператора
34 Есть неотправленные в ОФД документы
35 Допустима только одна скидка на чек
37 Неверный регистрационный номер
38 Невозможно изменить регистрационные данные
39 Дата/время переданы неверно
40 Неверный параметр "Тип документа"
41 Неверный параметр "Номер отдела"
42 Неверный параметр "Номер документа"
43 Неверный параметр "Система налогообложения"
44 Неверный параметр "Название товара"
45 Неверный параметр "Артикул"
46 Неверный параметр "Количество товара"
47 Неверный параметр "Цена товара"
48 Неверный параметр "Номер ставки налога"
49 Неверный параметр "Номер товарной позиции"
50 Неверный параметр "Номер секции"
51 Неверный параметр "Название скидки"
52 Неверный параметр "Сумма скидки"
53 Неверный параметр "Признак способа расчета"
54 Неверный параметр "Признак предмета расчета"
55 Неверный параметр "Тип платежа"
56 Неверный параметр "Сумма платежа"
57 Неверный параметр "Дополнительный текст"
58 Неверный параметр "Адрес покупателя"
59 Неверный параметр "Замена ФН"
60 Неверный параметр "ИНН пользователя"
61 Неверный параметр "Режим работы"
62 Автономный режим и шифрование
63 Неверная версия ФФД
64 Неверный признак агента
65 Неверный код активации
66 Неверный номер запроса
67 Неверный номер платной услуги
69 Введённый тип маркировки не поддерживается
70 У вас активирован универсальный ключ
71 Неверный параметр "Дополнительный реквизит чека"
72 Неверный параметр "Наименование дополнительного реквизита пользователя"
73 Неверный параметр "Значение дополнительного реквизита пользователя"
75 Неверный параметр "Тип коррекции"
76 Неверный параметр "Тип операции"
77 Неверный параметр "Номер документа основания коррекции"
78 Неверный параметр "Наименование основания коррекции"
79 Данные агента не соответствуют признаку агента
81 Неверный параметр "Код товара"
82 Превышено кол-во позиций с кодом товара
83 Параметр "Название товара" не соответствует параметру "Признак предмета расчета"
85 Неверный параметр "ИНН покупателя"
86 Неверный параметр "Покупатель"
88 Обновите прошивку ККТ для работы в режиме ФФД 1.2
89 Неверный параметр "Код страны происхождения товара"
90 Неверный параметр "Номер таможенной декларации"
91 Неверный параметр "Акциз"
93 Неверный параметр "Телефон"
94 Слишком большое изображение

Статус блокировок по ФН

Номер бита Пояснение
0 Зарезервировано
1 ФН не найден
2 Не был закрыт архив ФН
3 Ошибка теста архива ФН
4 Ошибка связи с ФН
5 Не завершена операция закрытия смены
6 Зарезервировано
7 ФН заполнен

Начало работы с ККТ (0x10)

Описание

Команда предназначена для инициализации ККТ и синхронизации времени между кассовой программой и ККТ. Команда должна быть обязательно подана перед началом работы на ККТ (в том числе, после подачи питания). Дата и время необходимы для проверки и синхронизации даты и времени работы КП и ККТ. Если разница между передаваемым временем в команде ”Начало работы” и внутренним текущем временем ККТ меньше 8 минут, то синхронизация времени в ККТ со временем в КП происходит автоматически, если разница больше – возвращается один из кодов ошибки 0x0B или 0x0С.

ККТ возвращает код ошибки 0x0B, в случае если передаваемые в команде ”Начало работы” дата и время отличаются от внутренних даты и времени ККТ более чем на 8 минут. Возврат от ККТ ошибки 0x0B свидетельствует о том, что команда “Начало работы” выполнена, ККТ инициализирована и готова продолжать работу по своему внутреннему времени. При получении кода ошибки 0x0B рекомендуется проверить время на управляющем компьютере, и, если оно соответствует местному времени в месте применения ККТ, произвести запись времени в ККТ, выполнив следующие действия: * закрыть смену (в случае если она открыта) * установить дату и время в ККТ соответствующей командой (0x14).

ККТ возвращает код ошибки 0x0С, в случае если передаваемая в команде ”Начало работы” дата меньше даты последней фискальной операции зарегистрированной в ККТ. Возврат от ККТ ошибки 0x0С свидетельствует о том, что команда “Начало работы” не выполнена, инициализация ККТ не произведена и работа ККТ заблокирована. При получении кода ошибки 0x0С рекомендуется проверить дату и время на управляющем компьютере и сравнить его с датой и временем последней фискальной операции. В случае если установлена неправильная дата на управляющем компьютере, ее необходимо исправить и затем повторно выполнить команду ”Начало работы”.

Входные параметры

Ответные параметры

Нет

Чтение таблицы настроек (0x11)

Описание

Команда содержит два параметра для адресации элемента Таблицы настроек ККТ, значение которого необходимо получить.

Входные параметры

Ответные параметры

Запись таблицы настроек (0x12)

Описание

Команда содержит три параметра: два параметра для адресации элемента Таблицы настроек ККТ, и новое значение элемента таблицы. Регистрационные данные менять нельзя. При записи "наименования пользователя" (1 и 2 строка) и "адреса расчетов" (1 и 2 строка) ошибки не будет, однако данные не изменятся.

Входные параметры

Ответные параметры

Нет

Чтение даты/времени ККТ (0x13)

Описание

Команда предназначена для получения значений даты и времени установленных во внутренних часах ККТ (внутреннее время ККТ).

Входные параметры

Нет

Ответные параметры

Запись даты/времени ККТ (0x14)

Описание

Команда предназначена для записи и установки новых значений времени и даты во внутренние часы ККТ. Команда выполняется только при закрытой смене. Вводимая дата не может быть более ранней, чем дата последней фискальной операции. Если новые значения времени/даты больше текущих, более чем на 24 часа, в ответе на данную команду возвращается ошибка 0x0A. Для установки таких значений времени и даты, после возврата ошибки 0x0A , команда должна подаваться повторно.

Входные параметры

Ответные параметры

Нет

Программировать логотип (0x15)

Описание

Команда предназначена для загрузки графического логотипа торгового предприятия во внутреннюю память память ККТ с автоматической печатью в зоне "препринта" по завершению предыдущего чека перед каждым следующим документом. Образ логотипа представляет собой монохромное изображение в формате BMP со специальным символом 0x1B в начале. Ширина изображения – 576 точек, высота – от 8 до 220 точек. Для бумаги шириной 57мм зона печати ограничена 400 точками справа, 176 точек слева должны быть без изображения(см. рис. 1).

Рисунок 1

Команда выполняется в два этапа. На первом передается количество байт в образе логотипа.

Если команда выполнена успешно, ККТ присылает байт с кодом 0x06 (ACK), что обозначает готовность ККТ к приему логотипа, либо стандартный ответ с кодом ошибки.

На втором этапе передается сам образ логотипа, после загрузки которого возвращается стандартный ответ с кодом ошибки.

Входные параметры

(Целое число) Количество байт

Ответные параметры

Нет

Удалить логотип (0x16)

Описание

Функция используется для удаления ранее загруженного логотипа.

Входные параметры

Нет

Ответные параметры

Нет

Загрузить дизайн чека (0x17)

Описание

Функция используется для загрузки файла дизайнов чека. Команда выполняется в два этапа. На первом передается количество байт в файле дизайнов. Если команда выполнена успешно, ККТ присылает байт с кодом 0x06 (ACK), что обозначает готовность ККТ к приему файла, либо стандартный ответ с кодом ошибки. На втором этапе передается сам файл, после загрузки которого возвращается стандартный ответ с кодом ошибки.

Входные параметры

(Целое число) Количество байт

Ответные параметры

Нет

Загрузить графическое изображение (0x18)

Описание

Максимальная ширина изображения при использовании бумаги шириной 80мм – 512 точек(64 мм). Максимальный размер – 22000 байт. Максимальная ширина изображения при использовании бумаги шириной 57мм – 336 точек точек(42 мм). 176 точек слева должны быть без изображения. Графика печатается прижатой к левому краю, вне зоны печати фискального логотипа. Если параметр смещение равен 0, картинка прижимается влево. Если параметр смещение равен 1, картинка выравнивается по центру. Если параметр смещение равен 2, картинка прижимается к правой границе зоны печати графики(512 точек).

Команда выполняется в два этапа. На первом передается параметры графики для печати. В ответ ККТ присылает байт с кодом 0x06 (ACK), что обозначает готовность ККТ к приему графического изображения, либо стандартный ответ с кодом ошибки. На втором этапе передается само графическое изображение, после печати которого возвращается стандартный ответ с кодом ошибки.

Входные параметры

Ответные параметры

Нет

Поиск графического изображения (0x19)

Описание

Функция используется поиска и проверки загруженного графического изображения в памяти устройства.

Входные параметры

Ответные параметры

Сформировать отчет без гашения (X-отчет) (0x20)

Описание

Сформировать отчет без гашения (X-отчет). Если касса зарегистрирована для использования в автоматическом режиме - имя оператора можно не передавать.

Входные параметры

Ответные параметры

Нет

Сформировать отчет о закрытии смены (0x21)

Описание

Сформировать отчет о закрытии смены. Если касса зарегистрирована для использования в автоматическом режиме - имя оператора можно не передавать.

Входные параметры

Ответные параметры

Нет

Открыть смену (0x23)

Описание

Открыть смену. Если касса зарегистрирована для использования в автоматическом режиме - имя оператора можно не передавать.

Входные параметры

Ответные параметры

Нет

Дополнительная информация

При регистрации в режиме ФФД 1.2 с признаком осуществления работы с маркированными товарами возможна задержка ответа на команду из-за процесса обновления ключей проверки в ФН (обновление обычно проводится раз в 15 дней).

Установить дополнительные реквизиты позиции (0x24)

Описание

Команда вызывается перед командой добавления товарной позиции (0x42) и устанавливает дополнительные реквизиты(тэги) для этой товарной позиции. Действие команды распространяется на одну товарную позицию в открытом документе.

Входные параметры

Ответные параметры

Дополнительная информация

В поля с телефонами допустимо передавать несколько телефонов, разделенных символом ','(запятая), без лишних пробелов. Каждый номер телефона должен начинаться с символа "+" и не должен превышать ограничение длины в 19 символов (включая "+").

Код товара (тег 1163)

Параметр предназначен для формирования тега 1163 “Код товара” при расчетах за товары, не подлежащих обязательной маркировке (товар не маркирован средством идентификации), но для которого законодательством РФ определена обязательность указания кода товара в кассовом чеке. КТ должен быть передан с символом ‘@’ перед кодом. Передаваемый код должен быть передан без предварительного разбора, в “сыром” виде. В случае наличия в коде управляющих символов (0x00..0x1F), указанные символы должны быть переданы в виде: $xy, где x и y – шестнадцатеричные цифры, например $1D соответствует значению 0x1D. В случае передачи некорректного значения параметра, документ будет сформирован, но код товара будет передан, как нераспознанный.

ВАЖНО!

Переданный в 0x24 команде код товара не проходит проверку в ФН, не добавляется в “Запрос кода маркировки” и в “Уведомление о реализации маркированного товара”. Передача кодов маркировки для товаров подлежащих обязательной маркировке в данной команде не допускается! При передаче в 0x24 команде кода маркировки, который распознается по правилам ФФД как значения тегов 1305 или 1306, ККТ заблокирует формирование фискального документа.

Исключением является тег 1307 КиЗ меховых изделий. Этот тег передается именно в этой команде.

Примечание

Для формирования ФД при продаже товаров, подлежащих обязательной маркировке, формирования “Запроса кода маркировки” и “Уведомления о реализации маркированного товара” используйте команды 0x79/1 – 0x79/15.

Признак агента по предмету расчета - битовая маска

Номер бита Пояснение
0 Банковский платежный агент
1 Банковский платежный субагент
2 Платежный агент
3 Платежный субагент
4 Поверенный
5 Комиссионер
6 Агент

Это поле должно быть передано при необходимости передачи каких-либо агентских реквизитов (1226, 1171, 1225 ...).

Внесение дополнительных реквизитов в отчеты(0x25)

Описание

Команда используется при добавлении дополнительных реквизитов в отчеты и вызывается ПЕРЕД вызовом соответствующей команды на формирование отчета. Команда допустима только при регистрации ККТ в режиме ФФД 1.2

Входные параметры

Ответные параметры

Нет

Дополнительная информация

Номер реквизита

Значение Пояснение
1 Доп. данные для отчета о регистрации
2 Доп. данные для отчета об открытии смены
3 Доп. данные для отчета о закрытии смены
4 Доп. данные для отчета о текущем состоянии расчетов
5 Доп. данные для отчета о закрытии ФН

Данные реквизита

Могут быть бинарными, передаваемые через $, как при передаче кода товара в команде 0x42

Открыть документ (0x30)

Описание

Эта команда открывает новый документ и переводит ККТ в режим формирования фискального документа. После успешного выполнения этой команды во внутренней переменной ККТ "Статус документа" устанавливается соответствующий тип (флаг) текущего документа. Этот статус можно получить выполнив команду “Запрос флагов статуса ККТ”.

Параметр, режим и тип документа представляет собой битовую маску, определяющую тип открываемого документа и режим его формирования. После успешного выполнения этой команды во внутренней переменной "статуса документа" устанавливается соответствующий тип текущего документа. Этот статус можно получить по команде “Запрос флагов статуса ККТ”.

Пакетный режим формирования документа является предпочтительным способом при применении на ККТ ФФД 1.2. При использовании данного режима, обработка КМ и вывод на печать информации в фискальном документе происходит быстрее.

В пакетном режиме формирования документа, при успешном выполнении команд с кодами 0x24, 0x40..0x49, 0x52, ответ на команду не посылается. Если какая-либо команда выполняется с ошибкой, то на команду, вызвавшую ошибку, возвращается стандартный ответ с кодом ошибки. Последующие команды формирования документа (с кодами 0x24, 0x40..0x49, 0x52) игнорируются, на каждую такую команду возвращается стандартный ответ с кодом ошибки "Функция невыполнима при данном статусе ККТ" до поступления команд “Завершить документ” или “Аннулировать документ”.

При возникновении ошибки в процессе формирования документа в пакетном режиме необходимо аннулировать документ и полностью сформировать документ заново, начиная с команды "Открыть документ".

Параметр "Номер документа" учитывается при установке бита в Таблице настроек ККТ "Нумерация чеков со стороны внешней программы" в значение "1". В других ситуациях параметр игнорируется. Если касса зарегистрирована для использования в автоматическом режиме - имя оператора можно не передавать. Если система налогообложения не передана, она будет выбрана по умолчанию (первая из зарегистрированных при формировании “Отчета о регистрации” ).

Входные параметры

Если адрес пользователя не передан, то в значение тэга 1009 подставляется значение, указанное при формировании “Отчета о регистрации”

Ответные параметры

Нет

Дополнительная информация

Режим и тип документа

Номер бита Пояснение
0..3 Тип открываемого документа. 1 - Сервисный документ, 2 - Чек на продажу (приход), 3 - Чек на возврат (возврат прихода), 4 - Внесение в кассу, 5 - Инкассация, 6 - Чек на покупку (расход), 7 - Чек на возврат покупки (возврат расхода)
4 0 - Обычный режим формирования документа, 1 - Пакетный режим формирования документа
5 0 - Обычный режим печати реквизитов, 1 - Режим отложенной печати реквизитов
7 0 - Обычный режим печати чека, 1 - Чек не печатается

Система налогообложения

Значение Пояснение
0 Общая
1 Упрощенная Доход
2 Упрощенная Доход минус Расход
3 Единый налог на вмененный доход
4 Единый сельскохозяйственный налог
5 Патентная система налогообложения

Передаваемая в параметрах система налогообложения должна быть ранее передана (зарегистрирована) в ККТ при формировании отчета о регистрации ККТ.

Завершить документ (0x31)

Описание

Команда завершения документа, открытого командой 0x30.

Если параметр Флаг отрезки = 1, отрезка сервисных документов по завершению не выполняется. Если параметр Флаг отрезки = 5, отрезка чеков продажи, покупки и возвратов по завершению не выполняется.

Номер фискального документа и фискальный признак возвращается ККТ только при завершении чеков продажи (приход), возврата (возврат прихода), покупки (расход) и возврат покупки (возврат расхода). При регистрации ККТ в режиме ФФД 1.2 № фискального документа и фискальный признак документа также возвращается при завершении формирования чеков коррекции на приход, возврат прихода, расход и возврат расхода. При формировании документа в пакетном режиме, команда “Завершить документ” выключает пакетный режим формирования документа.

Входные параметры

Ответные параметры

Дополнительная информация

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

Аннулировать документ (0x32)

Описание

Эта команда прерывает формирование текущего документа, данные удаляются из оперативной памяти ККТ и печатается сообщение об аннулировании.

Входные параметры

Нет

Ответные параметры

Нет

Отложить документ (0x33)

Описание

Работа команды аналогична команде “Аннулировать документ”, но подается в случаях, когда документ отменяется не навсегда, а будет обязательно повторно сформирован, в течении текущей смены. Данные документа удаляются из оперативной памяти ККТ и печатается причина отказа от чека, переданная во входных параметрах.

Используя параметры печати отчета о закрытии смены в Таблице настроек ККТ, можно настроить в "Отчете о закрытии смены” печать информации (сумма и количество) по отложенным за смену чекам. При этом, если команда "Отложить чек" выполняется без параметра (пустая строка), то итоговая сумма по отложенным чекам за смену фиксируется в ККТ и отображается в “Отчете о закрытии смены”, если с параметром – не фиксируются.

Входные параметры

Ответные параметры

Нет

Отрезать документ (0x34)

Описание

Эта команда выполняет принудительную отрезку документа с предпечатью заголовка следующего документа.

Входные параметры

Нет

Ответные параметры

Нет

Печать текста (0x40)

Описание

C помощью данной команды печатается текст внутри открытого сервисного документа.

Входные параметры

Ответные параметры

Нет

Дополнительная информация

Атрибуты текста – опциональный параметр, представляющий собой битовую маску.

Номер шрифта Пояснение
0 Шрифт 13х24, 44 символа в строке
1 Шрифт 10х20
2 Шрифт 13х24 жирный
3 Шрифт 10х20 жирный
4 Шрифт 8х14, 56 символов в строке
5 Шрифт 24х45
6 Шрифт 24х45 жирный (не используется, подменяется 24x45 нормальным)

Печатать штрих-код (0x41)

Описание

С помощью данной команды можно распечатать требуемый пользователю на печатной форме чека.

Входные параметры

Ответные параметры

Нет

Дополнительная информация

Опции вывода(для линейных кодов):

Значение Пояснение
0 не выводить
1 вывести наверху штрих-кода
2 вывести внизу
3 вывести наверху и внизу

Опции вывода (PDF417) - пропорции высоты/ширины ШК в процентах (по умолчанию 50%)

Ширина штрих-кода - значение задается в точках и может быть от 2 до 8.

Для UPC-A и EAN-13 максимальная ширина штрих-кода = 6, для остальных кодов зависит от длины параметра “Штрих-код”.

Высота штрих-кода - значение задается в точках и может принимать значения от 1 до 255 (только для линейных кодов).

Тип штрих-кода - Определяет, какой штрих-код будет напечатан. Длина и набор символов определяется типом штрих-кода:

Значение Пояснение
0 UPC-A
1 UPC-E
2 EAN-13
3 EAN-8
4 Code 39
5 Interleaved 2 of 5
6 Codabar
7 PDF417
8 QR CODE
9 Code 128 версии A

Штрих-код - строка содержащая штрих-код, причем контрольная сумма может и не указываться.

Добавить товарную позицию (0x42)

Описание

Эта команда может быть вызвана сразу после открытия чека и может повторяться любое количество раз внутри текущего документа для формирования всего списка товаров. Если позиция не может быть добавлена в ФН, на чеке после данных о позиции печатается строка “ОПЕРАЦИЯ ОТМЕНЕНА” и возвращается соответствующий код ошибки ФН.

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

Сумма позиции, получаемая в результате умножения цены на количество, округляется к ближайшему целому, т.е. часть менее 0.5 коп отбрасывается, 0.5 коп и более округляется до 1 коп.

Параметры ”Номер товарной позиции” и “Номер секции” не являются обязательными и могут отсутствовать. Если номер секции отсутствует (или равен нулю), учет ведется на номер отдела, указанный при открытии документа. Номер позиции - символьное поле, состоящее из цифр и символа разделителя, которым может быть пробел, двоеточие, тире и другие символы.

Входные параметры

Ответные параметры

Дополнительная информация

Название товара

При передаче пустого параметра будет использоваться наименование "Товар".

Количество товара в товарной позиции

Количество штучного товара в товарной позиции, маркированного средством идентификации, для которого в 0x79/15 был передан код маркировки (Datamatrix), должно равняться единице. При продаже мерного (не штучного) товара, маркированного средством идентификации, необходимо передавать фактический вес, объем единицы реализуемого товара. Для реализации функции частичного выбытия товаров подлежащих обязательной маркировке, допускается передача данных в формате n/m, где n - количество проданного товара (тег 1293), а m - количество товара в упаковке/партии (тег 1294), маркированной средством идентификации. При такой передаче m и n - целые положительные числа и n < m. При формировании ФД с частичным выбытием товара (дробным количеством маркированного товара - тег 1291) необходимо передавать цену за единицу части товара в упаковке/партии. ККТ автоматически сформирует значение реквизита «количество предмета расчета» (тег 1023), равное «1», для передачи в ОФД и сформирует печатную форму чека в соответствии с утвержденными ФФД.

Цена товара

По требованиям законодательства цена товара всегда должна передаваться с учётом всех скидок и наценок. При регистрации ККТ в режиме ФФД 1.2 и работе с маркированным товаром для реализации функции частичного выбытия маркированного товара, необходимо передать цену за единицу продаваемого товара. В этом случае, ККТ автоматически сформирует значение реквизита «цена за единицу предмета расчета с учетом скидок и наценок» (тег 1079) в соответствии со значением реквизита «дробная часть» (тег 1292) для передачи в ОФД и формирования печатной формы чека в соответствии с утвержденными ФФД.

Тип скидки/наценки

0 или пусто - нет скидки; 2 - скидка; 4 - наценка

Единица измерения

При работе в режиме ФФД 1.05 в поле указывается строка с названием единицы, которая передается, как тег 1197.

При работе в режиме ФФД 1.2 в поле указывается число с мерой количества предмета расчета, которая передается, как тег 2108. Разрешенные значения меры количества предмета расчета:

Значение Пояснение
0 шт.
10 г
11 кг
12 т
20 см
21 дм
22 м
30 кв. см
31 кв. дм
32 кв. м
40 мл
41 л
42 куб. м
50 кВт-ч
51 Гкал
70 сутки
71 час
72 мин
73 с
80 Кбайт
81 Мбайт
82 Гбайт
83 Тбайт

Значение 255 применяется при использовании иных единиц измерения, не поименованных в таблице.

Сумма скидки

Сумма скидки на товарную позицию является чисто информационным параметром и не влияет на итог чека (см. Цена товара). Пример: штучный товар стоит без скидки 10 рублей, со скидкой 7 рублей, покупатель приобретает этот товар в количестве 5 штук. В таком случае в цену товара нужно передать 7 рублей, количество - 5, в скидку - 15 рублей (3 рубля с одной штуки * 5 штук). Для печати скидки необходимо включить настройку "Печатать информацию о скидках" (см. Настройки ККТ).

Признак способа расчета:

Значение Пояснение
1 Предоплата 100%
2 Предоплата
3 Аванс
4 Полный расчет
5 Частичный расчет и кредит
6 Передача в кредит
7 Оплата кредита

Если параметр не передан, по умолчанию выбирается признак способа расчёта 4 (полный расчёт). Если признак способа расчёта равен 3 (аванс), то наименование товара может не передаваться.

Признак предмета расчета:

Значение реквизита Название товара содержит сведения
1 о реализуемом товаре, за исключением подакцизного товара (наименование и иные сведения, описывающие товар)
2 о реализуемом подакцизном товаре (наименование и иные сведения, описывающие товар)
3 о выполняемой работе (наименование и иные сведения, описывающие работу)
4 об оказываемой услуге (наименование и иные сведения, описывающие услугу)
5 о приеме ставок при осуществлении деятельности по проведению азартных игр
6 о выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению азартных игр
7 о приеме денежных средств при реализации лотерейных билетов, электронных лотерейных билетов, приеме лотерейных ставок при осуществлении деятельности по проведению лотерей
8 о выплате денежных средств в виде выигрыша при осуществлении деятельности по проведению лотерей
9 о предоставлении прав на использование результатов интеллектуальной деятельности или средств индивидуализации
10 об авансе, задатке, предоплате и кредите
11 о вознаграждении пользователя, являющегося платежным агентом (субагентом), банковским платежным агентом (субагентом), комиссионером, поверенным или иным агентом
12 о взносе в счет оплаты пени, штрафе, вознаграждении, бонусе и ином аналогичном предмете расчета
13 о предмете расчета, не относящемуся к предметам расчета, которым может быть присвоено значение от "1" до "11" и от "14" до "26"
14 о передаче имущественных прав
15 о внереализационном доходе
16 о суммах расходов, платежей и взносов, указанных в подпунктах 2 и 3 пункта 3.1 статьи 346.21 Налогового кодекса Российской Федерации, уменьшающих сумму налога
17 о суммах уплаченного торгового сбора
18 о курортном сборе
19 о залоге
20 о суммах произведенных расходов в соответствии со статьей 346.16 Налогового кодекса Российской Федерации, уменьшающих доход
21 о страховых взносах на обязательное пенсионное страхование, уплачиваемых ИП, не производящими выплаты и иные вознаграждения физическим лицам
22 о страховых взносах на обязательное пенсионное страхование, уплачиваемых организациями и ИП, производящими выплаты и иные вознаграждения физическим лицам
23 о страховых взносах на обязательное медицинское страхование, уплачиваемых ИП, не производящими выплаты и иные вознаграждения физическим лицам
24 о страховых взносах на обязательное медицинское страхование, уплачиваемые организациями и ИП, производящими выплаты и иные вознаграждения физическим лицам
25 о страховых взносах на обязательное социальное страхование на случай временной нетрудоспособности и в связи с материнством, на обязательное социальное страхование от несчастных случаев на производстве и профессиональных заболеваний
26 о приеме и выплате денежных средств при осуществлении деятельности казино с использованием обменных знаков казино, в зале игровых автоматов
27 о выдаче денежных средств банковским платежным агентом
30 о реализуемом подакцизном товаре, подлежащем маркировке средством идентификации, не имеющем кода маркировки
31 о реализуемом подакцизном товаре, подлежащем маркировке средством идентификации, имеющем код маркировки
32 о реализуемом товаре, подлежащем маркировке средством идентификации, не имеющем кода маркировки, за исключением подакцизного товара
33 о реализуемом товаре, подлежащем маркировке средством идентификации, имеющем код маркировки, за исключением подакцизного товара

Если параметр не передан, по умолчанию выбирается признак предмета расчёта 1 (товар).

Код страны происхождения товара

Трёхзначный цифровой код страны происхождения товара в соответствии с Общероссийским классификатором стран мира.

Сумма акциза

Сумма акциза с учетом копеек, включенная в стоимость предмета расчета. Реквизит включается в состав кассового чека (БСО) в случае, если предмет расчета признается объектом налогообложения акцизами (признак предмета расчёта 2) и расчет осуществляется с использованием наличных денежных средств и (или) с предъявлением электронных средств платежа.

Подытог (0x44)

Описание

Эта команда печатает промежуточный итог в чеке.

После повторной команды «Подытог», изменяется статус документа(на состояние оплаты). Далее можем прервать оформление чека командами «Отложить чек» и «Аннулировать чек», либо продолжить оформление документа, выполнив команду «Оплата» и команду «Завершить документ».

Входные параметры

Нет

Ответные параметры

Нет

Скидка на чек (0x45)

Описание

Данная команда позволяет устанавливать абсолютные скидки на весь чек. Команда может быть вызвана после первой команды “Подытог” только один раз, при этом необходимо помнить, что итоговая сумма после применения скидки не должна быть отрицательной. Доступен только один тип скидки: скидка на сумму (тип скидки = 1), при этом размер скидки не может превышать 99 копеек.

Входные параметры

Ответные параметры

Нет

Оплата (0x47)

Описание

С помощью этой команды производится регистрация расчета с покупателем, с указанием сумм и используемых при расчете типов оплаты. Команда может быть подана несколько раз. При выполнении первой поданной команды, ККТ автоматически распечатает итоговую сумму чека.

При передаче суммы наличными, больше итоговой суммы чека, ККТ самостоятельно рассчитывает сдачу и печатает на чеке. Сумма по безналичным типам платежа (с кодами от 1 до 15), не должна превышать итоговой суммы по чеку, в противном случае, команда “Оплата” выполнена не будет и ККТ вернет код ошибки.

Код типа платежа должен соответствовать одному из запрограммированных кодов типа платежа в Таблице настроек ККТ.

Входные параметры

Ответные параметры

Нет

Внесение / изъятие суммы (0x48)

Описание

Команда регистрирует в ККТ внесение или изъятие денежных сумм из денежного ящика. Команда может быть выполнена только после выполнения команды “Открыть документ”. Если производится внесение денежных сумм, тип документа должен быть 4, если изъятие - 5. При этом может быть напечатана информация о купюрах, которые были использованы при выполнении данной операции.

Входные параметры

Ответные параметры

Нет

Печать реквизита (0x49)

Описание

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

Код реквизита должен соответствовать одному из запрограммированных наименований реквизита в Таблице настроек ККТ. Если значение реквизита обеспечивает однозначное его толкование, его можно распечатать без предварительно запрограммированного наименования, с кодом реквизита равным нулю.

Значение реквизита может состоять из 4-х строк, при этом 1-я строка значения реквизита печатается непосредственно за наименованием реквизита в одну строку. Общая длина наименования и значения реквизита составляет не более 4-х строк.

Если значение реквизита состоит из одной строки и первым символом является символ '&', то перевод строки после печати данного реквизита не выполняется, можно на этой же строке начать печать следующего реквизита.

Входные параметры

Ответные параметры

Нет

Дополнительная информация

Атрибуты текста – опциональный параметр, представляющий собой битовую маску.

Номер шрифта Пояснение
0 Шрифт 13х24, 44 символа в строке
1 Шрифт 10х20
2 Шрифт 13х24 жирный
3 Шрифт 10х20 жирный
4 Шрифт 8х14, 56 символов в строке
5 Шрифт 24х45
6 Шрифт 24х45 жирный (не используется, подменяется 24х45 нормальным)

Зарегистрировать сумму по отделу (0x50)

Описание

Команда регистрирует сумму по указанному отделу. Эта команда может быть вызвана после любой команды при открытом документе. Для печати итоговых сумм по отделам на отчете о закрытии смены необходимо запрограммировать заголовок группы отделов в Таблице настроек ККТ.

Тип операции указывает, для какого типа операций регистрируется сумма по товарной группе: (0 – продажа, 1 – возврат)

Входные параметры

Ответные параметры

Нет

Сравнить сумму по чеку(0x52)

Описание

Команда сравнивает текущую сумму по чеку с переданной в параметре и возвращает ошибку “Некорректный формат или параметр команды”, если суммы не совпадают. Эта команда может быть вызвана после любой команды, если документ открыт. Команда позволяет сравнивать сумму по чеку между данными КП и данными ККТ.

Входные параметры

Ответные параметры

Нет

Открыть копию чека (0x53)

Описание

Эта команда открывает копию чека, как сервисный документ, с возможностью печати необходимых реквизитов оригинала чека. Реквизиты оригинала чека должны быть переданы во входных параметрах команды. Для формирования тела копии доступны команды: “Печать текста”, “Добавить товарную позицию”, “Подытог”, “Оплата”. При выполнении команды, ККТ автоматически напечатает текст “Копия чека” перед заголовком чека в печатной форме.

В случае передачи во входных параметрах команды номера ФД данные, печатаемые в подвале чека, будут браться из ФН (документ в ФН должен быть сформирован в текущей смене).

Если касса зарегистрирована для использования в автоматическом режиме - имя оператора можно не передавать.

Входные параметры

Ответные параметры

Нет

Дополнительная информация

Тип чека

Тип чека Пояснение
2 приход
3 возврат прихода
6 расход
7 возврат расхода

Система налогообложения

Значение Пояснение
0 Общая
1 Упрощенная Доход
2 Упрощенная Доход минус Расход
3 Единый налог на вмененный доход
4 Единый сельскохозяйственный налог
5 Патентная система налогообложения

Обнулить наличные в денежном ящике (0x54)

Описание

Команда обнуляет счетчик зарегистрированных ККТ наличных в денежном ящике.

Входные параметры

Нет

Ответные параметры

Нет

Печать графики в документе (0x55)

Описание

Максимальная ширина изображения при использовании бумаги шириной 80мм – 512 точек(64 мм). Максимальный размер – 20000 байт. Максимальная ширина изображения при использовании бумаги шириной 57мм – 336 точек точек(42 мм). 176 точек слева должны быть без изображения(как показано на рис. 1).

Графика печатается прижатой к левому краю зоны печати. Если параметр смещение равен 0, картинка прижимается влево. Если параметр смещение равен 1, картинка выравнивается по центру. Если параметр смещение равен 2, картинка прижимается к правой границе зоны печати графики(512 точек):

Рисунок 2

Команда выполняется в два этапа. На первом передается параметры графики для печати. В ответ ККТ присылает байт с кодом 0x06 (ACK), что обозначает готовность ККТ к приему графического изображения, либо стандартный ответ с кодом ошибки. На втором этапе передается само графическое изображение, после печати которого возвращается стандартный ответ на команду. Графика передается по горизонтали строка за строкой. Каждый бит в строке соответствует пикселю (1-черный, 0-белый). Число байт в строке - ширина картинки, деленная на 8. Если ширина картинки не кратна 8, добавляется еще 1 байт с остатками. И так по каждой строке.

Входные параметры

Ответные параметры

Нет

Печать загруженной картинки (0x56)

Описание

Команда используется для печати графических изображений, предварительно загруженных в память ККТ. Для предварительной загрузки изображений используется команда “Загрузить графическое изображение (0x18)”.

Если параметр смещение равен 0, изображение прижимается влево. Если параметр смещение равен 1, изображение выравнивается по центру. Если параметр смещение равен 2, изображение прижимается к правой границе зоны печати графических изображений (512 точек). Если параметр смещение равен 3 – используется значение смещения, заданное при загрузке графического изображения:

Рисунок 2

Входные параметры

Ответные параметры

Нет

Печать реквизита для ОФД (0x57)

Описание

Команда предназначена для печати и формирования в электронной форме дополнительных реквизиты кассового чека с последующей передачей оператору фискальных данных (ОФД), при открытом чеке. Код передаваемого в параметрах команды реквизита должен соответствовать кодам реквизитов определенных “Форматами фискальных данных”, утвержденных ФНС РФ. Если первым символом названия реквизита является символ '&', то перевод строки после печати данного реквизита не выполняется, можно на этой же строке начать печать следующего реквизита.

Если при установленном бите 6 из битовой маски Атрибутов шрифта первым символом значения реквизита является '#', то атрибут рассматривается, как целое число, иначе - как денежная сумма.

Входные параметры

Код Расшифровка
1192 Дополнительный реквизит чека (БСО) (до 16 символов)
1262 * Идентификатор ФОИВ (3 цифры)
1263 * Дата документа основания (ддммгггг)
1264 * Номер документа основания (до 32 символов)
1265 * Значение отраслевого реквизита (до 256 символов)
1271 ** Идентификатор операции (3 цифры)
1272 ** Данные операции (до 64 символов)
1273 ** Дата операции (ддммгг) или дата/время (ддммггччмм)

* - Тэги отраслевого реквизита (1261–1265, включаются в состав документа в случаях, установленных законодательством РФ и только при регистрации ККТ в режиме ФФД 1.2). ** - Тэги операционного реквизита (1270-1273, условия применения определяются ФНС РФ, включаются в состав документа только при регистрации ККТ в режиме ФФД 1.2).

Ответные параметры

Нет

Дополнительная информация

Атрибуты текста – опциональный параметр, представляющий собой битовую маску.

Номер шрифта Пояснение
0 Шрифт 13х24, 44 символа в строке
1 Шрифт 10х20
2 Шрифт 13х24 жирный
3 Шрифт 10х20 жирный
4 Шрифт 8х14, 56 символов в строке
5 Шрифт 24х45
6 Шрифт 24х45 жирный (не используется, подменяется 24х45 нормальным)

При установке бита “Признака агента” (тэг 1057) соответствующему признаку банковскому платежному агенту или субагенту необходимо передать реквизиты "Адрес оператора перевода" (1005), "ИНН оператора перевода" (1016), "Наименование оператора перевода" (1026), "Операция банковского платежного агента" (1044), "Телефон платежного агента" (1073), "Телефон оператора перевода" (1075) и "Телефон поставщика" (1171).

При установке бита “Признака агента” (тэг 1057) соответствующему признаку платежного агента или субагента необходимо передать реквизиты "Телефон платежного агента" (1073), "Телефон оператора по приему платежей" (1074) и "Телефон поставщика" (1171).

При передаче тэга 1057 (признак агента) необходимо обеспечить наличие в составе документа хотя бы 1 предмета расчета поля с тэгом 1226 (ИНН поставщика) - см. команду 0x24.

Открытие чека коррекции (0x58)

Описание

Команда предназначена для открытия чека коррекции. Дальнейшее формирование чека коррекции аналогично обычному чеку.

Входные параметры

Ответные параметры

Нет

Дополнительная информация

Имя оператора

Если ККТ зарегистрирована для использования в автоматическом режиме поле можно не передавать.

Тип коррекции

Номер бита Пояснение
0 0 - самостоятельная коррекция, 1 - коррекция по предписанию
1 0 - приход, 1 - расход
2..4 Система налогообложения (см. ниже)
5 Всегда 0
6 1 - возвратная операция (т.е. если бит 1 = 0, то возврат прихода, если бит 1 = 1, то возврат расхода)

Система налогообложения

Значение Пояснение
0 Общая
1 Упрощенная Доход
2 Упрощенная Доход минус Расход
3 Единый налог на вмененный доход
4 Единый сельскохозяйственный налог
5 Патентная система налогообложения

Формирование и печать отчета о текущем состоянии расчетов (0x59)

Описание

Команда формирует и печатает отчет из ФН о текущем состоянии расчетов. Если касса зарегистрирована для использования в автоматическом режиме - имя оператора можно не передавать. ФН версий до 1.34 не позволяет печатать отчет при открытой смене.

Входные параметры

Ответные параметры

Нет

Регистрация / перерегистрация (0x60)

Описание

При вводе ККТ в эксплуатацию данная команда сохраняет регистрационные данные в памяти ККТ, переводит ФН из "нефискального" режима в "фискальный" и формирует "Отчет о регистрации". При следующих после ввода в эксплуатацию случаях, команда используется для формировании “Отчета о перерегистрации” в связи с заменой ФН, а так же во всех случаях, когда необходимо внести изменения в параметры регистрации.

Если ККТ уже зарегистрирована, параметры "ИНН" и "регистрационный номер" игнорируются (используются сохраненные во внутренней памяти ККТ значения). Для изменения параметров "ИНН" и "регистрационный номер" сохраненных в ККТ, необходимо выполнить команду "Технологическое обнуление". Параметр “Номер автомата” игнорируется при регистрации ККТ без указания признака “Автоматический режим”. Параметры “Наименование ОФД”, “ИНН ОФД”, Аадрес электронной почты отправителя”, “Адрес сайта ФНС” игнорируются при регистрации ККТ с признаком “Автономный режим”.

Входные параметры

Ответные параметры

Дополнительная информация

Замена ФН

Значение Пояснение
0 Без замены ФН
1 С заменой ФН

Система налогообложения

Представляет собой битовую маску:

Номер бита Пояснение
0 Общая
1 Упрощенная Доход
2 Упрощенная Доход минус Расход
3 Единый налог на вмененный доход
4 Единый сельскохозяйственный налог
5 Патентная система налогообложения

Система налогообложения Единый налог на вмененный доход не используется с 01.01.2021 года.

Режим работы

Представляет собой битовую маску:

Номер бита Пояснение
0 Признак шифрования
1 Признак автономного режима
2 Признак автоматического режима
3 Признак расчетов только за услуги
4 Признак АС БСО (Формируем только БСО)
5 Признак ККТ для расчетов только в Интернет
6 Признак торговли подакцизными товарами
7 Признак проведения азартных игр
8 Признак банковского платежного агента
9 Признак банковского платежного субагента
10 Признак платежного агента
11 Признак платежного субагента
12 Признак поверенного
13 Признак комиссионера
14 Применение агентами
15 Признак проведения лотереи

Дополнительный режим работы

Представляет собой битовую маску:

Номер бита Пояснение
0 Устройство для печати находится вне корпуса ККТ
1 Признак торговли товарами подлежащими обязательной маркировке
2 Признак применения ККТ ломбардами
3 Признак применения ККТ в страховой деятельности

Версия ФФД представляет собой число. Если она равна 2, ККТ будет работать в режиме ФФД 1.05, если равна 4 - в режиме ФФД 1.2.

ИНН ОФД

Некоторые ФН блокируют передачу документов при неверном задании ИНН ОФД.

Технологическое обнуление (0x63)

Описание

Команда предназначена для стирания всей регистрационной информация из ККТ. Позволяет в дальнейшем зарегистрировать ККТ с другим регистрационным номером и ИНН.

Входные параметры

Ответные параметры

Нет

Установить итог чека (0x64)

Описание

Команда устанавливает сумму итога по чеку. Эта команда может быть вызвана для открытого документа до команды "оплата". Рублевая часть переданной суммы должна совпадать с рублевой частью итога, подсчитанного ККТ

Входные параметры

Ответные параметры

Нет

Печать QR-кода с текстом (0x66)

Описание

Команда предназначена для печати QR-кода вместе с двумя строками текста. Поддерживается, начиная с версии 565.1.20

Входные параметры

Ответные параметры

Нет

Дополнительная информация

Для перевода строк в параметрах "Строка 1" и "Строка 2" следует использовать символ '|'

Ширина штрих-кода

Значение задается в точках и может быть от 2 до 8.

Атрибуты текста

Опциональный параметр, представляющий собой битовую маску.

Номер шрифта Пояснение
0 Шрифт 13х24, 44 символа в строке
1 Шрифт 10х20
2 Шрифт 13х24 жирный
3 Шрифт 10х20 жирный
4 Шрифт 8х14, 56 символов в строке
5 Шрифт 24х45
6 Шрифт 24х45 жирный (не используется, подменяется 24х45 нормальным)

Печать изображения в формате PNG (0x67)

Описание

Команда предназначена для печати графической информации записанной в формате *.png файлов. Размеры изображения в ширину не более 512 точек для 80 бумаги и 336 точек для 57 бумаги. Произведение ширины на высоту не более 75000. Ширина изображения должна быть кратной 8. Цветовая палитра только типов 0 (Grayscale) и 3 (Indexed). Изображение должно быть сконвертировано из монохромного bmp-файла.

Входные параметры

Если параметр смещение равен 0, изображение прижимается влево. Если параметр смещение равен 1, изображение выравнивается по центру. Если параметр смещение равен 2, изображение прижимается к правой границе зоны печати графики (512 точек):

Рисунок 2

В ответ на команду ККТ возвращает байт с кодом 0x06 (ACK), что означает готовность ККТ к приему графического изображения, либо возвращает стандартный ответ с кодом ошибки.

Ответные параметры

Нет

Закрытие ФН (0x71)

Описание

Команда предназначена для закрытия ФН. Работа ККТ будет заблокирована. Используется для выполнения процедуры замены ФН. Без выполнения команды закрытия ФН замена ФН на новый не возможна. Для закрытия ФН, количество не переданных документов ОФД должно быть равно нулю.

Входные параметры

Ответные параметры

Распечатать документ из ФН (0x73)

Описание

Команда распечатывает документ из ФН. Если номер документа 0, то печатается список всех регистраций/перерегистраций. Если установлен младший бит флагов, то документ не отрезается.

Входные параметры

Ответные параметры

Нет

Обмен информацией с ФН (0x78)

Описание

Функция позволяет обмениваться информацией с ФН

Входные параметры

Ответные параметры

Дополнительная информация

Номер запроса (DEC) Наименование Запроса Формат возвращаемых данных Комментарии
1 Вернуть регистрационный номер ФН Строка
2 Вернуть статус ФН Целое число, Целое число, Целое число Состояние ФН (см. таблицу 1), Состояние текущего документа (см. таблицу 3), Флаги предупреждения (см. таблицу 4)
3 Вернуть номер последнего фискального документа Строка
4 Вернуть дату и время регистрации Дата, Время
5 Вернуть номер ФД последней регистрации Целое число
6 Вернуть состояние текущей смены Целое число, Целое число, Целое число Номер смены: 1 - смена открыта, 0 – смена закрыта, Номер чека в смене
7 Вернуть состояние обмена с ОФД Целое число, Целое число, Целое число, Дата, Время Статус обмена (см. таблицу 5), Количество документов для передачи в ОФД, Номер первого документа для передачи в ОФД, Дата/время первого док-та для передачи в ОФД
11 Запрос документа из архива Целое число, Массив HEX 1 - Если получена квитанция, Возвращается блок данных документа в шестнадцатеричном виде
12 Запрос квитанции о получении документа из архива Массив HEX Возвращается блок данных квитанции в шестнадцатеричном виде
13 Запрос последних ошибок ФН Массив HEX Возвращается блок данных в шестнадцатеричном виде
14 Запрос версии ФН и версии ФФД Строка, Число, Число, Строка, Число Версия прошивки ФН, Версия ФН (0 - отладочный ФН, 1 - серийный ФН) Версия ФФД (1209), Версия ККТ (1188), Версия ФФД ККТ (1189)
15 Запрос документа из архива в формате TLV Целое число, Целое число Тип документа, Размер данных документа
16 Запрос данных TLV Массив HEX Возвращается блок данных TLV в шестнадцатеричном виде. Номер документа задается запросом 15.
17 Запрос номера ФД начала смены Число
19 Запрос данных последней регистрации/перерегистрации Целое число, Целое число, Дата, Время ФД, ФП, Дата документа, Время документа
20 Запрос данных регистрации в формате TLV Целое число Номер регистрации; Возвращается тип регистрации: 1- регистрация, 11-перерегистрация
21 Запрос данных регистрации в TLV Массив HEX Возвращается блок данных TLV регистрации в шестнадцатеричном виде. Номер регистрации задается запросом 20.
22 Вернуть версию ФФД ФН Целое число, Целое число Текущая версия ФФД, Максимальная поддерживаемая версия ФФД (если 2, то ФФД 1.05, если 4 - ФФД 1.2)
23 Вернуть счетчики из ФН см. примечание 1 см. примечание 1

Состояние ФН

Номер бита Пояснение
0..3 Фаза жизни ФН (см. таблицу ниже)
4 Данные документа: 0 - нет данных документа, 1 - получены данные документа
5 Состояние смены: 0 - смены закрыта, 1 - смена открыта

Фаза жизни ФН

Бит 3 Бит 2 Бит 1 Бит 0 Фаза
0 0 0 0 0 - Настройка
0 0 0 1 1 - Готовность к фискализации
0 0 1 1 3 - Фискальный режим
0 1 1 1 7 - Постфиксальный режим. Идет передача ФД в ОФД
1 1 1 1 15 - Чтение данных из архива ФН

Тип открытого документа

Тип Значение
0x00 Нет открытого документа
0x01 Отчёт о регистрации ККТ
0x02 Отчёт об открытии смены
0x04 Кассовый чек
0x08 Отчёт о закрытии смены
0x10 Отчёт о закрытии фискального режима
0x11 Бланк строкой отчетности (БСО)
0x12 Отчет об изменении параметров регистрации ККТ в связи с заменой ФН
0x13 Отчет об изменении параметров регистрации ККТ
0x14 Кассовый чек коррекции
0x15 БСО коррекции
0x17 Отчет о текущем состоянии расчетов

Флаги предупреждения. Регистр представляет собой битовую маску

Бит Значение
0 Срочная замена КС (до окончания срока действия 3 дня)
1 Исчерпание ресурса КС (до окончания срока действия 30 дней)
2 Переполнение памяти ФН (Архив ФН заполнен на 90 %)
3 Превышено время ожидания ответа ОФД
4 нет
5 нет
6 нет
7 Критическая ошибка ФН

Статус обмена

Бит Значение (0 - нет, 1 - да)
0 Транспортное соединение установлено
1 Есть сообщение для передачи в ОФД
2 Ожидание ответного сообщения (квитанции) от ОФД
3 Есть команда от ОФД
4 Изменились настройки соединения с ОФД
5 Ожидание ответа на команду от ОФД
6 Начато чтение сообщения для ОФД

* Примечание 1 *

Входные параметры:

Возвращаемые данные:

Команда для работы с кодом маркировки(КМ) (0x79)

Команда предназначена для обработки кодов маркировки товаров, подлежащих обязательной маркировке средствами идентификации. Команда используется для формирования документов “Запрос о коде маркировки” и “ Уведомление о реализации маркированного товара”, получения статусов КМ, находящихся в обработке, режимов обработки и иной необходимой информации для соблюдения законодательства при продаже товаров подлежащих обязательной маркировке. Команда позволяет проверять достоверность КМ в ФН. Команда доступна только при регистрации ККТ в режиме ФФД 1.2 с ФН, поддерживающем ФФД 1.2

Процесс обработки товара содержащего КМ схематично показан на рисунке: Рисунок 3

Запрос статуса обработки кода маркировки (0x79 запрос 0)

Описание

С помощью этой команды можно получить статус обработки КМ по данным в ФН.

Входные параметры

Ответные параметры

Дополнительная информация

Состояние по проверке КМ

Значение Пояснение
0 Работа с КМ временно заблокирована
1 Нет КМ на проверке
2 Передан КМ
3 Сформирован запрос о статусе КМ
4 Получен ответ на запрос о статусе КМ

Состояние по формированию уведомления

Значение Пояснение
0 Уведомление о реализации не формируется
1 Начато формирование уведомления о реализации

Передача КМ в ФН для проверки достоверности КМ (0x79 запрос 1)

Описание

С помощью этой команды КМ проверяется в ФН и ОИСМ.

Важно

Передача кода маркировки меховых изделий запрещен. Используйте команду 0x24.

Входные параметры

Ответные параметры

Дополнительная информация

При работе ККТ в режиме передачи данных, ККТ отправляет запрос на проверку КМ на сервер ОИСМ через ОФД и в течение 3 сек ожидает ответа от сервера. При получении ответа на запрос, ККТ сформирует тэги 2005, 2105 и 2109 на основании значений в ответе ОИСМ. Если в течение 3 сек ККТ не поучит ответ на запрос, ККТ автоматически сформирует тэги 2005, 2105 и 2109 с пустыми значениями.

Код маркировки

КМ (или код товара для определенных законодательством случаях) должен быть передан без предварительного разбора, в “сыром” виде. Управляющие символы (0x00..0x1F) содержащиеся в КМ должны быть переданы в виде: $xy, где x и y – шестнадцатиричные цифры, например $1D соответствует значению 0x1D

Количество товара

Если мера количества (тег 2108) = 0 (штучный товар) допускается передача данных в формате n/m, где n - количество проданного товара (тег 1293), а m - количество товара в упаковке/партии (тег 1294), при такой передаче m и n - целые положительные числа и n < m) Применяется для реализации процесса частичного вывода товара, подлежащего обязательной маркировке, из оборота, при реализации конечным потребителям.

Режим работы

Значение Пояснение
0 Стандартный режим
1 Все равно проверять КМ в ИСМ, даже если ФН проверил код с отрицательным результатом
2 ** Не проверять КМ в ИСМ (если для товарной группы в постановлении правительства РФ прописана возможность объемно-сортового учета при осуществлении расчетов между организациями и (или) индивидуальными предпринимателями с использованием наличных денег и (или) с предъявлением электронных средств платежа)

** - Реализован, начиная с версий 565.1.20 и 665.4.20

Причина того, что КМ не проверен в ФН

Значение Пояснение
0 КМ проверен в ФН
1 КМ данного типа не подлежит проверке в ФН
2 ФН не содержит ключ проверки кода проверки этого КМ
3 Проверка невозможна, так как отсутствуют теги 91 и/или 92 или их формат неверный
4 Внутренняя ошибка в ФН при проверке этого КМ

Принятие КМ для включения в документ (0x79 запрос 2)

Описание

Команда предназначена для сохранения КМ в ФН для последующего включения КМ в состав реквизита предмет расчета товара, подлежащего обязательной маркировке.

Важно

Передача кода маркировки меховых изделий запрещен. Используйте команду 0x24.

Входные параметры

Ответные параметры

Дополнительная информация

Режим работы

Значение Пояснение
0 Исключение этого КМ из документа
1 Принятие КМ для включение в документ

При исключении КМ из документа, указанный КМ удаляется из ФН и не подлежит включению в фискальный документ.

Удаление сохраненных КМ в ФН (0x79 запрос 3)

Описание

Команда предназначена для удаления всех сохраненных КМ в ФН, подлежащих включению в “Уведомление о реализации маркированного товара”. В обычном режиме работы сохраненные в ФН КМ очищаются автоматически при закрытии фискального документа (кассового чека). На некоторых ФН команда может быть выполнена только при закрытом документе.

Если необходимо удалить из буфера ранее записанный одиночный КМ, его необходимо сначала проверить еще раз командой 0x79/1 и после проверки удалить командой 0x79/2.

Входные параметры

Нет

Ответные параметры

Нет

Запрос состояния передачи уведомлений о реализации маркированного товара (0x79 запрос 6)

Входные параметры

Ответные параметры

Дополнительная информация

Состояние передачи уведомлений

Значение Пояснение
0 Нет активного обмена
1 Начато чтение уведомления
2 Ожидание квитанции на уведомление

Запрос длины уведомления о реализации маркированного товара (0x79 запрос 7)

Входные параметры

Ответные параметры

Запрос блока уведомления о реализации маркированного товара (0x79 запрос 8)

Команда используется для получения данных сформированного ФН-ом уведомления о реализации маркированного товара из ФН.

Входные параметры

Ответные параметры

Окончание чтения уведомления о реализации маркированного товара (0x79 запрос 9)

Входные параметры

Ответные параметры

Дополнительная информация

Режим

Значение Пояснение
0 Прервать чтение
1 Закончить чтение

Передача квитанции от ОИСМ на отправленное уведомление о реализации маркированного товара (0x79 запрос 10)

Команда предназначена для записи квитанции в ФН.

Входные параметры

Ответные параметры

Дополнительная информация

Результаты обработки уведомления

Значение Пояснение
0 Проверка всех КМ положительна
1 Хотя бы один КМ отрицателен

При получении ошибки 0x60 в ответе на команду (0x79 запрос 10), в поле возвращается значение “Код обработки уведомления”.

Коды обработки уведомления

Значение Пояснение
0 Уведомление принято и обработано успешно
1 Некорректное уведомление

Запрос на выгрузку уведомлений о реализации маркированного товара при работе ККТ в автономном режиме (0x79 запрос 11)

Входные параметры

Ответные параметры

Дополнительная информация

Дополнительный код

Значение Пояснение
0 Выдать текущее состояние сессии выгрузки
1 Начать сессию выгрузки и выдать текущее состояние выгрузки

Запрос длины очередного уведомления о реализации маркированного товара при работе ККТ в автономном режиме (0x79 запрос 12)

Входные параметры

Ответные параметры

Дополнительная информация

Дополнительный код

Значение Пояснение
0 Получить параметры текущего уведомления
1 Перейти к выгрузке следующего уведомления и получить его параметры

Запрос очередного уведомления о реализации маркированного товара при работе ККТ в автономном режиме (0x79 запрос 13)

Входные параметры

Ответные параметры

Подтверждение выгрузки очередного уведомления о реализации маркированного товара при работе ККТ (0x79 запрос 14)

Входные параметры

Ответные параметры

Дополнительная информация

Дополнительный код

Значение Пояснение
0 Получить информацию по не подтвержденным уведомлениям
1 Подтвердить выгрузку уведомления

Передача КМ для включения в кассовый чек (0x79 запрос 15)

Важно

Передача кода маркировки меховых изделий запрещен. Используйте команду 0x24.

Входные параметры

Ответные параметры

Дополнительная информация

Значения параметров 'Код маркировки' и 'Мера количества' должны совпадать со значениями переданными в команде (0x79 запрос 1), при этом ККТ автоматически сформирует значение тэга 1163 "Код товара".

Запрос необходимости проверки КМ в ФН и ОИСМ (0x79 запрос 16)

Входные параметры

Ответные параметры

Запрос состояния ключей в ФН (0x79 запрос 52)

Команда может не поддерживаться ФН.

Входные параметры

Ответные параметры

Номер подзапроса

Значение Пояснение
0 Проверить необходимость обновления ключей (если возвращается не 0 - нужно обновить ключи)
1 Запросить URL сервера обновления ключей

Открыть денежный ящик (0x80)

Описание

Команда позволяет открыть денежный ящик, подключенный к ККТ.

Входные параметры

Ответные параметры

Нет

Получить статус денежного ящика (0x81)

Описание

Получить статус денежного ящика. 0 - закрыт, 1 - открыт.

Входные параметры

Нет

Ответные параметры

Подать звуковой сигнал (0x82)

Описание

Команда подает звуковой сигнал заданной длительности.

Входные параметры

Ответные параметры

Нет

Получить размер QR-кода (0x88)

Описание

Команда предназначена для получения размера QR-кода в точках. Поддерживается, начиная с версии 565.1.20

Входные параметры

Ответные параметры

Чтение блока памяти ККТ (0x91)

Описание

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

Тип данных определяет, из какой области нужно передать данные. Возможные значения - от 1 до 6.

Входные параметры

Ответные параметры

Установить скорость обмена (0x93)

Описание

Команда позволяет изменить скорость обмена между кассовой программой и ККТ по последовательному интерфейсу (COM-порт и USB).

Входные параметры

Ответные параметры

Нет

Дополнительная информация

Скорость обмена

Значение параметра Значение скорости
0 4800
1 9600
2 19200
3 38400
4 57600
5 115200

Распечатать сервисные данные (0x94)

Описание

Эта команда печатает на чеке данные по текущим настройкам, состоянию и дополнительной сервисной информации.

Входные параметры

Нет

Ответные параметры

Нет

Аварийное закрытие смены (0xA0)

Описание

Команда предназначена для формирования “Отчета о закрытии смены” в случае неисправности ФН. Результатом является “Отчет о закрытии смены”, далее для продолжения работы необходимо заменить ФН.

Входные параметры

Нет

Ответные параметры

Нет

Печать копии последнего “Отчета о закрытии смены” (0xA1)

Описание

Команда предназначена для печати копии последнего “Отчета о закрытии смены” из внутренней памяти ККТ.

Входные параметры

Нет

Ответные параметры

Нет

Печать копии “Отчета о регистрации/перерегистрации” (0xA3)

Описание

Эта команда позволяет распечатать копию чека регистрации, для проверки со стороны контролирующих органов.

Входные параметры

Нет

Ответные параметры

Нет

Аварийное закрытие ФН (0xA4)

Описание

Эта команда позволяет привести ККТ в состояние, пригодное для перерегистрации с заменой ФН, в случае если ФН вышел из строя и нет возможности выполнить команду “Закрытие архива ФН (0x71)”. Перед выполнением команды необходимо закрыть смену с помощью команды “Аварийное закрытие смены (0xA0)”.

Входные параметры

Нет

Ответные параметры

Нет

Отправить данные для отчёта cash_info в Кабинет (0xA6)

Описание

Эта команда отправляет данные, необходимые для формирования отчёта cash_info в Кабинет.

Входные параметры

Нет

Ответные параметры

Отправить данные для отчёта register в Кабинет(0xA7)

Описание

Эта команда отпраляет данные, необходимые для формирования отчёта register в Кабинет.

Входные параметры

Нет

Ответные параметры

Установить флаг наличия признака регистрации ККТ в Кабинете(0xA8)

Описание

Эта команда позволяет установить флаг наличия признака регистрации ККТ в Кабинете (ККТ зарегистрирован/не зарегистрирован)

Входные параметры

Ответные параметры

Нет

Считать флаг наличия признака регистрации ККТ в Кабинете(0xA9)

Описание

Эта команда позволяет считать флаг наличия признака регистрации ККТ в Кабинете (ККТ зарегистрирован/не зарегистрирован)

Входные параметры

Нет

Ответные параметры

Настройки ККТ

1 - Параметры ПУ (битовая маска)

Номер бита Пояснение
0 0 - нормальный режим печати, 1 - печать с уменьшенным межстрочным интервалом
1 0 - частичная отрезка чека, 1 - полная отрезка чека
2 0 - не печатать графический логотип, 1 - печатать графический логотип (логотип должен быть предварительно загружен в ПУ)
5 0 - не печатать QR на чеке, 1 - печатать QR код на чеке (неотключаемая настройка, всегда 1)
6 0 - не печатать отделы на чеках(*), 1 - печатать отделы на чеках
7 0 - печатать документы на чековой ленте(*), 1 - не печатать документы на чековой ленте

2 - Параметры чека (битовая маска)

Номер бита Пояснение
0..4 бит Номер дизайна чека: 0 - стандартный, 1 - расширенный, 2 - экономный, 3 - нано, 4 - расширенный для бумаги 57мм, экономный для бумаги 57мм, 16 и выше - дополнительные загружаемые дизайны
6 0 - печатать наличные в ДЯ на чеках внесения/инкассации, 1 - не печатать наличные в ДЯ на чеках внесения/инкассации
7 0 - нумерация чеков ККТ, 1 - нумерация чеков внешней программой

3 - Параметры отчета о закрытии смены (битовая маска)

Номер бита Пояснение
0 0 - не печатать сумму нарастающего итога на начало смены, 1 - печатать сумму нарастающего итога на начало смены
1 0 - не печатать суммы нарастающего итога, 1 - печатать суммы нарастающего итога
2 0 - не печатать информацию об отложенных чеках, 1 - печатать информацию об отложенных чеках
3 0 - не печатать информацию о скидках, 1 - печатать информацию о скидках
4 0 - Не печатать информацию об операциях с денежным ящиком, 1 - Печатать информацию об операциях с денежным ящиком (строки: "НА НАЧАЛО В КАССЕ", "СУММА В КАССЕ", "ВНЕСЕНИЕ", "ИЗЪЯТИЕ")
5 0 - печатать информацию по неиспользованным за смену платежным средствам, 1 - Не печатать информацию по неиспользованным за смену платежным средствам
6 0 - Не печатать дату и время начала смены, 1 - Печатать дату и время начала смены
7 0 - не печатать секции на отчете, 1 - Печатать секции на отчете

4 - Управление внешними устройствами (битовая маска)

Номер бита Пояснение
0 0 - Денежный ящик открывает внешняя программа, 1 - Денежный ящик открывает ККТ при работе с наличными
1 0 - Скидка/наценка в позициях - меняет стоимость, 1 - Скидка/наценка в позициях - только информационная
2 Начиная с версии 565.0.1: 0 - Ведение стандартных нарастающих итогов, 1 - Ведение расширенных нарастающих итогов
5 Начиная с версии 665.4.11 и 565.1.11: 0 - Печатаются теги 2106 и 2115, 1 - Не печатаются теги 2106 и 2115
6 Начиная с версии 665.4.12 и 565.1.12: 0 - В позициях с частичным выбытием передается цена единицы, 1 - передается общая стоимость

5 - Управление расчетами (битовая маска)

Номер бита Пояснение
0 0 - Включен контроль наличных в денежном ящике, 1 - Контроль наличных в денежном ящике отключен. При этом сумма в денежном ящике может быть отрицательной
1 0 - Учитывать чеки, аннулированные при включении питания, 1 - не Учитывать чеки, аннулированные при включении питания
2 0 - Автоматическая инкассация выключена, 1 - Автоматическая инкассация включена. При этом перед печатью отчета о закрытии смены печатается чек инкассации на всю сумму наличных в денежном ящике
3 0 - Счетчики покупок(расходов) выключены, 1 - Счетчики покупок(расходов) включены
4 0 - Автоматическая печать СКЛ выключена, 1 - Автоматическая печать СКЛ включена. При этом перед печатью отчета о закрытии смены печатается СКЛ за текущую смену
5 0 - СКЛ отключена, 1 - СКЛ включена. Внимание, после включения СКЛ, требуется перезагрузка и в случае использования не новой SD карты ее очистка
6 0 - Печать суммы нарастающего итога продаж(приходов)/покупок(расходов) на X-отчетах и отчетах о закрытии смены отключена, 1 - Печать суммы нарастающего итога продаж(приходов)/покупок(расходов) на X-отчетах и отчетах о закрытии смены включена.
7 0 - Печать суммы нарастающего итога возвратов (прихода и расхода) на X-отчетах и отчетах о закрытии смены отключена, 1 - Печать суммы нарастающего итога возвратов (прихода и расхода) на X-отчетах и отчетах о закрытии смены х включена

6 - Управление расчетами и печатью налогов (битовая маска)

Номер бита Пояснение
0 0 - Не печатать налоги на отчетах 1 - Печатать налоги на отчетах
1 0 - Не печатать налоги на чеках, 1 - Печатать налоги на чеках
2 0 - Не печатать нулевые налоговые суммы на отчетах, 1 - Печатать нулевые налоговые суммы на отчетах
3 0 - Округлять сумму налога после каждой позиции, 1 - Округлять сумму налога только после ввода всех позиций и скидок
6 0 - Не начислять НДС к стоимости товарной позиции для ставок НДС 20% и НДС 10%, 1 - Начислять НДС к стоимости товарной позиции для ставок НДС 20% и НДС 10%

10 - Логический номер ККТ

11 - Дополнительная ячейка

12 - Настройки ПУ (Массив 1..3)

20 - Пароль для связи

30 - Наименование и адрес организации (Массив 0..13)

(*) - С версии 565.0.15 допускается длина строки 57 символов на ленте 80мм или 50 символов на ленте 57мм

1 и 3 элемент может быть пустым. В этом случае эти строки не печатаются.

При отсутствии загруженного логотипа, строки с 0 по 3 (в случае Viki Print 57 с 0 по 1) будут напечатаны после завершения формирования предыдущего чека (зона "Препринт").

31 - Строки окончания чеков (Массив 0..9)

Пустые строки не печатаются.

32 - Названия типов платежей (Массив 0..15)

40 - Название ставки налога (Массив 0..5)

41 - Процент ставки налога (Массив 0..5)

42 - Название налоговой группы в чеке

50 - Наименование отдела/секции (Массив 1..16)

51 - Название группы отделов/секции на отчете о закрытии

52 - Наименование реквизита (Массив 1..5)

54 - Реквизиты ЦТО (Массив 0..1)

70 - Номер автомата

71 - ИНН ОФД

72 - Содержание QR-кода

73 - IP-адрес ККТ

74 - Маска подсети

75 - IP-адрес шлюза

76 - IP-адрес DNS

77 - Адрес сервера ОФД для отправки документов

78 - Порт сервера ОФД

79 - Таймер ФН

80 - Таймер С

81 - Наименование ОФД

82 - Электронная почта отправителя чека

83 - URL сайта ФНС

85 - Место расчетов

87 - Различные настройки

Номер бита Пояснение
0 1 - Для печати отчётов используется шрифт 8x14

91 - IP-адрес ОКП-сервера

92 - Порт ОКП-сервера

93 - URL ОКП-сервера

94 - Таймер ОКП-сервера

201 - IP-адрес ОИСМ-сервера

202 - Порт ОИСМ-сервера

203 - URL ОИСМ-сервера

204 - Таймер ОИСМ-сервера

Список кодов ошибок

Код ошибки в HEX Описание
0x00 Команда выполнена без ошибок
Ошибки выполнение команд
0x01 Функция невыполнима при данном статусе ККТ (для получения доп. информации вызовите команду 0x06/1)
0x02 В команде указан неверный номер функции
0x03 Некорректный формат или параметр команды (для получения доп. информации вызовите команду 0x06/1)
Ошибки протокола передачи данных
0x04 Переполнение буфера коммуникационного порта
0x05 Таймаут при передаче байта информации
0x06 В протоколе указан неверный пароль
0x07 Ошибка контрольной суммы в команде
Ошибки печатающего устройства
0x08 Конец бумаги
0x09 Принтер не готов
Ошибки даты/времени
0x0A Текущая смена больше 24 часов. Установка даты времени больше чем на 24 часа.
0x0B Разница во времени, ККТ и указанной в команде начала работы, больше 8 минут
0x0C Вводимая дата более ранняя, чем дата последней фискальной операции
Прочие ошибки
0x0E Отрицательное значение результирующего счетчика (недостаточная сумма денег в ККТ)
0x0F Для выполнения команды необходимо закрыть смену
0x10 Нет данных в журнале
0x11 Ошибка контрольной ленты
0x12 Ошибка посылки данных в ОФД
Фатальные ошибки
0x20 Фатальная ошибка ККТ. Причины возникновения данной ошибки можно уточнить в ”Статусе фатальных ошибок ККТ”
Ошибки ФН
0x41 Некорректный формат или параметр команды ФН
0x42 Некорректное состояние ФН
0x43 Ошибка ФН
0x44 Ошибка КС (Криптографического сопроцессора) в составе ФН
0x45 Исчерпан временной ресурс использования ФН
0x46 ФН переполнен
0x47 Неверные дата или время в ФН
0x48 Нет запрошенных данных в ФН
0x49 Некорректное значение параметров команды ФН
0x4A Некорректная команда ФН
0x4B ККТ передает в ФН данные, которые должен формировать ФН
0x4C ККТ передает в ФН данные, которые уже были переданы в составе данного документа
0x4D Отсутствуют данные, необходимые для корректного учета в ФН
0x4E Количество позиций в документе ФН превысило допустимый предел
0x50 Превышен размер данных TLV
0x51 Нет транспортного соединения
0x52 Исчерпан ресурс КС
0x54 Может быть выдан в нескольких случаях, в сочетании с флагами предупреждений. Если стоит флаг "Превышено время ожидания ответа ОФД", то это значит, что время нахождения в очереди самого старого сообщения на выдачу более 30 календарных дней, необходимо передать сообщения в ОФД (Только при ККТ в режиме передачи данных). Если стоит флаг "Архив ФН заполнен на 90 %", то это означает, что Архив ФН полностью заполнен – необходимо закрыть ФН. Если флаги предупреждений отсутствуют, то это означает, что ресурс 30 дневного хранения для документов для ОФД исчерпан
0x55 Время нахождения в очереди самого старого сообщения на выдачу более 30 календарных дней.
0x56 Продолжительность смены ФН более 24 часов
0x57 Разница более чем на 5 минут отличается от разницы, определенной по внутреннему таймеру ФН.
0x58 Некорректный реквизит, переданный ККТ в ФН
0x59 Переданный в ФН реквизит не соответствует установкам при регистрации
0x60 Неверное сообщение от ОФД
0x61 Нет связи с ФН
0x62 Ошибка обмена с ФН
0x63 Слишком длинная команда для посылки в ФН
0x64 Неизвестный ответ сервиса обновления ключей проверки
0x72 Запрещена работа с маркированным товарами. При активации ФН 1.2 не был установлен признак работы с маркированными товарами
0x73 Нарушена правильная последовательность подачи команд для обработки товаров, имеющих КМ
0x74 Работа с маркированными товарами временно заблокирована. Необходимо отослать или выгрузить сформированные уведомления.
0x75 Переполнена таблица хранения КМ
0x7C В переданном блоке данных, который должен содержать реквизиты в TLV формате отсутствуют необходимые реквизиты.
0x7E В реквизите 2007 содержится КМ, который ранее не проверялся в ФН

Дополнение для ошибок ФН

Примеры для разработчиков

Тестовый проект интеграции на Java