Подключение Shop-Script к сервису доставки Boxberry

Для подключения Shop-Script к сервису «Боксберри» (Boxberry) используется плагин, который нужно установить с помощью приложения «Инсталлер».

Рекомендуется использовать с Shop-Script не ниже версии 8.5.0. С предыдущими версиями Shop-Script работа плагина не проверялась.
Полезно: часто задаваемые вопросы и ответы для пользователей сервиса «Боксберри».

1. Зарегистрируйтесь в сервисе доставки

Зарегистрируйтесь на сайте «Боксберри». Заполните малую форму регистрации: имя, адрес электронной почты и номер телефона. Дождитесь email-уведомления с API-токеном для входа в личный кабинет.

Войдите в личный кабинет и перейдите в раздел «Мой профиль → Информация о магазине». Заполните и сохраните информацию о своей компании.

На вкладке «Услуги» выберите тарифы на выдачу посылок и оповещение. Они будут использоваться для создания черновиков отправлений в личном кабинете на сайте «Боксберри». Эти значения будут применены на следующий день после сохранения.

Значения, выбранные на вкладке «Услуги», влияют только на предварительное заполнение формы создания отправления в личном кабинете на сайте «Боксберри». На расчёт стоимости доставки в интернет-магазине они не влияют, но выбранные дополнительные услуги будут по умолчанию выбраны в отправлениях, который автоматически создаются на основе заказов в Shop-Script.

Сохраните настройки услуг.

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

Откройте раздел «Инфоцентр → Интеграция → Методы API».

Cкопируйте значение API токен.

2. Установите плагин

В бекенде Вебасиста перейдите в приложение «Инсталлер». С помощью функции поиска найдите плагин Boxberry.

Откройте страницу с информацией о плагине и щёлкните по кнопке «Установить».

3. Добавьте способ доставки для Shop-Script

Перейдите в бекенд Shop-Script, откройте раздел «Настройки → Доставка». В меню «Добавить способ доставки» выберите установленный плагин Boxberry.

Выключите флажок «Включен». Это нужно для того, чтобы не полностью настроенный способ доставки не был преждевременно доступен покупателям на витрине интернет-магазина. Это флажок нужно будет включить после окончания настройки, как описано ниже.

В поле «Ключ» вставьте токен, скопированный в аккаунте «Боксберри». Это нужно для того, чтобы позже можно было выбрать город и пункт приёма посылок.

Сохраните настройки способа доставки.

С помощью ссылки «Конфигурация» снова откройте настройки способа доставки.

