Класс для 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 КБ) 52139 просмотров

[zmi]

Игорь, что-то у меня 21-й тест "сломался", а именно: как и положено осуществляется перевод в режим "Авария" с выдачей соответствующего сообщения, но сразу после этого вместо пропуска проверки и разрешения продажи возникает незапланированное сообщение:
ВНИМАНИЕ ! ВЫПИСКА КМ ЗАБЛОКИРОВАНА.
Молоко Сценарий 1, 2, 5, 7, 14, Авария
0104670540176099215LpGKy93dGVz
Ошибка проверки в ТС ПИоТ:
Это и на оригинальной версии класса от 28.05.2026 (только точку поменял на https://tspiot.sandbox.crptech.ru )
Посмотрите, плиз: или я опять что-то недоучел (в последней версии) или всё же ошибочка закралась.

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

Добрый день !

Специально для Вас проверил - всё прекрасно работает.

1. Выписываем КМ из 21 сценария (ошибка 203) и получаем сообщение о проблеме:

2. Продажа разрешена и никаких других сообщений я не вижу:

3. Ну и далее выписка уже идёт без сообщений об ошибке 203 (что неправильно, но это уже совсем другая история).
Я выписал несколько марок из сценариев с разрешённой продажей.

[zmi]

Игорь, спасибо большое! И за быстрый ответ тоже.
А, теперь понял, это не в классе сообщение, а я выдаю после обработки HonestClass.CheckOneCode, которая возвращает код 254 ("нет данных проверки").
Далее идет проверка на соответствие цены по bSetPrice.
И вот тут, по-видимому, надо добавить проверку на работу в аварийном режиме - корректно ли будет проверить флаг PIoT:FlagError203 ?

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

Пожалуйста.

Не хотел бы Вас расстраивать, но метод HonestClass.CheckOneCode() выполняет проверку КМ через ГИС МТ,
и вообще не имеет никакого отношения, ни к ТС ПИоТ, ни к флагам аварийного режима / переустановки цен.

Посмотрите пожалуйста файл примеров, там использование методов класса разделено на секции.

[zmi]

Упс, пардоньте, промазал с копипастом...(( Конечно же использую Loc:Honest.PIoT_CheckOneCode из этого примера
! Проверка кода маркировки в GS1 при выписке с получением результата для самостоятельного разбора
If Loc:Honest.PIoT_CheckOneCode(gOneCode,dSalePrice,gOneResponse) > 0
! Есть проблемы -> результат в gOneResponse
Honest::Message('Проблема: ' & gOneResponse.LockName)
...
И проблемка в том, что в аварийном режиме PIoT_CheckOneCode возвращает 254, хотя при этом gOneResponse.LockFlag=0 и gOneResponse.LockName=''.
Добавил в проверку на блокировку выписки gOneResponse.LockFlag<>0

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

Упс, пардоньте, промазал с копипастом

У Вас с этим максимально какая-то беда. В прошлый раз мы разбирали кривой копипаст как сканерозаменитель ...

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

Дошел до проверки в офлайн режиме, это пункты 5.17 - 5.20.
ЛМ ЧЗ установлен и инициализирован http://127.0.0.1:5995.
Использую значение PIoT:RootHost Equate('https://tspiot.sandbox.crptech.ru') ! SandBox ЦРПТ
Предполагаю, что для этих тестов необходимо "вырубить инет". Отключаюсь от вай-фая.

Добрый день !

Не правильно ! Когда Вы работаете с тестовым стендом ЦРПТ - то по факту работаете в облаке.
Т.е. "подключаетесь" к удалённому компьютеру, который выполняет для Вас операции.
Если Вы отключите инетернет - то просто потеряете связь с облачным тестовым стендом ЦРПТ.

И как следствие - при работе со стедом ЦРПТ Вам вообще не нужен установленный локальный ПО ЛМ.
Потому что ТС ПИоТ использует ПО ЛМ установленный на стенде (т.е. на сервере ЦРПТ)

Проще один раз увидеть - сделал тест для сценария 5.17 в самом простом и понятном варианте.
Собираем и смотрим. Результат:

Открываем в папке DEBUG лог ответа сервиса и видим полный результат:

Что собственно нам и требовалось - код маркировки из сценария 5.17 успешно прошёл проверку
в режиме OFF-LINE (т.е. с использованием ПО ЛМ установленном на стенде ЦРПТ)

[StillZero]

ОК, спасибо! Теперь понятно.

Еще один момент, на сайте https://tspiot.sandbox.crptech.ru/mark/17?mode=online указан код для теста 0104607010350246215kRdG-1%2(UmV, а в примере тот же код + <29>93dGVz.
Почему?

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

Почему?

Ну здесь всё вообще просто.

На указанном Вами сайте показан CIS - т.е. код идентификации из КМ.
А при сканировании - мы получаем полный код марки в GS1 (он показан на сайте в BASE64).

Собственно, если мы декодируем код с сайта - то получим GS1 из примера: