← На главную

Для заказа кодов маркировки шин из программы «1С:Управление торговлей» используется станция управления заказами — СУЗ системы маркировки «Честный знак». Через СУЗ оформляются заказы на эмиссию кодов маркировки, получается результат их генерации и передаются отчеты о нанесении. Для выгрузки полученных данных пригодится инструмент выгрузки полных кодов маркировки с криптохвостом из заказа на эмиссию.

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

Важно: редакция УТ 11.4 является устаревшей. Поддержка обмена с СУЗ по API v3 была реализована в «1С:Управление торговлей» начиная с версии 11.5.17.90. Если организация продолжает использовать УТ 11.4, перед настройкой обмена следует обновить конфигурацию до актуального поддерживаемого релиза.

Какие данные нужны для подключения к СУЗ

В актуальных версиях 1С для настройки обмена обычно требуются следующие параметры:

• идентификатор СУЗ — OMS ID;
• идентификатор соединения — omsConnection или Connection ID;
• адрес сервера СУЗ;
• порт HTTPS-соединения;
• организация, которой принадлежит станция управления заказами;
• формат обмена с СУЗ.

OMS ID идентифицирует станцию управления заказами организации. Идентификатор omsConnection относится к конкретному устройству, созданному в разделе управления устройствами СУЗ.

Это разные значения. Нельзя указывать вместо omsConnection идентификатор станции, токен или идентификатор участника системы маркировки.

Актуальные адреса и порт СУЗ

Для подключения к API СУЗ используются следующие базовые адреса:

• продуктивный контур: https://suzgrid.crpt.ru/;
• демонстрационный контур: https://suz.sandbox.crptech.ru/;
• порт: 443.

Адрес suz2.crpt.ru, который встречается в старых инструкциях и обсуждениях, не следует использовать как основной адрес для новой настройки. Официальным базовым адресом продуктивного API является suzgrid.crpt.ru.

В некоторых формах 1С адрес и порт указываются раздельно. В таком случае необходимо заполнить:

• адрес — suzgrid.crpt.ru;
• порт — 443;
• защищенное соединение — включено.

Если форма требует полный URL, следует указывать https://suzgrid.crpt.ru/. Конкретный способ заполнения зависит от версии конфигурации.

Можно ли работать с СУЗ в файловой базе

Нельзя утверждать, что обмен гарантированно работает в любом файловом варианте 1С. Возможность подключения зависит от версии конфигурации и реализации соответствующего механизма обмена.

В клиент-серверной информационной базе соединение с СУЗ выполняется со стороны сервера «1С:Предприятия». Следовательно, доступ к адресу suzgrid.crpt.ru на порт 443 должен быть разрешен именно на сервере 1С, а не только на компьютере пользователя.

Для файловой информационной базы необходимо проверить документацию и поведение конкретного релиза. Если программа сообщает, что подключение выполняется только с сервера «1С:Предприятия», данный релиз не сможет полноценно выполнить операцию в файловом режиме.

Поэтому при использовании файловой базы рекомендуется:

• обновить конфигурацию до актуального релиза;
• проверить наличие формы настройки СУЗ и команды проверки подключения;
• выполнить тестовый заказ небольшого количества кодов;
• при сообщении о серверном выполнении рассмотреть переход на клиент-серверный вариант.

Создание устройства в СУЗ

Для получения идентификатора соединения необходимо создать устройство в личном кабинете СУЗ.

1. Войти в личный кабинет системы маркировки «Честный знак» с использованием УКЭП.
2. Перейти в раздел Управление заказами.
3. Открыть раздел Устройства.
4. Нажать кнопку Создать устройство.
5. Указать понятное наименование, например 1С УТ — маркировка шин.
6. Выбрать тип устройства АСУ ТП, если такой параметр присутствует в интерфейсе.
7. Выбрать автоматический режим отправки.
8. Сохранить устройство.

После создания устройства в списке появится идентификатор подключения — omsConnection. Его необходимо скопировать в параметры подключения к СУЗ в 1С.

Важно: идентификатор соединения не формируется динамически после сохранения настроек в 1С. Он создается на стороне СУЗ и относится к конкретному зарегистрированному устройству.

Раздел управления устройствами доступен пользователям, обладающим необходимыми административными правами. Если раздел отсутствует, следует проверить роль пользователя в личном кабинете.

Динамический токен СУЗ

Статические токены СУЗ больше не поддерживаются. Для обращения к API применяется динамический клиентский токен.

Динамический токен:

