{"name":"Boxberry API","vendor":"Boxberry","industry":"logistics","summary":"API службы доставки Boxberry для интернет-магазинов и партнёров: города и пункты выдачи, расчёт стоимости и сроков доставки, проверка курьерской доставки по индексу, создание и изменение заказов, курьерский забор, отслеживание статусов, штрихкоды и акты. Все методы вызываются через один адрес с параметром `method`. Есть также SOAP-интерфейс.","docsUrl":"https://yandex.ru/support/delivery-boxberry/ru/pages/web-service-addresses","coverage":{"included":[],"excluded":[]},"scenarios":[{"id":"rasschitat-stoimost-dostavki-do-punkta","title":"Рассчитать стоимость доставки до пункта выдачи или курьером","summary":"Показать покупателю цену доставки Boxberry при оформлении заказа.","steps":["Возьми токен в личном кабинете: «Интеграция» → «Методы API». Все методы вызываются по одному адресу https://api.boxberry.ru/json.php с параметрами token и method.","Получи города доставки: ListCities с CountryCode = 643 (Россия). Список обновляй раз в день. Код нужного пункта выдачи берётся из справочника пунктов Boxberry.","Посчитай стоимость: DeliveryCosts с weight (граммы), target — кодом пункта выдачи, ordersum (объявленная стоимость) и paysum (сумма к оплате с получателя). Для курьерской доставки передай zip — индекс получателя, тогда target игнорируется.","Итог — price в ответе (price_base + price_service). Метод не проверяет данные: при несуществующем пункте или индексе стоимость будет неточной без ошибки, поэтому проверяй коды заранее."],"code":"curl -G https://api.boxberry.ru/json.php \\\n  -d token=<токен> -d method=DeliveryCosts \\\n  -d weight=1500 -d target=010 -d ordersum=1500 -d paysum=0 \\\n  -d height=10 -d width=15 -d depth=20","language":"bash","methods":["ListCities","DeliveryCosts"]},{"id":"sozdat-zakaz-i-poluchit-trek-nomer","title":"Создать заказ и получить трек-номер с этикеткой","summary":"Передать заказ интернет-магазина в Boxberry.","steps":["Отправь заказ: 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 в граммах.","Для курьерской доставки заполни kurdost: citi и addressp. Индекс лучше оставить пустым — Boxberry определит сам.","В ответе track — трек-номер посылки и label — ссылка на этикетку со штрихкодом. Сохрани оба.","Чтобы изменить заказ, отправь ParselCreate ещё раз с sdata.updateByTrack = трек-номер.","Для многоместного заказа веса мест передаются как weight, weight2 … weight24."],"code":"curl -X POST https://api.boxberry.ru/json.php \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n        \"token\": \"<токен>\",\n        \"method\": \"ParselCreate\",\n        \"sdata\": {\n          \"order_id\": \"1042\",\n          \"vid\": 1,\n          \"price\": 1500,\n          \"payment_sum\": 0,\n          \"delivery_sum\": 0,\n          \"shop\": {\"name\": \"<код ПВЗ получателя>\", \"name1\": \"<код пункта приёма>\"},\n          \"customer\": {\"fio\": \"Иванов Иван Иванович\", \"phone\": \"9990001122\"},\n          \"weights\": {\"weight\": 1500}\n        }\n      }'\n# → {\"track\": \"AAP127020243\", \"label\": \"http://api.boxberry.ru/parcel-files/barcodes?...\"}","language":"bash","methods":["ParselCreate"]},{"id":"uznat-status-posylki","title":"Узнать статус посылки","summary":"Показать покупателю, где посылка, или обновить статусы заказов у себя.","steps":["Запроси историю: ListStatuses с ImId — трек-номером или номером заказа в магазине.","В ответе — список статусов с Date (по Москве) и Name, последний элемент — текущий статус.","Для массового обновления статусов по многим посылкам документация рекомендует GetLastStatusData, а не опрос по одной.","Следи за заголовками X-RateLimit-Remaining и X-Rate-Limit-Reset: при превышении лимита придёт 429."],"code":"curl -G https://api.boxberry.ru/json.php \\\n  -d token=<токен> -d method=ListStatuses -d ImId=AAP127020243","language":"bash","methods":["ListStatuses"]}],"baseUrls":[{"label":"Боевой (JSON API)","url":"https://api.boxberry.ru/json.php"},{"label":"Боевой (SOAP, посылки)","url":"https://api.boxberry.ru/__soap/1c_lc.php?wsdl"},{"label":"Боевой (SOAP, информация)","url":"https://api.boxberry.ru/__soap/1c_public.php?wsdl"}],"auth":{"type":"api_key","description":"API-токен берут в личном кабинете Boxberry (account.boxberry.ru): «Интеграция» → вкладка «Методы API». Токен передаётся в параметре `token` в каждом запросе, не меняется при смене пароля. Запросы — только по HTTPS (TLS 1.2 или 1.3).","example":"curl 'https://api.boxberry.ru/json.php?method=ListStatuses&token=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&ImId=AAP298792807'"},"methods":[{"id":"ListCities","title":"Список городов доставки","httpMethod":"POST","path":"ListCities","description":"Города с пунктами выдачи Boxberry. Обновляйте раз в день. GET-запрос: `https://api.boxberry.ru/json.php?token=...&method=ListCities`.\n\nВ ответе для каждого города: `Name`, `Code`, `CountryCode`, `Prefix`, `Region`, `Kladr`, `CourierDelivery` (0/1), `Reception` (0/1) и др.","params":[{"name":"token","in":"query","type":"string","required":true,"description":"Токен"},{"name":"method","in":"query","type":"string","required":true,"description":"ListCities"},{"name":"CountryCode","in":"query","type":"string","required":false,"description":"Код страны: 643 — Россия, 398 — Казахстан, 112 — Беларусь и др."}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"DeliveryCosts","title":"Калькулятор стоимости доставки","httpMethod":"POST","path":"DeliveryCosts","description":"Стоимость доставки до ПВЗ или курьером с учётом постоянных услуг по договору. Метод только считает и не проверяет данные: при неверном пункте или индексе стоимость будет неточной. GET-запрос.\n\nПример запроса (склад–склад):\n\nВ ответе: `price` (итог = `price_base` + `price_service`), `price_base` и др.","params":[{"name":"token","in":"query","type":"string","required":true,"description":"Токен"},{"name":"method","in":"query","type":"string","required":true,"description":"DeliveryCosts"},{"name":"weight","in":"query","type":"integer","required":true,"description":"Вес посылки, граммы"},{"name":"targetstart","in":"query","type":"string","required":false,"description":"Код пункта приёма; по умолчанию из настроек кабинета"},{"name":"target","in":"query","type":"string","required":false,"description":"Код пункта выдачи"},{"name":"zip","in":"query","type":"string","required":false,"description":"Индекс для курьерской доставки; если передан, target игнорируется"},{"name":"ordersum","in":"query","type":"number","required":false,"description":"Объявленная (страховая) стоимость"},{"name":"deliverysum","in":"query","type":"number","required":false,"description":"Заявленная стоимость доставки"},{"name":"paysum","in":"query","type":"number","required":false,"description":"Сумма к оплате с получателя"},{"name":"height","in":"query","type":"string","required":false,"description":"Высота коробки, см"},{"name":"width","in":"query","type":"string","required":false,"description":"Ширина, см"},{"name":"depth","in":"query","type":"string","required":false,"description":"Глубина, см"},{"name":"sucrh","in":"query","type":"string","required":false,"description":"1 — расчёт с индивидуальными настройками кабинета"}],"requestExample":"https://api.boxberry.ru/json.php?token=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&method=DeliveryCosts&weight=500&targetstart=010&target=010&ordersum=0&deliverysum=0&height=120&width=80&depth=50&paysum=100","responseExample":"","docsUrl":""},{"id":"ParselCreate","title":"Создать или обновить заказ","httpMethod":"POST","path":"ParselCreate","description":"POST на `https://api.boxberry.ru/json.php`, тело — JSON. Услуги из раздела «Услуги» кабинета подставляются автоматически. Если заполнен `updateByTrack`, обновляется ранее созданная посылка.","params":[{"name":"token","in":"body","type":"string","required":true,"description":"Токен"},{"name":"method","in":"body","type":"string","required":true,"description":"ParselCreate"},{"name":"sdata.order_id","in":"body","type":"string","required":true,"description":"Номер заказа в магазине"},{"name":"sdata.vid","in":"body","type":"string","required":true,"description":"1 — до ПВЗ, 2 — курьерская доставка"},{"name":"sdata.price","in":"body","type":"string","required":false,"description":"Объявленная стоимость (РФ: 5–500 000)"},{"name":"sdata.payment_sum","in":"body","type":"string","required":false,"description":"Сумма к оплате с получателя; для предоплаченного — 0"},{"name":"sdata.delivery_sum","in":"body","type":"string","required":false,"description":"Стоимость доставки для получателя"},{"name":"sdata.updateByTrack","in":"body","type":"string","required":false,"description":"Трек-номер для обновления посылки"},{"name":"sdata.barcode","in":"body","type":"string","required":false,"description":"Собственный штрихкод посылки"},{"name":"sdata.shop.name","in":"body","type":"string","required":false,"description":"Код пункта выдачи (обязателен для ПВЗ)"},{"name":"sdata.shop.name1","in":"body","type":"string","required":true,"description":"Код пункта приёма"},{"name":"sdata.customer.fio","in":"body","type":"string","required":true,"description":"ФИО получателя"},{"name":"sdata.customer.phone","in":"body","type":"string","required":true,"description":"Телефон, 10 цифр"},{"name":"sdata.kurdost.citi","in":"body","type":"string","required":false,"description":"Населённый пункт (обязателен для КД по РФ)"},{"name":"sdata.kurdost.addressp","in":"body","type":"string","required":false,"description":"Адрес: улица, дом, квартира (обязателен для КД по РФ)"},{"name":"sdata.kurdost.index","in":"body","type":"string","required":false,"description":"Индекс; лучше оставить пустым для автоопределения"},{"name":"sdata.weights.weight","in":"body","type":"string","required":true,"description":"Вес первого места, граммы (5–31 000)"}],"requestExample":"","responseExample":"{\n  \"track\": \"AAP127020243\",\n  \"label\": \"http://api.boxberry.ru/parcel-files/barcodes?parcel_id=127020243&token=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"\n}","docsUrl":""},{"id":"ListStatuses","title":"Статусы посылки","httpMethod":"POST","path":"ListStatuses","description":"GET или POST. Для массового обновления рекомендуется `GetLastStatusData`.\n\nПример ответа (сокращён):","params":[{"name":"token","in":"query","type":"string","required":true,"description":"Токен"},{"name":"method","in":"query","type":"string","required":true,"description":"ListStatuses"},{"name":"ImId","in":"query","type":"string","required":true,"description":"Трек-номер или номер заказа"}],"requestExample":"[\n  {\n    \"Date\": \"2024-02-07 13:38:13\",\n    \"Name\": \"Загружен реестр ИМ\"\n  },\n  {\n    \"Date\": \"2024-02-07 13:54:31\",\n    \"Name\": \"Выдано\"\n  }\n]","responseExample":"","docsUrl":""}],"codeExamples":[],"errors":[{"code":"429","description":"Превышен лимит запросов; тело {\"err\": \"Слишком много запросов\"}"}],"limits":"Текущие лимиты возвращаются в заголовках каждого ответа: `X-RateLimit-Limit` (максимум запросов в интервале), `X-RateLimit-Remaining` (остаток), `X-Rate-Limit-Reset` (сколько секунд ждать). При систематическом превышении доступ к API может быть ограничен.","gotchas":["Все методы — один адрес `json.php`; метод выбирается параметром `method`, токен — параметром `token`.","Курьерская доставка определяется по индексу получателя — проверяйте его методами `ListZips` или `ZipCheck`. Для курьерской доставки за рубеж используйте `DeliveryCalculation`.","`DeliveryCosts` не валидирует данные: несуществующий пункт или превышение габаритов дадут неточную стоимость без ошибки.","Вес — в граммах, габариты — в сантиметрах; даты статусов — по Москве.","Для многоместных заказов веса мест передаются как `weight`, `weight2` … `weight24`."],"slug":"boxberry","version":2,"updatedAt":"2026-10-24T17:05:31.806Z","sources":[{"title":"Адреса web-сервисов","url":"https://yandex.ru/support/delivery-boxberry/ru/pages/web-service-addresses","kind":"research","addedAt":"2026-10-12T19:28:05.113Z"},{"title":"Как узнать токен","url":"https://yandex.ru/support/delivery-boxberry/ru/pages/how-to-get-token","kind":"research","addedAt":"2026-10-12T19:28:05.113Z"},{"title":"Лимиты на запросы","url":"https://yandex.ru/support/delivery-boxberry/ru/pages/request-limits","kind":"research","addedAt":"2026-10-12T19:28:05.113Z"},{"title":"ListCities","url":"https://yandex.ru/support/delivery-boxberry/ru/pages/list-cities","kind":"research","addedAt":"2026-10-12T19:28:05.113Z"},{"title":"DeliveryCosts","url":"https://yandex.ru/support/delivery-boxberry/ru/pages/delivery-costs","kind":"research","addedAt":"2026-10-12T19:28:05.113Z"},{"title":"ParselCreate","url":"https://yandex.ru/support/delivery-boxberry/ru/pages/parcel-create","kind":"research","addedAt":"2026-10-12T19:28:05.113Z"},{"title":"ListStatuses","url":"https://yandex.ru/support/delivery-boxberry/ru/pages/list-statuses","kind":"research","addedAt":"2026-10-12T19:28:05.113Z"},{"title":"Вставленный текст","url":"","kind":"import","addedAt":"2026-10-12T19:28:05.113Z"},{"title":"scenarios-boxberry.md","url":"","kind":"import","addedAt":"2026-10-24T17:05:23.661Z"}],"logoUrl":null}