Виджет boxberry не работает

Установка и настройка модуля Boxberry для CMS WordPress

Модуль предназначен для CMS WordPress 4.9 и выше и плагина WooCommerce 3.5 и выше.

На хостинге должна быть установлена версия PHP не ниже версии 5.4. Рекомендуемая версия PHP 7.2 и выше.

Для установки и настройки обязательно проследуйте по шагам инструкции:

Установка модуля из маркетплейса WordPress

Зарегистрировать личный кабинет ЗДЕСЬ

Получить апи токен ЗДЕСЬ

В админке WordPress перейти в раздел Плагины нажать кнопку Добавить новый

В строке поиска справа ввести boxberry

Установить плагин Интеграция со службой доставки Boxberry, после установки нажать кнопку Активировать.

В разделе Плагины рекомендуем включить автоматическое обновление.

Затем перейдите к настройке

Установка модуля из архива

Зарегистрировать личный кабинет ЗДЕСЬ

Получить апи токен ЗДЕСЬ

Скачать модуль ЗДЕСЬ

В админке WordPress перейти в раздел Плагины нажать кнопку Добавить новый

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

Дождаться распаковки и установки и нажать кнопку Активировать плагин

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

В админке WordPress перейти в раздел Woocommerce → Настройки → Доставка

Если вы еще не добавляли зоны доставки — добавить зоны таким образом:

Для добавления способов доставки нужно перейти в настройки Зоны доставки

В настройке зоны доставки нажать кнопку Добавить метод доставки

Выбрать из списка необходимый способ доставки и нажать кнопку Добавить метод доставки

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

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

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

В поле API-token нужно указать ваш api token из ЛК ОТСЮДА

В полях Url для API и Url для виджета уже указаны необходимые адреса. В этих полях ничего не нужно менять!

В поле Вес по умолчанию указывается средний вес одной штуки вашего товара. Данный вес будет использоваться модулем при расчете и выгрузке заказа в ЛК Boxberry, в случае если вес в карточке товара не указан либо равен нулю. По умолчанию здесь указано значение 500 грамм.

В поле Минимальный вес указывается минимальный вес товара для работы службы доставки. Если вес товара строго меньше указанного, то доставка Boxberry не будет отображаться на странице оформления заказа (задается в граммах).

В поле Максимальный вес указывается максимальный вес товара для работы службы доставки. Если вес товара строго больше указанного, то доставка Boxberry не будет отображаться на странице оформления заказа (задается в граммах).

В поле Максимальная высота указывается максимальная высота товара для работы службы доставки. Если высота товара строго больше указанного, то доставка Boxberry не будет отображаться на странице оформления заказа (задается в сантиметрах).

В поле Максимальная глубина указывается максимальная глубина товара для работы службы доставки. Если глубина товара строго больше указанного, то доставка Boxberry не будет отображаться на странице оформления заказа (задается в сантиметрах).

В поле Максимальная ширина указывается максимальная ширина товара для работы службы доставки. Если ширина товара строго больше указанного, то доставка Boxberry не будет отображаться на странице оформления заказа (задается в сантиметрах).

Опция Отключить настройки расчёта для данного вида доставки позволяет отключать применение настроек из ЛК ОТСЮДА с вкладки Расчеты. По умолчанию передача настроек активна, если ее нужно выключить переключите опцию в положение Да

Опция Формировать акт автоматически после выгрузки заказа в ЛК Boxberry позволяет формировать акт автоматически, после того как вы произведете выгрузку заказа в ЛК. Если опция активна в заказе дополнительно отобразится ссылка на сформированный акт и ссылка на отслеживание заказа на сайте Boxberry. Опция по умолчанию выключена. Для ее активации переключите опцию в положение Да.

Опция Отображать кнопку открытия виджета (иначе, отображается ссылка) позволяет отображать кнопку для открытия виджета вместо ссылки. Опция по умолчанию выключена. Для ее активации переключите опцию в положение Да. Пример как это выглядит:

Настройки способов курьерской доставки такие же, за исключением отсутствия поля Url для виджета и опции Отображать кнопку открытия виджета (иначе, отображается ссылка) т.к. в случае с курьерской доставкой они не требуются.

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

Добавляем товар в корзину, переходим в оформление заказа, заполняем обязательные поля, выберем для примера доставку до ПВЗ:

При выборе способа доставки до ПВЗ отображается кнопка открытия виджета т.к. эту опцию мы активировали в настройке способа доставки.

Выберем пункт выдачи на карте и нажмем Выбрать отделение

Адрес выбранного ПВЗ отображается в кнопке выбора ПВЗ и в поле Адрес

Если покупатель нажмет кнопку Подтвердить заказ не выбрав ПВЗ отобразится уведомление о необходимости выбрать ПВЗ, продолжить оформление заказа без выбора ПВЗ нельзя

Выгрузка заказа в ЛК Boxberry

