📋 Обзор плагина

СДЭК для WooCommerce — независимый плагин для интеграции вашего интернет-магазина со службой доставки СДЭК® через API v2. Плагин состоит из двух частей:

FREE — бесплатные возможности

PRO — платные возможности

📦 Установка

FREE — установка из WordPress.org

1. Перейдите в Плагины → Добавить новый
2. Введите в поиске: СДЭК для WooCommerce
3. Нажмите «Установить» → «Активировать»

FREE — установка из архива

1. Скачайте архив wc-cdek-shipping.zip
2. Перейдите в Плагины → Добавить новый → Загрузить плагин
3. Выберите скачанный архив → «Установить»
4. Нажмите «Активировать плагин»

PRO — установка аддона

1. Убедитесь, что FREE-версия уже установлена и активирована
2. Приобретите PRO-аддон на it-life74.ru
3. Скачайте архив cdek-shipping-pro.zip из личного кабинета
4. Загрузите через Плагины → Добавить новый → Загрузить плагин
5. Активируйте и введите лицензионный ключ

Требования

⚙️ Настройка

После активации плагина откроется Мастер установки из 6 шагов:

1. Приветствие — обзор возможностей
2. API-ключи — Client ID и Client Secret от СДЭК
3. Отправитель — город, ФИО, телефон, адрес
4. Тарифы — выбор активных тарифов
5. Наценка — фиксированная или процентная
6. Готово! — ваш магазин готов к работе

🔑 API-ключи FREE

СДЭК API

Зарегистрируйтесь в личном кабинете СДЭК и получите:

• Client ID (Account) — идентификатор интеграции
• Client Secret (Secure key) — секретный ключ

Карта и подсказки

Плагин поддерживает два типа карт:

• 🗺️ Leaflet / OpenStreetMap — бесплатная карта, не требует API-ключа (используется по умолчанию в блочном чекауте)
• 🗺️ Яндекс Карты — требует API-ключ (классический чекаут)

Для DaData подсказок адреса и Яндекс Карт плагин предоставляет общие ключи, которые синхронизируются с сервера автоматически раз в 24 часа.

Если поле ключа пустое — плагин использует общий ключ. Кнопка «Получить общий» принудительно синхронизирует ключи прямо сейчас.

🚚 Тарифы FREE

Россия (8 тарифов)

Международные — СНГ (4 тарифа)

🗺️ ПВЗ и карта FREE

Два режима отображения пунктов выдачи на чекауте:

📋 Список (dropdown)

Классический выпадающий список ПВЗ. Работает без API-ключа карт. Покупатель выбирает ПВЗ из списка с адресами.

🗺️ Карта

Плагин поддерживает два провайдера карт:

• Leaflet / OpenStreetMap — бесплатная карта, используется в блочном чекауте. Не требует API-ключа.
• Яндекс Карты — интерактивная карта с кластеризацией. Требует API-ключ.

Функции карты:

• 🟢 Зелёные точки — пункты выдачи (ПВЗ)
• 🟠 Оранжевые точки — постаматы
• Кликните на точку — балун с адресом, часами работы, кнопкой выбора
• Кластеризация при большом количестве точек

📮 Постаматы

Опция «Показывать постаматы вместе с ПВЗ» включает/выключает постаматы в списке и на карте.

💰 Стоимость FREE

📐 Габариты по умолчанию FREE

Используются, когда у товара не указаны размеры:

⭐ PRO — обзор и тарифы PRO

CDEK Shipping PRO — платный аддон, который расширяет бесплатный плагин функциями управления заказами, печати, трекинга и автоматизации.

Что входит в PRO

• ✅ Создание заказов СДЭК из админки WooCommerce
• ✅ Автосоздание заказов при переходе в статус «Обработка»
• ✅ Печать накладных и штрих-кодов (PDF)
• ✅ Синхронизация статусов через вебхуки
• ✅ Трекинг для клиентов (ЛК + email)
• ✅ Наложенный платёж (COD)
• ✅ Вызов курьера на забор
• ✅ Калькулятор на странице товара
• ✅ Хуки для разработчиков

Тарифы PRO

Все PRO-тарифы включают одинаковый набор функций — отличие только в количестве сайтов и уровне поддержки. Лицензия действует 1 год с момента покупки и включает все обновления.

Купить PRO →

📋 Создание заказов PRO

Метабокс «СДЭК» появляется на странице заказа WooCommerce.

Ручное создание

1. Откройте заказ WooCommerce
2. В метабоксе «СДЭК» нажмите «Создать заказ СДЭК»
3. Заказ создаётся в СДЭК, появляется номер и ссылка

Автосоздание

В настройках PRO → Заказы можно включить автосоздание — заказ СДЭК создаётся автоматически при переходе WC-заказа в статус «Обработка».

Печать документов

• 📄 Накладная (waybill) — PDF с данными отправления
• 📊 Штрих-код (barcode) — PDF для наклейки на посылку

📍 Отслеживание PRO

Покупатели видят статус доставки в трёх местах:

• 🛒 Страница заказа в личном кабинете
• 📧 Email-уведомления WooCommerce
• 📝 Шорткод [cdek_tracking] на любой странице

🔔 Вебхуки PRO

Автоматическое обновление статусов заказов через вебхуки СДЭК.

1. В настройках PRO → нажмите «Зарегистрировать вебхук»
2. СДЭК будет отправлять уведомления при смене статуса
3. Статусы WC обновляются автоматически

🚗 Вызов курьера PRO

Вызовите курьера СДЭК на забор посылок через Intakes API прямо из карточки заказа.

1. Откройте заказ → метабокс «СДЭК»
2. Нажмите «Вызвать курьера»
3. Укажите дату и время забора
4. Курьер приедет по адресу отправителя

💳 Наложенный платёж PRO

Если покупатель выбирает оплату при получении (COD), плагин автоматически:

• Определяет способ оплаты как COD
• Передаёт сумму наложенного платежа в заказ СДЭК
• Выбирает правильный тип оплаты (наличные или карта)

🧮 Калькулятор на странице товара PRO

Шорткод [cdek_calculator] отображает виджет расчёта стоимости доставки прямо на странице товара.

Использование

• Автовставка — калькулятор появляется на всех товарах автоматически (включается в настройках PRO)
• Шорткод — [cdek_calculator product_id="123"] для ручной вставки

Как работает

1. Покупатель вводит город доставки
2. Калькулятор показывает стоимость и сроки по всем активным тарифам
3. Учитываются размеры и вес товара, наценки магазина

🧩 Шорткоды

Вставляйте виджеты СДЭК на любые страницы WordPress:

FREE шорткоды

PRO шорткоды

🎨 Пользовательский CSS FREE

Настройки → СДЭК → Инструменты → Пользовательский CSS

Стили инжектируются в <head> на всех страницах.

Основные CSS-классы

Примеры

/* Изменить цвет кнопок */
.cdek-offices-btn { background: #005baa; }

/* Увеличить карту */
#cdek-pvz-map { height: 500px; }

/* Скруглить карточки */
.cdek-office-card { border-radius: 12px; }

❓ Часто задаваемые вопросы

🔧 Устранение неполадок

👨‍💻 Для разработчиков

PRO хуки и фильтры PRO

FREE точки расширения FREE

REST API