View on GitHub

KassArray

Инструмент сервис-инженера ККТ

Инструмент сервис-инженера контрольно-кассовой техники KassArray: руководство пользователя

ƒ  RD AAOW FDL; 10.10.2025; 1:21

Содержание страницы

 

Общие сведения об инструменте KassArray

Инструмент позволяет:

Windows-версия инструмента также может быть добавлена в автозапуск при установке. В этом случае при запуске системы она остаётся свёрнутой в значок в трее. По нажатию на этот значок она может быть повторно вызвана или свёрнута обратно.

Для приложения доступны функции «Поверх всех окон» (Windows) и «Режим сервис-инженера» (все версии). Последний переводит приложение в режим полной функциональности и открывает опции, которые не должны быть доступны оператору или кассиру (например, команды нижнего уровня или работу с ФН). Соответствующие флажки доступны на последней вкладке.

 

Общие сведения об инструменте KassArrayTB

только Windows

Данный инструмент позволяет формировать бумажные заявления для регистрации и перерегистрации ККТ, а также снятия ККТ с учёта в ФНС в офлайн-режиме (при отсутствии ЭЦП). Интерфейс не должен вызвать сложностей у пользователей, имеющих опыт регистрационных действий в ЛК ФНС. Однако в его работе имеются некоторые особенности:

Поля, помеченные синим цветом, могут быть получены из ФН. Для этого рекомендуется:

Любой из этих шагов может быть пропущен (мы предполагаем, что последние два шага, скорее всего, в принципе в нормальных условиях применяться не будут). В этом случае будут запрошены только те данные, которые относятся к регистрационному номеру из последнего запрошенного статуса ФН. Однако при любом результате запроса перед печатью следует внимательно проверить все параметры заявления и самостоятельно заполнить недостающие поля, а также поля, которые не могут быть получены из ФН.

Поля адреса при запросе данных из ФН при нажатии мышью будут вызывать контекстное меню со списком элементов адреса последней регистрации ККТ, позволяя быстро их подставить при нажатии. Заполнение города или населённого пункта также позволяет использовать функцию «Найти почтовый индекс», если он отсутствует в данных ФН.

 

Модуль чтения и обработки данных ФН для KassArray

только Windows

1. Общие сведения

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

 

Доступные функции:

  1. Чтение данных из ФН с помощью физического или виртуального COM-порта и аппаратного адаптера.

  2. Формирование выгрузок архивов ФН в формате .fnc в соответствии с Приложением №2 к приказу ФНС России «Форматы фискальных документов, обязательные к использованию» для версий ФФД 1.05 и 1.2. Выгрузка в ФФД 1.1 также реализована, но находится в тестировании и может работать некорректно.

  3. Обработка фискальных данных:

    • Получение полного состояния и всех регистрационных данных ФН;
    • Получение отдельного документа ФН;
    • Получение контрольной ленты за отдельную смену;
    • Получение полного фискального (посменного) отчёта;
    • Получение посменного отчёта по диапазону дат;
    • Получение полного помесячного отчёта;
    • Восстановление печатной формы чеков, БСО и чеков коррекции по реквизитам;
    • Прямой запрос счётчиков ФН (для ФФД 1.1 и выше);
    • Расчёт гросс-итогов по данным фискальных документов (для файлов и ФФД 1.05);
    • Прямое чтение документов за определённую дату и расчёт сменных итогов.

  4. Сохранение архива ФН в файл в форматах:

    • Двоичных данных (.fsd). Это внутренний формат программы, который не может быть использован при перерегистрации или снятии ККТ с учёта в личном кабинете ФНС. Однако он доступен для последующего открытия и статистической обработки в программе.
    • Табличных данных (.csv, доступен для обработки в Microsoft Office Excel).

  5. Выполнение обмена с ОФД с параметрами подключения, получаемыми автоматически по данным последней регистрации / перерегистрации, или с параметрами, соответствующими выбранному ОФД. Обмен включает:

    • Передачу фискальных документов;
    • Передачу уведомлений о реализации маркированного товара;
    • Обновление ключей проверки кодов маркировки.

  6. Выполнение операций записи в ФН:

    • Открытие смены;
    • Закрытие смены;
    • Закрытие архива ФН;
    • Пакетная запись чеков, БСО и чеков коррекции в ФН;
    • Фискализация ФН;
    • Сброс МГМ (для технических целей).