Заполните и отредактируйте значения настроек:

  • Включен. Включите этот флажок, для того чтобы настроенный способ доставки стал доступен покупателям на витрине интернет-магазина.
  • Название способа доставки. Оно видно покупателям во время оформления заказа.
  • URL логотипа. Он виден покупателям во время оформления заказа.
  • Облагается налогом. Если необходимо, выберите правило расчёта налогов, настроенное в разделе «Настройки → Налоги». Налоговое правило будет применяться только для покупателей из тех регионов, для которых настроено выбранное здесь налоговое правило.
  • Дополнительное время на комплектацию. Введите количество времени в часах, которое необходимо сотрудникам пункта выдачи заказов, чтобы подготовить заказ к выдаче покупателю. Это время будет учитываться для показа информации о времени готовности заказа при оформлении заказа в корзине. Если нужно настроить получение заказа на следующий день, сохраните в этом поле значение 24 (часа).
  • Описание. Оно видно покупателям во время оформления заказа.
  • Предлагать доставку типам покупателей. Выберите тип покупателей, которым должен быть доступен этот способ доставки: только персонам (физическим лицам), только компаниям (юридическим лицам) или всем покупателям.
  • Основные настройки
    • Название службы. Введите дополнительное название службы доставки, которое будет видно покупателям только при использовании оформления заказа в корзине в Shop-Script.
    • Адрес API. Если нужно переключить плагин Boxberry в тестовый режим, запросите тестовый адрес API и токен у службы поддержки «Боксберри».
    • Город приема посылок. Начните писать название города, в котором нужно выбрать пункт приёма посылок. Выберите свой или ближайший к вам город.
    • Пункт приема посылок. Выберите удобный пункт приёма посылок «Боксберри» для выбранного города. Вы будете отвозить свои заказы в этот пункт, а Shop-Script будет показывать покупателям стоимость доставки заказов через «Боксберри» от выбранного пункта приёма посылок.
    • Длина, ширина, высота по умолчанию. Сохраните стандартные значения или измените их. Эти значения используются для расчёта стоимости доставки, если габариты заказа не были рассчитаны специальным плагином. Если оставить эти поля пустыми, то сроки и стоимость доставки не будут рассчитаны во время оформления заказа.
  • Условия доступности
    • Страна. Доставка через «Боксберри» с использованием плагина доступна только для покупателей из Российской Федерации.
    • Регион, населённый пункт. Укажите регион и населённые пункты, для жителей которых должен быть доступен способ доставки с использованием сервиса «Боксберри». Если доставка должна быть доступна всем покупателям, не выбирайте регион и не указывайте названия населённых пунктов.
    • Максимальный вес, длина, ширина, высота, размеры. Укажите значения, при превышении которых способ доставки через «Боксберри» не будет доступен покупателям при оформлении заказа. Размеры заказа должны рассчитываться специальным плагином, если он установлен. Если плагина нет, будут использоваться размеры заказа по умолчанию, сохранённые в настройках этого способа доставки.
  • Стоимость доставки
    • Минимальная стоимость заказа для бесплатной доставки. Укажите стоимость заказа в рублях, начиная с которой покупателям будет предлагаться бесплатная доставка через «Боксберри».
    • Объявленная стоимость посылки (страховая стоимость). Укажите фиксированную стоимость в рублях или долю от суммы заказа в процентах, либо сумму или разность этих значений. Оценочная стоимость выплачивается магазину, если служба доставки потеряет или повредит груз. В случае оплаты заказа при получении в службу доставки передается объявленная стоимость отправления, равная стоимости заказа за вычетом стоимости доставки, т. е. стоимость товаров с учетом скидки.
  • Варианты доставки
    • Пункты выдачи заказов и Курьерская доставка. Выберите значения в соответствии с условиями своего договора. Если выбран вариант «Только предоплата», то в приложении Shop-Script в режиме «Оформление заказа в корзине» после выбора варианта доставки будут доступны только варианты предоплаты. Если выбран вариант «Все», то в приложении Shop-Script в режиме «Оформление заказа в корзине» по умолчанию будет показана минимальная стоимость доставки с расчетом на предоплату, а после выбора вариантов доставки и оплаты стоимость доставки будет уточнена.
    • Название курьера. Если нужно, отредактируйте стандартное название варианта доставки курьером, которое будут видеть покупатели.
  • Настройки интеграции
    • Вид выдачи посылок. Если ничего не выбрано, то используется значение по умолчанию, установленное в разделе «Услуги» профиля магазина в вашем личном кабинете на сайте «Боксберри».
    • Наименование магазина для SMS- и email-оповещений. Эти оповещения будет отправлять покупателям сервис «Боксберри», чтобы уведомить их о статусе доставки заказа.

Сохраните настройки способа доставки.

Готово!

Ваш магазин подключён к сервису «Боксберри». Теперь покупатели могут выбрать новые способы доставки при оформлении заказа на витрине интернет-магазина: курьером и самовывозом.

Дополнительные возможности

Автоматическое обновление черновика отправления

После оформления заказа в вашем личном кабинете на сайте «Боксберри» создается посылка — черновик отгрузки. Каждый раз, когда вы редактируете заказ в бекенде Shop-Script, информация в этом черновике автоматически обновляется.

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

Использование округления и наценок

В личном кабинете на сайте «Боксберри» можно настроить округление и надбавки для расчёта стоимости разных вариантов доставки. Для этого перейдите в раздел «Инфоцентр → Интеграция → Настройка виджетов → Расчеты».

Активируйте флажок «Включить настройки расчета».

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

Как добавить информацию о пункте выдачи заказа в уведомление для покупателя

В шаблон email- или SMS-уведомления о заказе, которое отправляет Shop-Script, можно добавить информацию о пункте выдачи заказа:

{if !empty($shipping_plugin) && $shipping_plugin instanceof boxberryShipping}
  {$point_data = $shipping_plugin->getPointInfo($order)}
  {if !empty($point_data)}
     {* Напишите код с использованием значений, которые присылает сервис "Боксберри". *}
  {/if}
{/if}

Вместо комментария, заключённого в скобки {* *}, напишите код Smarty, который добавит в текст уведомления информацию о пункте выдачи заказа. В этом коде удобно использовать элементы ассоциативного массива $point_data со следующими ключами:

  • name — наименование пункта выдачи
  • phone — номер телефона
  • address — адрес
  • max_volume — ограничение на максимальный допустимый объём посылки
  • max_weight — ограничение на максимальный допустимый вес посылки
  • only_prepaid_orders — выдаёт ли пункт выдачи только предоплаченные заказы
  • schedule — расписание работы
  • delivery_period — срок доставки заказа из Москвы
  • metro — ближайшая станция метро
  • courier_delivery — доступна ли курьерская доставка заказов от пункта выдачи
  • acquiring — возможна ли оплата заказов банковскими картами
