Модуль предназначен для CMS WordPress 4.9 и выше и плагина WooCommerce 3.5 и выше.
На хостинге должна быть установлена версия PHP не ниже версии 5.4. Рекомендуемая версия PHP 7.2 и выше.
Скачать предыдущие версии модуля можно здесь: https://ru.wordpress.org/plugins/boxberry/advanced/
Для установки и настройки обязательно проследуйте по шагам инструкции:
Установка модуля из маркетплейса Wordpress
Зарегистрировать личный кабинет ЗДЕСЬ
Получить апи токен ЗДЕСЬ
В админке Wordpress перейти в раздел Плагины нажать кнопку Добавить новый
В строке поиска справа ввести boxberry
Установить плагин Интеграция со службой доставки Boxberry, после установки нажать кнопку Активировать.
В разделе Плагины рекомендуем включить автоматическое обновление.
Затем перейдите к настройке
Установка модуля из архива
Зарегистрировать личный кабинет ЗДЕСЬ
Получить апи токен ЗДЕСЬ
Скачать модуль ЗДЕСЬ
В админке Wordpress перейти в раздел Плагины нажать кнопку Добавить новый
На странице добавления плагина нажать кнопку Загрузить плагин и выбрать архив с модулем, скачанный ранее и нажать кнопку Установить
Дождаться распаковки и установки и нажать кнопку Активировать плагин
Настройка модуля
В админке Wordpress перейти в раздел Woocommerce → Настройки → Доставка
Если вы еще не добавляли зоны доставки - добавить зоны таким образом:
Написать название (например, Россия), указать соответствующую зону
Пример с Казахстаном
Для добавления способов доставки нужно перейти в настройки Зоны доставки
В настройке зоны доставки нажать кнопку Добавить метод доставки
Выбрать из списка необходимый способ доставки и нажать кнопку Добавить метод доставки
После добавления способов доставки они отобразятся в настройке зоны доставки
Перейдем в настройку любого из способов доставки до ПВЗ
| Наименование настройки | Описание настройки |
|---|---|
| Название | В этом поле указывается название способа доставки, которое будет отображаться при оформлении заказа на сайте и фигурировать в заказе в дальнейшем. |
| API-токен | Здесь указывается API-токен из ЛК Boxberry для работы модуля. |
URL для API | В этом поле уже указаны необходимые данные. Начиная с версии 2.5 поле URL для API заблокировано для редактирования во избежание ошибок со стороны пользователя. В этом поле ничего менять не нужно! |
URL для виджета | Убедиться, что введён URL https://points.boxberry.ru/js/boxberry.js |
Вес по умолчанию | Укажите вес одной товарной позиции, который будет использоваться по умолчанию, если это значение не указано в карточке товара. Для корректного расчета стоимости доставки необходимо, чтобы вес был задан в карточке каждого товара. |
Минимальный вес | Укажите минимальный вес заказа для работы службы доставки. Если вес заказа будет строго меньше указанного, то доставка Boxberry не будет отображаться на странице оформления заказа. |
Максимальный вес | Укажите максимальный вес заказа для работы службы доставки. Если вес заказа будет строго больше указанного, то доставка Boxberry не будет отображаться на странице оформления заказа. |
Максимальная высота | Указывается максимальная высота товара для работы службы доставки. Если высота товара строго больше указанного, то доставка Boxberry не будет отображаться на странице оформления заказа (задается в сантиметрах). |
| Максимальная глубина | Указывается максимальная глубина товара для работы службы доставки. Если глубина товара строго больше указанного, то доставка Boxberry не будет отображаться на странице оформления заказа (задается в сантиметрах). |
| Максимальная ширина | Указывается максимальная ширина товара для работы службы доставки. Если ширина товара строго больше указанного, то доставка Boxberry не будет отображаться на странице оформления заказа (задается в сантиметрах). |
| Отправлять заказы в ЛК Boxberry автоматически при наступлении статуса заказа | Опция позволяет выгружать заказы в ЛК при смене статуса в Wordpress, по умолчанию выключено. |
| Автоматический статус, после отправки заказа в ЛК Boxberry | Опция позволяет менять статус заказа в Wordpress на выбранный, после выгрузки заказа в ЛК Boxberry. |
| Отключить настройки расчёта для данного вида доставки | Опция позволяет отключать применение настроек из ЛК ОТСЮДА с вкладки Расчеты. По умолчанию передача настроек активна, если ее нужно выключить переключите опцию в положение Да. |
| Формировать акт автоматически после выгрузки заказа в ЛК Boxberry | Опция позволяет формировать акт автоматически, после того как вы произведете выгрузку заказа в ЛК. Если опция активна в заказе дополнительно отобразится ссылка на сформированный акт и ссылка на отслеживание заказа на сайте Boxberry. Опция по умолчанию выключена. Для ее активации переключите опцию в положение Да. |
| Отображать кнопку открытия виджета (иначе, отображается ссылка) | Опция позволяет отображать кнопку для открытия виджета вместо ссылки. Опция по умолчанию выключена. Для ее активации переключите опцию в положение Да. Пример как это выглядит:
|
| Префикс для заказов | Опция позволяет менять либо удалять префиксы, которые модуль добавляет к номерам заказов при выгрузке в ЛК Boxberry. |
| Использовать индекс покупателя | Опция позволяет проверять индекс указанный при оформлении и если индекс указан не верно или доставка по нему не производится скрывать способ доставки курьером. Активация этой опции отключает автоматический поиск индекса. Опция будет полезна если поле Индекс является обязательным для заполнения или вы столкнулись с проблемой при автоматическом поиске индекса. По умолчанию отключено. Доступно только в способах доставки курьером. |
| Включено для способов оплаты | Опция позволяет ограничить использование способа доставки только для определенных способов оплаты. Можно выбрать несколько способов оплаты одновременно. Для отключения нужно удалить все выбранные способы оплаты. По умолчанию отключено. |
| |
Настройки способов курьерской доставки такие же, за исключением отсутствия поля Url для виджета и опции Отображать кнопку открытия виджета (иначе, отображается ссылка) т.к. в случае с курьерской доставкой они не требуются.
Проверяем работу модуля
Добавляем товар в корзину, переходим в оформление заказа, заполняем обязательные поля, выберем для примера доставку до ПВЗ:
При выборе способа доставки до ПВЗ отображается кнопка открытия виджета т.к. эту опцию мы активировали в настройке способа доставки.
Выберем пункт выдачи на карте и нажмем Выбрать отделение
Адрес выбранного ПВЗ отображается в кнопке выбора ПВЗ и в поле Адрес
Если покупатель нажмет кнопку Подтвердить заказ не выбрав ПВЗ отобразится уведомление о необходимости выбрать ПВЗ, продолжить оформление заказа без выбора ПВЗ нельзя
Выгрузка заказа в ЛК Boxberry
Например, мы хотим выгружать заказы в ЛК и сразу формировать акты из админки Wordpress.
Перейдем в админку и активируем в нашем способе доставки до ПВЗ опцию автоматического формирования актов
Далее перейдем в наш оформленный заказ.
В блоке с доставкой для выгрузки заказа в ЛК нужно нажать кнопку Отправить заказ в систему. Т.к. мы включили автоматическое формирование актов, нам также вернется ссылка на акт и на отслеживание заказа на сайте
Проверяем блок доставки после выгрузки заказа в ЛК Boxberry
Выгрузка прошла успешно, все нужные данные вернулись корректно.
После формирования акта статус заказа на сайте выглядит так
Ориентировочно через 30-60 минут данные по заказу загрузятся в систему и будут отображаться полностью.
Если при выгрузке заказа возникает ошибка, обратитесь в техподдержку. В заявке добавьте текст и/или скриншот ошибки.
Если опция автоматического формирования актов выключена, после выгрузки заказа в блоке доставки будет доступен только трек-номер для отслеживания и ссылка на этикетку.