• Регистрация приложения
• Настройки для сайта
• Регистрация в модуле Boxberry
• Настройки модуля
• Проверка работы модуля
• Настройки расчёта стоимости доставки

Регистрация приложения

Для создания приложения необходимо авторизоваться под своим uID администратора — создателя сайта (важно!):

http://uapi.ucoz.com/uapi_panel

Перейдите по ссылке для создания приложения:

http://api.ucoz.net/ru/join/reg

Выберите способ регистрации — Полуавтоматом.

Следуйте инструкциям на экране и выполните предложенные действия.

Повторно откройте ссылку:

http://api.ucoz.net/ru/join/reg

Заполните данные приложения:

• Название приложения и Consumer key — придумайте самостоятельно.
• Consumer secret — будет сгенерирован автоматически (пример см. ниже).
• В поле Redirect URL укажите адрес вашего сайта в системе uCoz. Если подключён собственный домен — укажите его.

Нажмите Сохранить, затем — Готово, идем дальше.

Введите Consumer key и Consumer secret в соответствующие поля.

Нажмите Готово, идем дальше, затем — Подтвердить данные.

В открывшейся вкладке нажмите Разрешить.

Скопируйте URL из адресной строки браузера:

Вставьте полученный URL в соответствующее поле и нажмите Готово, идем дальше.

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

В панели управления сайтом перейдите в раздел:

Панель управления » Интернет-магазин » Настройки модуля

Активируйте опцию Включить uAPI для модуля и сохраните изменения.

Затем откройте:

Панель управления » Интернет-магазин » Способы оплаты, доставки, валюты и курсы

Нажмите Добавить способ доставки, укажите название (например, Boxberry) и сохраните.

Установите галочку у пункта Использовать модуль расчёта стоимости доставки и в выпадающем списке выберите Внешний калькулятор.

Нажмите Настройки модуля. В появившемся окне отметьте опцию Разрешить нулевую величину и сохраните настройки.

Откройте:

Панель управления » Интернет-магазин » Управление дизайном модуля

Откройте шаблон Страница служебных форм и после переменной $ORDER_FIELDS$ добавьте следующий код:

<?if($PAGE_ID$ == 'checkout')?>
<script src="https://points.boxberry.de/js/boxberry.js"></script>
<script src="https://ucoz.boxberry.ru/js/widget.js"></script>
<script type="text/javascript">
$(function () {
 bbCalculate($ORDER_WEIGHT$, $ORDER_TOTAL_RAW$, '$SERVER_NAME$', '$IP_ADDRESS$', $PAYMENT_ID$, $ORDER_NUM$);
})
</script>
<?endif?>

Теперь откройте:

Панель управления » Интернет-магазин » Управление полями заказа

Для корректной работы модуля необходимо создать следующие поля (названия могут быть произвольными):

• Контактный телефон
• Адрес доставки (адрес пункта выдачи)
• ФИО (имя покупателя)
• E-mail — обязательно, если активна услуга Извещение E-mail

Регистрация в модуле Boxberry

Перейдите по ссылке для регистрации в модуле:

https://ucoz.boxberry.ru/register

Укажите данные приложения (доступны по адресу http://uapi.ucoz.com/uapi_panel) в форме регистрации:

Настройки модуля

Настройки модуля доступны по адресу:

https://ucoz.boxberry.ru/settings

После регистрации или авторизации вы автоматически перейдёте на страницу настроек.

• В поле API токен Boxberry укажите токен, полученный в личном кабинете: перейти
• В поле Пункт приёма заказов выберите тот же пункт, что указан в личном кабинете: перейти
• Вес по умолчанию — вес товара в граммах, если не указан явно.
• Высота по умолчанию — высота товара в сантиметрах.
• Ширина по умолчанию — ширина товара в сантиметрах.
• Длина по умолчанию — длина товара в сантиметрах.

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

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

Выберите соответствующий способ доставки Boxberry (список подтягивается из настроек вашего магазина):

Укажите статус заказа, при котором он будет выгружаться в ЛК Boxberry:

Настройте соответствие полей (подтягиваются автоматически):

При необходимости задайте префикс к номеру заказа (максимум 6 символов). Используется при выгрузке:

Укажите способы оплаты с наложенным платежом (если есть):

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

Откройте интернет-магазин, добавьте товар в корзину и перейдите к оформлению заказа.

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

Если покупатель попытается оформить заказ без выбора пункта выдачи, отобразится соответствующее уведомление:

Выберите пункт выдачи:

Адрес выбранного пункта выдачи будет автоматически подставлен в поле Адрес доставки (если в настройках указана запись именно в это поле).

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

Нажмите Выбрать отделение, затем Оформить заказ:

Перейдите в админку сайта, чтобы просмотреть созданный заказ и изменить его статус:

Измените статус заказа на тот, который указан в настройках выгрузки (в примере — Доставляется):

Проверьте, появился ли заказ в личном кабинете Boxberry:

Если всё сделано верно — заказ успешно выгружен.

Настройки расчёта стоимости доставки

Перейдите в личный кабинет Boxberry на вкладку Расчёты:

https://account.boxberry.ru/client/infoblock/index?tab=api&api=settings

Для активации опций обязательно установите флажок Включить настройки расчёта.

Основные параметры:

• Укажите количество дней — добавляет указанное число дней к основному сроку доставки.
• Округление до — устанавливает шаг округления (например, до 10 руб.).
• Округлить как — выберите тип округления:
  • Математическое — до ближайшего целого. Пример: 124₽ → 120₽ (до десятков), 124.35₽ → 124₽ (до рублей).
  • В большую сторону — всегда вверх. Пример: 124₽ → 130₽, 124.35₽ → 125₽.

Стоимость посылок:

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

Надбавки:

Можно задать как положительные, так и отрицательные значения:

• Вес — добавляется/вычитается из расчётного веса (например, -300 или +1000 грамм).
• Процент от тарифа Boxberry — изменение итоговой стоимости доставки.
• Процент от объявленной стоимости — влияет на стоимость страховки.
• Процент от суммы к оплате — влияет на комиссию наложенного платежа.
• Фиксированная сумма — корректировка на фиксированную сумму.

Дополнительные опции:

• Минимальная стоимость доставки — не опускаться ниже заданного значения, даже при меньшем расчёте.
• Максимальная стоимость доставки — не превышать установленный максимум, даже при более высоком расчёте.