Первые три задачи могут быть выполнены с применением текущей даты или даты последнего документа ФН (для ФН с истекшим сроком КС).

  1. Чтение и статистическая обработка выгрузок архивов ФН в форматах .fnc и .fsd.

  2. Формирование выгрузки уведомлений о реализации маркированного товара (при работе в автономном режиме) в формате .fnm в соответствии с Приложением 2 к приказу ФНС России «Форматы фискальных документов, обязательные к использованию» для версии ФФД 1.2 (находится в тестировании).

  3. Кэширование имеющихся файлов .fnc и быстрый доступ к любому из них с помощью поиска по ИНН, заводским номерам, РНМ или наименованиям пользователей.

Чтение может быть выполнено четырьмя способами:

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

Детализация чтения может быть:

Работа программы протестирована на всех моделях ФН из реестра ФНС. При соблюдении производителями существующего аппаратного протокола чтения данных работа с будущими моделями ФН также будет возможна. Однако выгрузка в формате .fnc требует дополнительных исследований, в связи с чем модуль может не поддерживать эту функцию для новейших моделей ФН и новых серий ЗН существующих моделей.

Для выполнения операций с ФН требуется наличие одного из следующих аппаратных адаптеров:

2. Начало работы (на примере VCOM-адаптера ООО «РИК»)

2.1. Подключение ФН и адаптера к ПК

Перед началом работы необходимо подготовить адаптер к работе. Порядок подключения следующий:

Подключение и отключение ФН при наличии питания на адаптере запрещено! Это может вывести оба устройства из строя!

Отключение по окончании работы с адаптером следует производить в обратном порядке:

Отключение или переподключение адаптера при обращении к нему программы (определяется горящим или мигающим светодиодом на адаптере) запрещено! Это может вывести адаптер и ФН из строя!

Кроме того, при использовании USB-подключения для корректной и стабильной работы рекомендуются короткие соединительные кабели (не длиннее 20 см) с общим сечением не менее 2,5 мм. Более длинные и / или тонкие кабели могут не обеспечивать достаточную силу тока для некоторых моделей ФН (проверено на некоторых интерфейсных кабелях, не предназначенных для зарядки аккумуляторов).

2.2. Установка драйвера устройства

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

Далее рассматривается установка драйвера на примере устройства FT230X Basic UART. Для установки драйвера необходимо выполнить следующие действия:

3. Работа с модулем

В комплектацию модуля входят три файла – KassArrayFN.exe, KassArrayDB.dll и KassArrayLL.dll. Отсутствие любого из них делает работу модуля невозможной. Запускать следует файл KassArrayFN.exe или файл KassArray.exe, из которого следует вызывать функцию «Работа с ФН».

Основной интерфейс модуля представлен на рисунке ниже.

3.1. Функции, доступные при запуске

Управляющие кнопки в модуле разведены по функциональным вкладкам. Далее их названия будут указаны под заголовками.

Выбрать номер порта подключения ФН

Вкладка «Физический ФН»

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

Начать чтение

Вкладка «Физический ФН»

Запрашивает статус ФН и, если выбран способ чтения «чтение всех регистраций и всех документов», запускает процесс считывания данных из ФН. При этом будет отображено окно состояния чтения. На время считывания основное окно программы блокируется. Если было выполнено полное считывание, по его завершении откроется доступ к аналитическим функциям программы.

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

Контекстное меню поля статуса ФН

Поле статуса ФН в главном окне

При нажатии правой кнопкой мыши в текстовом поле главного окна, в котором отображается статус ФН, открывается контекстное меню. Оно позволяет:

