Класс для API ТС ПИоТ ЕСМ от АО «ЕСП»

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

Привет всем !

Класс для разрешительной проверки КМ (кодов маркировки) через API ТС ПИоТ ЕСМ от АО «ЕСП».
Поддержка работы с API ЦРПТ: ПО Локальный модуль и Национальный каталог.
Полный боевой комплект с описанием интерфейса API и примерами.

Реализованный в классе функционал соответствует ПФС версии 1.16 от 20.05.2026 г. (26 сценариев),
для получения сертификата совместимости и допуска к работе в промышленной среде ТС ПИоТ ЦРПТ.

Благодарность за помощь на старте проекта: FinsoftRZ и Alex412.
Любые замечания, исправления и дополнения - приветствуются !
----------------------------------------------------------------------------------------------------
Рекомендуем использовать актуальные версии классов LibCURL, cJSON и PrintF.

esp.png (13.96 КБ) 16780 просмотров

[finsoftrz]

В чем опасность? Не встречал, чтобы количество маркированных товаров было дробным. Бывает, когда отгружают в литрах/кг. В этом случае количество марок указывается отдельно.

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

В чем опасность?

Ну у Вас как бы предполагается, что Len(Tov:Shtrih) всегда 13 и GTIN всегда начинается с "0". Не факт. Например сигареты.

Не встречал, чтобы количество маркированных товаров было дробным

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

[finsoftrz]

У нас gtin это всегда еан13, дополненный нулем спереди до 14 знаков. С другими вариантами не сталкивался. Столкнемся, будем думать. Видел где-то, что для товара gtin указывался отдельно от шк. Это будет довольно неудобно для работы, так как тогда у товара может быть как несколько шк, так и несколько gtin.
Количество у нас контролируется в зависимости от типа товара (штучный или весовой/мерный). У штучного товара не может быть никаких дробных остаточков. Вот отгружать могут в литрах, когда цена задается на литр. В этом случае рядом с количеством в литрах в накладной можно поставить дополнительно количество целых бутылок или упаковок. А если не поставили, то считается как 1.

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

Видел где-то, что для товара gtin указывался отдельно от шк.

Правильно говоря - это вообще разные коды. Тут можно кратко вспомнить историю.

Когда вводили GTIN то наши деятели успели даже открыть совместно российско-немчиновое предприятие
для выдачи логистических GTIN "всем тёмным росиянам". Кажется хотели недорого. По 3000 рубликов за код.
Но поднялась волна народного гнева, которая дошла до Думы. Тогда Минторге отложили мечту о домике в Израиле
и сказали что пошутили. GTIN - это тот же штрих-код. 0 + EAN13 для штучного товара и EAN14 для фасованного.

Это я к чему рассказал ? Например, на коробку с мороженным наносится упаковочный КМ длиной 60 символов,
который содержит 14-значный GTIN и первая цифря в нём совсем не 0 ...

[finsoftrz]

В связи с надвигающимся ПИоТ (с 28.12.2025), все разработки, связанные с true api. вроде как уходят на свалку истории? Хотя, мне кажется, все сразу не отключат. Что-то так стремительно, очень прямо жалко потраченного времени жизни на эту чепуху.

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

Особенно радует реестр официально зарегистрированных ПИоТ !
https://xn--80ajghhoc2aj1c8b.xn--p1ai/i ... e-ts-piot/

Но есть интересная оговорка ... что вот эта вот хрень может быть встроена в драйвер ККТ.
Мне кажется, что развитие пойдёт именно по этому пути (через покупку отдельной лицензии разумеется) и потом ...
потому что на Январь 2026 г. запланирован переход на новые ставки НДС и это государству намнооооого интересней,
чем бесконечные придумки "Честного ЗНАКА" ...

[finsoftrz]

Народ потихоньку уже начал закрываться в связи с изменениями правил по ндс. Хотя порог освобождения на 26 год сделали 30 млн, а в следующие 2 года еще понизят до 10 млн, как хотели изначально. 30 млн это больше 2 млн оборота в месяц, примерно небольшой продуктовый магазин на пару кассовых проходов.

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

примерно небольшой продуктовый магазин на пару кассовых проходов.

Да ! Выжившие перенесут налоги на покупателей.
Мне вот с "новым" НДС нравится, что Дума только приняла закон, СФ и Президент его ещё не видели.
Ну подпишут конечно. Но ни прошивок ККТ, ни изменений форм отчётности, ни методических рекомендаций по применению ...
А Вы говорите ПИоТ с января запускать ...

