Boxberry API: ParselCreate — Создать или обновить заказ

POST на https://api.boxberry.ru/json.php, тело — JSON. Услуги из раздела «Услуги» кабинета подставляются автоматически. Если заполнен updateByTrack, обновляется ранее созданная посылка.

Параметр	Где	Тип	Обяз.	Описание
token	body	string	да	Токен
method	body	string	да	ParselCreate
sdata.order_id	body	string	да	Номер заказа в магазине
sdata.vid	body	string	да	1 — до ПВЗ, 2 — курьерская доставка
sdata.price	body	string	нет	Объявленная стоимость (РФ: 5–500 000)
sdata.payment_sum	body	string	нет	Сумма к оплате с получателя; для предоплаченного — 0
sdata.delivery_sum	body	string	нет	Стоимость доставки для получателя
sdata.updateByTrack	body	string	нет	Трек-номер для обновления посылки
sdata.barcode	body	string	нет	Собственный штрихкод посылки
sdata.shop.name	body	string	нет	Код пункта выдачи (обязателен для ПВЗ)
sdata.shop.name1	body	string	да	Код пункта приёма
sdata.customer.fio	body	string	да	ФИО получателя
sdata.customer.phone	body	string	да	Телефон, 10 цифр
sdata.kurdost.citi	body	string	нет	Населённый пункт (обязателен для КД по РФ)
sdata.kurdost.addressp	body	string	нет	Адрес: улица, дом, квартира (обязателен для КД по РФ)
sdata.kurdost.index	body	string	нет	Индекс; лучше оставить пустым для автоопределения
sdata.weights.weight	body	string	да	Вес первого места, граммы (5–31 000)

Пример ответа:

{
  "track": "AAP127020243",
  "label": "http://api.boxberry.ru/parcel-files/barcodes?parcel_id=127020243&token=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}

Базовые 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