Класс для API АТОЛ «Драйвер ККТ версии 10»

[Игорь Столяров]

Привет всем !

Класс работы с драйвером ККТ АТОЛ 10 на основе JSON заданий.
(форк класса ADMIN'а 2019 г.)

Класс рабочий, в комплекте примеры использования. Любые замечания и дополнения - приветствуются.
В FTP разделе форума создана папка: /_Books/Atol.KKT со всей сопутствующей документацией.

ВНИМАНИЕ !
Для работы с КМ (кодами маркировки) через JSON задания требуется прошивка ККТ 5.12 и выше (двухлетней давности).
На старых прошивках будет ошибка: Объекту 0x05C1E828 присвоен код ошибки 148 [Ошибка программирования реквизита 1023]

[Игорь Столяров]

Сообщение переехало в первый пост темы.

[raketa151]

Добрый день
Касса АТОЛ, драйвер ККТ10. Как убрать тег 1021 - (Имя кассира)?

Данный тег не вызываю драйвере.
fptr.setParam(1021, '');
Но касса сама отправляет тег 1021:"Сис. администратор"

-—
Использую кассу АТОЛ 30Ф
Драйвер ККТ 10.10.3.5

ID Серии (5.12.0)
1---5.8.1
3---5.12.0

Кассу использую для интернет магазина.
При регистрации кассы ставил галочки:
-Автоматический режим
-Номер автомата:1
-Расчеты только в интернет

[Игорь Столяров]

Сообщение переехало в первый пост темы.

[Admin]

Класс прикреплён к моему сообщению от 21.08.2024 г. с картинкой АТОЛ.

Предлагаю следующее.
Назначил тебя владельцем первого поста в треде. Очистил его и включил настройку отображать первым постом.
Можешь контент своего сообщения перенести туда. (Свое потом удалить)
Будет по красоте...

[Игорь Столяров]

Назначил тебя владельцем первого поста в треде.

Господин назначил меня любимой женой !
(C) Белое солнце пустыни.

[finsoftrz]

Европейцы?

[Игорь Столяров]

Привет всем !

Версия класса для ККТ АТОЛ 10 от 31.10.2024 г.
-----------------------------------------------------------
При печати чека из файла - всегда проверяется корректность JSON задания;
Расчёт значения тега 2106 "Результат проверки сведений КМ товара";
Пакетная проверка КМ в синхронном режиме до печати чека (см. примеры);
Просмотр папки с протоколом работы драйвера АТОЛ 10;
Устранены известные проблемы и обновлены примеры.
-----------------------------------------------------------
Мы используем актуальную версию класса cJSON с сайта автора.

[finsoftrz]

Мы используем современную версию класса cJSON с сайта автора. Так лучше звучит.
Интересно, кто-нибудь еще пользуется классом из этой темы? Но, в любом случае, спасибо за труд, как пример работающего кода это может стать интересно в какой-то момент.

[Игорь Столяров]

Классы для кассовой техники - это всегда немного особенный баян.

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

И хорошо, когда ты знаешь на каком конкретно оборудовании работает программа и можешь всё проверить.
Я попробовал всё это привести к некому общему встраиваемому решению для всех версий ФФД и платформ оборудования.
Которое, в общем-то, сам и использую. А так с класса можно натырить отлаженные константы и структруры данных.

[finsoftrz]

Я к этому вопросу немного не так подхожу. Делаю только то, что можно отладить на реальных пользователях. А классы предпочитаю свои, так как важна унификация кода, чтобы потом можно было быстро разобраться с проблемой.

[Игорь Столяров]

В общем-то и я рассказал тоже самое ...

Здесь есть ещё один момент. Независимо от нашего желания и малых потребностей - следующий драйвер АТОЛ
будет уже полностью кроссплатформенный. В принципе, он уже и сейчас таковым является, просто для Windows
ещё исторически поддерживается вызов функций из DLL. Но по сути это уже прошлое, так же как и OLE интерфейс.

Документация по КМ, пакетные режимы, примеры - всё уже только на кроссплатформе для Windows / Android / Linux.
Любой вопрос в тех. поддержку АТОЛ -> покажите Ваш чек в JSON и лог. файл его обработки на ККТ ...

[finsoftrz]

Ага, и за все приходится платить ресурсами.

[Игорь Столяров]

Ага, и за все приходится платить ресурсами.

Есстественно ! Потому, что это всё равно работает интерпретатор транслирующий на лету JSON в команды.
Но добавлется сервис, улучшен поиск ошибок в коде и меняется сам принцип взаимодействия с оборудованием.
И за это нужно платить ... Но здесь главное - это то, что содержать отдельный драйвер для каждой ОС слишком дорого.

[finsoftrz]

Причем, заметьте, этот интерпретатор работает на железе ккм, а не на компьютере. Подобное решение давно уже было на ккм СП, только там не json, а xml. Причем довольно забавный. Можно сказать, что внешний вид xml, но интерпретатор самодельный, заточенный строго на свою задачу. Например, чувствительный к порядку следования тегов.

[Игорь Столяров]

этот интерпретатор работает на железе ккм, а не на компьютере

Конечно же нет. Интерпретатор программный, работает на стороне драйвера, т.е. на компьютере.
Проц АТОЛ слишком дохлый для таких задач, да и памяти там нет для парсинга.

Многие мелкие производители юзают XML / JSON или текст. Им ведь проще перестраиваться.
А тот же гигант ШТРИХ-М всё еще сидит на OLE, хотя в "современных" релизах Win11 он уже отключен по умолчанию.

Например, чувствительный к порядку следования тегов.

Ну как тут недавно выяснилось, наш класс CJSON тоже не без этого греха. Но есть надежда на исправление !