При настройке и интеграции Локального модуля «Честного Знака» (ЛМ ЧЗ) с программными продуктами 1С (например, 1С:Розница) пользователи часто сталкиваются со следующей ошибкой подключения:
«Не удалось подключиться к локальному модулю. Описание ошибки: Не удалось запросить данные ГИС МТ по причине: При выполнении запроса api/V1/STATUS возникла ошибка. Код состояние HTTP 404».
В этой статье мы подробно разберем, почему возникает данная проблема, проанализируем архитектурные изменения в системе маркировки и пошагово рассмотрим, как настроить корректное взаимодействие кассового ПО с актуальной версией Локального модуля.
---
Код состояния HTTP 404 Not Found означает, что запрашиваемый ресурс не найден на сервере. В контексте нашей проблемы адрес запроса содержит путь api/V1/STATUS. Это указывает на то, что программа 1С пытается обратиться к первой версии (V1) API Локального модуля.
Оператор маркировки ЦРПТ полностью прекратил поддержку и отключил серверную часть первой версии Локального модуля (версии семейства 1.5.х и ниже). Все старые модули принудительно переводятся в режим деконфигурации (not_configured), а попытки отправить запросы по старым адресам возвращают ошибку 404.
Сейчас актуальной и единственной рабочей является вторая версия API (V2) Локального модуля (версии 2.5.х, 2.6.х и выше). В ней изменился не только адрес запроса (теперь он выглядит как api/V2/...), но и структура ответов в формате JSON. Соответственно, если ваша программа 1С «не умеет» общаться по протоколу V2, настроить обмен не удастся.
---
Прежде чем приступать к настройке 1С, нам необходимо убедиться, что сам Локальный модуль установлен, запущен как служба и готов к работе. Проанализируем статус модуля. Для этого выполним GET-запрос к локальной службе (по умолчанию она работает на порту 1443 или 8080 в зависимости от настроек) либо воспользуемся специализированной утилитой проверки.
Пример JSON-ответа от работоспособного, но еще не настроенного модуля версии V2 выглядит следующим образом:
{
"version": "2.6.0-10",
"status": "not_configured",
"serviceUrl": "https://rsapi.crpt.ru",
"operationMode": "active",
"name": "regime",
"lastUpdate": 0,
"lastSync": 0,
"isGreyGtin": false,
"inst": "",
"dbState": {}
}
Давайте проанализируем эти параметры:
"version": "2.6.0-10" — на компьютере установлена актуальная версия модуля V2. Это отлично."status": "not_configured" — это ключевой маркер проблемы. Модуль запущен, но он не инициализирован. База данных заблокированных кодов пуста, модуль не связан с конкретным личным кабинетом налогоплательщика.Если Локальный модуль находится в статусе not_configured, он не сможет осуществлять проверки в режиме офлайн. При отсутствии интернета касса будет выдавать ошибки, а в личном кабинете «Честного Знака» начнут копиться предупреждения о продажах без проверки по разрешительному режиму.
---
Поскольку в сообщении об ошибке фигурирует старый адрес api/V1/STATUS, это однозначно указывает на то, что используемый релиз 1С:Розница (в данном случае 3.0.12.261) не поддерживает отправку запросов по протоколу V2, либо в настройках интеграции не переключена версия АПИ.
Рассмотрим порядок действий для исправления этой ситуации:
localhost или локальный IP-адрес компьютера, где установлен ЛМ) и порт.---
После того как мы обновили программу 1С и убедились в наличии версии ЛМ 2.6.0, нам необходимо перевести модуль из статуса not_configured в рабочий статус.
Существует два основных способа инициализации Локального модуля:
Это наиболее современный и автоматизированный метод. В связке с Единым сервисным модулем (ЕСМ) версии не ниже 1.6.3.0 и ТС ПИоТ кассовое ПО способно автоматически инициализировать ЛМ ЧЗ. Для этого используются криптографические ключи фискального накопителя (ФН) подключенной онлайн-кассы. При таком подходе ручной ввод токенов не требуется, так как система генерирует динамические токены авторизации самостоятельно.
Если автоматическая инициализация не отрабатывает, мы можем запустить процесс вручную с помощью 1С или сервисной утилиты. Для этого выполним следующие действия:
Важное предупреждение: Процесс первичной загрузки базы данных (базы инцидентов и заблокированных кодов) крайне ресурсоемок. Синхронизация может занимать от 20 минут до 5-6 часов в зависимости от скорости интернет-соединения и загруженности серверов ЦРПТ. На протяжении этого времени статус модуля может оставаться в режиме настройки. Настоятельно рекомендуем проводить первичную инициализацию в нерабочее время торговой точки. Для ручной инициализации и диагностики без Postman можно использовать мастер инициализации и проверки Локального модуля «Честный знак», который подключается к установленному ЛМ по REST API, позволяет запустить инициализацию и проверить его текущий статус.
---
Часто у пользователей возникает иллюзия, что все работает правильно, потому что при сканировании марок на кассе данные уходят в ОФД, а в личном кабинете Честного Знака увеличивается счетчик «Онлайн ГИС МТ».
Давайте проясним этот момент. Если Локальный модуль не инициализирован (находится в статусе not_configured), программа 1С автоматически переходит в режим прямой онлайн-проверки через API ГИС МТ. Проверить это можно, открыв чек в ЛК ОФД:
Таким образом, полноценно настроенный и инициализированный Локальный модуль версии V2 — это залог отсутствия штрафов за продажу неисправных или заблокированных кодов маркировки при перебоях со связью. Если требуется собственная интеграция 1С с разрешительным режимом, в готовом примере работы с «Честным знаком» и ТС ПИоТ реализованы онлайн- и офлайн-проверки, переход на ЛМ ЧЗ версии 2.x и работа с API ТС ПИоТ.