Настройка модуля «СДЭК»

Модуль СДЭК подключает CDEK API к ADWOS CMS. Он подходит интернет-магазинам, маркетплейсам и сервисам объявлений, где нужно рассчитать доставку, показать покупателю пункты выдачи и передать заказ в службу доставки.

Что делает модуль

• Авторизуется в СДЭК по OAuth 2.0 с использованием `Account` и `Secure password`.
• Рассчитывает стоимость доставки через `POST /v2/calculator/tariff`.
• Получает список офисов и пунктов выдачи через `GET /v2/deliverypoints`.
• Создаёт заказ в СДЭК через `POST /v2/orders`.
• Поддерживает тестовую среду `api.edu.cdek.ru` и боевую среду `api.cdek.ru`.

Что подготовить до настройки

• `Account` и `Secure password` из личного кабинета СДЭК.
• Код тарифа, который соответствует вашей схеме доставки.
• Данные отправителя: город, адрес или код пункта отгрузки.
• Данные получателя: город, адрес или код ПВЗ, телефон и имя.
• Вес и габариты каждого места в заказе. Без этих данных расчёт тарифа будет некорректным.

Настройка в ADWOS CMS

• Откройте админку ADWOS, раздел «Каталог», затем «Маркетплейс».
• Найдите модуль «СДЭК» и установите его, если он ещё не установлен.
• Откройте управление модулем и перейдите в настройки.
• Заполните «Account» значением из API-доступа СДЭК.
• Заполните «Secure password». Это защищённое поле, его нельзя хранить в обычных текстовых заметках или передавать менеджерам сайта.
• Оставьте тестовый режим включённым для проверки через `api.edu.cdek.ru`.
• После успешной проверки переключите тестовый режим только тогда, когда готовы создавать реальные отправления.
• Сохраните настройки и включите модуль.

Проверка после установки

• Проверьте `/calc` на тестовом наборе данных: тариф, город отправления, город получения, вес и габариты.
• Проверьте `/delivery-points` с фильтром по городу или типу пункта выдачи.
• Создайте тестовый заказ через `/orders` в тестовой среде СДЭК.
• Если старая интеграция сайта вызывает `/label`, она продолжит работать как совместимый алиас создания заказа. Для новых сценариев используйте `/orders`.
• Сверьте ответ СДЭК с кабинетом: заказ должен появиться в правильной среде и с ожидаемыми параметрами.

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

• Путать тестовые и боевые ключи. Для `api.edu.cdek.ru` нужны тестовые данные, для `api.cdek.ru` нужны боевые.
• Называть создание заказа печатью этикетки. В API СДЭК печать штрихкодов и квитанций выполняется отдельными методами.
• Передавать вес и размеры в неправильных единицах. Проверьте требования СДЭК к весу, длине, ширине и высоте.
• Создавать заказ до проверки расчёта тарифа и ПВЗ. Сначала убедитесь, что направление и тариф доступны.
• Оставлять тестовый режим включённым после перехода к реальным отправлениям.

Когда переводить в production

Переводите СДЭК в боевой режим после успешного расчёта тарифа, загрузки ПВЗ и создания тестового заказа. Перед первым реальным заказом проверьте, что в настройках указаны боевые `Account` и `Secure password`, а тестовый режим выключен.