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

Интеграция с Boxberry — расчёт стоимости доставки и выбор пункта выдачи. Эта инструкция написана для владельца ADWOS CMS: что подготовить, где включить модуль, какие поля проверить и как понять, что запуск прошел корректно.

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

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

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

• В заказе появляется доставка через «Boxberry» или данные для передачи в эту службу.
• Площадка может учитывать регион, склад, пункт выдачи, тестовый режим и ограничения провайдера.
• Администратор проверяет расчет и ошибки до реального отправления.
• Пользователь получает более понятный сценарий оформления заказа.

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

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

• Проверьте договор, личный кабинет или API-доступ службы «Boxberry».
• Подготовьте ключи, идентификатор склада, город отправления и параметры тестового заказа, если они требуются.
• Включите тестовый режим, если провайдер позволяет проверять сценарий без реального отправления.
• Согласуйте категории, регионы и ограничения доставки с правилами вашей площадки.

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

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

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

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

• «Код ПВЗ отправки». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Поле обязательное.
• «API Token». Обязательное секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах.

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

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

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

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

• Доставка не рассчитывается. Проверьте ключи, регион отправления, склад и тестовый режим.
• Пункт выдачи не отображается. Проверьте доступность региона и ограничения службы доставки.
• При проверке создается реальное отправление. Вернитесь в тестовый режим и повторите сценарий.
• Статус доставки не обновляется. Проверьте callback, webhook и права API в кабинете провайдера.

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