# 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) |

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

```json
{
  "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://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