Assembly v 6.0.6 (3.12.24)

adslbarxatov · Dec 2, 2024 · 21dffa3 · 21dffa3
1 parent 9567134
commit 21dffa3
Show file tree

Hide file tree

Showing 8 changed files with 164 additions and 6 deletions.
diff --git a/.github/workflows/Release.yaml b/.github/workflows/Release.yaml
@@ -16,7 +16,7 @@ jobs:
 # Константы, используемые далее по тексту
     env:
       PROJ: ${{ github.event.repository.name }}
-      TAG: '6.0.2'
+      TAG: '6.0.6'
 
     steps:
 # Проверка состава репозитория (без анализа, как может показаться)

diff --git a/.release/KassArray.exe b/.release/KassArray.exe
diff --git a/.release/KassArrayDB.dll b/.release/KassArrayDB.dll
diff --git a/.release/KassArrayFN.exe b/.release/KassArrayFN.exe
diff --git a/.release/KassArrayLL.dll b/.release/KassArrayLL.dll
diff --git a/.release/KassArray_ru_ru.html b/.release/KassArray_ru_ru.html
@@ -0,0 +1,148 @@
+<html charset='utf-8'>
+
+<head>
+<title>Инструмент сервис-инженера контрольно-кассовой техники KassArray: руководство пользователя | KassArray</title>
+</head>
+
+<body>
+
+<h1 id="kassarray--">Инструмент сервис-инженера контрольно-кассовой техники KassArray: руководство пользователя</h1>
+<p>ƒ <i>RD AAOW FDL</i></p>
+<br />
+
+<p>Инструмент позволяет:</p>
+<ul>
+<li>просматривать и сохранять / отправлять на печать <em><strong>инструкции по работе с ККТ</strong></em>;</li>
+<li>просматривать расшифровки <em><strong>кодов ошибок ККТ</strong></em>;</li>
+<li>определять <em><strong>срок жизни ФН</strong></em> в соответствии параметрами пользователя, от которых он зависит;</li>
+<li>определять <em><strong>корректность регистрационного номера ККТ</strong></em> и <em><strong>генерировать его</strong></em> при необходимости;</li>
+<li>определять <em><strong>соответствие моделей ККТ версиям ФФД</strong></em>;</li>
+<li>получать <em><strong>настройки операторов фискальных данных</strong></em> (ОФД) по их ИНН или названиям;</li>
+<li>получать <em><strong>описания и признаки обязательности TLV-тегов</strong></em> для различных ФФД;</li>
+<li>получать описания <em><strong>команд нижнего уровня</strong></em>;</li>
+<li>вручную (без использования внешней клавиатуры) <em><strong>программировать текстовые данные в ККТ</strong></em>, имеющих только цифровую клавиатуру;</li>
+<li>автоматически <em><strong>определять модели ККТ и фискальных накопителей</strong></em> (ФН) по их заводским номерам, а также регионы РФ по кодам ИНН;</li>
+<li>просматривать <em><strong>распиновки кабелей</strong></em> ККТ – ПК, ККТ – ДЯ и ККТ – Принтер;</li>
+<li>определять <em><strong>типы штрих-кодов</strong></em> и разбирать их содержимое (включая DataMatrix маркируемых товаров);</li>
+<li>дополнительно: получать разложения и представления чисел в системах счисления с основаниями 2, 10 и 16;</li>
+<li>дополнительно: преобразовывать коды Unicode в символам и наоборот;</li>
+<li>дополнительно: преобразовывать двоичные данные в текст и обратно.</li>
+</ul>
+
+<r/>
+
+<br/>
+<br/>
+<p>Windows-версия инструмента также может быть добавлена в автозапуск при установке; при запуске системы она остаётся свёрнутой
+в значок в трее. По нажатию на этот значок он может быть повторно вызван или свёрнут обратно.</p>
+<p>Для приложения доступны функции «Поверх всех окон» (Windows) и «Режим сервис-инженера» (все версии). Последний переводит приложение
+в режим полной функциональности и открывает опции, которые не должны быть доступны оператору или кассиру
+(например, команды нижнего уровня или работу с ФН). Соответствующие флажки доступны на последней вкладке.</p>
+<br/>
+<br/>
+<br/>
+
+<h2 id="kassarray-1">Модуль чтения и обработки данных ФН для KassArray (только Windows)</h2>
+<p>Модуль предназначен для чтения и обработки фискальных данных (ФД) из фискального накопителя (ФН).
+Далее представлено полное описание функционала приложения.</p>
+
+<br/>
+<br/>
+<p>Доступные функции:</p>
+<p><strong>1. Чтение данных из ФН</strong> с помощью физического или виртуального COM-порта и аппаратного адаптера.</p>
+
+<p><strong>2. Формирование выгрузок архивов ФН в формате</strong> <code>.fnc</code> в соответствии с Приложением №2 к приказу
+ФНС России «Форматы фискальных документов, обязательные к использованию» для версий ФФД <code>1.05</code> и <code>1.2</code>. Выгрузка в ФФД <code>1.1</code>
+также реализована, но находится в тестировании и может работать некорректно.</p>
+
+<p><strong>3. Обработка фискальных данных</strong>:</p>
+<ul>
+<li>Получение полного состояния и всех регистрационных данных ФН;</li>
+<li>Получение отдельного документа ФН;</li>
+<li>Получение контрольной ленты за отдельную смену;</li>
+<li>Получение полного фискального (посменного) отчёта;</li>
+<li>Получение посменного отчёта по диапазону дат;</li>
+<li>Прямой запрос счётчиков ФН (для ФФД <code>1.1</code> и выше);</li>
+<li>Расчёт гросс-итогов по данным фискальных документов (для файлов и ФФД <code>1.05</code>);</li>
+<li>Прямое чтение документов за определённую дату и расчёт сменных итогов.</li>
+</ul>
+
+<p><strong>4. Сохранение архива ФН в файл</strong> в форматах:</p>
+<ul>
+<li>Двоичных данных (<code>.fsd</code>). Это внутренний формат программы, который не может быть использован
+при перерегистрации или снятии ККТ с учёта в личном кабинете ФНС. Однако он доступен для последующего открытия и статистической обработки в программе.</li>
+<li>Табличных данных (<code>.csv</code>, доступен для обработки в Microsoft Office Excel).</li>
+</ul>
+
+<p><strong>5. Выполнение обмена с ОФД</strong> с параметрами подключения, получаемыми автоматически по данным последней
+регистрации / перерегистрации, или с параметрами, соответствующими выбранному ОФД. Обмен включает:</p>
+<ul>
+<li>Передачу фискальных документов;</li>
+<li>Передачу уведомлений о реализации маркированного товара;</li>
+<li>Обновление ключей проверки кодов маркировки.</li>
+</ul>
+
+<p><strong>6. Выполнение операций записи в ФН</strong>:</p>
+<ul>
+<li>Открытие смены;</li>
+<li>Закрытие смены;</li>
+<li>Закрытие архива ФН;</li>
+<li>Сброс МГМ (для технических целей).</li>
+</ul>
+<p>Первые три задачи могут быть выполнены с применением текущей даты или даты последнего документа ФН (для ФН с истекшим сроком жизни).</p>
+
+<p><strong>7. Чтение и статистическая обработка выгрузок архивов ФН</strong> в форматах <code>.fnc</code> и <code>.fsd</code>.</p>
+
+<p><strong>8. Формирование выгрузки уведомлений о реализации маркированного товара</strong> (при работе в автономном режиме)
+в формате <code>.fnm</code> в соответствии с Приложением 2 к приказу
+ФНС России «Форматы фискальных документов, обязательные к использованию» для версии ФФД <code>1.2</code> (<em><strong>находится в тестировании</strong></em>).</p>
+
+<p><strong>9. Кэширование имеющихся файлов</strong> <code>.fnc</code> и быстрый доступ к любому из них с помощью поиска по ИНН, заводским номерам,
+РНМ или наименованиям пользователей.</p>
+
+<br/>
+<br/>
+<p>Чтение может быть выполнено четырьмя способами:</p>
+<ul>
+<li><em><strong>Полное чтение архива</strong></em>. По его завершении становятся доступными все функции обработки данных.</li>
+<li><em><strong>Прямое чтение ФН</strong></em>. В этом случае доступны только функции чтения статуса ФН и содержимого отдельного документа.</li>
+<li><em><strong>Формирование выгрузки .fnc с последующей её загрузкой</strong></em>. Работает аналогично первому варианту, но набор
+реквизитов документов будет неполным, т.к. в файлах выгрузок они хранятся в ограниченном составе.</li>
+<li><em><strong>Прямое чтение документов из ФН за указанную дату</strong></em>. Данный способ позволяет сформировать сменные
+итоги без полного считывания ФН. Аналитика при этом останется недоступной.</li>
+</ul>
+
+<p>Независимо от варианта и настроек чтения состояние ФН запрашивается в максимально полном виде. Количество видимых регистраций
+и перерегистраций может быть ограничено последней (актуальной), если выбрана соответствующая опция.</p>
+
+<br/>
+<br/>
+<p>Детализация чтения может быть:</p>
+<ul>
+<li><em><strong>Полной</strong></em>. При этом из ФН считываются все TLV-теги (в том числе – неизвестные приложению с представлением
+в шестнадцатеричной форме) и квитанции подтверждения ОФД. Может занимать продолжительное время.</li>
+<li><em><strong>Неполной</strong></em>. Из ФН считываются только известные приложению TLV-теги. По скорости не отличается от предыдущего варианта.</li>
+<li><em><strong>Краткой</strong></em>. При этом считываются только суммовые счётчики, временны́е метки, номера, фискальные признаки
+документов и состояния отправки ОФД. Выполняется быстрее полного считывания примерно в два раза.</li>
+</ul>
+
+<br/>
+<br/>
+<p>Работа программы протестирована на всех моделях ФН из реестра ФНС.
+При соблюдении производителями существующего аппаратного протокола чтения данных работа с будущими моделями ФН также будет возможна.
+Однако выгрузка в формате <code>.fnc</code> требует дополнительных исследований, в связи с чем модуль может не поддерживать эту функцию
+для новейших моделей ФН.</p>
+
+<p>Для выполнения операций с ФН требуется наличие одного из следующих аппаратных адаптеров:</p>
+<ul>
+<li>COM-UART переходник для подключения ФН к разъёму COM (RS-232) компьютера.</li>
+<li>USB-VCOM-UART переходник для подключения к разъёму USB компьютера. В этом случае потребуется установить драйвера устройства;
+инструкции и ссылки для их установки предоставляются производителями таких переходников.</li>
+</ul>
+
+<p>Обращаем внимание, что срок действия каждого релиза модуля ограничен с целью устранения устаревающих версий и обеспечения
+его постоянного соответствия актуальным изменениям в ФФД. Срок указан в информационном окне, появляющемся при каждом запуске приложения. По его истечении
+останутся доступными функции анализа ранее считанных данных. Для работы с новыми данными необходимо будет получить актуальный экземпляр приложения.</p>
+
+</body>
+</html>
diff --git a/.release/Release.md b/.release/Release.md
@@ -1,4 +1,10 @@
-_Изменения для v 6.0.2_:
+_Изменения для v 6.0.6_:
+- `ФН`: исправлен дефект чтения ФН, внесённый версией `6.0.2`;
+- `ФН`: кэш считанных статусов ФН теперь включён по умолчанию (касается только первого запуска);
+- Добавлена серия ЗН ФН 73864408 для Пр15-4;
+- Добавлена предполагаемая серия ЗН ФН 73864407 для Пр15-4;
+- `ФН`: скорректировано отображение некоторых тегов в режиме полной детализации;
+- Исправлена распиновка разъёма денежного ящика для ККТ Штрих (была отзеркалена);
 - Добавлена серия ЗН ФН `7384408` для `Ав15-4`;
 - Добавлены предполагаемые серии ЗН ФН `73824407` и `73844407`;
 - Базовый адрес чтения ФН теперь может быть корректно переопределён даже для неизвестных приложению моделей;

diff --git a/Changes.log b/Changes.log
@@ -1,11 +1,15 @@
 KassArray: лог изменений
 
-ToDo:
-- Квадратные скобки при распознанных значениях тегов
-- Особый формат для ФПД
+Версия 6.0.6:
+• ФН: исправлен дефект чтения ФН, внесённый версией 6.0.2;
+• ФН: кэш считанных статусов ФН теперь включён по умолчанию (касается только первого запуска);
+• Добавлена серия ЗН ФН 73864408 для Пр15-4;
+• Добавлена предполагаемая серия ЗН ФН 73864407 для Пр15-4;
+• ФН: скорректировано отображение некоторых тегов в режиме полной детализации;
+• Исправлена распиновка разъёма денежного ящика для ККТ Штрих (была отзеркалена)
 
 Версия 6.0.2:
-• Добавлена серия ЗН ФН 7384408 для Ав15-4;
+• Добавлена серия ЗН ФН 73844408 для Ав15-4;
 • Добавлены предполагаемые серии ЗН ФН 73824407 и 73844407;
 • Базовый адрес чтения ФН теперь может быть корректно переопределён даже для неизвестных
   приложению моделей