Как настроить работу с Локальным модулем Честного Знака версии 2.X в 1С:Розница 2.3?

Системный администратор 1С v8.3 (Управляемые формы) 1С:Розница Торговля и дистрибуция
← На главную

При обновлении Локального модуля (ЛМ) государственной системы маркировки «Честный Знак» до версии 2.X многие пользователи конфигурации 1С:Розница редакции 2.3 сталкиваются с невозможностью установить связь между учетной системой и службой проверки кодов. Программа выдает ошибки соединения, а в настройках подключения отсутствует видимая возможность переключить протокол API с v1 на v2. Разберем причины возникновения этой неполадки, штатные способы ее устранения в типовой конфигурации и временные обходные пути.

Причина проблемы: несовместимость протоколов API

Проанализируем техническую сторону взаимодействия учетной системы с локальной службой проверки кодов. В Локальном модуле версии 2.X разработчики ЦРПТ перешли на обновленный протокол API v2. Из структуры эндпоинтов службы были исключены или модифицированы старые пути, использовавшиеся в первой версии API, в том числе эндпоинт api/v1/status.

В релизах конфигурации 1С:Розница 2.3, предшествующих версии 2.3.24.26, библиотека интеграции с ИС МП жестко обращается к маршрутам API v1. При попытке опроса состояния или инициализации Локальный модуль возвращает ошибку с кодом HTTP 404 (Not Found). Пользователь физически не может изменить версию протокола в интерфейсе программы, так как соответствующий реквизит и логика переключения в устаревших версиях конфигурации отсутствуют.

Решение 1: Штатное обновление конфигурации и переключение формата обмена

Рассмотрим официальный и наиболее правильный метод решения проблемы. Начиная с версии 2.3.24.26, разработчики фирмы «1С» добавили полную поддержку API v2 для взаимодействия с Локальным модулем. Разберем по шагам порядок действий для перехода на новую версию:

  1. Обновление конфигурации: обновим информационную базу «1С:Розница 2.3» до релиза 2.3.24.26 или выше. Если используется базовая версия конфигурации, обновление выполняется в штатном режиме через сервис обновлений.
  2. Переустановка службы ЛМ: выполним полное удаление устаревшей службы Локального модуля 1.X через панель управления операционной системы, после чего установим чистую версию Локального модуля 2.X.
  3. Настройка формата обмена в 1С: перейдем в раздел Администрирование (или Настройки) → Интеграция с ИС МП → Настройки подключения к ЛМ ЧЗ. В открывшейся форме найдем появившийся реквизит «Формат обмена» и переключим его значение с «V1» на «V2».
  4. Инициализация модуля: нажмем гиперссылку «Запустить процесс настройки», укажем актуальный токен ККТ из личного кабинета системы маркировки и завершим привязку службы.

Решение 2: Временный откат на Локальный модуль версии 1.5.2

Выясним, как поступить в ситуации, когда оперативно обновить конфигурацию 1С не представляется возможным (например, требуется время на доработку или согласование, либо используется закрытая базовая версия без возможности внесения оперативных правок в код конфигуратором).

Рабочим временным решением является откат службы на версию ЛМ 1.5.2. Рассмотрим особенности применения этого метода:

  1. Остановим и удалим службу Локального модуля версии 2.X.
  2. Установим и заново инициализируем дистрибутив ЛМ 1.5.2.
  3. Проверим доступность службы из 1С:Розница — поскольку версия 1.5.2 полноценно поддерживает маршруты API v1, программа сразу восстановит обмен данными без изменения исходного кода.

Важное ограничение: данный способ подходит не для всех категорий товаров. Версия ЛМ 1.5.2 успешно справляется с проверками для легкой промышленности («шмотки»), обуви и прочих категорий, где не требуется расширенный офлайн-контроль цен. Однако версия ЛМ 2.X является обязательной для розничных продавцов никотинсодержащей и табачной продукции, где законодательно зафиксирована необходимость офлайн-проверки минимальной розничной цены (МРЦ/ЕМЦ). Если в номенклатуре присутствует табачная продукция, откат на 1.5.2 не позволит соблюсти требования законодательства — в этом случае обновление конфигурации 1С до релиза с поддержкой API v2 строго обязательно.

Установка исправлений (патчей) в базовых версиях

Обратим внимание на работу с базовыми версиями конфигурации 1С. В них закрыта возможность модификации конфигурации через Конфигуратор, поэтому программист не может вручную исправить путь запроса в коде модуля. Однако при выходе официальных исправлений от разработчиков 1С пользователи базовых версий могут загружать расширения-исправления.

Для проверки и установки доступных исправлений выполним следующие действия:

  1. Перейдем в раздел Администрирование → Обслуживание.
  2. Откроем пункт Обновление программы → Установка обновлений и исправлений (патчей).
  3. Загрузим и применим актуальные патчи по подсистеме интеграции с ИС МП.
← На главную