Пример кода
{if !empty($shipping_plugin) && $shipping_plugin instanceof boxberryShipping}
    {$point_data = $shipping_plugin->getPointInfo($order)}
    {if !empty($point_data)}

        {* начало вашего кода *}
        {if $point_data.acquiring}
            В пункте выдачи заказ можно оплатить банковской картой.
        {/if}
        {* конец вашего кода *}

    {/if}
{/if}

Как рассчитывается срок доставки заказа в пункты выдачи

Плагин рассчитывает срок доставки заказа в пункт выдачи в соответствии с расписанием работы магазина и значением в поле «Дополнительное время на комплектацию». Полученная дата корректируется, если она не является рабочим днём пункта выдачи, — вы этом случае дата выдачи заказа отодвигается на ближайший рабочий день, информацию о котором плагин получил от API сервиса доставки.

Не совпадают стоимость доставки при оформлении заказа и результат расчёта калькулятора в личном кабинете

Чтобы проверить расчёт стоимости доставки плагином, можно использовать калькулятор в личном кабинете на сайте «Боксберри».

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

Почему так происходит

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

Когда плагин получает стоимость доставки для заказа через API «Боксберри», при вычислении этой стоимости может применяться стоимость стандартных дополнительных услуг. Уточнить набор стандартных услуг для вашего договора можно через службу поддержки «Боксберри».

20 комментариев

  • +1
    Роман Роман 3 сентября 2019 10:05 #

    а для СДЕКа такое будет?

  • +2
    Михаил Михаил 9 сентября 2019 13:47 #

    Не работает!

    Указал тестовому товару ширину, высоту, длину, вес (weight).

    Инструкцию выполнил. Даже удалил все другие способы доставки.

    Ошибка:

    "Для указанного вами местоположения нет доступных вариантов доставки.
    Проверьте значения в полях местоположения или свяжитесь с нами."

  • +1
    Yeoja.Market Yeoja.Market 9 сентября 2019 18:42 #

    такой город boxberry не выдает, туда даже пвз boxberry не дает, только сдэк

    и советую купить плагин автозаполнение города, так покупатель никогда не заполнит поля регион город

  • +2
    АгроЭлита АгроЭлита 20 сентября 2019 15:24 #

    Вроде работает.

    Пожелания:

    1. Возможность выбора нескольких вариантов городов при курьерской доставке. Например курьер только по Москва, СПБ и Казань.

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

    Очень Важны статусы "доставлен в ПВЗ", "Вручен", остальные на усмотрение.

    • +1
      Михаил Ушенин Михаил Ушенин Webasyst 20 сентября 2019 17:35 #

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

    • +1
      Михаил Ушенин Михаил Ушенин Webasyst 20 сентября 2019 17:40 #

      Возможность выбора нескольких вариантов городов при курьерской доставке. Например курьер только по Москва, СПБ и Казань.

      В настройках плагина можно выбрать регионы и населённые пункты, для жителей которых должен быть доступен способ доставки. Вам эта настройка не помогает добиться нужного результата?

    • +1
      Iron_bone Iron_bone Партнер-разработчик 25 сентября 2019 12:54 #

      Добрый день!

      После включения плагина на шаге выбора доставок становится вообще пусто, хотя есть и другие способы помимо этого.

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

    • +1
      Андрей Миронов Андрей Миронов 26 сентября 2019 15:00 #

      Добрый день. 

      Все настроили как в инструкции.

      При выборе города, выдает цену и требует обязательного заполнения региона. 

      При выборе региона перестает работать.

      В чем может быть проблема? 

    • +4
      Роман Роман 24 октября 2019 13:34 #

      А как добавить карту на "Пошаговое оформление заказа"?

    • +1
      Сергей Сергей 28 ноября 2019 21:04 #

      Нужна карта ПВЗ на пошаговом оформлении заказа. 

      • +1
        Михаил Ушенин Михаил Ушенин Webasyst 29 ноября 2019 09:06 #

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

      • +1
        Сергей Сергей 14 декабря 2019 17:26 #

        Подскажите как в уведомление подставить трек -номер отправления.

        • +1
          Михаил Ушенин Михаил Ушенин Webasyst 17 декабря 2019 15:36 #

          Попробуйте использовать стандартный шаблон уведомления для действия «Заказ отправлен». В нём есть код для отправки идентификатора отправления. У вас он не работает?

          Добавить комментарий

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