Адаптация УТ 10.3 для работы с ТС ПиОТ (ESM): используем код из УПП1.3

Руководство по точечному внедрению проверки кодов маркировки через локальный ESM в УТ 10.3 без перехода на УТ 11.

1. Зачем это нужно

При розничной продаже маркированных товаров действует разрешительный режим: перед фискализацией код маркировки (КМ) должен быть проверен, а в чек ФФД 1.2 передаются идентификатор запроса и время (тег 1260).

Два основных пути проверки КМ:

ПиОТ снижает зависимость от интернета: локальный модуль «Честный знак» (ЛМ ЧЗ) внутри ESM проверяет КМ даже при обрыве связи с ГИС МТ. Конфигурация УПП 1.3 (ветка с ПиОТ) содержит готовый блок. Типовая УТ 10.3 его не включает. Задача — точечно перенести блок ПиОТ, не ломая существующую розницу и CDN-fallback.

2. Основная идея адаптации

Что переносим:

• ~12 объектов метаданных ПиОТ (справочник, регистр, перечисление, формы).
• 6 общих модулей ИнтеграцияТСПИоТ*.
• Адаптацию имён API под модули УТ.
• Фасад проверки КМ в прикладном модуле.

Что НЕ переносим:

• Всю библиотеку ИСМП (~470 модулей).
• Документы опта ИСМП.
• ШтрихкодированиеОбщегоНазначения* целиком.

Что НЕ перезаписываем:

• Доработанные формы розницы.
• Модуль ЧекККМ целиком.
• CDN-ветку.

Принципы:

1. Точечный перенос, не объединение конфигураций.
2. Хук в существующую цепочку фискализации (ФискализироватьЧек), а не замена модуля документа.
3. CDN остаётся как вариант — если ПиОТ не настроен, поведение как раньше.
4. Адаптация API — модули из УПП ссылаются на имена модулей УПП; в УТ их нужно заменить на аналоги.
5. Сохранить доработки целевой конфигурации — особенно хранение и обработка штрихкодов маркировки.

3. Архитектура: как взаимодействуют компоненты

3.1. Общая схема на кассовом ПК

3.2. Роли компонентов

3.3. Цепочка при продаже

3.4. Почему два шага: ESM + буфер ККТ

Ошибка 420 «Контрольная марка не проверена» возникает, если КМ не зарегистрирована в буфере ФН перед пробитием.

• ESM выполняет разрешительный режим (бизнес-проверка в ГИС МТ).
• Буфер ККТ (ЗапросКМ/ПодтвердитьКМ) — техническая регистрация КМ в ФН для ФФД 1.2.

При ПиОТ проверка на ККТ через ОИСМ не нужна (уже проверено через ESM), поэтому в epf передаётся NotSendToServer = Истина.

4. Что импортировать из УПП

4.1. Метаданные (переносить целиком)

Зарегистрировать в Configuration.xml, ConfigDumpInfo.xml, при необходимости — в ролях.

4.2. Общие модули (переносить + адаптировать API)

4.3. Точечные доработки в существующих модулях целевой УТ

4.4. Что НЕ импортировать

• Всю библиотеку ШтрихкодированиеОбщегоНазначения* / ОбщегоНазначенияИСМП* (~470 файлов).
• ИнтерфейсИСМПОбщегоНазначения* целиком (~8000 строк) — только реально вызываемые функции.
• Модули МенеджерОборудования* / ОборудованиеЧекопечатающиеУстройства из УПП — если БПО в УТ достаточно.
• Типовую цепочку ШтрихкодированиеИСМПКлиент для сканирования — если в целевой конфигурации своя розничная логика.
• Модуль Документ.ЧекККМ из УПП — только хук, не замена.

4.5. Внешняя обработка (не входит в CF)

Подключается как обработка обслуживания ККТ ATOL на каждом кассовом месте.

5. Адаптация API: таблица замен

При переносе модулей ИнтеграцияТСПИоТ* из УПП в УТ 10.3 выполнить замену имён модулей:

Автоматизация: скрипты migrate_piot_to_prod.py, adapt_piot_api_prod.py, port_interface_helpers.py.

6. Ключевые функции адаптера (на примере ДопФункции)

Рекомендуется реализовать единый фасад в общем модуле прикладных функций.

6.1. ПроверитьКМПриПродаже — главная точка входа

ПроверитьКМПриПродаже(
    ОбъектДрайвера,
    ОбработкаОбслуживания,
    ТЧТовары,
    ФискальноеУстройство,
    ПараметрыОперацииФискализацииЧека,
    ТоварныйДокумент = Неопределено,
    ЭтоПродажа = Истина,
    ПроверятьСредствамиККТ = Истина)

Матрица сценариев:

6.2. ПроверитьКМ_РазрешительныйРежимТСПИоТ

• Сбор КМ из ТЧ (ШКМаркировки.ПолныйШтрихкод → Base64).
• HTTP POST api/v1/codes/check через ИнтеграцияТСПИоТКлиентСервер.
• Заполнение СтРезультатПроверкиКМ (ключ — ссылка на элемент ШтрихкодыУпаковокТоваров).

6.3. ЗарегистрироватьКМВБуфереККТПослеВнешнейПроверки

• Вызов epf: ПроверитьКодыКМПослеВнешнейПроверки → NotSendToServer = Истина.
• Без ожидания ответа ОИСМ на ККТ.

6.4. НастройкиПодключенияТСПИоТДляФискализации

