Настройка модуля «Яндекс Доставка»

Доставка через Яндекс Доставку — расчёт, заказ, трекинг, ПВЗ. Эта инструкция написана для владельца ADWOS CMS: что подготовить, где включить модуль, какие поля проверить и как понять, что запуск прошел корректно.

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

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

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

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

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

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

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

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

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

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

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

• «Вес по умолчанию (граммы)». Укажите числовое значение. Для TTL, лимитов и таймаутов используйте разумное стартовое значение и проверьте результат на тестовом сценарии. Значение по умолчанию: 1000.
• «OAuth-токен Яндекс Доставки». Обязательное секретное поле. Вставьте значение из кабинета провайдера и не публикуйте его в описаниях, письмах или открытых страницах.
• «ID склада отправки». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий.

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

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

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

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

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

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