Позволяет получить стоимость доставки заказа до ПВЗ с учётом стоимости постоянных услуг, предусмотренных Вашим договором, возможен расчет с учетом курьерской доставки.
- почтового индекса/города по которому не осуществляется КД
- кода пункта выдачи не осуществляющего выдачу посылок
- кода пункта выдачи не существующего в 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
Входящие параметры:
Параметр | Обяз. | Тип | Описание | Пример |
|---|---|---|---|---|
| token | ● | string | Токен для доступа к api-сервисам | d6f33e419c16131e5325cbd84d5d6000 |
| method | ● | string | Название метода | DeliveryCosts |
| weight | ● | integer | Вес посылки в граммах | 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 | Расчет с учетом настроек установленных в ЛК ИМ: Настройки средств интеграции - Расчеты - "Включить настройки расчета". Возможные значения: | 0 | |
| cms | string | название CMS. Параметр предназначен для разработчиков CMS, проводящих интеграцию с Boxberry. Применяется только в JSON. *для учета данного параметра в статистике также должен быть передан параметр url | bitrix wordpress cscart | |
| url | string | url сайта. Параметр предназначен для разработчиков CMS, проводящих интеграцию с Boxberry. Применяется только в JSON. | site.com | |
| version | string | версия интеграции/модуля | 2.2 |
Данные ответа:
Параметр | Тип | Описание | Пример |
|---|---|---|---|
| price | float | Итоговая стоимость доставки (равна price_base + price_service) | 224 |
| price_base | float | Стоимость базового тарифа | 147 |
| price_service | float | Стоимость обязательных и дополнительных услуг (опции заказа),
Проверить список активных дополнительных услуг можно в ЛК ИМ в разделе «Услуги».
| 77 |
| delivery_period | integer | Срок доставки в рабочих днях с учетом варианта выдачи (получение посылки на ПВЗ или КД). Если параметр sucrh не указан или равен нулю, то отдает значение с типом string. Если параметр sucrh равен 1, то отдает значение с типом integer. | 1 |
DeliveryCosts. Справочник ошибок
| № | Текст ошибки | Описание ошибки |
|---|---|---|
| 1 | "Необходимо указать Отделение получения или Почтовый индекс" | Параметры target и zip одновременно отсутствуют, пустые или =0 |
| 2 | "Необходимо указать вес отправления" | Параметр weight отсутствует, пусто или = 0 |
| 3 | "Некорректный почтовый индекс" | Параметр zip не состоит из 6 цифр И не равен 0 |
| 4 | "Необходимо указать Отделение отправления" | Параметр targetstart не передан/пусто или = 0. И В ЛК в разделе «Мой профиль» - «Доступы» у пользователя, с токеном которого выполняется запрос, не установлен пункт приема. И В ЛК в разделе «Мой профиль» - «Информация о магазине» не установлен пункт приема для отправлений. |
Не нашли ответ?
Обратитесь к нам на портал Service Desk
Краткую справку по нему можно найти в этой статье.