Boxberry API: Создать заказ и получить трек-номер с этикеткой

Сценарий из mcp-everything. Актуально на 2026-10-24.

Передать заказ интернет-магазина в Boxberry.

1. Отправь заказ: POST на https://api.boxberry.ru/json.php с method = ParselCreate и sdata: order_id (номер у тебя), vid (1 — до ПВЗ, 2 — курьером), price, payment_sum (0 для предоплаченного), delivery_sum, shop.name (код пункта выдачи) и shop.name1 (код пункта приёма), customer (fio и phone — 10 цифр) и weights.weight в граммах.
2. Для курьерской доставки заполни kurdost: citi и addressp. Индекс лучше оставить пустым — Boxberry определит сам.
3. В ответе track — трек-номер посылки и label — ссылка на этикетку со штрихкодом. Сохрани оба.
4. Чтобы изменить заказ, отправь ParselCreate ещё раз с sdata.updateByTrack = трек-номер.
5. Для многоместного заказа веса мест передаются как weight, weight2 … weight24.

curl -X POST https://api.boxberry.ru/json.php \
  -H 'Content-Type: application/json' \
  -d '{
        "token": "<токен>",
        "method": "ParselCreate",
        "sdata": {
          "order_id": "1042",
          "vid": 1,
          "price": 1500,
          "payment_sum": 0,
          "delivery_sum": 0,
          "shop": {"name": "<код ПВЗ получателя>", "name1": "<код пункта приёма>"},
          "customer": {"fio": "Иванов Иван Иванович", "phone": "9990001122"},
          "weights": {"weight": 1500}
        }
      }'
# → {"track": "AAP127020243", "label": "http://api.boxberry.ru/parcel-files/barcodes?..."}

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

Методы сценария

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"
}

Нюансы

• Все методы — один адрес 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