Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Описание алгоритма работы виджета. Формат передаваемых и
получаемых параметров виджета.
На Вашем сайте или приложении в нужном Вам месте устанавливается дополнительная «кнопка», например, «Доставка Boxberry», при выборе которой Ваш пользователь попадает на специально разработанный интерфейс по выбору удобной для него точки доставки. Выбор может осуществляться по карте города или по выпадающему списку городов, а также по списку станций метро. Пример размещения можно увидеть по ссылке: http://points.boxberry.ru/demo/ Информация о выбранном пункте выдачи возвращается в виде объекта result с параметрами:

ПараметрЗначение
IdКод ПВЗ в базе Boxberry
NameНазвание ПВЗ 
AddressАдрес ПВЗ
WorkscheduleГрафик работы ПВЗ 
PhoneТелефон ПВЗ
PeriodПериод доставки до ПВЗ (параметр доступен только при передаче ключа
интеграции)
PriceСтоимость доставки до ПВЗ (параметр доступен только при передаче
ключа интеграции) 
PrepaidПризнак работы отделения только по предоплате (возможные значения 1|0,
где «1» - отделение работает только с предоплаченными посылками, «0» -
отделение работает с любым типом посылок). Необходимо для
дополнительного информирования клиента на вашем сайте, в случае, если
это необходимо. 


При инициализации виджета возможны следующие входные параметры:

ПараметрНазначениеПримечание
callback_functioncallback-функция, которая будет принимать объект с
выбранным ПВЗ 
Обязательный параметр
api_token (в
шифрованом формате)
Ключ интеграции виджета. Необходим для
использования функций калькулятора доставки, а
также использования фильтрации отображения ПВЗ
на карте. 
Можно получить в
Личном Кабинете в
разделе «Настройка
виджетов»
custom_cityГород инициализации карты (например, Москва)Передается название
города строкой
target_startКод пункта приема посылок Используется для
калькулятора доставки
ordersumОбъявленная стоимость посылки Используется для
калькулятора доставки
weightВес посылки в граммах, обязательно должен быть >
Обязательный параметр.
Используется для
калькулятора доставки
paysumСумма к оплате покупателем (оплата при получении) Используется для
калькулятора доставки 
heightВысота коробки Используется для
калькулятора доставки 
widthШирина коробки Используется для
калькулятора доставки 
depthГлубина коробкиИспользуется для
калькулятора доставки 


Последовательность аргументов инициализации виджета:
boxberry.open(‘callback_function’,‘api_token’,‘custom_city’,’target_start’,’ordersum’,’weight’,’paysum’,’height’,’width’,’depth’);

...

  1. Необходимо подключить следующий скрипт: http://points.boxberry.de/js/boxberry.js Для сайтов, работающих по https протоколу, необходимо подключить следующий скрипт: https://points.boxberry.de/js/boxberry.js
  2. Затем в нужном месте на сайте магазина Вам необходимо поставить ссылку: Выбрать ПВЗ, по событию «onclick» которой должна вызываться функция «boxberry.open» из подключенного ранее файла. В эту функцию обязательно должен передаться параметр «callback_function», который и будет принимать массив с выбранным ПВЗ. 
  3. «callback_function» - это название javascript – функции, которая должна быть прописана на странице оформления заказа. Её имя может быть любым, главное, чтобы она была передана в качестве параметра в «boxberry.open». 
  4. При нажатии на кнопку "Выбрать отделение" на сайте вызывается функция «callback_function», куда в качестве параметра передается объект с ключами, описанными в таблице 2. Формат данных в возвращенном объекте — строки. 
  5. Для работы в режиме ИнфоВиджета – без кнопки «Выбрать отделение», необходимо вызывать виджет без передачи в функцию boxberry.open каких-либо параметров. То есть строка инициализации виджета будет выглядеть примерно так: Выбрать пункт выдачи на карте 
  6. Если Вы хотите задать высоту отступа окна виджета относительно верхней части экрана самостоятельно, то используйте метод boxberry.displaySettings(). Например, boxberry.displaySettings({top:10}), где 10 - размер в пикселях. 
  7. Для фильтрации отображения ПВЗ с ограничением по максимальному весу существует возможность передавать вес массивом в граммах. Если вес передан числом, то фильтрации ПВЗ не происходит.

...