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

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

При работе с маркированными товарами пользователи 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С или самописных решений, не адаптированных под новые требования, может стать источником ошибок. В некоторых случаях пользователям приходится опираться на практический опыт работы с маркировкой в древней УТ 10.3, чтобы избежать немедленного перехода на новые платформы.

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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

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

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

← На главную