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

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

Привет всем !

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

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

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

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

просто через true api из любого ПО

Во-первых не просто, а с использованием выдаваемого токена доступа.
Это разное. Т.е. нельзя с улицы запрашивать проверку - остаётся след кто это делал.

[finsoftrz]

Токен можно стырить.

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

Новые требования к ФФД вступают в силу 1 сентября 2025 года
в соответствии с Приказом ФНС России от 26.03.2025 № ЕД-7-20/236@.

Изменения призваны улучшить пользовательский опыт (например, сделать чек более читаемым
для покупателей) и повысить прозрачность в онлайн- и офлайн-торговле.
Особенно при продаже маркированного товара и через вендинговые аппараты.

Для ККТ АТОЛ требуется обновление версий прошивки 5.16 и драйвера 10.10.7.0.

Новые требовния НЕ будут поддержаны (прошивки не будет) для следующих моделей:
АТОЛ 90Ф
АТОЛ 52Ф
АТОЛ 60Ф

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

Привет всем !

Версия класса для API АТОЛ 10 от 01.09.2025 г.
-----------------------------------------------------------
Небольшая коррекция по рабочим запросам в связи с введением в действие
изменений указанных в Приказе ФНС России от 26.03.2025 № ЕД-7-20/236@

- Добавлен метод: GetLastReceipt() - получить номер последнего чека;
- Устранены проблемы с данными QR кода при запросе документа из ФН;
- В чеке по умолчанию передаются данные тегов 1009 и 1187 из настроек ККТ;
- Для отчётов состояния расчётов, открытия / закрытия смены добавлена печать:
- Дополнительный реквизит отчета;
- Адрес расчетов (тег 1009);
- Место расчетов (тег 1187).

-----------------------------------------------------------
Мы используем актуальную версию класса cJSON с сайта автора.

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

Привет всем !

Если кто-нибудь будет разбираться с реализацией новых требований к чекам в АТОЛ -
обратите внимание, что задания в JSON, видимо делалась разными сотрудниками,
в разное время и в разном состоянии ... Наименования тегов:

Код: Выделить всё

В ФИСКАЛЬНОМ ЧЕКЕ:
paymentsAddress       ! Адрес расчётов (тег 1009)
paymentsPlace         ! Место расчетов (тег 1187)
 
ОТКРЫТИЕ / ЗАКРЫТИЕ СМЕНЫ / СОСТОЯНИЕ РАСЧЁТОВ:
address               ! Адрес расчетов (тег 1009)
paymentAddress        ! Место расчетов (тег 1187)

Ошибок в работает и парсинге JSON не замечено ... но это достаточно сложно в понимании.
Тех. поддержка АТОЛ, видимо, подключила ИИ для обработки запросов без слова "купить" -
и теперь разговаривать с роботами стало пустой тратой времени.

[RaFaeL]

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

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

больше можно ничего не делать

Да, всё верно ! Но при условии, что кассовый аппарат находится в одной часовой зоне с местом продажи.

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

Привет всем !

Версия класса для API АТОЛ 10 от 04.09.2025 г.
-----------------------------------------------------------
Небольшая коррекция по рабочим запросам в связи с введением в действие
изменений указанных в Приказе ФНС России от 26.03.2025 № ЕД-7-20/236@

- Отработаны чеки с расчётом в интернет;
- Коррекция структур данных для передачи в чеке сведений о месте расчёта;
- В режиме объединения позиций блокируется печать текста внутри фискальных строк чека;
- Класс теперь поставляется в RAR архиве;
- Устранены известные проблемы;
- Добавлены новые ...

-----------------------------------------------------------
Мы используем актуальную версию класса cJSON с сайта автора.