[finsoftrz]

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

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

Ну я читал, что повышения ставки налога - это от отсутствия креативных идей и реальных рычагов
в Правительстве вообще и в Минфине в частности. Нам не на что больше жать ! (С) Аквариум

Произойдёт стагнация рынка и ожидаемый гешефт будет нивелирован уменьшением налоговой базы.
Ставь лайк, если тоже понимаешь как непросто досидеть на тёплом месте до пенсии !

[finsoftrz]

На темную сторону начнут активно уходить.

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

Всем привет !

Новогодняя версия класса для API НСЦМ «Честный ЗНАК» / ТС ПИоТ от 02.01.2026 г.
-------------------------------------------------------------------------------
- Отработаны изменения в Руководстве ЦРПТ версии 14 от 29.12.2025 г. (прилагается в комплекте);
- Реализована проверка КМ по протоколу ТС ПИоТ (примеры для тестового стенда ЦРПТ и описание API - прилагаются);
- Устранены известные проблемы в рабочем порядке.
-------------------------------------------------------------------------------

Как я понимаю, далее нужно переключать Edpoint на локальный ТС ПИоТ от ЕСМ и проверять.
Если у кого-нибудь (а вдруг !) уже есть настроенный боевой ЕСМ - попробуйте пожалуйста и пишите о результате.

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

!!! Endpoint интеграционного стенда ПИоТ
PIoT:RootHost        Equate('https://tspiot.sandbox.crptech.ru/api/v1')  ! SandBox ЦРПТ                
!PIoT:RootHost       Equate('http://localhost:51401/api/v1')             ! ЕСМ ?! 

Вот здесь марки для тестирования обработки ошибок: https://esm-emu.ao-esp.ru/

P/S: Я не знаю какая больная обезьяна и зачем придумала формат ответа сервиса "массив из массивов внутри массива",
а также вложенные теги с одинаковым наименованием, но класс cJSON его разобрал ! Не сразу. Но разобрал !

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

Всем привет !

Версия класса для API НСЦМ «Честный ЗНАК» / ТС ПИоТ от 04.01.2026 г.
-------------------------------------------------------------------------------
- Новый режим для проверки КМ из кеша ТС ПИоТ Off-Line;
- Новый метод PIoT_CheckReceipt() - проверка содержимого кассового чека в ТС ПИоТ;
- Новый Метод PIoT_CheckOneCode() - проверка одного КМ (в т.ч. МРЦ и ЕМЦ) при выписке;
- В процедуре Honest::CheckReceipt() опция gContact.bPIoT переключает проверку КМ на ТС ПИоТ;
- Изменена структура фильтра для определения попадания КМ в товарные группы;
- Добавлена расшифровка ОГВ в сообщениях о блокировке оборота КМ;
- Добавлена настройка Endpoint для тестирования ТС ПИоТ в песочнице ЕСМ;
- Внесены поправки по результатам тестирования ошибок КМ на эмуляторе ЕСМ;
- Устранены известные проблемы в рабочем порядке;
- Обновлены примеры и описание.
-------------------------------------------------------------------------------
- КЛАСС ПРОВЕРЕН ЧЕРЕЗ РЕАЛЬНЫЙ БОЕВОЙ ТС ПИоТ от ЕСМ - ВСЁ ОК ! УРА !

Удачи Вашему ПМСР при прохождении сертификации в ЦРПТ !

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

Всем привет !

В файле полезная информация для подготовки к сертификации Вашего ПМСР в ЕСМ.
На вскидку, в классе всё нужое уже есть, но теперь требуется прогнать все тесты ЕСМ (и возможно внести корректировки).
Если кто-нибудь обнаружит какие-либо несоответствия в тестах ЕСМ - пишите сюда, будем доводить класс до кондиции.

[zmi]

Столкнулся с такой проблемкой. По описанию класса сделал тестовый примерчик, а он не работает - в GPF уходит.
Начал разбираться: как только вызывается процедура с объявлением класса SpecialFolder, программа валится.
Сделал тестовый "чистый" пример уже на класс SpecialFolder по описанию из CW help'а - GPF.
Прописал в проект <DefineConstants>_ABCDllMode_=&gt;0%3b_ABCLinkMode_=&gt;1</DefineConstants>
Помогло. Может еще кому-то поможет на те же грабли не наступить.