В последнее время пользователи программных продуктов 1С, таких как 1С:Комплексная автоматизация (включая работу с техническими картами), 1С:ERP и 1С:Управление торговлей, начали сталкиваться с критическими ошибками при обмене данными с государственной информационной системой мониторинга товаров (ГИС МТ). Проблема проявляется при эмиссии кодов, проверке статусов или возвратах. В логах системы и сообщениях об ошибках фигурирует адрес /api/v4/facade/cis/cis_list с пометкой об устаревшем API. В этой статье мы подробно разберем, почему это происходит, в какие сроки необходимо принять меры и как правильно обновить вашу систему 1С.
Давайте проанализируем ситуацию. Центр развития перспективных технологий (ЦРПТ) проводит плановое технологическое обновление системы «Честный ЗНАК». Старая архитектура взаимодействия, известная как Facade API (v4), признана устаревшей еще в сентябре 2023 года. Она не справлялась с возросшими нагрузками и не обеспечивала необходимую скорость обработки запросов.
Рассмотрим основные этапы отключения старого функционала, которые озвучила техническая поддержка ГИС МТ:
POST /api/v4/facade/cis/cis_list отключался в дневное время для стимулирования перехода пользователей на новые рельсы.404 Not Found или 410 Gone.Для замены устаревшего метода были внедрены новые инструменты — TrueAPI. Они работают значительно быстрее и позволяют более гибко управлять данными о кодах маркировки.
Посмотрим на альтернативы, которые предлагает ЦРПТ. Вместо одного универсального, но медленного метода cis_list, теперь рекомендуется использовать два специализированных запроса:
Важное ограничение: В отличие от старого API, TrueAPI накладывает строгие лимиты на количество кодов в одном пакете. Обычно это не более 500-1000 единиц. Если ваша система попытается отправить больше, сервер вернет ошибку. Это необходимо учитывать при доработке самописных интеграций. Для готовой проверки КИ без разработки собственных запросов можно использовать обработку для проверки кодов маркировки Честного Знака.
Рассмотрим, что нужно сделать пользователям 1С для восстановления работоспособности обмена. Основная логика маркировки в современных версиях программ 1С вынесена в БЭД (Библиотеку электронных документов).
Самый надежный метод — обновить вашу 1С до актуального релиза. Фирма 1С оперативно выпускает обновления, в которых старые вызовы API заменены на новые методы TrueAPI. Если ваша конфигурация типовая (без доработок) и выполнен корректный перенос штрихкодов, это решит проблему полностью. Проверьте, чтобы версия БЭД в составе вашей программы была актуальной на ноябрь 2024 года.
Если вы не можете быстро обновить всю конфигурацию (например, из-за большого количества кастомных доработок), воспользуйтесь механизмом расширений или патчей. Фирма 1С часто выпускает локальные исправления для критических ошибок обмена с ГИС МТ. Рассмотрим алгоритм действий:
Проанализируем еще один важный момент, отмеченный практикующими специалистами. В новых протоколах TrueAPI требования к безопасности и сессиям стали жестче. Некоторые пользователи отмечают, что переход с «переменного» (динамического) токена на «постоянный» токен в настройках интеграции помогает стабилизировать работу в переходный период. Однако это следует рассматривать как временную меру до полноценного обновления кода системы. Для автоматизации этого процесса можно использовать решение для автоматического обновления токенов Честного Знака.
Посмотрим, как это может выглядеть в коде, если вы занимаетесь разработкой собственной интеграции. Вместо старого пути /api/v4/facade/... необходимо сформировать запрос к новому эндпоинту:
// Пример формирования структуры запроса к TrueAPI
Запрос = Новый HTTPЗапрос("/cises/short/list");
Запрос.Заголовки.Вставить("Content-Type", "application/json");
Запрос.Заголовки.Вставить("Authorization", "Bearer " + ТокенАвторизации);
// Формируем массив кодов для проверки
МассивКИ = Новый Массив;
МассивКИ.Добавить("0104600012345678215JkLmN");
СтруктураТела = Новый Структура;
СтруктураТела.Вставить("cises", МассивКИ);
ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку();
ЗаписатьJSON(ЗаписьJSON, СтруктураТела);
Запрос.УстановитьТелоИзСтроки(ЗаписьJSON.Закрыть());
Подводя итог, проанализируем план действий для минимизации простоев в работе склада и бухгалтерии:
cis_list, не ждите 19 ноября. Доступ к методу уже ограничивается в рамках техработ.sign) также имеет свои нюансы в структуре JSON.Помните, что переход на TrueAPI — это не просто прихоть регулятора, а необходимый шаг для обеспечения стабильности системы при огромных оборотах маркируемой продукции в масштабах всей страны. Своевременное обновление 1С позволит вам избежать очередей на отгрузке и проблем с контролирующими органами.