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

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

Привет всем !

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

Класс рабочий, в комплекте примеры использования. Любые замечания и дополнения - приветствуются.

В FTP разделе форума создана папка: /_Books/Atol.KKT со всей сопутствующей документацией.

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

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

Привет всем !

Версия класса для API АТОЛ 10 от 22.04.2025 г.
-----------------------------------------------------------
Завершение переходного периода по 176-ФЗ;
Устранены известные проблемы и мелкие технические помарки.
-----------------------------------------------------------
Мы используем актуальную версию класса cJSON с сайта автора.

wad_ja · Сообщение **wad_ja** » 25 Июнь 2025, 8:40

В одном ТСЖ налоговая кучу чеков с 1 мая закинула в карантин. Лишние теги в чеке. Работник кассовик посмотрел в ОФД и прислал

Я пробовал смотреть через Яндекс и не понял какие теги лишние. Нет тега 2108 единица измерения - моя программа этот тег заполняет - проверено в других предприятиях с кассовиками . Кассовик сейчас меняет прошивку кассы и будет менять драйвер. В современном драйвере есть fptr10.dll или мне уже беспокоится ?

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

ДД !

Насколько я вижу чек формируется на ККТ с ФФД 1.05.
Многие ОФД уже отключают работу с чеками в старых ФФД - там уже много ограничений на использование.

Для ФФД 1.05 тег 2108 не передаётся, единица измерения указывается в теге 1197 (которого в дампе я не вижу).
Возможно проблема связана с тем, что на других предприятиях Ваша программа работает с ККТ с современным ФФД 1.2
Всё есть в описании драйвера - прикреплю снимок, что бы не искать:

wad_ja · Сообщение **wad_ja** » 25 Июнь 2025, 12:58

Вопрос снят. Там был драйвер 21 го года! Кассовик обновил прошивку и обновил драйвер. Два чека прибили в ОФД ушло нормально!

wad_ja · Сообщение **wad_ja** » 25 Июнь 2025, 13:08

Спасибо за подсказку по ФФД 1.05 и 1.2 я написал кассовику пусть смотрит и возможно меняет ФФД - у меня коммуналка только услуги.

wad_ja · Сообщение **wad_ja** » 30 Июнь 2025, 8:11

Кто нибудь знает требования к формату номера телефона покупателя в чеке? на номер "69-63-33" ошибка тег 1008 убрали тире вроде проходит, а некоторые номера телефонов всё равно ошибка.

теги.txt: (1.91 КБ) 67 скачиваний

Документ 173.pdf: (186.08 КБ) 85 скачиваний

wad_ja · Сообщение **wad_ja** » 30 Июнь 2025, 8:40

Нашел на форуме другом.
Номер телефона покупателя передается на фискальный регистратор в формате 10 знаков (9151111111), а ОФД ожидает получить номер телефона в формате 11 знаков (79151111111). Добавляем в начало строки "7", и смс начинают отправляться, а в личном кабинете Контура в чеках становится видно телефон.

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

Привет всем !

Версия класса для API АТОЛ 10 от 09.07.2025 г.
-----------------------------------------------------------
Поддержка изменений в новой версии драйвера АТОЛ 10.10.7.0 и прошивке 5.16.0;

10.10.7.0 от 30.06.2025 **************************************************************************************

Релиз ревью:

В рамках релиза поддержаны изменения в соответствии с приказом Федеральной налоговой службы от 26.03.2025 № ЕД-7-20/236@ "О внесении изменений в приказ Федеральной налоговой службы от 14.09.2020 № ЕД-7-20/662@", добавлена модель ККТ АТОЛ 2Ф, повышена стабильность работы драйвера, а также исправлены некоторые ошибки.

Внесённые изменения:

- Драйвер ККТ

1. Поправлен запрос данных о последнем чеке LIBFPTR_FNDT_LAST_RECEIPT методом fnQueryData();
2. Добавлена модель ККТ АТОЛ 2Ф;
3. Добавлена настройка часовой зоны LIBFPTR_SETTING_TIME_ZONE, используемая при формировании уведомлений;
4. Добавлены новые значения для реквизита LIBFPTR_PARAM_MARKING_CODE_STATUS(тег 2003, тег 2110) - LIBFPTR_MES_PIECE_FOR_SALE и LIBFPTR_MES_DRY_SOLD в соответствии с изменениями ФФД;
5. Переименовано значение признака предмета расчета "Курортный сбор" в "Туристический налог" в соответствии с изменениями ФФД;
6. Добавлена возможность подачи адреса расчета (тег 1009), признака расчета в "Интернет" (тег 1125) при открытии чека в соответствии с изменениями ФФД;
7. Добавлена возможность подать дополнительные сведения об оплате безналичными (тег 1235) в соответствии с изменениями ФФД;
8. Добавлена возможность считывания всех лицензий с данным номером в запросе LIBFPTR_DT_LICENSE_ACTIVATED методом queryData(), используя индекс лицензии LIBFPTR_PARAM_LICENSE_INDEX;
9. Добавлена возможность передать в отчеты об открытии смены, закрытии смены, о регистрации, о состоянии расчетов, закрытия архива дополнительные реквизит и данные отчёта;
10. Добавлено новое JSON-задание "uploadPictureCliche" для загрузки картинки в клише;
11. Переименована секция "13. Скорость печати" в "13. Настройки ТПМ" графической библиотеки драйвера;
12. Добавлены настройки 394 "Смещение отрезчика", 395 "Исполнение ТПМ", 396 "Включить датчик крышки";
13. Поправлено отображение окна графической библиотеки при работе в ОС Astra Linux;

