Boxberry API: Узнать статус посылки

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

Показать покупателю, где посылка, или обновить статусы заказов у себя.

1. Запроси историю: ListStatuses с ImId — трек-номером или номером заказа в магазине.
2. В ответе — список статусов с Date (по Москве) и Name, последний элемент — текущий статус.
3. Для массового обновления статусов по многим посылкам документация рекомендует GetLastStatusData, а не опрос по одной.
4. Следи за заголовками X-RateLimit-Remaining и X-Rate-Limit-Reset: при превышении лимита придёт 429.

curl -G https://api.boxberry.ru/json.php \
  -d token=<токен> -d method=ListStatuses -d ImId=AAP127020243

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

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

ListStatuses — Статусы посылки

GET или POST. Для массового обновления рекомендуется GetLastStatusData.

Пример ответа (сокращён):

Параметр	Где	Тип	Обяз.	Описание
token	query	string	да	Токен
method	query	string	да	ListStatuses
ImId	query	string	да	Трек-номер или номер заказа

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

[
  {
    "Date": "2024-02-07 13:38:13",
    "Name": "Загружен реестр ИМ"
  },
  {
    "Date": "2024-02-07 13:54:31",
    "Name": "Выдано"
  }
]

Нюансы

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