Настройка модуля «Честный знак (ЦРПТ)»

Модуль «Честный знак (ЦРПТ)» добавляет отдельную возможность в ADWOS CMS. Инструкция поможет включить его в панели управления, заполнить настройки и проверить результат до полноценного запуска.

Когда стоит подключать модуль

• Владельцам ADWOS CMS, которым нужна дополнительная функция без изменения основного кода проекта.
• Администраторам, которые хотят включить модуль для конкретного бизнес-сценария и проверить результат на тестовом объекте.
• Командам, которым важно сохранить возможность быстро отключить модуль, если сценарий требует доработки.

Что изменится на сайте

• Модуль добавляет отдельную функцию в установленную ADWOS CMS.
• Настройка выполняется через панель управления, без ручного редактирования кода.
• Результат можно проверить на тестовом объекте перед полноценным запуском.
• При необходимости модуль можно выключить, сохранив базовую работу площадки.

Что подготовить заранее

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

• Проверьте, что модуль совместим с текущей версией ADWOS CMS.
• Подготовьте тестовый объект: объявление, заказ, страницу, профиль или пользователя.
• Опишите ожидаемый результат до включения, чтобы проще проверить изменения.
• Не запускайте модуль сразу на критичном сценарии без тестовой проверки.

Установка в ADWOS CMS

• Откройте административную панель ADWOS CMS под учетной записью администратора.
• В меню выберите раздел «Каталог», затем откройте «Маркетплейс».
• Найдите модуль «Честный знак (ЦРПТ)» по названию или через список модулей.
• Если модуль еще не установлен, нажмите «Установить» и дождитесь завершения установки.
• Откройте карточку установленного модуля, выберите «Управлять», затем перейдите в «Настройки».
• Заполните обязательные поля, сохраните настройки и включите модуль переключателем.

Настройка модуля

В настройках модуля заполняйте только те значения, которые относятся к вашему проекту. Секретные ключи храните в защищенных полях и не переносите их в открытые тексты, письма или инструкции для пользователей.

• «Блокировать без КИЗ». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true. Автоматически блокировать карточки товаров в маркируемых категориях без КИЗов.
• «API Token». Секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах. Токен авторизации в API ЦРПТ (получить в личном кабинете markirovka.crpt.ru после регистрации платформы).
• «API ЦРПТ URL». Укажите полный адрес страницы, callback или webhook, который должен использовать внешний сервис. Значение по умолчанию: https://markirovka.crpt.ru. Базовый URL API ЦРПТ. Для production оставить дефолт; для test-стенда — sandbox URL.
• «Модуль включён». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: false. Активировать проверку Честного знака. Перед включением — зарегистрировать платформу в реестре ЦРПТ.
• «УКЭП сертификат». Секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах. УКЭП-сертификат платформы (path к pfx-файлу или PEM содержимое). Нужен для подписания актов вывода.

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

Проверка перед запуском

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

Частые ошибки

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

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