Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.
Примечание

Модуль совместим с модулем Главный модуль Битрикса 22 и новее.

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

Предупреждение

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

Оглавление

Оглавление

Установка из Маркетплейса

...

ВкладкаНаименование настройкиОписание настройки

Тип доставки


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

Настройки наложенного платежа


 

Режим наложенного платежа для расчета стоимостиПозволяет игнорировать настройку наложки из службы доставки (где добавление наложки в стоимость доставки зависит от выбранного способа оплаты) для текущего профиля и сделать его постоянно профилем с наложенным платежом, либо без. По умолчанию не используется (отключена).
Режим наложенного платежа для выгрузки в ЛКПозволяет принудительно устанавливать сумму к оплате выгружать заказ в личный кабинет интернет магазина с суммой к оплате или без неё для текущего профиля доставки.  По По умолчанию опция не используется (отключена).

Источник настроек расчета

(Каждый профиль позволяет выбрать источник настроек расчета стоимости доставки)


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

Описанные далее настройки применимы, если выбран источник настроек расчета - Профиль доставки.

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

Округление

Округление до

Позволяет округлить расчет стоимости. Возможные варианты:

  • Не округлять
  • До рублей
  • До десяти рублей
  • До сотен рублей
Округлить как
  • Округление математическое - округление до ближайшего целого, например стоимость доставки 124р будет округляться как 120р при округлении до десяти рублей, либо 124.35р будет округляться как 124р при округлении до рублей
  • Округление в большую сторону - округление до целого в большую сторону, например стоимость доставки 124р будет округляться как 130р при округлении до десяти рублей, либо 124.35р будет округляться как 125р при округлении до рублей

Стоимость доставки


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

Например, при таком условии стоимость доставки будет рассчитана по тарифу для заказов <= 7000р, а затем доставка будет бесплатной.

Раскрыть
titleПоказать скриншот

Надбавки

(Позволяет настроить надбавки ко многим параметрам)
Подсказка
Важно: все надбавки могут быть как положительными, так и отрицательными. Например, указание надбавки к весу со знаком минус -300, вычтет 300 грамм из переданного для расчета веса, а указание надбавки 1000  – добавит 1000 грамм к переданному весу. 

Подсказка
Чтобы убрать из стоимости доставки страховку укажите в надбавке Процент от объявленной стоимости -0.5
Вес

Добавляет\убавляет вес, переданный для расчета на сайте.

Процент от тарифа Boxberry

Добавляет\убавляет процент от итоговой стоимости доставки.

Процент от объявленной стоимости

Добавляет\убавляет процент от стоимости услуги страховки.

Процент от суммы к оплате

Добавляет\убавляет процент от стоимости услуги Прием платежа (Наложенный платеж).

Фиксированная сумма

Добавляет\убавляет фиксированную сумму от стоимости доставки

Опции

Минимальная стоимость доставки

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

Максимальная стоимость доставки

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

...

ВкладкаНаименование настройкиОписание настройки

Общие настройки


 


 

 

Укажите код свойства артикула товараПо умолчанию указан код свойства ARTNUMBER. Настройка позволяет передавать артикулы у вложений в заказе, если указанный код свойства не будет найден передается Id товара.

Якорь
add_bb_button_to_all_orders_descr
add_bb_button_to_all_orders_descr
Отображать кнопку создания заказа в Boxberry для всех заказов в админке

Если активно, в просмотре любого заказа будет отображаться кнопка Доставка Boxberry, кнопка отображает удобную форму для создания и редактирования данных в отправке, если не активно отображается только в заказах со службой доставки Boxberry.
Выберите статус заказа для выгрузкиПри наступлении указанного статуса заказы будут выгружаться в ЛК Boxberry.
Добавлять трек номер в поле "Идентификатор отправления" при создании заказа в ЛКДобавляет треки в идентификатор отправления после выгрузки заказа в ЛК. По умолчанию активно.
Инициализация виджета только на стандартное событиеПозволяет ограничить инициализацию расширения виджета только на стандартное событие, чтобы он не подключался на всех страницах сайта
Максимальное количество запросовКол-во запросов к трекингу после создания заказа (повторные запросы выполняются в случае ошибок)
Пауза между запросамиПауза между запросами к трекингу (повторные запросы выполняются в случае ошибок)

Настройки статусов

Включить синхронизацию статусов

Активирует агента (фоновое задание) для синхронизации статусов Boxberry со статусами в Битриксе, что позволяет автоматически двигать заказы по статусам. 