Кроме того, в зависимости от того, какой документ в данный момент отображается, меню позволяет найти и скопировать некоторые реквизиты документа: РНМ, ЗН ККТ, ЗН ФН, ИНН пользователя, номер ФД и другие. Наконец, при выборе четырёхзначного номера TLV-тега, который не смог расшифровать модуль, можно запросить его описание согласно ФФД.

Открыть файл архива ФН

Вкладка «Работа с файлами»

Открывает ранее сохранённый файл выгрузки ФН и позволяет выполнять с ним те же манипуляции, что и со считанными данными, открывая аналитический функционал. Функция поддерживает два формата файлов:

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

Найти архив или статус ФН

Вкладка «Работа с файлами»

Открывает отдельное окно управления базой считанных архивов ФН (файлов .fnc). Данный интерфейс позволяет:

Нажатие кнопки «Открыть найденный файл» передаёт путь к нему в основной интерфейс, после чего его обработка выполняется в соответствии с функциями приложения.

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

Сформировать файл архива ФН

Вкладка «Выгрузка архивов»

Запускает процесс выгрузки архива ФН в формат .fnc, пригодный для передачи в ЛК ФНС при замене ФН, зарегистрированных в автономном режиме. Эту же функцию можно задействовать, когда требуется получить доступ к аналитике для ФН с большим количеством документов. При успешном завершении процесса программа откроет этот файл для обработки автоматически.

Сформировать выгрузку уведомлений о реализации маркированных товаров

Вкладка «Выгрузка архивов»

Запускает процесс выгрузки уведомлений в формат .fnm, пригодный для передачи в систему «Честный знак», для ФН, зарегистрированных в автономном режиме с ФФД 1.2 и признаком торговли маркированными товарами (ТМТ).

Функционал находится в тестировании. Поэтому приложение будет выполнять подтверждение выгрузки – необратимую часть процедуры, – только если пользователь согласится на продолжение. Это позволит проверить создаваемые файлы на корректность (при отправке в «Честный знак»). Кроме того, создание выгрузки согласно всем правилам по каким-то причинам делает их отличающимися и от выгрузок приложения WIN_TEST_FM_1_2 (не совпадает поле CRC при соответствии всех остальных данных), и от выгрузок программы FNArc_1_2 (отличается поле «номер последнего уведомления» в заголовке). Поэтому проверка выгрузки перед подтверждением на текущий момент строго обязательна!

Изменение уровня детализации считывания

Вкладка «Физический ФН»

Переключатель детализации позволяет указать, будет ли выполняться считывание:

Включение детализации замедляет полный процесс чтения примерно в два раза, но позволяет просмотреть, например, наименования товаров и услуг или реквизиты покупателя. Обращаем внимание, что выбранный вариант определяет поведение и функции считывания ФН, и функции прямого доступа к нему.

Отобразить статус ФН

Вкладка «Прочее»

Возвращает ранее запрошенный статус ФН в окно статуса приложения. Для этой функции также доступны сохранение в файл и отправка на принтер.

Общие настройки

Вкладка «Прочее»

Управляемые настройки модуля вынесены в отдельный интерфейс. Здесь можно:

Руководство пользователя

Вкладка «Прочее»

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

Отобразить горячие клавиши

Вкладка «Прочее»

Отображает в поле статуса краткую справку по горячим клавишам приложения. Модуль поддерживает набор удобных клавиатурных сокращений для наиболее часто используемых функций:

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

Обмен с ОФД

Вкладка «Обмен с ОФД»

Запускает отправку документов из ФН оператору фискальных данных, если очередь отправки не пуста. Настройки подключения определяются автоматически (при выборе автоматического обмена). На данный момент для всех ОФД из реестра ФНС имеется однозначное соответствие ИНН / Названия ОФД и параметров Host name / IP + TCP port, которое позволяет избавить пользователя от необходимости ручной настройки соединения. Программе известны настройки связи со всеми ОФД, действующими на 1 сентября 2025 года.

