Почему 1С:УНФ ругается на авторизацию в ГИС МТ при розничной продаже маркированных товаров и как это исправить?

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

При работе с маркированными товарами в рознице пользователи 1С:УНФ (Управление нашей фирмой) версии 3 часто сталкиваются с проблемой авторизации в ГИС МТ (Государственная информационная система мониторинга товаров, также известная как «Честный ЗНАК»). Основная сложность возникает при сканировании марки в Рабочем месте кассира (РМК), когда система выдает ошибку авторизации, несмотря на наличие так называемого «розничного токена» — поможет внешняя обработка для онлайн-касс с поддержкой разрешительного режима. Парадоксально, но при актуализации «не розничного» токена авторизация проходит успешно. Разберемся, почему так происходит и как правильно настроить работу с токенами.

Понимание типов токенов авторизации в ГИС МТ

Чтобы выяснить причину проблемы, нам необходимо рассмотреть основные типы токенов, используемых для взаимодействия с системой «Честный ЗНАК», и их предназначение.

  1. X-API-KEY (розничный токен):

    Этот токен является бессрочным и предназначен специально для розничных продаж на кассах. Его основная функция — выполнение проверок марок по разрешительному режиму. Изначально планировалось, что срок его действия будет ограничен, однако оператор системы маркировки продлил его до 1 июля 2026 года. Именно этот токен должен использоваться для подключения к ГИС МТ при розничной продаже в 1С:УНФ и 1С:Рознице. В конфигурациях 1С он обычно отображается с типом «ИС МП (розница)» для конкретной организации. Для его корректной работы часто требуется установка специальных патчей от 1С, продлевающих срок его действия в программном обеспечении.

  2. TrueAPI токены (ранее JWT, сейчас UUID):

    В отличие от X-API-KEY, эти токены имеют ограниченный срок действия, обычно не более 10 часов. Они используются для взаимодействия с СУЗ (Станция управления заказами) и другими API «Честного ЗНАКа», то есть для программных запросов, не связанных напрямую с продажами на кассах. Например, через TrueAPI можно заказывать коды маркировки, подписывать документы, работать с агрегированными кодами и так далее — удобнее через универсальное решение для интеграции с Честным Знаком. С 1 марта 2026 года «Честный ЗНАК» планирует перейти на использование UUID-токенов вместо JWT-токенов для авторизации, но поддержка JWT-токенов была продлена до осени 2026 года в связи с обновлениями инфраструктуры True API. Эти токены требуют регулярного обновления и обычно генерируются с использованием квалифицированной электронной подписи (УКЭП).

Почему 1С:УНФ может использовать неверный токен?

Как мы видим из обсуждения на форуме, основной вопрос автора заключается в том, почему при сканировании марки в РМК 1С:УНФ ругается на авторизацию, когда используется «розничный» токен, но начинает работать, если актуализировать «не розничный» токен ИС МП. Разберем эту ситуацию подробнее:

Суть проблемы: До 1 июля 2026 года (пока не введен в обязательную эксплуатацию ТСПИоТ) проверки марок по разрешительному режиму на кассах при розничной продаже должны осуществляться по X-API-Key – тому самому бессрочному токену из личного кабинета ГИС МТ. Если типовая конфигурация 1С запрашивает другой тип токена для этих операций, это может быть связано с несколькими причинами:

  1. Ошибка в конфигурации 1С: Возможно, в текущей версии конфигурации или ее настройках присутствует ошибка, которая заставляет систему использовать динамические TrueAPI токены (типа JWT/UUID) для операций в РМК, хотя для розницы должен применяться X-API-Key. Это может быть связано с некорректной логикой взаимодействия с ГИС МТ, заложенной разработчиками.
  2. Ошибки в настройках пользователя: Реже, но возможно, что пользователь некорректно настроил параметры обмена с ГИС МТ, в результате чего система пытается использовать токены, предназначенные для других операций. Однако, как справедливо отмечается в обсуждении, типовая конфигурация должна предотвращать возможность создания таких «косяков» пользователем.
  3. Отсутствие необходимых патчей: 1С регулярно выпускает патчи для актуализации работы с «Честным ЗНАКом», включая продление сроков действия токенов или исправление логики их использования. Если критически важный патч не установлен, система может работать некорректно.

