Как добавить новый способ доставки в OpenCart

Создание модуля — доставки — задача, которая возникает при интеграции с новой службой доставки. В OpenCart модуль доставки рассчитывает стоимость на основе веса, адреса и способа доставки.

Структура модуля доставки

upload/
├── catalog/model/extension/shipping/myshipping.php
├── catalog/controller/extension/shipping/myshipping.php
└── admin/controller/extension/shipping/myshipping.php

Метод getQuote

Этот метод вызывается при оформлении заказа для получения вариантов доставки. Возвращает массив с названием, стоимостью и сроком доставки.

Рекомендации из практики

Как лучше: Используйте готовые модули для популярных служб доставки (СДЭК, Boxberry, Почта России). Они реализуют расчёт стоимости и отслеживание через API.

Как не делать: Не пишите кастомный модуль доставки с нуля, если есть готовый. Кастомная разработка оправдана только при нестандартной логике расчёта.

Кейс из практики: Добавляли СДЭК в OpenCart через готовый модуль. Настройка заняла 1 час: API-ключ, тарифы, ПВЗ на карте. Клиент сразу начал получать на 15% больше заказов — покупатели выбирали удобный пункт выдачи.

По практике, интеграция служб доставки — закажите доработку. Закажите доработку OpenCart

Интеграция с API

Если модуль рассчитывает стоимость через API (СДЭК, Boxberry, Почта России), запрос должен быть асинхронным, чтобы не блокировать оформление заказа. Кэшируйте результаты расчёта на 5-10 минут.

FAQ

Поче

Как тестировать модуль доставки. После установки модуля сделайте тестовый заказ с реальными адресами в разных регионах. Проверьте: что стоимость считается правильно, что модуль не отображается для зон, где доставка не работает, что при недоступности API расчёта checkout не зависает (должен показать сообщение об ошибке, а не белый экран).

Geo Zones. В OpenCart зоны доставки настраиваются через Система → Локализация → Geo Zones. Модуль доставки должен проверять, попадает ли адрес покупателя в настроенную зону. Без этой проверки модуль может предлагать доставку в регионы, куда вы физически не отправляете.

у модуль доставки не отображается на checkout?

Проверьте, что модель загружена, getMethod возвращает данные, и модуль включён в настройках.

Нужно ли создавать отдельную модель для расчёта?

Да, если расчёты сложные — вынесите их в отдельный метод модели, а не пишите логику в контроллере.

Итог

Модуль доставки = getQuote + интеграция с API. Кэшируйте расчёты, тестируйте с реальными адресами.

Из практики. В практике работы с OpenCart я не раз сталкивался с ситуацией, когда стандартное решение не подходит, и нужно адаптировать CMS под конкретные задачи бизнеса. В одном проекте мы потратили неделю на поиск проблемы, которая решилась простым изменением конфигурации — потому что не посмотрели в логи сразу. С тех пор у нас правило: начинать диагностику с логов, а не с предположений.

Как не надо. Не копируйте готовые решения из интернета без проверки совместимости с вашей версией OpenCart и установленными модулями. То, что сработало у другого владельца магазина, может сломать ваш сайт — особенно если у вас нестандартная сборка. Всегда делайте бэкап перед любыми изменениями.