Модуль совместим с Opencart 2.3 - 3.x

Поддерживаемые модули оформления заказа: 

  • Стандартная пошаговая страница оформления заказа
  • Simple (до версии 4.11.5 включительно)
  • OnePage Checkout

Требования к серверу (хостингу) для корректной работы модуля: PHP не ниже версии 5.6, активный модуль curl.


При использовании других checkout (модулей оформления заказа), а также несовместимых версий PHP, корректная работа модуля не гарантируется!

Для установки и настройки обязательно проследуйте по шагам инструкции:

Установка модуля

<br>
Зарегистрировать личный кабинет <a href="https://account.boxberry.ru/" target="_blank"><b>ЗДЕСЬ</b></a>


Получить API-токен ЗДЕСЬ

В настройке ЛК ЗДЕСЬ и ЗДЕСЬ обязательно выбрать пункт приема.

Скачать модуль Installer Fix Allow All directories ЗДЕСЬ

Скачать модуль Boxberry для Opencart ЗДЕСЬ

В админке Opencart перейти в раздел МодулиУстановка модулей (также может называться Установка расширений)

Загрузить и установить модули, в первую очередь модуль Installer Fix Allow All directories затем модуль Boxberry для Opencart

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

Перейти в раздел Модули Модули (также может называться Модули \ Расширения) в выпадающем списке выбрать Доставка 

Активируем способ доставки Boxberry и заходим в настройки

Описание настроек модуля

РазделНаименование настройкиОписание настройки
Настройки доступаСтатусПозволяет включить/отключить службу доставки Boxberry.
API-Токен*Укажите ваш API-токен из ЛК Boxberry ОТСЮДА
URL API сервиса*URL для API запросов, редактировать не нужно!
URL для виджета*URL скрипта виджета, редактировать не нужно!
Статус для автоматической выгрузки в ЛКЗаказ с указанным статусом будет автоматически выгружен в ЛК Boxberry.
Порядок сортировкиДанный числовой индекс указывается для сортировки службы доставки на странице оформления заказа.
Настройки веса и габаритовВес по умолчанию (г)*

Обязательно укажите вес по умолчанию на ваш выбор в формате целого числа. Нельзя указывать 0.

Вес по умолчанию используется в случае, если в карточке товара вес не указан, либо равен нулю.

Задается в граммах.

Рекомендуется указывать значение не меньше 5

Вес мин. (г.)

Если вес заказа строго меньше указанного, то доставка Boxberry не будет отображаться на странице оформления заказа (задается в граммах).

Рекомендуется указывать значение не меньше 5

Вес макс. (г.)

Если вес заказа строго больше указанного, то доставка Boxberry не будет отображаться на странице оформления заказа (задается в граммах).

Рекомендуется указывать значение не более 31000

Ширина товара (если ширина для товара не указана) (см)Задание ширины для товара по умолчанию, если ширина у товара не указана.
Высота товара (если высота для товара не указана) (см)Задание высоты для товара по умолчанию, если высота у товара не указана.
Длина товара (если длина для товара не указана) (см)Задание длины для товара по умолчанию, если длина у товара не указана.
Применить вышеуказанные габариты и вес ко всему отправлению, а не к каждой позиции

При включенной опции вышеуказанные габариты и вес по умолчанию будут применяться автоматически ко всему заказу.

При выключенной опции вышеуказанные габариты и вес по умолчанию будут применяться автоматически к каждому товару в заказе, если такие данные в товаре не заполнены, иначе габариты и вес будут браться непосредственно из данных товара.

Настройки способов доставки


Доставка до пункта выдачи

Профиль доставки до пункта выдачи с наложенным платежом. Для заказов в которых стоимость заказа и доставки покупатель оплачивает в пункте выдачи при получении.

Профиль доставки возможно включить/отключить, сменой статуса.

Возможно включить/отключить настройки расчета из ЛК ОТСЮДА с вкладки Расчеты.

Возможно включить/отключить автоматическую выгрузку заказов в ЛК Boxberry сразу после оформления заказа на сайте (доступно с 29.03.2021 в версии 1.5).

Возможно включить/отключить автоматическое формирование актов после выгрузки заказа в ЛК Boxberry. Опция по умолчанию выключена.(доступно с 31.03.2021 в версии 1.6).

Также возможно задать любое имя для профиля.

Доставка до пункта выдачи без наложенного платежа

Профиль доставки до пункта выдачи без наложенного платежа. Для заказов в которых стоимость заказа и доставки уже предоплачена, покупатель только забирает заказ в пункте выдачи.

Профиль доставки возможно включить/отключить, сменой статуса.

Возможно включить/отключить настройки расчета из ЛК ОТСЮДА с вкладки Расчеты.

Возможно включить/отключить автоматическую выгрузку заказов в ЛК Boxberry сразу после оформления заказа на сайте (доступно с 29.03.2021 в версии 1.5).

Возможно включить/отключить автоматическое формирование актов после выгрузки заказа в ЛК Boxberry. Опция по умолчанию выключена.(доступно с 31.03.2021 в версии 1.6).

Также возможно задать любое имя для профиля.

Курьерская доставка