Далее следует соответствие статусов, статусы свои у каждого магазина. Необязательно выбирать соответствие каждому, те что не нужны можно не настраивать, они не будут обрабатываться.
Количество заказов, обрабатываемых за 1 запускЕсли заказов слишком много и агент не забирает на обработку все нужные заказы с настройкой по умолчанию, количество можно увеличить.
Интервал запуска агентаЗдесь можно изменить интервал запуска.
Количество дней с последнего обновления заказа, на которые запрашиваются статусыПозволяет исключить из обработки заказы, статус которых не менялся указанное количество дней.
Помечать заказ оплаченным при успешной выдачеЕсли активно, то при смене статуса заказа на "Успешно выдан", статус оплаты заказа будет изменён на "Оплачен".

Отладка и логирование

Записывать ошибки модуля в журнал событийПозволяет записывать все ошибки в штатный Журнал событий Битрикса (Настройки/Инструменты/Диагностика/Журнал событий). По умолчанию отключено.
Выводить в консоль данные для отладкиВыводит отладочную информацию в консоль браузера. Работает в оформлении заказа, в службе доставки, создании заказа в админке.
Логировать запросы к апиЗаписывает все api запросы/ответы в файл с расширением .log
Размер лог-файла API запросовЛимит размера файла для логов, в мегабайтах.
Пусть к лог-файлу API запросовПуть создания файла с логами, модуль создает только файл, убедитесь что указанная папка существует.

Доступ

 Стандартная для всех модулей настройка прав доступа.

Обновление модуля

 

Модуль предлагает встроенную систему обновлений. В этом случае дистрибутивы обновлений загружаются с сервера Boxberry bitrix.boxberry.ru

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

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

Сервисы

 

Раздел предназначен для подключения сторонних сервисов для работы с модулем.

На данный момент доступно только указание своего токена для сервиса DaData. Это необязательно, но добавлено на случай исчерпания лимита по встроенному в модуль токену. В этом случае пользователь может зарегистрировать аккаунт в сервисе DaData  и добавить в настройку свой токен. Бесплатный лимит запросов в сервисе 10000 запросов в сутки. С учетом того, что модуль кеширует результат запроса на сутки и редких обращений к сервису, этого количества должно хватить более чем.

В дальнейшем данный раздел будет дополняться другими сервисами.

...

  • boxes - массив мест в заказе, его можно изменять

Таблицы модуля 

Модуль создает 3 таблицы в БД при установке


onBeforeSetNotice - позволяет добавлять комментарий к заказу, строка с комментарием передается в параметре notice апи метода ParselCreate. Пример работы

Метод обработчик получает объект \Bitrix\Main\Event содержащий два параметра:

  • orderId -  id заказа в Битриксе
  • notice - строка с комментарием, его можно изменять

Таблицы модуля 

Модуль создает 3 таблицы в БД при установке

b_boxberry_cities_full - таблица с b_boxberry_cities_full - таблица с городами

b_boxberry_points_for_parcels - таблица с пунктами приема

...

Блок кода
languagephp
themeMidnight
linenumberstrue
use Bitrix\Main\EventManager;

//Регистрация обработчика
$eventManager = EventManager::getInstance();
$eventManager->registerEventHandler(
    'boxberry.delivery',
    'onBeforeGetWeights',
    'boxberry.delivery',
    '\Boxberry\Bitrix\Entity\Order',
    'modifyPlaces'
);

// Метод-обработчик события в классе \Boxberry\Bitrix\Entity\Order

public static function modifyPlaces(Event $event): void
{
    $boxes = $event->getParameter('boxes');
    $boxes[0]['Weight'] = 1301;
    $event->setParameter('boxes', $boxes);
}


Передача комментария для заказа 

Якорь
onBeforeSetNoticeDescription
onBeforeSetNoticeDescription

Регистрируем обработчик события onBeforeSetNotice, затем, для примера, добавляем комментарий к заказу

Блок кода
languagephp
themeMidnight
linenumberstrue
use Bitrix\Main\EventManager;

//Регистрация обработчика
$eventManager = EventManager::getInstance();
$eventManager->registerEventHandler(
    'boxberry.delivery',
    'onBeforeSetNotice',
    'boxberry.delivery',
    '\Boxberry\Bitrix\Entity\Order',
    'setNotice'
);

// Метод-обработчик события в классе \Boxberry\Bitrix\Entity\Order

public static function setNotice(Event $event): void
{
    $event->setParameter('notice', 'Комментарий к заказу');
}

Запуск агентов

Запуск агента синхронизации статусов заказов

...

  1. Модуль подписан на событие OnSaleComponentOrderJsData для определения выбранного способа доставки в оформлении заказа.
  2. Модуль подписан на событие OnSaleOrderBeforeSaved для проверки выбранного ПВЗ при сохранении заказа.
  3. Модуль подписан на событие OnSaleOrderSaved для обработки и сохранения данных заказа.

Все указанные выше подписки находятся в файле /bitrix/php_interface/include/sale_delivery/boxberry/handler.php

Если в вашем кастоме этот функционал изменен\работает по другому, вам нужно адаптировать его под модуль самостоятельно.

...