Если «не розничный» токен (который, скорее всего, является TrueAPI токеном) работает, это может означать, что 1С:УНФ по какой-то причине использует его для авторизации, даже если это не соответствует рекомендованной логике для розничных продаж. Это является некорректным поведением, так как для кассовых операций следует использовать стабильный X-API-Key.

Правильное использование токенов для РМК

Итак, для розничных продаж маркированных товаров в РМК 1С:УНФ должен использоваться X-API-Key. Этот токен бессрочен до 01.07.2026 и не требует постоянного обновления. Проблемы с авторизацией, когда «розничный токен» не работает, обычно указывают на следующие моменты:

  1. Отсутствие или некорректный X-API-Key: Возможно, токен не был сгенерирован в личном кабинете ГИС МТ или неверно добавлен в 1С:УНФ.
  2. Неустановленные патчи: 1С выпускает патчи, которые исправляют логику работы с токенами и продлевают их срок действия в программном обеспечении. Отсутствие такого патча может быть причиной некорректного поведения.
  3. Ошибки в логике 1С: Несмотря на то, что это типовая конфигурация, не исключены внутренние ошибки, которые заставляют ее неверно определять, какой токен использовать для РМК.

Основные шаги для решения проблем с авторизацией в ГИС МТ в 1С:УНФ

Разберем по шагам, что нам необходимо проверить и настроить для устранения проблем с авторизацией в ГИС МТ при розничной продаже маркированных товаров.

1. Проверяем версию 1С:УНФ и устанавливаем необходимые патчи

Прежде всего, убедимся, что наша конфигурация 1С:УНФ обновлена до последней версии. Также критически важно проверить наличие и установить необходимые патчи, касающиеся работы с маркировкой и сроков действия токенов.

  1. Актуализируем конфигурацию: Удостоверимся, что используется самая последняя версия 1С:УНФ 3.0 (например, 3.0.13.278 или новее). Регулярные обновления помогают исправить известные ошибки и улучшить взаимодействие с внешними системами.
  2. Проверяем и устанавливаем патчи: 1С выпускает специальные патчи для продления срока действия розничного токена и корректной работы разрешительного режима. Например, для продления срока действия X-API-KEY до 1 июля 2026 года был выпущен патч EF_00_00835911. Мы рекомендуем установить его до 1 марта 2026 года. Если в конфигурации включено автообновление, патч должен установиться автоматически. В противном случае его необходимо скачать с портала releases.1c.ru и установить вручную. После установки обязательно проверяем его применение в разделе «О программе», подразделе «Информация для технической поддержки». Для более старых версий или других проблем могли требоваться патчи вроде EF_00_00708281.

2. Проверяем и настраиваем X-API-Key (Розничный Токен) в 1С:УНФ

Убедимся, что правильный розничный токен сгенерирован и корректно внесен в 1С.

  1. Генерируем X-API-Key в личном кабинете ГИС МТ: Заходим в личный кабинет «Честного ЗНАКа» под учетной записью нашей организации. В профиле пользователя или в разделе настроек находим опцию для генерации токена авторизации для контрольно-кассовой техники (или X-API-Key). Генерируем новый токен и копируем его.
  2. Добавляем токен в 1С:УНФ:

    Переходим в 1С:УНФ. Открываем раздел «Обмен с ИС МП (обувь, одежда, табак…)» и находим там пункт «См. также» или «Настройки и справочники». Выбираем «Токены авторизации». Здесь нам необходимо добавить скопированный X-API-Key. Важно указать тип токена как «ИС МП (розница)» для нашей организации.

    Убедимся, что для организации, от имени которой производится продажа, существует именно этот токен и он активен (это особенно актуально, когда внедряется автоматизация продажи маркированного разливного пива).

3. Проверяем настройки 1С:УНФ для маркированной продукции