Профиль курьерской доставки с наложенным платежом. Для заказов в которых стоимость заказа и доставки покупатель оплачивает при получении курьеру.

Профиль доставки возможно включить/отключить, сменой статуса.

Возможно включить/отключить настройки расчета из ЛК ОТСЮДА с вкладки Расчеты.

Возможно включить/отключить автоматическую выгрузку заказов в ЛК Boxberry сразу после оформления заказа на сайте (доступно с 29.03.2021 в версии 1.5).

Возможно включить/отключить автоматическое формирование актов после выгрузки заказа в ЛК Boxberry. Опция по умолчанию выключена.(доступно с 31.03.2021 в версии 1.6).

Также возможно задать любое имя для профиля.

Курьерская доставка без наложенного платежа

Профиль курьерской доставки без наложенного платежа. Для заказов в которых стоимость заказа и доставки уже предоплачена, курьер выдает заказ покупателю без оплаты.

Профиль доставки возможно включить/отключить, сменой статуса.

Возможно включить/отключить настройки расчета из ЛК ОТСЮДА с вкладки Расчеты.

Возможно включить/отключить автоматическую выгрузку заказов в ЛК Boxberry сразу после оформления заказа на сайте (доступно с 29.03.2021 в версии 1.5).

Возможно включить/отключить автоматическое формирование актов после выгрузки заказа в ЛК Boxberry. Опция по умолчанию выключена.(доступно с 31.03.2021 в версии 1.6).

Также возможно задать любое имя для профиля.


Проверяем работу модуля

С модулем Simple

Добавляем товар в корзину, переходим в оформление заказа, заполняем обязательные поля.

Начиная с версии модуля 1.5 указание почтового индекса и наличие поля Индекс не требуется. Модуль будет получать и искать индексы самостоятельно на основании указанного города и/или города+региона.


Переходим к способам доставки, например, нам нужна доставка до ПВЗ, выбираем ПВЗ на карте 

Краткая информация о выбранном ПВЗ отобразится под выбранным способом доставки:

ПВЗ выбран, адрес и код ПВЗ записаны в поле адреса, при этом для способа доставки до ПВЗ поле с адресом заблокировано, чтобы покупатель не мог его отредактировать. При смене способа доставки на другой поле разблокируется.

Завершаем оформление заказа кнопкой Оформить заказ.

Оформление заказа со стандартным пошаговым шаблоном.

Добавляем товар в корзину, переходим в оформление заказа, заполняем обязательные поля.

Начиная с версии модуля 1.5 указание почтового индекса и наличие поля Индекс не требуется. Модуль будет получать и искать индексы самостоятельно на основании указанного города и/или города+региона.

Переходим к способам доставки, например, нам нужна доставка до ПВЗ, выбираем ПВЗ на карте

В данном случае информация о выбранном ПВЗ отображена прямо в блоке выбора доставки, чтобы не возвращаться к полям адреса:

Завершаем оформление заказа кнопкой Оформить заказ.


Автоматическая выгрузка заказа в ЛК и формирование актов

Начиная с версии 1.6 в настройке модуля доступны опции Выгружать заказы в ЛК автоматически (включена по умолчанию), а также Формировать акт автоматически после выгрузки заказа в ЛК (выключена по умолчанию).

При активной опции Выгружать заказы в ЛК автоматически заказы будут автоматически выгружаться в ЛК Boxberry сразу после оформления на сайте. В разделе ПродажиBoxberry будет отображаться информация по заказу и ссылка на этикетку:

При активной опции Формировать акт автоматически после выгрузки заказа в ЛК по заказу будет сформирован акт после того как он будет выгружен в ЛК Boxberry. 

Также можно вручную сформировать акт приёма/передачи для одного или нескольких отправлений, выделив необходимые заказы галочками слева от нужных заказов и нажав в правом меню Акты кнопку Сформировать акт.

В разделе ПродажиBoxberry будет отображаться информация по заказу, ссылка на этикетку, ссылка на акт и отслеживание заказа.

При этом не важно каким образом произведена выгрузка заказа, автоматически или вручную, акт сформируется. 

Выгрузка заказа в ЛК вручную

В админке Opencart переходим в раздел Продажи Заказы

Переходим в редактирование нашего заказа

Проходим до вкладки Итоги и меняем статус заказа, на тот, который мы выбрали в настройке модуля:

Меняем статус заказа и жмем Сохранить 

Нажимаем сохранить

Переходим в раздел Продажи Boxberry и проверяем успешно ли выгрузился наш заказ

Заказ успешно выгружен, ЛК вернул трек номер и ссылку на этикетку.

При активной опции Формировать акт автоматически после выгрузки заказа в ЛК будет также отображаться ссылка на акт и отслеживание заказа на сайте.

После формирования акта статус заказа на сайте выглядит так


Ориентировочно через 30-60 минут данные по заказу загрузятся в систему и будут отображаться полностью. 

В случае неуспешной выгрузки заказа в столбце Описание ошибки, будет указан текст ошибки.

Если при выгрузке заказа возникает ошибка и вы не можете решить ее самостоятельно, обратитесь в техподдержку. В заявке добавьте текст и/или скриншот ошибки.