Woo & CDEK — интеграция woocommerce с ТК СДЭК

Расчёт стоимости и сроков доставки в реальном времени, карта пунктов выдачи на Яндекс.Картах, автоматическое оформление отправления после оплаты и трекинг статуса — без единого вводимого вручную кода тарифа. Плагин закрывает всю цепочку работы с ТК СДЭК внутри WooCommerce: от показа покупателю актуальной цены доставки на чекауте до печати накладной и автоматической отмены отправления при возврате заказа. Всё через официальный CDEK API v2.

Для кого этот плагин

Для владельцев интернет-магазинов на WooCommerce, которые возят товары через СДЭК и устали от:

1. ручного расчёта стоимости доставки «на глазок» или фиксированных тарифов, не совпадающих с реальной ценой СДЭК;
2. ручного создания отправлений в личном кабинете СДЭК после каждого заказа;
3. сборной солянки из нескольких несвязанных плагинов (отдельно калькулятор, отдельно карта ПВЗ, отдельно трекинг);
4. необходимости объяснять покупателям и менеджерам, что такое «код тарифа 136».

Плагин рассчитан на владельца магазина без технического бэкграунда: два переключателя в настройках способа доставки («Пункт выдачи» / «Курьер») — и всё, никаких справочников кодов.

Ключевые возможности

Расчёт доставки в реальном времени

1. Живой запрос к CDEK API (/v2/calculator/tarifflist) при каждом изменении адреса на чекауте — покупатель видит реальную цену и срок, а не усреднённый тариф.
2. Автоматический подбор подходящего тарифа отдельно для самовывоза и для курьера по стратегии «самый дешёвый» или «самый быстрый» — администратору не нужно знать и вводить коды тарифов СДЭК.
3. Расчёт веса и габаритов посылки из корзины (с дефолтными значениями из настроек для товаров без указанного веса/размеров).
4. Кэширование расчёта на 15 минут — не нагружает API СДЭК на каждый чих чекаута.

Карта выбора пункта выдачи

1. Интерактивная карта на Яндекс.Картах с кластеризацией маркеров прямо на странице оформления заказа.
2. Работает и на классическом чекауте, и на блочном (Cart & Checkout Blocks) WooCommerce — тип чекаута определяется автоматически, никаких дополнительных настроек.
3. Город берётся из уже введённого адреса доставки — нет отдельного поля, которое сбивало бы покупателя с толку.
4. Жёсткая валидация: оформить заказ с доставкой в ПВЗ без выбранной точки на карте невозможно.
5. Понятные состояния «загружаем карту», «ПВЗ не найдены», таймаут с сообщением об ошибке, если Яндекс.Карты не загрузились.

Автоматизация после оплаты

1. Автосоздание отправления в СДЭК при переходе заказа в настраиваемый статус (по умолчанию «Обработка»), плюс ручная кнопка в заказе — работает всегда, независимо от статуса.
2. Учитывает выбранный тариф, ПВЗ или адрес курьерской доставки, состав и габариты корзины.
3. Автоматическая отмена отправления в СДЭК при отмене/возврате заказа WooCommerce — синхронно, без ручных действий.
4. Печать накладной (PDF) в один клик из карточки заказа.
5. Обновление статуса и трек-номера через вебхуки СДЭК — без вебхуков доступно ручное обновление кнопкой.

Уведомления и личный кабинет покупателя

1. Отдельное письмо с трек-номером, отправляемое автоматически, как только номер становится известен — стандартный WC_Email, настраивается и включается/выключается в WooCommerce → Настройки → Уведомления, как любое штатное письмо магазина.
2. Статус и трек-номер со ссылкой на официальный трекинг СДЭК показываются покупателю в личном кабинете («Мои заказы»).

Удобство для администратора

1. Одна вкладка настроек: WooCommerce → Настройки → СДЭК — учётные данные API, тест/боевой контур, город и адрес отправителя с поиском по названию (без ручного ввода кода города), упаковка по умолчанию, ключ Яндекс.Карт, статус для автосоздания заказа.
2. Кнопка проверки подключения к CDEK API прямо из настроек.
3. Кнопка подключения вебхуков в один клик.
4. Метабокс в заказе: статус, UUID, трек-номер, кнопки «Создать / Обновить / Отменить / Печать накладной».

Технически

1. CDEK API v2, OAuth2 (client_credentials) с кэшированием токена, тестовый (api.edu.cdek.ru) и боевой (api.cdek.ru) контур переключаются одной настройкой.
2. Совместимость с HPOS (хранение заказов в отдельных таблицах WooCommerce) задекларирована и обеспечена — плагин работает с заказами только через штатный WC_Order API.
3. Полное логирование запросов к CDEK API и входящих вебхуков через стандартный WC_Logger, с маскированием секретов в логах.
4. Безопасность: nonce-проверки и капабилити (manage_woocommerce / edit_shop_orders) на всех административных действиях, санитайзинг входных данных, экранирование вывода во всех шаблонах и в JS.
5. Секретный токен в URL вебхука + перепроверка данных напрямую через авторизованный запрос к CDEK при каждом событии (реальные данные никогда не берутся из необработанного тела вебхука).
6. Локализация: строки через __()/_e(), готовый .pot-файл (127 строк) для перевода.