Skip to content

Commit

Permalink
Assembly v 5.11.4 (12.11.24)
Browse files Browse the repository at this point in the history
  • Loading branch information
@adslbarxatov
adslbarxatov committed Nov 11, 2024
1 parent fc32e3c commit e152420
Show file tree
Hide file tree
Showing 10 changed files with 156 additions and 8 deletions.
2 changes: 1 addition & 1 deletion .github/workflows/Release.yaml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ jobs:
# Константы, используемые далее по тексту
env:
PROJ: ${{ github.event.repository.name }}
TAG: '5.11.2'
TAG: '5.11.4'

steps:
# Проверка состава репозитория (без анализа, как может показаться)
Expand Down
Binary file modified .release/KassArray.apk
View file
Binary file not shown.
Binary file added .release/KassArray.exe
View file
Binary file not shown.
Binary file added .release/KassArrayDB.dll
View file
Binary file not shown.
Binary file added .release/KassArrayFN.exe
View file
Binary file not shown.
Binary file added .release/KassArrayLL.dll
View file
Binary file not shown.
147 changes: 147 additions & 0 deletions .release/KassArray_ru_ru.html
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,147 @@
<html charset='utf-8'>

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

<body>

<h1 id="kassarray--">Инструмент сервис-инженера контрольно-кассовой техники KassArray: руководство пользователя</h1>
<p>ƒ <i>RD AAOW FDL</i></p>

<br />
<h2 id="kassarray">Общие сведения об инструменте KassArray</h2>
<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>

<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>
10 changes: 4 additions & 6 deletions .release/Release.md
View file
Original file line number Diff line number Diff line change
@@ -1,9 +1,7 @@
_Изменения для v 5.11.2_:
_Изменения для v 5.11.4_:
- Обновлён интерфейс “О приложении”;
- `Windows`: подсказки выполнены в более компактном варианте;
- Добавлены новые модели ККТ из приказа от 27.09.24;
- `Android`: обновлены пакеты поддержки MAUI;
- `Android`: исправлено некорректное отображение календаря в разделе срока жизни ФН;
- `Windows`: реализована поддержка формата `RTF` при сохранении статусов и отчётов;
- Добавлена серия ЗН ФН `Эв15-4` релиза `4408`, выполняется тестирование адресного пространства;
- Добавлено описание тегов `1011`, `1119`, `1120` и `1125`;
- Обновлены описание и сведения об обязательности тега `1199`;
- Обновлена таблица ставок НДС
- `Windows`: реализована поддержка формата `RTF` при сохранении статусов и отчётов
3 changes: 3 additions & 0 deletions Changes.log
View file
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,9 @@ KassArray: лог изменений
ToDo:
• Добавить новую модель ККТ (Приказ ФНС России от 24.10.2024 г. № АБ-7-20/891@)

Version 5.11.4:
• Обновлён интерфейс “О приложении”

Версия 5.11.2:
• Добавлены новые модели ККТ из приказа от 27.09.24;
• Android: обновлены пакеты поддержки MAUI;
Expand Down
2 changes: 1 addition & 1 deletion src/android/AndroidManifest.xml
View file
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.RD_AAOW.TextToKKT"
android:installLocation="internalOnly" android:versionCode="601543" android:versionName="5.11.1">
android:installLocation="internalOnly" android:versionCode="601544" android:versionName="5.11.4">

<uses-sdk android:minSdkVersion="21" android:targetSdkVersion="34" />

Expand Down

0 comments on commit e152420

Please sign in to comment.