Устранены известные проблемы и мелкие технические помарки.

Ссылки для любителей самостоятельно реализовывать требования законодательства РФ:
http://publication.pravo.gov.ru/documen ... 2506020064
https://www.nalog.gov.ru/rn22/news/acti ... 7406980691

Общее впечатление, что с 01.09.2025 г. хотят поставить раком кассовый учёт по всем направлениям.

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

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

Привет всем !

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

Описание изменений в человеческом виде: https://www.garant.ru/news/1847733/

В том числе, реализована передача тегов (см. примеры чеков):
1011 - «Часовая зона»;
1125 - «Признак расчета в Интернет»;
1234 - «Сведения обо всех оплатах по чеку безналичными».

Сразу хочу уточнить, что на стороне ОФД (у меня Taxcom) я вижу теги 1125 и 1234 и не вижу тег 1011.

Возможно, что тег 1011 начнёт передаваться ККТ в ОФД с 01.09.2025 г., либо он зависим от значений других тегов.
Может быть это недоработка конкретного ОФД по визуализации чека и она будет устранена к 01.09.2025 г. ... ХЗ !

Пока у меня нет информации. Общение с тех. поддержкой АТОЛ и г-ном Царюковым - это сложный квест.

Если у Вас есть информация или Вы смогли протолкнуть и увидеть тег 1011 в чеке Вашего ОФД - сообщите пожалуйста !

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

finsoftrz

Как я понял, доработка кассового ПО касается интернетовских сервисов по приему оплаты. Обычным магазинам, оптовкам достаточно обновить прошивки. Вчера потыкал палочкой айтишников в торговой сети по этому вопросу, отписались, что пару дней назад до них уже дошла информация.

Надо бы на всякий случай всех клиентов оповестить, а то сейчас все отдыхают, могут пропустить. Хотя обычно дают время после указанного срока для приведения ПО в соответствие.

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

finsoftrz писал(а): 23 Август 2025, 8:19 Как я понял, доработка кассового ПО касается интернетовских сервисов по приему оплаты.

Это безосновательное предположение ...

Тот же тег 1011 - указан как обязательный. Но в АТОЛ меня заверили, что сами его передадут (чего я не вижу)
и указывать нужно только изменение от значения LIBFPTR_TIME_ZONE_DEVICE ...

Применение комплексного тега 1234 будет дополнительно уточнено ФНС. Поэтому нельзя сейчас что-либо здесь утверждать.

Наше дело обеспечить интерфейс взаимодействия и передачу параметров в драйвер АТОЛ в соответствии с законодательством.
А применение - это уже в зависимости от бизнес-модели реализуемой в каждой прикладной программе.

finsoftrz

Это обсуждалось с другими разработчиками кассового ПО не так давно.
Разумеется, это не проблема заполнить перечисленные теги из кассового ПО, но вся информация для их формирования уже передается в ккм (кроме 1125, признак электронного чека используют для других целей).
Я всем заинтересованным лицам сейчас закинул информацию.

SergioRaguzini

finsoftrz писал(а): 23 Август 2025, 8:44 это не проблема заполнить перечисленные теги из кассового ПО, но вся информация для их формирования уже передается в ккм

Приветствую!
Видимо, именно так, я по этой теме закидывал вопрос в сторонний форум (https://olegon.ru/showthread.php?t=40652), мнения там аналогичные

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

ДД !

Знаком ли кто-нить вот с таким чудесным девайсом: https://neva.mertrade.ru/ ?
Эта "НЕВА" полностью дублирует бюджетные АТОЛ, в т.ч. и по драйверу ...

Опять какое-то почкование в связи со сменой собственника и уходом команды разработки ?
Или это ОЕМ сборка АТОЛ для SABY (бывший СБИС++) - уж очень активно они её продвигают ... ХЗ.

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

Привет всем !

Версия класса для API АТОЛ 10 от 25.08.2025 г.
-----------------------------------------------------------
Поддержка изменений указанных в Приказе ФНС России от 26.03.2025 № ЕД-7-20/236@
Описание изменений в человеческом виде: https://www.garant.ru/news/1847733/

Добавлена возможность установки параметров ККТ:
- Часовая зона;
- Объединять позиции в ПФ чека;

Установка тега 1011 в чеке перенесена в блок уведомлений (см. пример)
Устранены известные проблемы и мелкие технические помарки.

P/S Для избежания разношёрстых толкований из "других форумов" опубликую
ответ тех. поддержки АТОЛ по вопросу с тегом 1011 "Часовая зона":

Передача тега 1011 -> "salesNotice": { "timeZone": 4}
Данный тег вы не увидите в ОФД, тег передается уведомлением в ЧЗ.
Вы можете запросить json структуру уведомления в ЦРПТ и посмотреть там данный тег.
С уважением, Служба технической поддержки АТОЛ

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