История страницы

...

Настройки профиля доставки

...

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

 В новом модуле добавлен функционал редактирования данных заказа в ЛК Boxberry в просмотре заказа в Битриксе.

 В новом модуле добавлен функционал редактирования данных заказа в ЛК Boxberry в просмотре заказа в Битриксе.

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

Пример заказа, оформленного со службой доставки Boxberry:

...

Разберем как это работает на практике.:

1. Создадим этот заказ в ЛК Boxberry

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

...

1. После создания заказа в панели снизу отобразятся данные полученные от ЛК Boxberry, текст

...

1. кнопки Создать заказ в ЛК сменится на Обновить заказ в ЛК. 
2. Вверху формы отобразится сообщение об успешном создании заказа. Станет активна кнопка Удалить заказ из ЛК

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

...

2. Сменим профиль доставки в форме на Курьер и

...

1. нажмем Обновить заказ в ЛК. Отобразится сообщение об успешном расчете или ошибка в случае если для населенного пункта недоступна курьерская доставка

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

2. Расчет стоимости и смена способа доставки прошли успешно.
3. Изменим тип выдачи, пункт приема, сумму к оплате и нажмем кнопку Пересчитать стоимость 

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

4. Данные успешно обновились. Обратите внимание, вы можете не выполнять перерасчета при смене данных, а обновлять заказы с любыми данными, которые вам нужны. Перерасчеты выполняются автоматически только при смене профиля доставки т.к. в этом случае нужно убедится, что тариф по маршруту существует. В других случаях вам решать выполнять перерасчет или нет.
5. Форма редактирования не позволит создать заказ с не верными данными, она отобразит ошибку, которую возвращает ЛК Boxberry, например попробуем указать вес места больше возможного:

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

6. Получаем ошибку, заказ не будет обновлен. Такая валидация работает со всеми данными.
7. Теперь попробуем удалить заказ из ЛК Boxberry, при удалении всегда отображается окошко для подтверждения

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

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

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

...

1. Мы выбрали профиль доставки, получили расчет и автоматическое заполнение доступных данных, попробуем создать заказ в ЛК

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

2. Получаем ошибку т.к. для создания заказа с самовывозом нужно выбрать пункт выдачи, нажмем кнопку Выбрать ПВЗ, выберем тот, что нам нужен и снова нажмем Создать заказ в ЛК

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

...

1. Заказ успешно создан.
2. Если мы перейдем в админку Магазин/Заказы и распечатаем акт для этого заказа, ссылка на акт добавится в панель информации в просмотре заказа, обновление и удаление заказа станут недоступными

...

1. Раскрыть
   title Показать скриншот
   Image Modified Image Modified Image Modified Image Modified

Заказы Boxberry в админке

Посмотреть все статусы заказов со службой доставки Boxberry можно в админке в разделе Магазин/Заказы Boxberry. На этой странице доступен поиск, отображение текущих статусов заказов. Из массовых действий доступно обновление статусов выделенных заказов.

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

Агенты модуля

...

Агент обновления городов, интервал 86400 секунды (раз в сутки)

Boxberry\Bitrix\Agents\CitiesUpdate::run();

 Агент обновления пунктов приема, интервал 21600 секунды (раз в 6 часов)

Boxberry\Bitrix\Agents\PointsForParcelsUpdate::run();

Агент проверки активности API токенов, интервал 3600 секунд (раз в час)

Boxberry\Bitrix\Agents\KeysChecker::checkToken();

Агент синхронизации статусов заказов, интервал 3600 секунд (раз в час).  Настройки этого агента можно менять в настройках модуля

Boxberry\Bitrix\Agents\Tracking::syncStatuses();

...

Для начала загружаем модуль используя класс Loader

\Bitrix\Main\Loader::includeModule('boxberry.delivery');

...

Создание экземпляра класса с тестовым токеном

$client = new \Boxberry\Api\Client(\Boxberry\Api\Client::TEST_TOKEN);

...

Выполнение api запроса GetKeyIntegration

\Bitrix\Main\Loader::includeModule('boxberry.delivery');
$client = new \Boxberry\Api\Client(\Boxberry\Api\Client::TEST_TOKEN);
$widgetKey = $client->getKeyIntegration();
var_dump($widgetKey);

...

Для получения опций профиля и службы доставки нужно создать экземпляр класса \Boxberry\Bitrix\Helpers\Options передав аргументом id профиля доставки. Id профиля доставки легко получить из объекта заказа или другими способами.

\Bitrix\Main\Loader::includeModule('boxberry.delivery');
$options = new \Boxberry\Bitrix\Helpers\Options('95'); //замените id профиля на ваш существующий

echo '<pre>';
print_r($options);
echo '</pre>';

...

Работать с опциями модуля нужно через статичные методы класса \Boxberry\Bitrix\Helpers\Options, например:

\Bitrix\Main\Loader::includeModule('boxberry.delivery');

echo '<pre>';
print_r(\Boxberry\Bitrix\Helpers\Options::getApiLogFilePath());
echo '</pre>';

...

Для выполнения расчета необходим объект отгрузки \Bitrix\Sale\Shipment

\Bitrix\Main\Loader::includeModule('boxberry.delivery');

use Bitrix\Sale\Order;

$order = Order::load('7'); //айди заказа
$shipmentCollection = $order->getShipmentCollection();

$calculateResult = null;

foreach ($shipmentCollection as $shipment) {
    if (!$shipment->isSystem()) {
        $calculateResult = \Boxberry\Bitrix\Helpers\Delivery::calculate($shipment);
    }
}

echo '<pre>';
print_r($calculateResult);
echo '</pre>';

...

Как проверить содержится ли в заказе способ доставки Boxberry

\Bitrix\Main\Loader::includeModule('boxberry.delivery');

use Bitrix\Sale\Order;

$order = Order::load('7'); // ID заказа
$isBoxberryDeliveryInOrder = \Boxberry\Bitrix\Helpers\Validator::isBoxberryDeliveryInOrder($order);

var_dump($isBoxberryDeliveryInOrder);

...

Получение по коду города из api Boxberry

\Bitrix\Main\Loader::includeModule('boxberry.delivery');

$bbCity = \Boxberry\Bitrix\CitiesFullTable::getBbCityByCode('68'); // 68 - Москва, код города в api Boxberry

echo '<pre>';
print_r($bbCity);
echo '</pre>';

...

Получение по коду местоположения Битрикса

\Bitrix\Main\Loader::includeModule('boxberry.delivery');

$bbCity = \Boxberry\Bitrix\CitiesFullTable::getBbCityByBitrixLocationCode('0000073738'); // 0000073738 - Москва, код города в Битриксе

echo '<pre>';
print_r($bbCity);
echo '</pre>';

...

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

\Bitrix\Main\Loader::includeModule('boxberry.delivery');

$syncStatusesAgentRun = Boxberry\Bitrix\Agents\Tracking::syncStatuses();

echo $syncStatusesAgentRun;

...

Запуск агента обновлений городов

\Bitrix\Main\Loader::includeModule('boxberry.delivery');

$citiesUpdateAgentRun = Boxberry\Bitrix\Agents\CitiesUpdate::run();

echo $citiesUpdateAgentRun;

...

Запуск агента обновлений пунктов приема заказа

\Bitrix\Main\Loader::includeModule('boxberry.delivery');

$pointsForParcelsUpdateAgentRun = Boxberry\Bitrix\Agents\PointsForParcelsUpdate::run();

echo $pointsForParcelsUpdateAgentRun;

...