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

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

Привет всем !

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

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

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

просто через 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 с сайта автора.

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

Всем привет !

Из-за калечной связи сейчас каждый понедельник начинается (не в субботу ! )
с нескольких отрубленных ККТ из-за непереданных в ОФД данных.

На самом деле проблему легко предупредить, если контролировать непереданные в ОФД документы.
Ну и плюс 72 часа (3 суток) к дате первого неотправленного ФД - это время блокировки ККТ.

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

   Data
gOfdExchangeStatus   Group(Atol:G_OfdExchangeStatus).
        
   Code     
   Glo:MyAtol.Open()  ! Открываем канал с ККТ
   If Glo:MyAtol.Opened()   
      ....   
      ! Запрос состояния обмена с ОФД
      If Glo:MyAtol.jOfdExchangeStatus(gOfdExchangeStatus) and |              
         gOfdExchangeStatus.status.notSentCount > 0  ! 1097 Количество неотправленных ФД
         
         Atol::Message('ВНИМАНИЕ !!!||Не отправлены в ОФД документы: ' & | 
                                       Clip(Left(gOfdExchangeStatus.status.notSentCount)) & |
              ' начиная с ФД ' &       Clip(Left(gOfdExchangeStatus.status.notSentFirstDocNumber))  & |
              ' от '   & Format(Atol::SplitUTC(1,gOfdExchangeStatus.status.notSentFirstDocDateTime),@D06.) & |
              ' г. ('  & Format(Atol::SplitUTC(2,gOfdExchangeStatus.status.notSentFirstDocDateTime),@T04) & ')')
         end               
      end
      ....
      Glo:MyAtol.Close()  ! Закрываем канал с ККТ        
   end

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

Привет всем !

Версия класса для API АТОЛ 10 от 14.09.2025 г.
-----------------------------------------------------------

- Метод jDisplayFnStatus()
В сообщение о текущем статусе ФН добавлены:
* Дата и время успешного обмена с ОФД;
* Кол-во непереданных в ОФД фискальных документов (не путать с чеками !);
* Дата и время первого непереданного в ОФД документа;
* Текст ошибки сети, ОФД и ФН при процедуре обмена данными.

- Метод jDisplayShiftTotals()
Просмотр итогов текущей смены без печати X-отчёта на ленту.

- Atol:ClassVersion - дата версии класса АТОЛ 10 в человеческом формате '14.09.2025'.
- Процедура Atol::GetClassVersion() вернёт версию класса АТОЛ 10 в формате даты Clarion.

P/S: Вспомнил молодость и рисование текстовых отчётов по символам в CPD 2.1. До слёз, блин !

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

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

Привет всем !

Версия класса для API АТОЛ 10 от 18.09.2025 г.
-----------------------------------------------------------

Новые методы:
- jAddTipsFooter - Добавить QR код на сервис оплаты чаевых;
- jDisplayOverallTotals - Показать сообщение с состоянием необнуляемых счётчиков;
- ResetUniversalCounters - Очистить универсальные счётчики;
- ResetSettings - Технологическое обнуление ККТ;
- DisableOfdChannel - Выключить подключение к ОФД;
- EnableOfdChannel - Включить подключение к ОФД;

Безусловная не печать тега 1030 в чеке на аванс (ранее по условию NoAdvanceName);
Добавлен пример печати чека с QR кодом сервиса выплаты чаевых;
Незначительное приведение к общей схеме параметров совсем старых методов.

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

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

Привет всем !

Версия класса для API АТОЛ 10 от 03.10.2025 г.
-----------------------------------------------------------

Новые методы:
- jCheckFnNumber - Проверка соответствия номера ФН и данных в ККТ
- ValidateKeys - Проверка ключей ККТ
- ViewLicenses - Просмотр списка введенных в ККТ лицензий / кодов защиты

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

P/S: Тоже буду картинки постить !