Доставка СДЭК для OpenCart 4

Доставка СДЭК для OpenCart 4

Расширение типа «Доставка» для OpenCart 4.1.0.4: на шаге «Способ доставки» покупатель видит реальную стоимость и срок доставки СДЭК. Расчёт делает сам СДЭК по своему API (калькулятор v2) для города из адреса доставки, веса и габаритов товаров в корзине; магазин выбирает, какие тарифы предлагать — курьером до двери и до пункта выдачи или постамата — и добавляет свою наценку.

Для кого

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

Что умеет

• Стоимость и срок в рабочих днях от СДЭК для каждого выбранного тарифа; каждый тариф — отдельный вариант доставки с названием, сроком и ценой.
• Два способа: «до двери» (курьер СДЭК привозит покупателю) и «до пункта выдачи» (пункт СДЭК или постамат); тарифы отмечаются флажками, поле «Другие коды тарифов» принимает любые коды; ничего не отмечено — все тарифы способа, которые вернёт СДЭК.
• Наценка в процентах и в рублях, бесплатная доставка от суммы товаров.
• Вес и габариты из карточек товаров в единицах магазина (граммы, килограммы, сантиметры, миллиметры), значения по умолчанию для товаров без веса и габаритов; одна посылка на заказ.
• Стоимость в рублях переводится в основную валюту магазина по курсу RUB.
• Кэш расчётов на заданное число часов: одинаковые запросы не уходят в СДЭК повторно.
• Тестовый контур СДЭК (api.edu.cdek.ru) для знакомства с модулем без договора; рабочий контур — с ключами договора.
• Кнопка «Проверить подключение»: токен, код города отправителя и пробный расчёт с таблицей доступных тарифов (коды, режимы, стоимость, срок).
• Геозона, налоговый класс, порядок сортировки — как у штатных способов; ошибки API пишутся в журнал магазина, оформление заказа не блокируется.
• Руководство пользователя — вкладкой «Руководство» на странице расширения.

Как это работает

Покупатель вводит адрес; модуль находит код города в справочнике СДЭК (при одинаковых названиях — по индексу), собирает посылку из веса и габаритов корзины, запрашивает калькулятор и показывает выбранные тарифы: «Посылка склад-дверь, 1–2 раб. дн. — 644 ₽», «Посылка склад-склад, 1–2 раб. дн. — 429,50 ₽». Выбранный тариф записывается в заказ как «СДЭК — название тарифа, срок».

Установка

1. «Расширения → Установщик» → «Загрузить» → файл cdek_oc4.ocmod.zip (имя не менять: OpenCart 4 берёт из него код расширения) → «Установить».
2. «Расширения → Расширения», тип «Доставка» → «Установить» у «Доставка СДЭК» → «Редактировать».
3. Введите идентификатор клиента и секретный ключ, укажите город отправителя, нажмите «Проверить подключение», отметьте тарифы, задайте наценки и включите «Статус».

Модификаторов нет, обновлять их не нужно. Права на страницу получает группа пользователя, который нажал «Установить».

Ключи СДЭК

Ключи интеграции выдаёт СДЭК в личном кабинете для бизнеса (Интеграция → API) по договору. Для проверки без договора включите «Тестовый контур» и используйте тестовые ключи из документации СДЭК — они приведены в руководстве модуля; стоимость на учебном контуре учебная.

Обновление и удаление

Обновление — установка нового архива поверх прежних файлов через Установщик; настройки сохраняются. Удаление: «Расширения → Расширения → Доставка» → «Удалить», затем удалить пакет в Установщике. Заказы с выбранной доставкой СДЭК остаются как есть.

Совместимость и ограничения

• OpenCart 4.1.0.4, PHP 8.2, тема Default — проверено; нужно расширение PHP cURL и доступ сервера к api.cdek.ru.
• Другие версии OpenCart 4 и сторонние темы оформления не проверялись.
• Названия тарифов на витрине приходят из ответа API СДЭК (по-русски и на английской витрине).
• Страховка, наложенный платёж, несколько посылок на заказ, выбор пункта выдачи и передача заказов в СДЭК в эту версию не входят.

Расширение входит в состав бесплатной русской сборки OCM Store: там оно уже установлено и выключено до ввода ключей. Этот пакет — для обычного OpenCart 4.1.0.4.

Список изменений

1.0.0 — первая версия: калькулятор по API v2 СДЭК, способы «до двери» и «до пункта выдачи» с выбором тарифов, наценки, бесплатная доставка от суммы, кэш, тестовый контур, кнопка проверки подключения, руководство вкладкой.