Примечание |
---|
Модуль совместим с модулем Главный модуль Битрикса 22 и новее. Требования к серверу (хостингу) для корректной работы модуля: PHP не ниже версии 8.1. |
Предупреждение |
---|
При использовании другой версии модуля Главный модуль Битрикса, а также несовместимых версий PHP, корректная работа модуля не гарантируется! |
Оглавление
Оглавление |
---|
Установка из Маркетплейса
...
Вкладка | Наименование настройки | Описание настройки | |||||
---|---|---|---|---|---|---|---|
Тип доставки | При создании профиля доставки на вкладке Тип доставки нужно обязательно выбрать, какой тип профиля вы хотите создать: самовывоз или курьерская доставка. Не забывайте изменить название профиля. После создания профиля изменить его тип уже нельзя. | ||||||
Настройки наложенного платежа
| Режим наложенного платежа для расчета стоимости | Позволяет игнорировать настройку наложки из службы доставки (где добавление наложки в стоимость доставки зависит от выбранного способа оплаты) для текущего профиля и сделать его постоянно профилем с наложенным платежом, либо без. По умолчанию не используется (отключена). | |||||
Режим наложенного платежа для выгрузки в ЛК | Позволяет принудительно устанавливать сумму к оплате выгружать заказ в личный кабинет интернет магазина с суммой к оплате или без неё для текущего профиля доставки. По По умолчанию опция не используется (отключена). | ||||||
Источник настроек расчета (Каждый профиль позволяет выбрать источник настроек расчета стоимости доставки) | ЛК Boxberry | Будут использоваться настройки из ЛК Boxberry отсюда со вкладки Расчеты. | |||||
Профиль доставки | Позволяет использовать настройки внутри профиля. Все опции аналогичны настройкам из ЛК со вкладки Расчеты, работают также с одинаковой логикой и также называются. Выбор этой опции открывает настройки в профиле, а настройки расчета из ЛК будут игнорироваться. | ||||||
Описанные далее настройки применимы, если выбран источник настроек расчета - Профиль доставки. | |||||||
Срок доставки | Скрыть срок доставки | Скрывает срок доставки в оформлении заказа и при любом расчете стоимости доставки с данным профилем. | |||||
Укажите количество дней, которое необходимо добавить к основному сроку доставки Boxberry | Добавляет указанное число к сроку доставки. | ||||||
Округление | Округление до | Позволяет округлить расчет стоимости. Возможные варианты:
| |||||
Округлить как |
| ||||||
Стоимость доставки | Позволяет настроить бесплатную стоимость доставки от определенной суммы заказа, либо полностью бесплатную стоимость доставки. Например, при таком условии стоимость доставки будет рассчитана по тарифу для заказов <= 7000р, а затем доставка будет бесплатной.
| ||||||
Надбавки (Позволяет настроить надбавки ко многим параметрам)
| Вес | Добавляет\убавляет вес, переданный для расчета на сайте. | |||||
Процент от тарифа Boxberry | Добавляет\убавляет процент от итоговой стоимости доставки. | ||||||
Процент от объявленной стоимости | Добавляет\убавляет процент от стоимости услуги страховки. | ||||||
Процент от суммы к оплате | Добавляет\убавляет процент от стоимости услуги Прием платежа (Наложенный платеж). | ||||||
Фиксированная сумма | Добавляет\убавляет фиксированную сумму от стоимости доставки | ||||||
Опции | Минимальная стоимость доставки | Позволяет задать минимальную стоимость доставки, т.е. даже если реальный расчет стоимости будет ниже указанной, модуль все равно отобразит минимальную стоимость. | |||||
Максимальная стоимость доставки | Позволяет задать максимальную стоимость доставки, т.е. даже если реальный расчет стоимости будет выше указанной, модуль все равно отобразит максимальную стоимость. |
...
Вкладка | Наименование настройки | Описание настройки | |||||
---|---|---|---|---|---|---|---|
Общие настройки
| Укажите код свойства артикула товара | По умолчанию указан код свойства ARTNUMBER. Настройка позволяет передавать артикулы у вложений в заказе, если указанный код свойства не будет найден передается Id товара. | |||||
| Если активно, в просмотре любого заказа будет отображаться кнопка Доставка 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 - таблица с пунктами приема
...
Блок кода | ||||||
---|---|---|---|---|---|---|
| ||||||
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
onBeforeSetNoticeDescription | |
onBeforeSetNoticeDescription |
Регистрируем обработчик события onBeforeSetNotice, затем, для примера, добавляем комментарий к заказу
Блок кода | ||||||
---|---|---|---|---|---|---|
| ||||||
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', 'Комментарий к заказу');
} |
Запуск агентов
Запуск агента синхронизации статусов заказов
...
- Модуль подписан на событие OnSaleComponentOrderJsData для определения выбранного способа доставки в оформлении заказа.
- Модуль подписан на событие OnSaleOrderBeforeSaved для проверки выбранного ПВЗ при сохранении заказа.
- Модуль подписан на событие OnSaleOrderSaved для обработки и сохранения данных заказа.
Все указанные выше подписки находятся в файле /bitrix/php_interface/include/sale_delivery/boxberry/handler.php
Если в вашем кастоме этот функционал изменен\работает по другому, вам нужно адаптировать его под модуль самостоятельно.
...