Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

Позволяет получить стоимость доставки заказа до ПВЗ с учётом стоимости постоянных услуг, предусмотренных Вашим договором, возможен расчет с учетом курьерской доставки.
Возможность Курьерской доставки определяется по почтовому индексу получателя. Предварительно необходимо проверить индекс методами API ListZips или ZipCheck.

Внимание! Метод служит только для расчета стоимости доставки и не осуществляет проверку. В случае передачи, например:

  • почтового индекса по которому не осуществляется КД,
  • кода пункта выдачи не осуществляющего выдачу посылок,
  • кода пункта выдачи не существующего в Boxberry,
  • другое,

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

GET-запросы:
Тип доставки: Склад-Склад https://api.boxberry.ru/json.php?token=d6f33e419c16131e5325cbd84d5d6000&method=DeliveryCosts&weight=500&targetstart=010&target=010&ordersum=0&deliverysum=0&height=120&width=80&depth=50&paysum=100
Тип доставки: Склад-КД https://api.boxberry.ru/json.php?token=d6f33e419c16131e5325cbd84d5d6000&method=DeliveryCosts&weight=500&targetstart=010&ordersum=0&deliverysum=0&paysum=100&height=120&width=80&depth=50&zip=624000 

Входящие параметры:

Параметр

Обяз.

Тип

Описание

Пример

tokenstringТокен для доступа к api-сервисамd6f33e419c16131e5325cbd84d5d6000
weightintegerВес посылки в граммах1500
targetstart
string

Код пункта приема заказа

Метод PointsForParcels -
позволяет получить перечень
пунктов приёма посылок
Boxberry.
* Если не передан, используется пункт приема по умолчанию из настроек пользователя «Мой
профиль» - «Доступы»,
* Если в настройках пользователя не установлен пункт приема по умолчанию, то берется из настроек магазина «Мой профиль» - «Информация о магазине» - «Пункт приема для отправлений»

010
targetstring

Код пункта выдачи заказа

Метод ListPoints -
позволяет получить перечень
пунктов выдачи заказов.

19733
ordersum
floatОбъявленная стоимость посылки (страховая стоимость)2000
deliverysum
floatЗаявленная стоимость доставки100
paysum
floatСумма к оплате с получателя2000
height
stringВысота коробки, см15
width
stringШирина коробки, см18
depth
stringГлубина коробки, см10
zip
string

Почтовый индекс для курьерской доставки (в случае передачи zip - target игнорируется).

Методы ListZips или ZipCheck позволяют получить список почтовых индексов, для которых возможна курьерская доставка.

-
sucrh
string

Расчет с учетом настроек установленных в ЛК ИМ:

"Настройки средств интеграции - Расчеты - Включить настройки расчета".

Возможные значения:

1 - получить расчет с учетом индивидуальных настроек

0 - получить расчет без настроек

0
cms  

string

название CMS. Параметр предназначен для разработчиков CMS, проводящих интеграцию с Boxberry. Применяется только в JSON.

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

bitrix

wordpress

cscart

url
stringurl сайта. Параметр предназначен для разработчиков CMS, проводящих интеграцию с Boxberry. Применяется только в JSON.site.com
version
stringверсия интеграции/модуля2.2

Данные ответа:

Параметр

Тип

Описание

Пример

pricefloatИтоговая стоимость доставки (равна price_base + price_service)224
price_basefloatСтоимость базового тарифа147
price_servicefloat

Стоимость обязательных и дополнительных услуг (опции заказа),
выбранных при заключении договора, таких как:

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

Проверить список активных дополнительных услуг можно в ЛК ИМ в разделе «Услуги».

77
delivery_periodintegerСрок доставки в рабочих днях с учетом варианта выдачи (получение посылки на ПВЗ или КД).
Если параметр sucrh не указан или равен нулю, то отдает значение с типом string.
Если параметр sucrh равен 1, то отдает значение с типом integer.
1

DeliveryCosts. Справочник ошибок

Текст ошибкиОписание ошибки
1"Необходимо указать Отделение получения или Почтовый индекс"Параметры target и zip одновременно отсутствуют, пустые или =0
2"Необходимо указать вес отправления"Параметр weight отсутствует, пусто или = 0
3"Некорректный почтовый индекс"Параметр zip не состоит из 6 цифр И не равен 0
4"Необходимо указать Отделение отправления"Параметр targetstart не передан/пусто или = 0.
И
В ЛК в разделе «Мой профиль» - «Доступы» у пользователя, с токеном которого выполняется запрос, не установлен пункт приема.
И
В ЛК в разделе «Мой профиль» - «Информация о магазине» не установлен пункт приема для отправлений.


  • No labels