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

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

Привет всем !

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

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

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

Список изменений в версии от 28.05.2026 г.
----------------------------------------------------------------------------------------------------
- Завершена поддержка работы с API ТС ПИоТ версии 2 (в т.ч. и в ЕСМ ПО ЛМ);
- Поддержка изменений в ЕСМ от АО "ЕСП" версии 1.6.3;
- Получение через ТС ПИоТ токена для инициализации ПО ЛМ;
- В сообщение об ошибке показаны версии API и хост для каждого сервиса;
- Добавлены ссылки Национального каталога и получения API KEY доступа;
- Получение номера товарной группы по коду GTIN из Национального каталога;
- Устранены проблемы по запросам и внесены изменения в примеры.
----------------------------------------------------------------------------------------------------
Рекомендуем использовать актуальные версии классов LibCURL, cJSON и PrintF.

esp.png (13.96 КБ) 49204 просмотра

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

продажи не в диапазоне цен сами не блокируют

Этому есть объяснение. МРЦ устанавливает производитель (импортёр), а ЕМЦ / МЦ - Минсельхоз раз в год.
Поэтому товар тупо может заваляться на складе и при продаже произойти конфликт с текущими ограничителями цен.
Регламент предписывает переустановить розничную цену реализации или вернуть товар производителю (импортёру).

Вы (ПМСР) при проверке не сообщаете в ГИС МТ розничную цену реализации. Поэтому принятие решения на стороне ПМСР.

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

Скоро, действительно, все, кроме федералов, закроются.

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

Список изменений в текущей версии публикуется в заглавном сообщении темы.

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

Галя, у нас отмена !

Начались непонятки на сертификации с протоколами ТС ПИоТ (ошибка 403).
На сайте ЦРПТ / АО "ЕСП" представлены 2 несовместимых варианта формата запроса API версии 3:

Сейчас реализован вариант для отладочного стенда (на рисунке слева).
Запросил информацию в тех. поддержке, но это не быстро будет ...
До выяснения рекомендую переключить класс на версию API 1 или 2 для ТС ПИоТ - с ними всё OK !

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

PIoT:VerAPI          Equate('1')    ! Версия API: 1, 2, 3

P/S:
Тех. поддержка ответила, что правильный вариант всё-таки в эмуляторе (слева на рисунке).
Он сейчас и реализован в классе. Т.е. пока ничего не переделываем (мне не сложно) и ждём
обновления описания протоколов и самого локального ТС ПИоТ с поддержкой API версии 3 ... Мда.

[SergioRaguzini]

Привет Всем!
Хотел бы уточнить несколько методологических моментов по работе ЛМ ЧЗ.
На первом этапе (до того как появился сам ЛМ), когда марка проверялась "напрямую", то, при получениии положительного результата проверки от ЧЗ, заполнялись соответствующие атрибуты тегов ККМ и в ККМ выполнялась регистрация продажи. Но в документации по ЛМ, присутсвуют "Метод регистрации факта продажи товаров" и, соответственно, "Метод возврата товаров".
Исходя из данных пунктов, напрашивается необходимость, что после успешной(безошибочной, с точки зрения функционала ФР) регистрации продажи в ККМ, необходимо записать КМ товаров в ЛМ, в список проданных (и аналогично, при возврате, удалить).
Будет ли правильным такой алгоритм действий?
Спасибо

p.s. А вообще, для чего(?) в ЛМ хранить продажи/возвраты в базе ЛМ, если в той же документации по ЛМ сказано:

• БД проданных товаров хранится только в месте установки ЛМ ЧЗ, рекомендуется периодически делать резервную копию;
• по умолчанию добавленные КИ удаляются из базы проданных товаров через 30 дней.

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

когда марка проверялась "напрямую"

Что бы не запуться, я предлагаю придерживаться терминологии ЦРПТ (которая далека от идеала, но всё-таки).
Да, разрешительная проверка КМ выполняется в ГИС МТ и по новой версии это будет работать до 01.07.2026 г.

что после успешной(безошибочной, с точки зрения функционала ФР) регистрации продажи в ККМ, необходимо записать КМ товаров в ЛМ, в список проданных (и аналогично, при возврате, удалить). Будет ли правильным такой алгоритм действий?

Да. Но это делать необязательно. Запись продаж / возвратов с использованием указанных Вами методв ПО ЛМ выполняется
только для контроля дубликатов в режиме проверки Off-Line (без доступа к ГИС МТ через CDN площадки). Вы можете вести
самостоятельно в БД ПМСР список проданных КМ и проверять дубликаты по нему. Важно что бы такая проверка выполнялась.

Считается, что 30 дней достаточно для того, что избежать путанцы и пересортицы с повторной продажей КМ.

Но это не значит, что Вы можете обойтись в режиме проверки OFF-LINE без ПО ЛМ, т.к. всё равно должны проверять в нём КМ
на предмет блокировки ОГВ, ну и собственно получать данные для тега 1260 кассового чека. Как-то так ...

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

Выяснилось, что на 01.07.2026 г. намечен не только переход разрешительной проверки КМ с ГИС МТ на ТС ПИоТ,
но и полная замена версии ПО ЛМ "Честный ЗНАК" с 1 на 2.1 (кстати с несовместимым API):

Если конечно ЦРПТ не переобуется на лету со сроками, как уже было не раз.

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

Госкомиссия поддержала полный запрет в РФ электронных сигарет, вейпов и жидкостей для их наполнения.
Согласованные Госкомиссией инициативы практически всегда принимаются в форме закона, так как она является межведомственным органом, куда включены руководители федеральных и региональных органов власти

Вот Игорю интересно, а на кой тогда были все эти пляски с бубном вокруг НСП с их ценами в "Честном ЗНАКЕ" ?

[finsoftrz]

То, что творят сейчас чиновники, на голову не налазит. Я смотрю на происходящее большими круглыми глазами, как и все, наверно.

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

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

[finsoftrz]

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

[finsoftrz]

Интересно, а долго заявление на функциональное тестирование находится на рассмотрении? У меня уже больше 2 недель прошло. На письма по электронной почте не отвечают...

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

функциональное тестирование

А зачем ? Вы же, вроде бы, с улицы не наливаете ?
А если уже получили доступ в промышленную среду, то просто выполняйте настройку своих РМК
самостоятельно (или через доверенных сисадминов на местах) и работайте без проблем.

[finsoftrz]

Вы не поняли. Я не получил доступ в "промышленную среду", только отправил заявку, она больше 2 недель висит на рассмотрении, а на письма не отвечают.

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

Вы не поняли.

А ! Т.е. это ЦРПТ. Ну там всё строго по регламенту. Вы же видите статус своей заявки в ЛК ?
И всегда можно уточнить статус прохождения заявки в тех. поддержке - они в течении 48 часов должны ответить
(реально отвечают в течении рабочего дня). Возможно ожидают какой-то запрошенный документ и т.д.