Двухступенчатый поиск настроек ESM:

1. Справочник.ТСПИоТ.ПолучитьТСПИоТ(ФискальноеУстройство) — если БПО ≥ 3.2.9.8 и справочник заполнен.
2. РегистрСведений.НастройкиПодключенияТСПИоТ по НомерФискальногоНакопителя (= ЗаводскойНомерФН из параметров ККТ).

Рекомендации:

• Добавить реквизит СтИспользуетсяПиОТ (Булево) в регистр — включение/выключение без удаления настроек.
• Для одной кассы — fallback: если ЗаводскойНомерФН пуст, брать единственную активную запись регистра.
• Прокидывать ЗаводскойНомерФН из ПараметрыККТ в ПараметрыОперацииФискализацииЧека в формах предпросмотра и возврата.

6.5. Инициализация СтРезультатПроверкиКМ

Всегда создавать пустое Соответствие в начале ПроверитьКМПриПродаже — иначе МенеджерОборудованияВызовСервера.ЗаполнитьТоварнуюСтрокуЧека падает при возврате через предпросмотр.

7. Штрихкоды маркировки: типовая УТ vs доработанная

Это критическое различие, которое определяет, куда встраивать ПиОТ.

7.1. Типовая УТ 10.3

7.2. Доработанная УТ10 ПРОД (пример)

7.3. Что учесть программисту при адаптации

1. Не копировать слепо цепочку УПП (ШтрихкодированиеОбщегоНазначенияИСМП*) — она рассчитана на типовую структуру документов.
2. Найти в своей конфигурации, где хранится КМ в розничном документе: ШтрихкодУпаковки, ШКМаркировки, ШтрихкодыУпаковок (ТЧ) или иное.
3. Адаптировать сбор массива КМ в ПроверитьКМ_РазрешительныйРежимТСПИоТ под свои реквизиты.
4. Ключ СтРезультатПроверкиКМ — должен совпадать с тем, что используется при заполнении тега 1260 в ЗаполнитьТоварнуюСтрокуЧека / ДанныеДляПробитияЧека.
5. Если в конфигурации нет ПолныйШтрихкод — нужна своя функция подготовки Base64-кода для ESM.

8. Настройка ESM на стенде

8.1. Два способа хранения настроек в 1С

Связь параметров:

Важно: в fallback-ветке регистра поиск идёт по номеру ФН, а не по UUID кассы. Если ЗаводскойНомерФН не передан в параметрах — запись не найдётся.

8.2. Рекомендуемый реквизит СтИспользуетсяПиОТ

Булево в регистре НастройкиПодключенияТСПИоТ:

• Истина — проверка через ESM;
• Ложь — настройки сохранены, но используется CDN (fallback).

Добавить в запрос: ГДЕ СтИспользуетсяПиОТ = ИСТИНА.

9. Точки интеграции в рознице (чеклист программиста)

После переноса метаданных и модулей встроить вызов ПроверитьКМПриПродаже в существующие точки фискализации:

Не включать типовой async-путь BPO ПроверитьКодМаркировкиСредствамиККТ / PiotCheckKM, если используется кастомный epf ATOL.

10. Требования к окружению

11. Порядок внедрения (пошагово)

Фаза 0 — подготовка

• Бэкап целевой конфигурации и базы
• Diff целевая ↔ УПП (розница, маркировка, ККТ)
• Diff целевая ↔ типовая (что уже доработано)
• Зафиксировать версию БПО

Фаза 1 — метаданные

• Перенести объекты из раздела 4.1
• Загрузить в конфигуратор, обновить БД
• Проверка конфигурации

Фаза 2 — модули ПиОТ

• Перенести 6 модулей из раздела 4.2
• Адаптировать API (раздел 5)
• Компиляция модулей

Фаза 3 — адаптер розницы

• Функции в ДопФункции (раздел 6)
• Хуки в точках из раздела 9
• Гиперссылка в ПанельОбменИСМП
• Подключить epf ATOL

Фаза 4 — настройка и права

• Запись в НастройкиПодключенияТСПИоТ (ФН + адрес ESM)
• Права на ТСПИоТ, НастройкиПодключенияТСПИоТ, ШтрихкодыУпаковокТоваров
• Права на Document.ЧекККМ (Read без RLS для закрытия смены, если нужно)

Фаза 5 — тестирование

• Продажа с маркой через ПиОТ
• Продажа без ПиОТ (CDN regression)
• Возврат (та же смена + через предпросмотр)
• Скан при продаже (онлайн без буфера)
• ESM недоступен / аварийный режим
• Закрытие кассовой смены

12. Типичные ошибки и решения

13. HTTP API ESM (справочно)

Ответ codes/check содержит статусы кодов и реквизиты для тега 1260 (reqId, reqTimestamp / аналоги в JSON ESM).

14. Краткий вывод

Адаптация УТ 10.3 под ПиОТ — это не перенос всей маркировки из УПП, а:

1. Импорт ~12 объектов метаданных и 6 модулей ТС ПиОТ.
2. Адаптация имён API под модули УТ.
3. Реализация фасада проверки КМ в прикладном общем модуле.
4. Хук в свою (не типовую) цепочку фискализации.
5. Настройка ESM + epf ATOL на кассе.
6. Учёт особенностей хранения штрихкодов в целевой конфигурации.

CDN остаётся запасным путём. ЛМ ЧЗ работает через ESM, не через 1С. Буфер ККТ обязателен даже после успешной проверки ESM.