Правильные настройки в конфигурации 1С обеспечат корректную работу с маркировкой.

  1. Активируем продажи маркированной продукции: В настройках 1С:УНФ убедимся, что включена опция "Продажи маркированной продукции" (здесь же можно настроить ограничение продаж по категориям номенклатуры).
  2. Включаем запрос данных сервиса ГИС МТ: Для использования разрешительного режима и обязательного контроля статусов товаров, необходимо активировать запрос данных сервиса ГИС МТ «Честный ЗНАК». Это позволит системе проверять коды маркировки при продаже на предмет их легальности и актуального статуса.
  3. Актуализируем список CDN-площадок: Модуль ККТ может автоматически отслеживать актуальность CDN-площадок и запрашивать новый список доступных площадок ЦРПТ. Убедимся, что эта функциональность работает корректно (в некоторых случаях может потребоваться доработка РМК для освобождения порта кассы).

4. Автоматизация обновления динамических TrueAPI токенов (для прочих операций, не РМК)

Вопрос об автоматизации обновления токенов, имеющих срок жизни в 10 часов (то есть TrueAPI токенов), является актуальным, особенно для работы в выходные или вне рабочего времени. Для таких токенов действительно не требуется постоянно держать подключенную ЭЦП к каждому кассовому компьютеру.

Разберем логику, которую мы можем применить для TrueAPI токенов:

  1. Хранение токена: Мы можем хранить полученный TrueAPI токен в файлике на диске вместе с датой и временем его получения.
  2. Проверка срока жизни: При каждом обращении к запросам TrueAPI (например, при отправке отчетов, заказе кодов и т.д.) наша система будет проверять срок жизни токена, сравнивая время получения из файла с текущим временем.
  3. Перезапрос «на ходу»: Если токен просрочился (прошло более 10 часов), наша система автоматически запрашивает новый токен, используя УКЭП (который может быть установлен на одном выделенном компьютере, например, сервере или рабочем месте бухгалтера/менеджера). После получения нового токена, мы перезаписываем его в файле и используем в текущем запросе.

Такой подход позволяет нам избежать регламентных процедур и постоянного присутствия УКЭП на каждом рабочем месте. Существуют сторонние решения и расширения для 1С, которые позволяют автоматизировать продление этих токенов по расписанию. В 1С:УНФ мы можем настроить ответственных за актуализацию токенов авторизации и, при необходимости, использовать регламентные задания для их периодической проверки и обновления.

Мы помним, что этот метод применим для TrueAPI токенов, а для РМК и розничных продаж должен использоваться X-API-Key.

5. Будущее: Технические средства получения информации о товаре (ТСПИоТ)

Важно отметить, что с 28 декабря 2025 года все продавцы маркированных товаров обязаны применять специальный программный модуль ТСПИоТ — для этого подойдет инструмент для настройки онлайн-касс под требования ТСПИоТ. До 1 июля 2026 года будет действовать переходный период, когда разрешительный режим работает совместно с текущим локальным модулем. После этой даты старый способ передачи данных будет полностью заменен на ТСПИоТ. ТСПИоТ — это отдельная программа, которая будет выступать связующим звеном между кассой и системой «Честный ЗНАК», проверяя коды маркировки при продаже, передавая данные о выбытии и блокируя продажу при запрете со стороны «Честного ЗНАКа».

Заключение

В большинстве случаев проблема с авторизацией в ГИС МТ при розничной продаже маркированных товаров в 1С:УНФ связана с некорректным использованием или отсутствием X-API-Key (розничного токена), а также с неустановленными патчами от 1С. Мы должны убедиться, что для розницы настроен именно бессрочный X-API-Key, а не динамический TrueAPI токен. Для TrueAPI токенов, используемых для других операций, мы можем реализовать автоматическое обновление, чтобы избежать ручного вмешательства и постоянного присутствия УКЭП.

Внимательно следуя этим рекомендациям и поддерживая конфигурацию 1С:УНФ в актуальном состоянии, мы сможем обеспечить стабильную и корректную работу с маркированными товарами в рознице.

← На главную