Например, мы хотим выгружать заказы в ЛК и сразу формировать акты из админки WordPress.

Перейдем в админку и активируем в нашем способе доставки до ПВЗ опцию автоматического формирования актов

Далее перейдем в наш оформленный заказ.

В блоке с доставкой для выгрузки заказа в ЛК нужно нажать кнопку Отправить заказ в систему. Т.к. мы включили автоматическое формирование актов, нам также вернется ссылка на акт и на отслеживание заказа на сайте

Проверяем блок доставки после выгрузки заказа в ЛК Boxberry

Выгрузка прошла успешно, все нужные данные вернулись корректно.

После формирования акта статус заказа на сайте выглядит так

Ориентировочно через 30-60 минут данные по заказу загрузятся в систему и будут отображаться полностью.

Если при выгрузке заказа возникает ошибка, обратитесь в техподдержку. В заявке добавьте текст и/или скриншот ошибки.

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

Источник

Установка и настройка модуля для CMS 1C-Битрикс (Bitrix)

Корректная работа модуля гарантируется только для стандартного пошагового шаблона оформления заказа (sale.order.ajax)

Рекомендуемая версия Битрикса не ниже 17. Для корректной работы модуля на сервере должен быть активен модуль curl и директива allow_url_fopen.

Для установки и настройки обязательно проследуйте по шагам инструкции:

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

Зарегистрировать личный кабинет ЗДЕСЬ

Получить апи токен ЗДЕСЬ

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

На вкладке Администрирование перейти к разделу Marketplace

В разделе Marketplace выбрать подраздел Каталог решений, в строке поиска набрать
Boxberry и в блоке нашего модуля нажать ссылку Установить

Откроется страница с установкой, нажать кнопку Загрузить, затем кнопку Установить

При успешной установке отобразится уведомление Решение «Калькулятор доставки Boxberry» успешно установлено.

При возникновении ошибки при установке, создайте заявку на портале техподдержки с описанием ошибки.

Установка модуля из архива

Зарегистрировать личный кабинет ЗДЕСЬ

Получить апи токен ЗДЕСЬ

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

Проверить кодировку вашей установки Bitrix, нажать на клавиатуре Ctrl + U

В открывшейся вкладке вы увидите кодировку, она может быть windows-1251, либо UTF-8

Скачать архив соответствующий вашей кодировке:

В админке перейти в раздел Контент → Файлы и папки, в строке Путь указать такой адрес /bitrix/modules перейти по этому адресу и нажать кнопку Загрузить файл

В открывшемся окне выбрать скачанный ранее файл с модулем и нажать Сохранить

Вас вернет в папку /bitrix/modules найдите только что загруженный файл и выберите Распаковать

После успешной распаковки в текущей папке появится папка up.boxberrydelivery

В разделе Marketplace выбрать подраздел Установленные решения и произвести установку таким образом

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

В админке перейти в раздел Настройки → Настройки продукта → Настройки модулей → Калькулятор доставки Boxberry

Откроется страница настроек с основной вкладкой Общие настройки

В поле Ваш API Token укажите API токен ОТСЮДА

В поле API URL уже указан адрес для апи запросов. В этом поле ничего не нужно менять!

В поле URL виджета Boxberry уже указан адрес скрипта виджета. В этом поле ничего не нужно менять!

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

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

Опция Выгружать заказы в ЛК Boxberry автоматически, после оформления на сайте позволяет выгружать заказы в ЛК автоматически, сразу после оформления на вашем сайте.

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

Опция Хранить этикетки локально в папке /bitrix/pdf позволяет хранить этикетки в папке /bitrix/pdf/ после выгрузки заказа в ЛК Boxberry, если опция неактивна, будут сохранятся только ссылки на этикетки. Пример:

В поле ID элемента для ссылки «Выбрать пункт выдачи» указывается DIV id только в том случае, если вам нужно отображать ссылку открытия виджета в другом блоке. По умолчанию в этом поле ничего не нужно указывать!

Опция Отображать кнопку открытия виджета (иначе, отображается ссылка) позволяет включить отображение кнопки открытия виджета на странице оформления заказа

В поле Вес товара для расчёта стоимости доставки (если вес для товара не указан) г. указывается средний вес одной штуки вашего товара. Данный вес будет использоваться модулем при расчете и выгрузке заказа в ЛК Boxberry, в случае если вес в карточке товара не указан либо равен нулю. Модуль проверяет вес только из торгового каталога!

Опция Отключить настройки расчёта для КД позволяет отключить применение настроек из ЛК отсюда для способов доставки курьером.

Опция Включить логирование запросов к АПИ позволяет получить лог апи запросов для отладки. После включения опции файл с логом под именем boxberrydelivery.log будет находится здесь /bitrix/cache/log/

Опция Добавлять трек номер в отгрузку после выгрузки заказа в ЛК Boxberry добавляет трек номер в отгрузку заказа в поле «Идентификатор отправления» после выгрузки заказа в ЛК.