Тем не менее, выбор ручного обмена позволяет указать любой неаннулированный ОФД вручную. Это удобно в случаях, когда пользователь хочет сменить ОФД (уже перестал его оплачивать), а в ФН ещё остались непереданные документы, мешающие сделать перерегистрацию. ОФД обычно принимают документы, не обращая внимания на несовпадение ИНН ОФД в параметрах регистрации.

В этой же вкладке случае доступен также флажок «Восстанавливать связь при обрыве». Если он активен, отправка документов будет циклически перезапускаться, пока не будет отменена вручную (даже в случае отсутствия выхода в интернет или истечения тарифа ОФД).

При запуске обмена из ФН запрашивается длина очереди отправки и ИНН ОФД, после чего выполняется попытка подключения и передачи. В случае ошибки модуль сообщает, на каком шаге она происходит. А именно – была ли проблема в подключении, или подключение есть, но ОФД не принимает документ из-за истечения тарифа. Если связь устанавливается, программа последовательно отправляет все документы из очереди. При необходимости этот процесс можно прервать. По окончании передачи состояние ФН автоматически перезапрашивается.

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

Прямое чтение документов из ФН

Вкладка «Чтение ФД из ФН»

Флажок «Включить» установлен, когда программа находится в режиме прямого чтения данных. В этом режиме доступны только функции чтения статуса ФН, а также извлечения отдельного документа.

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

Нажатие клавиши Enter в поле номера документа для прямого чтения или кнопок «Запросить», «Первый» и «Последний» запускает запрос документа. В случае двух последних кнопок поле номера документа получает соответствующее значение.

Извлечение смены из ФН по дате

Вкладка «Чтение смены из ФН»

Данная функция позволяет извлечь данные за указанную дату из ФН без его полного считывания (без запуска аналитики). При этом определяются границы смены, и выполняется расчёт её итогов, которые затем можно сохранить или распечатать. Здесь возможен выбор формата отчёта: только итоговые суммы или полная контрольная лента.

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

Получение отчётов

Вкладка «Сводные отчёты»

После полного считывания или в результате загрузки файла архива ФН становятся доступны функции:

Сохранение считанных данных

Вкладка «Выгрузка архивов»

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

В этом случае программа предложит в качестве имени файла комбинацию из заводского номера ФН, заводского номера ККТ и наименования владельца ККТ.

Запрос счётчиков ФН

Вкладка «Чтение смены из ФН»

Если ФН был фискализирован с ФФД 1.1 или выше, эта функция позволяет напрямую запросить счётчики накоплений из ФН. В противном случае опция будет доступна только при полном считывании данных или работе с файлом архива ФН. Если приложению окажутся доступны оба варианта, пользователь сможет выбрать, каким из них следует воспользоваться.

Интерактивные функции

Вкладка «Сводные отчёты»

Эти функции предполагают отображение сведений в поле статуса окна приложения при выполнении следующих действий:

Запись в ФН

Вкладка «Запись в ФН»

Флажок «Разрешить» активирует режим, предполагающий запись данных в ФН. В нём доступны:

Эти функции могут быть удобны, если по какой-либо причине закрытие смены или архива в ККТ невозможно (например, исчерпание ресурса ФН при открытой смене). Эти функции позволяют, например, снять с учёта ФН с истекшими тарифами ОФД и регистрациями ФНС или исправить множественные ошибки или факты неприменения ККТ. Переключатель применения даты последнего документа ФН вместо текущей позволяет снять необходимость в её ручном поиске по документам.

Если Вы не знаете, зачем нужны эти функции, использовать их и включать этот режим запрещено. Их применение требует внимания, т.к. результаты их работы необратимы. Все перечисленные функции выполняются пользователем на свой страх и риск!

При успешном завершении этих операций программа автоматически предпринимает попытку отправить вновь появившиеся документы ОФД, после чего предлагает перейти в режим прямого чтения для запроса последнего документа (с целью последующего сохранения или печати). Особенности работы с пакетным оформлением описаны в следующем разделе.

Пакетное проведение документов

