Почему 1С выдает ошибку API при подборе и проверке маркированных товаров?

При работе с маркированными товарами пользователи 1С нередко сталкиваются с загадочными ошибками API. Эти ошибки могут проявляться при подборе товаров, их проверке или попытке вывода из оборота, вызывая затруднения в ежедневной работе. Давайте вместе разберем, почему возникают такие проблемы и как их эффективно решать, опираясь на опыт сообщества 1С и актуальные требования системы "Честный ЗНАК". Мы рассмотрим основные причины и предложим подробные шаги для устранения неполадок.

Актуальность API и необходимость обновления 1С

Одной из наиболее частых причин возникновения ошибок API является использование устаревших версий протоколов взаимодействия с системой "Честный ЗНАК". Система мониторинга оборота товаров постоянно развивается, и ее API регулярно обновляется. Если ваша конфигурация 1С или внешние доработки не соответствуют текущим требованиям, это неизбежно приведет к ошибкам.

1. Устаревшие версии API: Например, Система управления заказами (СУЗ), предназначенная для производителей и импортеров, перешла с версии 2.0 на 3.0. Поддержка API СУЗ v2.0 была прекращена 1 июня 2024 года, а отключение методов API СУЗ v2.0 произошло 1 сентября 2024 года. Переход на API СУЗ v3.0 стал обязательным с 1 сентября 2024 года. Похожие поэтапные отключения касаются и других методов API, затрагивая различные товарные группы.
2. Необходимость своевременного обновления 1С: Для корректной работы с маркировкой и поддержки новых версий API критически важно своевременно обновлять конфигурацию 1С. Например, в 1С:Управление торговлей (УТ) версии 11.5.17.90 уже реализована поддержка API СУЗ версии 3.0. Использование старых версий 1С или самописных решений, не адаптированных под новые требования, может стать источником ошибок и потребовать серьезных доработок.

Мы настоятельно рекомендуем регулярно обновлять ваши типовые конфигурации 1С до актуальных релизов. Часто ошибки, связанные с API, уже исправлены в новых версиях, и дополнительные доработки не требуются. Если вы используете доработанные конфигурации или расширения, свяжитесь с разработчиком для адаптации под новые требования.

Различия между СУЗ и общей системой маркировки (ГИС МТ)

Важно понимать, что существуют разные системы и методы взаимодействия с "Честным ЗНАКом" для различных участников оборота:

• Система управления заказами (СУЗ): Этот компонент в первую очередь предназначен для производителей и импортеров. Он используется для заказа и получения кодов маркировки, а также для подачи отчетов о нанесении. Если вы не являетесь производителем или импортером, скорее всего, вам не нужно взаимодействовать напрямую с СУЗ.
• Государственная информационная система мониторинга оборота товаров (ГИС МТ) "Честный ЗНАК" (markirovka.crpt.ru): Для розничных операций, таких как продажа и вывод товара из оборота, используются другие механизмы. Эти операции осуществляются через контрольно-кассовую технику (ККТ) и оператора фискальных данных (ОФД), которые передают данные непосредственно в ГИС МТ. Если вы работаете в рознице, ваши основные взаимодействия с маркировкой происходят через кассу.

Давайте проанализируем ситуацию: если вы пытаетесь использовать методы API, предназначенные для СУЗ, будучи розничным продавцом, это может привести к ошибкам доступа или некорректным ответам, поскольку вы находитесь не в той системе, которая ожидает ваш запрос.

Правильный вывод маркированного товара из оборота через ККТ

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

1. Обязательность ФФД 1.2: Большинство продавцов маркированных товаров должны были перейти на формат фискальных документов (ФФД) 1.2 к 1 февраля 2022 года. Использование ФФД 1.2 критически важно для корректной передачи данных о маркированных товарах в "Честный ЗНАК" через ОФД. Если ваша ККТ работает на более старых ФФД (1.05 или 1.1), это может быть причиной проблем. Убедитесь, что ваш АТОЛ или другая ККТ обновлена до платформы 5 и прошивки, поддерживающей ФФД 1.2.
2. Передача полных кодов: При использовании ФФД 1.2 необходимо обязательно передавать полные коды маркировки в теге 2000 "codeString" в запросе о коде маркировки и уведомлении о реализации. Неполные данные или их отсутствие вызовут ошибки.
3. Процесс вывода из оборота: При продаже маркированного товара конечному потребителю ККТ сканирует Data Matrix код. ОФД в режиме реального времени передает эту информацию в "Честный ЗНАК", что приводит к выводу товара из оборота. Это стандартный и правильный механизм.
4. Возврат товара: Если возвращаемый товар имеет неповрежденный код маркировки и используется ФФД 1.2, повторное сканирование кода при оформлении чека возврата достаточно для ввода его обратно в оборот. При использовании ФФД 1.05 или 1.1 потребуется отправка отдельного уведомления в "Честный ЗНАК" через личный кабинет.
5. Передача между участниками оборота: Обратите внимание, что если в кассовом чеке присутствует реквизит "ИНН покупателя (клиента)" (для расчетов между организациями и/или индивидуальными предпринимателями), товар не выводится из оборота, а происходит его передача между участниками оборота.