• получается с использованием механизма единой аутентификации;
• связан с идентификатором соединения устройства;
• имеет ограниченный срок действия;
• действует не более 10 часов с момента получения;
• должен своевременно обновляться учетной системой.

В актуальных версиях 1С пользователь обычно указывает OMS ID и идентификатор соединения, после чего конфигурация использует предусмотренный механизм получения динамического токена.

Не следует строить настройку на ручном копировании токена из личного кабинета. Даже если временный токен удалось получить и вставить вручную, после окончания срока его действия обмен снова перестанет работать. Для решения этой проблемы можно использовать модуль автоматического обновления токенов Честного Знака в 1С.

Настройка маркировки в 1С

Наименование разделов может отличаться в зависимости от версии УТ. В актуальных релизах настройки обычно находятся в разделе:

НСИ и администрирование → Настройка интеграции → Интеграция с ИС МП.

В более ранних релизах УТ 11 путь мог выглядеть следующим образом:

НСИ и администрирование → Администрирование → Настройка интеграции с ИС МП.

Для включения работы с маркировкой необходимо:

1. Открыть настройки интеграции с системой маркировки.
2. Включить учет маркируемой продукции.
3. Включить товарную группу Шины.
4. Открыть параметры подключения к СУЗ.
5. Создать новую настройку подключения.
6. Выбрать организацию, которой принадлежит СУЗ.
7. Указать OMS ID.
8. Указать идентификатор соединения omsConnection.
9. Указать адрес suzgrid.crpt.ru.
10. Указать порт 443.
11. Выбрать защищенное HTTPS-соединение.
12. Выбрать актуальный формат обмена, поддерживаемый установленным релизом 1С.
13. Сохранить настройку и выполнить проверку подключения.

Если в форме отсутствует формат API v3 или обмен выполняется по старым методам, необходимо проверить версию конфигурации. Для работы с актуальным API СУЗ следует использовать релиз, в котором официально реализована поддержка API v3.

Настройка таймаута

Таймаут определяет, сколько времени 1С будет ожидать ответа от СУЗ. Универсального значения для всех организаций нет.

Для начала можно использовать значение от 30 до 60 секунд. Увеличение таймаута может помочь при медленном соединении, но оно не исправит:

• неправильный адрес;
• закрытый порт;
• ошибочный OMS ID;
• ошибочный идентификатор соединения;
• проблему получения токена;
• несовместимость версии 1С с API СУЗ.

Если проверка подключения зависает на несколько минут, сначала следует искать сетевую или программную проблему, а не бесконечно увеличивать таймаут.

Как проверить доступность сервера СУЗ

Обычная команда ping не является надежным способом проверки. Сервер может не отвечать на ICMP-запросы, но при этом нормально принимать HTTPS-соединения.

В Windows доступность порта можно проверить в PowerShell:

Test-NetConnection suzgrid.crpt.ru -Port 443

В результате параметр TcpTestSucceeded должен иметь значение True.

Дополнительно можно проверить разрешение имени:

Resolve-DnsName suzgrid.crpt.ru

На Linux можно использовать:

curl -I https://suzgrid.crpt.ru/

Получение HTTP-ответа, включая ответ с кодом ошибки приложения, означает, что DNS, TCP-соединение и TLS в целом работают. Полное отсутствие соединения или ошибка TLS указывают на сетевую проблему, прокси, фильтрацию трафика либо проблему цепочки сертификатов.

Что проверять в клиент-серверной базе

Если используется сервер «1С:Предприятия», диагностические команды необходимо выполнять непосредственно на сервере 1С.

Типичная ошибка состоит в том, что адрес СУЗ открывается на компьютере пользователя, но недоступен на сервере, где фактически выполняется обмен.

На сервере следует проверить:

• разрешение DNS-имени suzgrid.crpt.ru;
• исходящее соединение на TCP-порт 443;
• настройки системного или корпоративного прокси;
• правила межсетевого экрана;
• доверенную цепочку TLS-сертификатов;
• дату и время операционной системы;
• версию платформы «1С:Предприятие».

Ошибка «Доступ в СУЗ отсутствует»

Сообщение об отсутствии доступа может возникать по нескольким причинам:

• организация не подключена к необходимой товарной группе;
• не завершена регистрация участника оборота;
• пользователь не обладает необходимыми правами;
• не создано устройство СУЗ;
• указан неправильный OMS ID;
• указан неправильный omsConnection;
• не удается получить динамический токен;
• используется устаревшая версия 1С.

Также необходимо убедиться, что параметры относятся к одной организации. Нельзя использовать OMS ID одной организации и идентификатор устройства другой организации.