Вкладка «Запись в ФН»

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

Пакетное оформление находится в разделе «Запись в ФН» в списке режимов записи. Запустить его можно только при успешном подключении к зарегистрированному ФН с незакрытым архивом. При этом смена должна быть открыта (можно сделать здесь же).

:warning: Обращаем внимание, что данная функция является новой для приложения. И мы, несмотря на длительную отладку и сверку реквизитов с ОФД, пока не можем гарантировать, что она будет работать ожидаемым образом. Настоятельно рекомендуем сначала выполнить все действия, предлагаемые этой опцией, на МГМ, прежде чем использовать боевой ФН.

:warning: Помните, что все действия здесь Вы выполняете на свой страх и риск! Любая ошибка в реквизитах документов является исключительно Вашей ответственностью!

На первом шаге приложение предложит Вам сохранить образец шаблона, содержащий подробные комментарии и формат таблицы, совместимый с текущей версией приложения. Вы можете изменить его требуемым образом с помощью программы Microsoft Office Excel (или аналогичного табличного процессора с поддержкой формата XLSX). Далее его потребуется сохранить в формате «CSV – разделители-запятые», после чего его уже можно будет использовать в приложении.

Если при последующей загрузке файла CSV у Вас возникнут проблемы, убедитесь, что в сохранённом файле разделителем столбцов является символ ; (точка с запятой), а не табуляция или запятая. Последнее, скорее всего, может означать, что Ваш табличный процессор не поддерживает русскую локализацию

Программа выполняет полный контроль всех полей таблицы. В текущей версии она представлена следующими столбцами:

Результат контроля собирается программой в журнал. При обнаружении хотя бы одной непреодолимой проблемы вся процедура будет отменена, и будет открыт журнал ошибок. Если ошибок нет, или имеются только предупреждения, пользователь может запустить внесение документов в ФН.

По завершении приложение сообщит об успехе операции или об ошибке, которая не позволяет её продолжить, а также предложит отправить документы ОФД. В случае, если в шаблоне были документы, дата которых ещё не наступила, мы рекомендуем отложить отправку до момента их «актуализации»

Фискализация ФН

Вкладка «Запись в ФН»

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

Фискализация ФН находится в разделе «Запись в ФН» в списке режимов записи. Запустить его можно только при успешном подключении к ФН с незакрытым архивом. При этом смена должна быть закрыта (можно сделать здесь же).

:warning: Обращаем внимание, что данная функция является новой для приложения. И мы, несмотря на длительную отладку и сверку реквизитов с ОФД, пока не можем гарантировать, что она будет работать ожидаемым образом. Настоятельно рекомендуем сначала выполнить все действия, предлагаемые этой опцией, на МГМ, прежде чем использовать боевой ФН.

:warning: Помните, что все действия здесь Вы выполняете на свой страх и риск! Любая ошибка в реквизитах документов является исключительно Вашей ответственностью!

На первом шаге приложение предложит Вам сохранить образец шаблона, содержащий подробные комментарии и формат полей, совместимый с текущей версией приложения. Вы можете изменить его требуемым образом с помощью программы Microsoft Office Word, Wordpad или аналогичного текстового процессора с поддержкой формата RTF. Далее его потребуется сохранить в том же формате, после чего его уже можно будет использовать в приложении.

Обращаем внимание, что при сохранении файла шаблона для фискализированного ФН приложение подставляет лишь часть реквизитов регистрации (адрес, место, наименование, РНМ, ЗН ККТ, ИНН и некоторые другие, а также часть флагов). Остальные параметры не всегда возможно извлечь из ФН. Поэтому, независимо от успешности запроса статуса, всегда самостоятельно проверяйте корректность всех реквизитов, включая те, которые не меняются при перерегистрации.

Результат контроля всех реквизитов собирается программой в журнал. При обнаружении хотя бы одной непреодолимой проблемы процедура будет отменена, и будет открыт журнал ошибок. Если ошибок нет, или имеются только предупреждения, пользователь может запустить запись в ФН.

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