Выясним причину: проверьте настройки вашей ККТ и версию ФФД. Убедитесь, что 1С правильно формирует данные для чека, включая полные коды маркировки.

Особенности работы с методами API /cises/info и /cises/search

Если вы взаимодействуете с API напрямую для получения информации о кодах маркировки, следует учитывать следующие моменты:

1. Передача списка марок: Для запроса информации по списку кодов идентификации (КИ) методом /cises/info или /cises/search необходимо передавать список марок в теле запроса в формате JSON. Если этот список отсутствует или передан некорректно, вы получите ошибку.
2. Назначение /cises/info: Метод /cises/info используется для проверки статуса кода идентификации (за исключением корректности криптографической подписи). Он имеет ограничения: до 50 запросов в секунду и не более 1000 КИ в одном запросе. Если вы превышаете эти лимиты, система может вернуть ошибку. Также учтите, что /cises/info работает только для "своих" марок. В противном случае, даже при успешном запросе (код 200), в ответе будет указано, что марки не найдены.
3. Ошибки доступа и токенов: При работе с API могут возникать ошибки типа "Токен не действителен" или "Отсутствует доступ к ресурсу". Это может быть связано с использованием недействительного, просроченного динамического токена авторизации (срок действия которого ограничен, обычно до 10 часов) или с некорректными настройками доступа в личном кабинете "Честного ЗНАКа".
4. Автоматическое обновление токена в 1С: В современных версиях 1С:УТ 11 реализован механизм автоматического обновления токена для взаимодействия с ГИС МТ, что значительно упрощает работу и снижает вероятность возникновения подобных ошибок.

Посмотрим на пример: Убедитесь, что ваш код правильно формирует тело запроса с JSON-списком марок, если вы используете эти методы. Примерно так должен выглядеть код для формирования JSON с марками:

Запрос = Новый Соответствие();
Запрос.Вставить("cis", СписокМарок); // СписокМарок - это массив строк с кодами маркировки

JSONЗапрос = Новый ЗаписьJSON();
JSONЗапрос.УстановитьСтроку();
ЗаписатьJSON(JSONЗапрос, Запрос);
СтрокаJSON = JSONЗапрос.Закрыть();

Затем эту строку СтрокаJSON нужно передать в тело HTTP-запроса.

Общие рекомендации и важные аспекты

Помимо вышеперечисленных решений, рассмотрим еще несколько важных моментов, которые помогут вам избежать или устранить ошибки API при работе с маркировкой:

1. Документация API: Актуальную документацию по API "Честный ЗНАК" (СУЗ, True API) всегда можно найти в разделе "Помощь" личного кабинета ГИС МТ или в разделе "База знаний" личного кабинета "Реестр интеграторов". Регулярно обращайтесь к ней, чтобы быть в курсе всех изменений.
2. Локальный модуль "Честный ЗНАК" (ЛМ ЧЗ): Существует локальный модуль "Честный ЗНАК", который обеспечивает офлайн-проверку кодов идентификации продукции и регистрацию фактов продажи/возврата в офлайн-режиме. Он хранит актуальный список запрещенных к продаже товаров. 1С:УТ, начиная с версии 11.5.20.91, поддерживает офлайн-проверки для разрешительного режима с использованием ЛМ ЧЗ. Убедитесь, что ваш ЛМ ЧЗ установлен и обновлен, если вы его используете.
3. Требования к HTTPS и сертификатам: Для взаимодействия с API "Честный ЗНАК" используется протокол HTTPS с ГОСТ-сертификатами. Необходимо установить оба корневых сертификата. Протокол HTTP для всех участников отключен. Проверьте настройки защищенного соединения на вашем сервере или рабочем месте.
4. Методы валидации кодов: В системе "Честный ЗНАК" существуют специальные методы API для валидации структуры кода маркировки и верификации криптографического хвоста. Используйте их для предварительной проверки кодов, чтобы избежать ошибок на более поздних этапах.
5. Доработки конфигурации: Если ваша конфигурация 1С содержит значительные доработки, касающиеся обмена с "Честным ЗНАКом", и вы сталкиваетесь с ошибками API, мы рекомендуем связаться с тем, кто эти доработки выполнял. Возможно, они устарели и требуют адаптации к новым требованиям. В крайнем случае, рассмотрите переход на штатный функционал типовых конфигураций 1С, который постоянно обновляется и поддерживается.

Надеемся, что этот подробный анализ поможет вам успешно решить проблемы с ошибками API при работе с маркированными товарами в 1С. Успехов в работе!