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

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

Привет всем !

Класс работы с драйвером ККТ АТОЛ 10 на основе JSON заданий.
Форк класса ADMIN'а: Driver10.zip

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

Список изменений в версии от 10.07.2026 г.
----------------------------------------------------------------------------------------------------
- Поддержка изменений в драйвере АТОЛ 10.10.9.0
- Устранены проблемы по запросам и внесены изменения в примеры.
----------------------------------------------------------------------------------------------------

[wad_ja]

Вопрос ещё: Если чек не печатается электронно - то печатается на бумагу - можно ли провести чек и не тратить бумагу - чек НЕ электронно ?

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

Если чек не печатается электронно

Вы напрасно придумываете какую-то странную терминологию, потому что сами в ней уже запутались.
Нет никаких "печать, но не на бумагу" и "проводок чека".

СОЗДАНИЕМ кассового чека осуществляется фиксация факта совершения товарно-денежной операции.
Кассовый чек может быть распечатан на ленту или передан контрагенту электронно (при выполнении некоторых условий).

Я понимаю, что Вы не хотите собирать БД контактных данных и при этом хотите создавать электронные кассовые чеки.
Но в этой стране так не получится. Вы просто получите оборотный штраф и никто все эти глупости в ФНС РФ слушать не будет.

[wad_ja]

Понял! Спасибо!

[wad_ja]

Мне все таки надо делать чеки электронно. Бухгалтер предъявил адрес почты если в карточке лицевого счёта почта не указана.
В электронном чеке нужны дополнительное теги
SELF.SetParamInt(1125, 0) ! Тег 1125 принимает следующие значения: 1 — расчёт произведён в сети Интернет; 0 — расчёт не в сети Интернет (то есть офлайн: в магазине, офисе и т.д.)
Жители платят в банке - не на предприятии - на предприятии только чеки для налоговой пробивают. Деньги поступают на расчетный счёт.
SELF.SetParamDouble(1082, GLO_summBEZNAL) сумма безнала - это я добавил
SELF.SetParamInt(1236, 5) ! 5 — Иная форма безналичной оплаты- это я добавил - я не знаю как именно оплатил житель и ставлю 5. Это нормально ?

Возможные параметры тега 1236 («Признак способа оплаты безналичными»):
1 — банковская карта;
2 — мобильное приложение (например, Apple Pay, Google Pay);
3 — электронное средство платежа (например, Яндекс.Деньги, WebMoney);
4 — безналичный перевод (включая СБП — Систему быстрых платежей);
5 — иная форма безналичной оплаты.

В инете написано, что тег 1234–1238 при оплате через QR или интернет я эти теги должен формировать?

Тег 1237 в кассовом чеке — «Идентификаторы безналичной оплаты». Это реквизит, который вводится с 1 сентября 2025 года приказом ФНС России от 26.03.2025 №ЕД-7-20/236@. Тег используется только в электронных кассовых чеках. Он указывает уникальные коды транзакции, присваиваемые платёжным сервисом.
Я не знаю этот код транзакции. Без него нельзя сформировать чек?

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

Тег 1237 в кассовом чеке — «Идентификаторы безналичной оплаты»

Вот здесь почитайте пожалуйста: https://www.nalog.gov.ru/rn71/news/acti ... /16524721/
И бухгалтеру тоже покажите.

[wad_ja]

Я прочитал и нечего не понял!
В настоящий момент порядок заполнения реквизита «Сведения обо всех оплатах по чеку безналичными» (тег 1234) не утвержден. Учитывая, что данный реквизит имеет значение обязательности «3», что означает необязательность его включения, то согласно приказу ФНС России от 14.09.2020 № ЕД-7-20/662@, данный реквизит пока может не включаться в состав ФД
В инете написано, что без 1237 не проходит чек! 1236 не указывать ? Я все равно не знаю как оплатили и кода транзакции нет.

[wad_ja]

Если я сделаю пробный чек без 1236 и 1237 а ОФД не примет - мои действия? 1082 сумма безнал то же можно не указывать?

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

1082 сумма безнал то же можно не указывать?

Всё действия подробно описаны на сайте ФНС РФ:
https://www.nalog.gov.ru/rn13/news/acti ... /16540943/

[wad_ja]

https://kontur.ru/qa/25584?ysclid=mnprt1ooch592184030
Почему ФНС не принимает чек без тега 1237 и как его заполнить?
комментарий эксперта
Реквизит по-прежнему необязателен, и ФНС не выпускала рекомендаций по его заполнению.
Однако, в протоколах информационного взаимодействия между ОФД и ФНС появились правила по которым отправляют чеки в ошибку: если в чеке заполнили теги 1234 и 1235, то тег 1237 должен быть заполнен обязательно.
Т.е. в вашем случае, вероятнее всего, в чеке заполнен тег 1234 или 1235.
Буду пробовать без 1236 1237 и 1082.

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

если в чеке заполнили теги 1234 и 1235, то тег 1237 должен быть заполнен обязательно

Я конечно дико извиняюсь, а на кой заполнять никому не нужные сейчас теги 1234 и 1235 ?
Только для того, что бы получить проблемы с тегом 1237 из-за настраиваемых протоколов взаимодействия ОФД и ФНС ?

[wad_ja]

Я убрал 1236 и 1082 и сделал 1 чек с email в ОФД прошло и налоговая приняла ! Ура!

[RaFaeL]

Вроде бы успешно внедрили марки с 1 июля по новым группам товаров (парфюмерия и медицинские изделия) как вдруг пришли накладные приходные с товарами с какими-то недомарками где есть только GTIN, например 0204040943005669373 - 3 штуки (значение после разделителя 37) товара 04040943005669, и первые 2 символа не 01 а 02, это вроде как некий "объемно-сортовой учет", что с этим делать в контексте списания через кассу и надо ли что-то делать?

[finsoftrz]

Для маркированных товаров существует объемно-сортовой учет и поштучный учет. При объемно-сортовом учете производитель регистрирует марки в ЧЗ, а при продаже на кассах в рознице они переводятся в статус выбывших из оборота. Движения от производителя до розничной точки в ЧЗ не регистрируются. В эдо передаются gtin. Если поштучный учет, то в ЧЗ регистрируются все операции по каждой марке от производителя до розничной точки. В эдо передаются все марки (или иерархия с групповыми упаковками, палетами). В этом случае на момент продажи на кассе известен текущий владелец марки, чужие продавать запрещается.

[finsoftrz]

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

[RaFaeL]

при продаже на кассах в рознице они переводятся в статус выбывших из оборота.

Так а как это сделать? Я не нашел в обсуждаемом классе никакого упоминания ОСУ и разбора этого типа марок