Boxberry API: DeliveryCosts — Калькулятор стоимости доставки

Стоимость доставки до ПВЗ или курьером с учётом постоянных услуг по договору. Метод только считает и не проверяет данные: при неверном пункте или индексе стоимость будет неточной. GET-запрос.

Пример запроса (склад–склад):

В ответе: price (итог = price_base + price_service), price_base и др.

Параметр	Где	Тип	Обяз.	Описание
token	query	string	да	Токен
method	query	string	да	DeliveryCosts
weight	query	integer	да	Вес посылки, граммы
targetstart	query	string	нет	Код пункта приёма; по умолчанию из настроек кабинета
target	query	string	нет	Код пункта выдачи
zip	query	string	нет	Индекс для курьерской доставки; если передан, target игнорируется
ordersum	query	number	нет	Объявленная (страховая) стоимость
deliverysum	query	number	нет	Заявленная стоимость доставки
paysum	query	number	нет	Сумма к оплате с получателя
height	query	string	нет	Высота коробки, см
width	query	string	нет	Ширина, см
depth	query	string	нет	Глубина, см
sucrh	query	string	нет	1 — расчёт с индивидуальными настройками кабинета

Пример запроса:

https://api.boxberry.ru/json.php?token=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&method=DeliveryCosts&weight=500&targetstart=010&target=010&ordersum=0&deliverysum=0&height=120&width=80&depth=50&paysum=100

Базовые URL

• Боевой (JSON API): https://api.boxberry.ru/json.php
• Боевой (SOAP, посылки): https://api.boxberry.ru/__soap/1c_lc.php?wsdl
• Боевой (SOAP, информация): https://api.boxberry.ru/__soap/1c_public.php?wsdl

Авторизация

Тип: API-ключ

API-токен берут в личном кабинете Boxberry (account.boxberry.ru): «Интеграция» → вкладка «Методы API». Токен передаётся в параметре token в каждом запросе, не меняется при смене пароля. Запросы — только по HTTPS (TLS 1.2 или 1.3).

curl 'https://api.boxberry.ru/json.php?method=ListStatuses&token=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&ImId=AAP298792807'

Нюансы

• Все методы — один адрес json.php; метод выбирается параметром method, токен — параметром token.
• Курьерская доставка определяется по индексу получателя — проверяйте его методами ListZips или ZipCheck. Для курьерской доставки за рубеж используйте DeliveryCalculation.
• DeliveryCosts не валидирует данные: несуществующий пункт или превышение габаритов дадут неточную стоимость без ошибки.
• Вес — в граммах, габариты — в сантиметрах; даты статусов — по Москве.
• Для многоместных заказов веса мест передаются как weight, weight2 … weight24.

Сценарии с этим методом

• Рассчитать стоимость доставки до пункта выдачи или курьером

---

Если этого недостаточно — официальная документация: https://yandex.ru/support/delivery-boxberry/ru/pages/web-service-addresses Вся интеграция одним документом: https://mcp-everything.ru/integrations/boxberry.md