View on GitHub

KassArray

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

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

ƒ  RD AAOW FDL; 18.07.2024; 15:38

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

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

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

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

Для приложения доступны функции «Поверх всех окон» (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 данного руководства). Если подключение устройства выполнено после запуска приложения, можно обновить список системных портов кнопкой «Обновить список портов».

Открыть порт

Вкладка «Подключение»

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

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

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

Вкладка «Подключение»

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

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

Найти считанный архив ФН

Вкладка «Подключение»

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

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

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

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

Вкладка «Выгрузка данных»

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

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

Вкладка «Выгрузка данных»

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

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

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

Вкладки «Подключение» и «Прямое чтение ФН»

Выпадающий список позволяет указать, будет ли выполняться считывание:

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

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

Вкладка «Статус и счётчики»

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

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

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

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

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

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

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

Горячие клавиши

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

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

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

Обмен с ОФД

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

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

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

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

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

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

Прямое чтение из ФН

Вкладка «Прямое чтение ФН»

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

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

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

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

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

Вкладка «Статус и счётчики»

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

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

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

Вкладка «Отчёты»

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

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

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

Вкладка «Выгрузка данных»

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

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

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

Вкладка «Статус и счётчики»

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

Флажок «Только ненулевые значения» позволяет скрыть поля с нулевыми суммами из запрошенных данных.

Для этой функции также доступны сохранение в файл, отправка на принтер и добавление текста статуса, если он отсутствует.

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

Вкладка «Отчёты»

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

Запись в ФН

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

Кнопка «Разрешить» активирует режим, предполагающий запись данных в ФН: сброс МГМ, открытие и закрытие смены, закрытие архива. Эти функции могут быть удобны, если по какой-либо причине закрытие смены или архива в ККТ невозможно (например, исчерпание ресурса ФН при открытой смене).

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

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

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