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

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

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

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

```bash
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://mcp-everything.ru/integrations/boxberry/scenarios/rasschitat-stoimost-dostavki-do-punkta.md)
- [Создать заказ и получить трек-номер с этикеткой](https://mcp-everything.ru/integrations/boxberry/scenarios/sozdat-zakaz-i-poluchit-trek-nomer.md)

---

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