Ошибки авторизации HTTP 401 и 403

Ответ HTTP 401 обычно означает, что сервер не смог подтвердить авторизацию запроса. Возможные причины:

• токен отсутствует;
• токен истек;
• неправильно указан идентификатор соединения;
• 1С не смогла получить новый динамический токен;
• на сервере установлено неправильное время.

Ответ HTTP 403 обычно означает, что запрос распознан, но для выполнения операции отсутствуют права или доступ к соответствующей товарной группе.

При таких ошибках следует проверить не только адрес сервера, но и связку:

организация → OMS ID → устройство → omsConnection → динамический токен.

Ошибки HTTP 500, 502 и 503

Коды HTTP 500, 502 и 503 могут указывать на временную ошибку сервиса СУЗ, шлюза или внутреннего компонента системы маркировки. Однако считать любую ошибку HTTP 500 исключительно проблемой ЦРПТ нельзя.

Ошибка также может быть вызвана запросом, который устаревшая версия 1С формирует в неподдерживаемом формате.

Рекомендуемый порядок действий:

1. Повторить операцию через некоторое время.
2. Проверить статус других операций обмена.
3. Обновить 1С до актуального релиза.
4. Проверить, что используется API v3.
5. Зафиксировать точное время ошибки.
6. Сохранить полный текст технической информации.
7. При повторении ошибки создать обращение в поддержку.

В обращение желательно приложить:

• дату и точное время возникновения ошибки;
• версию платформы 1С;
• версию конфигурации;
• тип информационной базы;
• наименование выполняемой операции;
• код HTTP-ответа;
• полный текст ошибки без секретных ключей и токенов;
• идентификатор заказа, если он был создан.

Проверка сертификатов и HTTPS

Если возникает ошибка TLS, SSL handshake или защищенное соединение вообще не устанавливается, необходимо проверить хранилище доверенных сертификатов на том компьютере, где выполняется обращение к СУЗ.

Для клиент-серверной базы это сервер 1С. Для поддерживаемого файлового варианта — компьютер, на котором выполняется операция.

Причинами ошибки могут быть:

• устаревшее хранилище корневых сертификатов;
• перехват HTTPS-трафика антивирусом или корпоративным прокси;
• неправильная дата операционной системы;
• устаревшая версия платформы 1С;
• ограничения используемой операционной системы;
• блокировка отдельных алгоритмов шифрования.

Не следует без необходимости отключать проверку сертификатов. Это снижает безопасность соединения и обычно скрывает исходную причину проблемы.

Подготовка номенклатуры шин

Успешное подключение к СУЗ еще не означает, что заказ кодов будет сформирован правильно. Для шин необходимо корректно подготовить данные номенклатуры.

Следует проверить:

• признак маркируемой продукции;
• товарную группу «Шины»;
• вид номенклатуры;
• единицу измерения;
• код GTIN;
• карточку товара в Национальном каталоге;
• способ выпуска товара в оборот;
• соответствие организации роли производителя, импортера или другого участника.

Ошибки карточки товара, GTIN или способа выпуска могут проявляться уже после успешной проверки подключения — при создании или отправке заказа на эмиссию.

Оборудование и дополнительные сервисы

В зависимости от выполняемых операций организации могут потребоваться:

• усиленная квалифицированная электронная подпись;
• криптографическое программное обеспечение;
• 2D-сканер, поддерживающий Data Matrix;
• принтер этикеток;
• терминал сбора данных;
• подключение к оператору электронного документооборота;
• обновленная контрольно-кассовая техника;
• актуальные драйверы торгового оборудования.

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

Рекомендуемый порядок настройки

1. Обновить платформу и конфигурацию 1С.
2. Проверить поддержку СУЗ API v3.
3. Завершить регистрацию организации в системе маркировки.
4. Подключить товарную группу «Шины».
5. Перейти в СУЗ и определить OMS ID.
6. Создать устройство и получить omsConnection.
7. Настроить станцию управления заказами в 1С.
8. Проверить доступность suzgrid.crpt.ru:443 с места выполнения обмена.
9. Выполнить проверку подключения в 1С.
10. Проверить карточки шин и коды GTIN.
11. Создать тестовый заказ на небольшое количество кодов.
12. Проверить получение кодов и обработку статусов заказа.

Итог

Для актуального подключения 1С к СУЗ следует использовать адрес suzgrid.crpt.ru, порт 443, корректные значения OMS ID и omsConnection, а также версию конфигурации, поддерживающую динамическую авторизацию и API v3.

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