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

Метод служит только для расчета стоимости доставки и не осуществляет проверку. В случае передачи, например:
  • почтового индекса/города по которому не осуществляется КД
  • кода пункта выдачи не осуществляющего выдачу посылок
  • кода пункта выдачи не существующего в Boxberry
  • веса и габаритов превышающих допустимые

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

Возможность Курьерской доставки определяется по почтовому индексу получателя, поэтому для РФ необходимо проверять индекс методами API ListZips или ZipCheck.
Для расчёта КД в зарубежные страны рекомендуем использовать метод DeliveryCalculation

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
methodstringНазвание методаDeliveryCosts
weightintegerВес посылки в граммах1500
targetstart
string

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

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

010
target
string

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

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

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

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

620100
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

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

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

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

  • Услуга Полный возврат после выкупа не учитывается в расчете.
  • Услуга Дополнительное E-Mail-Извещение не учитывается в расчете.
  • Услуга Голосовое извещение дополнительное не учитывается в расчете.
77
delivery_periodintegerСрок доставки в рабочих днях с учетом варианта выдачи (получение посылки на ПВЗ или КД).
Если параметр sucrh не указан или равен нулю, то отдает значение с типом string.
Если параметр sucrh равен 1, то отдает значение с типом integer.
1

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

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

Не нашли ответ?
Обратитесь к нам на портал Service Desk
Краткую справку по нему можно найти в этой статье.

  • No labels