Далее переходим на вкладку Поля интеграции

Здесь указаны соответствия свойств в Битриксе с параметрами модуля, а также соответствия id плательщиков.

Как это проверить:

id плательщиков в Битриксе находятся в разделе Магазин → Настройки → Типы плательщиков

Здесь мы видим, что у нас активно два плательщика, физлицо с id 1 и юрлицо с id 2. У физлица есть 7 свойств, просмотреть которые мы можем, если кликнем на количество

Откроется страница свойств плательщика с id 1.

В столбце Тип плательщика в квадратных скобках указан id, в столбце Код указаны те самые коды, которые соответствуют кодам в настройке нашего модуля

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

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

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

Добавим товар в корзину и перейдем в оформление заказа.

В блоке Доставка выберем, например, способ доставки до пункта выдачи с оплатой при получении

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

Пункт выдачи выбран, его адрес записан в поле Адрес доставки

Выгрузка заказа в ЛК Boxberry вручную

Перейти в раздел Магазин → Выгрузка в Boxberry

Здесь отображаются заказы оформленные с профилями доставки Boxberry

Для выгрузки заказа нужно выбрать конкретный заказ и нажать кнопку Выгрузить в Boxberry

Для массовой выгрузки нужно выделить все заказы, в действиях выбрать Выгрузить в Boxberry

При успешной выгрузке ЛК вернет трек номер заказа и ссылку на файл этикетки. При активной опции Формировать акт автоматически после выгрузки заказа в ЛК Boxberry также отобразится ссылка на акт и отслеживание заказа на сайте Boxberry.

При возникновении ошибки ЛК вернет текст ошибки. Для отладки и исправления ошибки создайте заявку на портале техподдержки с описанием и скриншотами.

Формирование актов вручную

В версии модуля 2.2.16 доступно добавление нескольких заказов в один акт при ручном формировании акта. Все выбранные заказы должны быть выгружены в ЛК Boxberry перед формированием акта!

Переходим на страницу Магазин → Выгрузка в Boxberry

Выбираем нужные заказы, выгружаем их в ЛК, если они еще не выгружены

После выгрузки формируем акт по этим заказам

Отобразится сообщение об успешном формировании акта, по заказам отобразятся новые данные

При этом оба заказа добавлены в один акт

По обоим заказам также доступны все этикетки.

Создание заявки на курьерский забор заказов

В версии модуля 2.2.13 доступно оформление заявки на курьерский забор заказов. Курьер Boxberry заберет заказы с вашего склада. Подробнее об услуге вы можете найти здесь https://boxberry.ru/e-commerce/dokumenty/dokumenty-i-tarify

Создать заявку вы можете на странице выгрузки заказов

При успешном создании заявки вернется ее номер. При возникновении ошибки создайте заявку на портале техподдержки с описанием и скриншотами.

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

Выбор пункта выдачи в админке может потребоваться, если:

• менеджер оформил заказ в админке самостоятельно, для выгрузки заказа с доставкой до пункта выдачи требуется его выбрать;
• покупателю необходимо сменить пункт выдачи в заказе;
• покупатель оформил быстрый заказ, менеджеру нужно выбрать пункт выдачи для выгрузки заказа в ЛК;

Для настройки выбора пункта выдачи нужно перейти в раздел Магазин → Выгрузка в Boxberry и произвести такую настройку

Теперь на странице выгрузки появится столбец с именем Пункт самовывоза

У заказов, которые еще не выгружены в ЛК, теперь отображается код выбранного пункта выдачи, либо текст Выбрать ПВЗ на карте

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

Настройки расчета в ЛК

В ЛК ЗДЕСЬ на вкладке Расчеты доступны настройки срока доставки, округления расчета стоимости, надбавки и различные настройки условий бесплатной доставки

Опция Укажите количество дней, которое необходимо добавить к основному сроку доставки Boxberry добавит указанное количество дней к сроку доставки при расчете стоимости на сайте и в виджете

Настройки Округление до позволяют округлять расчет стоимости на сайте и в виджете

Настройки Округлить как позволяют настроить два типа округления:

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

Блок Стоимость посылок, позволяет настроить бесплатную стоимость доставки от определенной суммы заказа, либо полностью бесплатную стоимость доставки. Например, при таком условии стоимость доставки будет бесплатная для заказов свыше 7000р, и будет рассчитана по тарифу для заказов дешевле 7000р

Блок Надбавки позволяет настроить надбавки ко многим параметрам.

Надбавка Вес – добавляет\убавляет вес, переданный для расчета на сайте

Надбавка Процент от тарифа Boxberry – добавляет\убавляет процент от итоговой стоимости доставки

Надбавка Процент от объявленной стоимости – добавляет\убавляет процент от стоимости услуги страховки

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

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

Опции:

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

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

Источник