{"name":"Яндекс Доставка API (Доставка по России)","vendor":"Яндекс","industry":"logistics","summary":"API логистической платформы Яндекс Доставки для доставки заказов в другой день по России: забор с вашего склада или самопривоз в точку отгрузки, доставка до двери или в ПВЗ и постаматы. Сценарий: рассчитать стоимость, получить варианты доставки (офферы), подтвердить оффер — заявка создана, затем отслеживать статус, печатать ярлыки и акты. Отдельный API есть для экспресс-доставки в течение дня — в этот файл он не вошёл.","docsUrl":"https://yandex.ru/support/delivery-profile/ru/api/other-day/","coverage":{"included":[],"excluded":[]},"scenarios":[{"id":"rasschitat-stoimost-dostavki","title":"Рассчитать стоимость доставки","summary":"Показать покупателю цену доставки Яндекса до двери или до пункта выдачи.","steps":["Получи Bearer-токен в личном кабинете (раздел «Профиль») и ID своего склада отгрузки platform_station_id — его выдаёт менеджер. Для отладки есть тестовый контур https://b2b.taxi.tst.yandex.net с тестовым токеном и складом из документации.","Посчитай стоимость: POST /api/b2b/platform/pricing-calculator с source.platform_station_id, destination (platform_station_id пункта выдачи или address для доставки до двери), tariff (time_interval — до двери, self_pickup — до ПВЗ), total_weight и places.","Вес передавай в граммах, габариты dx, dy, dz — в сантиметрах. total_assessed_price — оценочная стоимость посылки.","Это предварительная оценка: точную цену и сроки покажут офферы при создании заявки."],"code":"curl -X POST https://b2b-authproxy.taxi.yandex.net/api/b2b/platform/pricing-calculator \\\n  -H \"Authorization: Bearer $YD_TOKEN\" \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n        \"source\": {\"platform_station_id\": \"<ID склада отгрузки>\"},\n        \"destination\": {\"address\": \"Санкт-Петербург, Большая Монетная улица, 1к1А\"},\n        \"tariff\": \"time_interval\",\n        \"total_weight\": 1500,\n        \"total_assessed_price\": 1500,\n        \"client_price\": 0,\n        \"payment_method\": \"already_paid\",\n        \"places\": [{\"physical_dims\": {\"weight_gross\": 1500, \"dx\": 20, \"dy\": 15, \"dz\": 10}}]\n      }'","language":"bash","methods":["POST /api/b2b/platform/pricing-calculator"]},{"id":"pokazat-punkty-vydachi-i-postamaty","title":"Показать пункты выдачи и постаматы в городе","summary":"Список ПВЗ Яндекса для выбора при оформлении заказа.","steps":["Определи населённый пункт: POST /api/b2b/platform/location/detect с адресом или его фрагментом (например, названием города). В ответе — geo_id.","Запроси точки: POST /api/b2b/platform/pickup-points/list с geo_id и type = pickup_point. Для поиска на карте вместо geo_id передай диапазоны latitude и longitude видимой области.","Если нужны примерка или частичный выкуп, отфильтруй по pickup_services. С пустым телом метод вернёт вообще все доступные точки.","Сохрани ID выбранной точки — он пойдёт в destination.platform_station при создании заявки."],"code":"curl -X POST https://b2b-authproxy.taxi.yandex.net/api/b2b/platform/location/detect \\\n  -H \"Authorization: Bearer $YD_TOKEN\" -H 'Content-Type: application/json' \\\n  -d '{\"location\": \"Казань\"}'\n\ncurl -X POST https://b2b-authproxy.taxi.yandex.net/api/b2b/platform/pickup-points/list \\\n  -H \"Authorization: Bearer $YD_TOKEN\" -H 'Content-Type: application/json' \\\n  -d '{\"geo_id\": <geo_id>, \"type\": \"pickup_point\"}'","language":"bash","methods":["POST /api/b2b/platform/location/detect","POST /api/b2b/platform/pickup-points/list"]},{"id":"sozdat-zakaz-vybrat-variant-dostavki","title":"Создать заказ: выбрать вариант доставки и подтвердить","summary":"Основной поток: получить варианты доставки (офферы) для заказа и забронировать подходящий.","steps":["Запроси офферы: POST /api/b2b/platform/offers/create с info.operator_request_id (уникальный номер заказа у тебя), source.platform_station.platform_id, destination (type = platform_station и ID пункта — или custom_location с адресом для доставки до двери), items, places, billing_info, recipient_info и last_mile_policy.","Цены товаров передавай в копейках, вес — в граммах, габариты — в сантиметрах. Одинаковые товары — одной позицией с count, иначе запишется количество 1.","В ответе — офферы с интервалом доставки, ценой и expires_at. Выбери подходящий и успей подтвердить до истечения срока.","Подтверди: POST /api/b2b/platform/offers/confirm с offer_id. В ответе request_id созданной заявки — сохрани его в заказе.","Если выбирать не нужно, заявку на ближайшее время можно создать одним вызовом: POST /api/b2b/platform/request/create."],"code":"curl -X POST https://b2b-authproxy.taxi.yandex.net/api/b2b/platform/offers/confirm \\\n  -H \"Authorization: Bearer $YD_TOKEN\" \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"offer_id\": \"c1b139dbd76b4ee3b39b19180b516119\"}'\n# → {\"request_id\": \"77241d8009bb46d0bff5c65a73077bcd-udp\"}","language":"bash","methods":["POST /api/b2b/platform/offers/create","POST /api/b2b/platform/offers/confirm","POST /api/b2b/platform/request/create"]},{"id":"otsledit-zakaz-i-pri-neobhodimosti","title":"Отследить заказ и при необходимости отменить","summary":"Показать покупателю статус доставки и отменить заявку, если заказ отменён.","steps":["Узнай статус: GET /api/b2b/platform/request/info с request_id (или request_code — твоим номером заказа). История статусов — /api/b2b/platform/request/history, актуальная дата доставки — /api/b2b/platform/request/actual_info.","Для синхронизации многих заказов используй выборку за период — /api/b2b/platform/requests/info, а не опрос по одному.","Отмени заявку: POST /api/b2b/platform/request/cancel с request_id. Курьерскую заявку можно отменить до статуса DELIVERY_TRANSPORTATION_RECIPIENT. В ответе status, reason и description — проверь, что отмена прошла."],"code":"curl -G https://b2b-authproxy.taxi.yandex.net/api/b2b/platform/request/info \\\n  -H \"Authorization: Bearer $YD_TOKEN\" \\\n  -d request_id=77241d8009bb46d0bff5c65a73077bcd-udp\n\ncurl -X POST https://b2b-authproxy.taxi.yandex.net/api/b2b/platform/request/cancel \\\n  -H \"Authorization: Bearer $YD_TOKEN\" -H 'Content-Type: application/json' \\\n  -d '{\"request_id\": \"77241d8009bb46d0bff5c65a73077bcd-udp\"}'","language":"bash","methods":["GET /api/b2b/platform/request/info","POST /api/b2b/platform/request/cancel"]},{"id":"napechatat-yarlyki-na-posylki","title":"Напечатать ярлыки на посылки","summary":"Подготовить отгрузку: ярлыки на каждое место и акт приёма-передачи для курьера.","steps":["Получи ярлыки: POST /api/b2b/platform/request/generate-labels со списком request_ids. generate_type = one печатает по ярлыку на лист, many — несколько на лист; label_size_mm — размер под твой принтер (100x150 для термопринтера, 210x297 — лист A4).","Наклей ярлык на каждое грузоместо.","Для передачи курьеру сформируй акт методом /api/b2b/platform/request/get-handover-act."],"code":"curl -X POST https://b2b-authproxy.taxi.yandex.net/api/b2b/platform/request/generate-labels \\\n  -H \"Authorization: Bearer $YD_TOKEN\" -H 'Content-Type: application/json' \\\n  -o labels.pdf \\\n  -d '{\"request_ids\": [\"77241d8009bb46d0bff5c65a73077bcd-udp\"], \"generate_type\": \"one\", \"label_size_mm\": \"100x150\"}'","language":"bash","methods":["POST /api/b2b/platform/request/generate-labels"]}],"baseUrls":[{"label":"Боевой","url":"https://b2b-authproxy.taxi.yandex.net"},{"label":"Тестовый","url":"https://b2b.taxi.tst.yandex.net"}],"auth":{"type":"bearer","description":"Bearer-токен в заголовке `Authorization: Bearer <token>`. Для продакшена токен берут в личном кабинете в разделе «Профиль»; ID склада отгрузки (`platform_station_id`) выдаёт коммерческий менеджер.\n\nДля тестового контура в документации даны:\n\nДля корректной работы нужен TLS 1.2 и выше с шифрами по стандарту PCI DSS v4.","example":""},"methods":[{"id":"POST /api/b2b/platform/pricing-calculator","title":"Предварительная оценка стоимости","httpMethod":"POST","path":"/api/b2b/platform/pricing-calculator","description":"","params":[{"name":"is_oversized","in":"query","type":"boolean","required":false,"description":"Флаг КГТ"},{"name":"source","in":"body","type":"object","required":false,"description":"Точка отправления: platform_station_id"},{"name":"destination","in":"body","type":"object","required":false,"description":"Точка получения: platform_station_id или address (одно из двух)"},{"name":"tariff","in":"body","type":"string","required":false,"description":"time_interval (до двери в интервал) или self_pickup (до ПВЗ)"},{"name":"total_weight","in":"body","type":"integer","required":false,"description":"Суммарный вес, граммы"},{"name":"total_assessed_price","in":"body","type":"integer","required":false,"description":"Оценочная стоимость"},{"name":"client_price","in":"body","type":"integer","required":false,"description":"Стоимость для клиента"},{"name":"payment_method","in":"body","type":"string","required":false,"description":"Способ оплаты, например already_paid"},{"name":"places","in":"body","type":"array","required":false,"description":"Места: physical_dims.weight_gross, dx, dy, dz"}],"requestExample":"{\n  \"source\": {\n    \"platform_station_id\": \"fbed3aa1-2cc6-4370-ab4d-59c5cc9bb924\"\n  },\n  \"destination\": {\n    \"platform_station_id\": \"e1139f6d-e34f-47a9-a55f-31f032a861a6\",\n    \"address\": \"Санкт-Петербург, Большая Монетная улица, 1к1А\"\n  },\n  \"tariff\": \"time_interval\",\n  \"total_weight\": 0,\n  \"total_assessed_price\": 0,\n  \"client_price\": 0,\n  \"payment_method\": \"already_paid\",\n  \"places\": [\n    {\n      \"physical_dims\": {\n        \"weight_gross\": 100,\n        \"dx\": 10,\n        \"dy\": 10,\n        \"dz\": 10\n      }\n    }\n  ]\n}","responseExample":"","docsUrl":""},{"id":"POST /api/b2b/platform/location/detect","title":"Определение geo_id по адресу","httpMethod":"POST","path":"/api/b2b/platform/location/detect","description":"Возвращает идентификатор населённого пункта (`geo_id`) по адресу или его фрагменту.","params":[],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /api/b2b/platform/pickup-points/list","title":"Точки самопривоза и ПВЗ","httpMethod":"POST","path":"/api/b2b/platform/pickup-points/list","description":"С пустым телом возвращает все доступные точки самопривоза, ПВЗ и постаматы.","params":[{"name":"geo_id","in":"body","type":"integer","required":false,"description":"Населённый пункт"},{"name":"type","in":"body","type":"string","required":false,"description":"Тип точки, например pickup_point"},{"name":"available_for_dropoff","in":"body","type":"boolean","required":false,"description":"Возможность отгрузки в точку; для warehouse обязательно true"},{"name":"is_yandex_branded","in":"body","type":"boolean","required":false,"description":"Только брендированные точки"},{"name":"is_not_branded_partner_station","in":"body","type":"boolean","required":false,"description":"Добавить партнёрские ПВЗ"},{"name":"payment_method","in":"body","type":"string","required":false,"description":"Способ оплаты"},{"name":"latitude","in":"body","type":"object","required":false,"description":"Диапазон широт from/to"},{"name":"longitude","in":"body","type":"object","required":false,"description":"Диапазон долгот from/to"},{"name":"pickup_services","in":"body","type":"object","required":false,"description":"Услуги: примерка, частичный выкуп и др."}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /api/b2b/platform/offers/create","title":"Создание заявки (получение офферов)","httpMethod":"POST","path":"/api/b2b/platform/offers/create","description":"Возвращает варианты доставки (офферы) для заказа. Одинаковые товары передавайте одной позицией с `count`, иначе будет записано количество 1.","params":[{"name":"send_unix","in":"query","type":"boolean","required":false,"description":"Формат интервалов: true — unix, false — UTC"},{"name":"info.operator_request_id","in":"body","type":"string","required":false,"description":"ID заказа у отправителя, уникальный"},{"name":"info.comment","in":"body","type":"string","required":false,"description":"Комментарий"},{"name":"info.merchant_id","in":"body","type":"string","required":false,"description":"ID мерчанта (если есть зарегистрированные)"},{"name":"source.platform_station.platform_id","in":"body","type":"string","required":false,"description":"Склад или точка отгрузки"},{"name":"source.interval_utc","in":"body","type":"object","required":false,"description":"Интервал отгрузки from/to"},{"name":"destination.type","in":"body","type":"string","required":false,"description":"platform_station (ПВЗ) или custom_location (до двери)"},{"name":"destination.platform_station","in":"body","type":"object","required":false,"description":"ПВЗ получения"},{"name":"destination.custom_location","in":"body","type":"object","required":false,"description":"Адрес: latitude, longitude, details (full_address, locality, street, house, room и др.)"},{"name":"destination.interval_utc","in":"body","type":"object","required":false,"description":"Интервал доставки"},{"name":"items","in":"body","type":"array","required":true,"description":"Товары: count, name, article, billing_details, physical_dims, place_barcode"},{"name":"items[].billing_details.unit_price","in":"body","type":"integer","required":false,"description":"Цена за единицу, копейки"},{"name":"items[].billing_details.assessed_unit_price","in":"body","type":"integer","required":false,"description":"Оценочная цена за единицу, копейки"},{"name":"items[].billing_details.nds","in":"body","type":"integer","required":false,"description":"НДС: 0, 5, 7, 10, 22; без НДС — -1"},{"name":"places","in":"body","type":"array","required":true,"description":"Грузоместа: physical_dims (weight_gross, dx, dy, dz), barcode"},{"name":"billing_info","in":"body","type":"object","required":false,"description":"Оплата: payment_method, delivery_cost"},{"name":"recipient_info","in":"body","type":"object","required":false,"description":"Данные получателя"},{"name":"last_mile_policy","in":"body","type":"string","required":false,"description":"time_interval или self_pickup"},{"name":"forbid_unboxing","in":"body","type":"boolean","required":false,"description":"Запрет вскрытия упаковки"},{"name":"particular_items_refuse","in":"body","type":"boolean","required":false,"description":"Разрешён частичный выкуп"}],"requestExample":"","responseExample":"{\n  \"offers\": [\n    {\n      \"offer_id\": \"c1b139dbd76b4ee3b39b19180b516119\",\n      \"expires_at\": \"2021-10-25T15:00:00.000000Z\",\n      \"offer_details\": {\n        \"delivery_interval\": {\n          \"min\": \"2021-10-25T15:00:00.000000Z\",\n          \"max\": \"2021-10-25T15:00:00.000000Z\",\n          \"policy\": \"time_interval\"\n        },\n        \"pickup_interval\": {},\n        \"pricing\": \"192.15 RUB\",\n        \"pricing_commission_on_delivery_payment\": \"2.2%\",\n        \"pricing_commission_on_delivery_payment_amount\": \"9.43 RUB\",\n        \"pricing_total\": \"1400.96 RUB\"\n      }\n    }\n  ]\n}","docsUrl":""},{"id":"POST /api/b2b/platform/offers/confirm","title":"Подтверждение заявки","httpMethod":"POST","path":"/api/b2b/platform/offers/confirm","description":"Бронирует выбранный оффер и создаёт заявку.\n\nВ ответе — `request_id` созданной заявки, например `77241d8009bb46d0bff5c65a73077bcd-udp`.","params":[{"name":"offer_id","in":"body","type":"string","required":true,"description":"ID оффера"}],"requestExample":"{\n  \"offer_id\": \"c1b139dbd76b4ee3b39b19180b516119\"\n}","responseExample":"","docsUrl":""},{"id":"POST /api/b2b/platform/request/create","title":"Создание заказа на ближайшее время","httpMethod":"POST","path":"/api/b2b/platform/request/create","description":"Создаёт заказ сразу на ближайшее доступное время, без шага выбора оффера.","params":[],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/b2b/platform/request/info","title":"Информация о заявке","httpMethod":"GET","path":"/api/b2b/platform/request/info","description":"История статусов — `GET /api/b2b/platform/request/history`, актуальная дата доставки — `GET /api/b2b/platform/request/actual_info`, заявки за период — `POST /api/b2b/platform/requests/info`.","params":[{"name":"request_id","in":"query","type":"string","required":false,"description":"ID заявки в платформе"},{"name":"request_code","in":"query","type":"string","required":false,"description":"Номер заказа в системе заказчика"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /api/b2b/platform/request/cancel","title":"Отмена заявки","httpMethod":"POST","path":"/api/b2b/platform/request/cancel","description":"Курьерскую заявку можно отменить до статуса `DELIVERY_TRANSPORTATION_RECIPIENT`.\n\nВ ответе: `status` (`CREATED`, `SUCCESS` и др.), `reason`, `description`.","params":[{"name":"request_id","in":"body","type":"string","required":true,"description":"ID заявки в платформе"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /api/b2b/platform/request/generate-labels","title":"Получение ярлыков","httpMethod":"POST","path":"/api/b2b/platform/request/generate-labels","description":"Акты приёма-передачи — `POST /api/b2b/platform/request/get-handover-act`.","params":[{"name":"request_ids","in":"body","type":"array","required":true,"description":"ID заказов"},{"name":"generate_type","in":"body","type":"string","required":false,"description":"one (по одному на лист, по умолчанию) или many"},{"name":"label_size_mm","in":"body","type":"string","required":false,"description":"210x297 (по умолчанию), 100x150, 75x120, 58x60, 58x40"},{"name":"language","in":"body","type":"string","required":false,"description":"Язык надписей, по умолчанию ru"}],"requestExample":"","responseExample":"","docsUrl":""}],"codeExamples":[],"errors":[{"code":"400","description":"Ошибка в данных пользователя, например bad_request с сообщением Missing required field 'offer_id'"},{"code":"403","description":"Доступ запрещён"},{"code":"404","description":"Не найдено"},{"code":"500","description":"Внутренняя ошибка сервера"}],"limits":"","gotchas":["Основной поток — двухшаговый: `offers/create` возвращает офферы с ограниченным сроком (`expires_at`), заявка создаётся только после `offers/confirm`.","Суммы в товарах передаются в копейках, вес — в граммах, габариты — в сантиметрах.","Для `destination` заполняется либо `platform_station` (ПВЗ), либо `custom_location` (доставка до двери) в соответствии с `type`.","`operator_request_id` должен быть уникальным для каждого заказа.","В тестовом контуре используйте тестовый токен и тестовый склад из документации; продакшен-ID склада выдаёт менеджер."],"slug":"yandex-delivery","version":2,"updatedAt":"2026-10-24T17:05:40.021Z","sources":[{"title":"API Доставки по России","url":"https://yandex.ru/support/delivery-profile/ru/api/other-day/","kind":"research","addedAt":"2026-10-12T19:26:42.093Z"},{"title":"Список методов","url":"https://yandex.ru/support/delivery-profile/ru/api/other-day/ref/","kind":"research","addedAt":"2026-10-12T19:26:42.093Z"},{"title":"Создание заявки","url":"https://yandex.ru/support/delivery-profile/ru/api/other-day/ref/3.-Osnovnye-zaprosy/apib2bplatformofferscreate-post","kind":"research","addedAt":"2026-10-12T19:26:42.093Z"},{"title":"Подтверждение заявки","url":"https://yandex.ru/support/delivery-profile/ru/api/other-day/ref/3.-Osnovnye-zaprosy/apib2bplatformoffersconfirm-post","kind":"research","addedAt":"2026-10-12T19:26:42.093Z"},{"title":"Отмена заявки","url":"https://yandex.ru/support/delivery-profile/ru/api/other-day/ref/3.-Osnovnye-zaprosy/apib2bplatformrequestcancel-post","kind":"research","addedAt":"2026-10-12T19:26:42.093Z"},{"title":"Статусная модель","url":"https://yandex.ru/support/delivery-profile/ru/api/other-day/status-model","kind":"research","addedAt":"2026-10-12T19:26:42.093Z"},{"title":"Технические детали интеграции","url":"https://yandex.ru/support/delivery-profile/ru/api/express/integration","kind":"research","addedAt":"2026-10-12T19:26:42.093Z"},{"title":"Вставленный текст","url":"","kind":"import","addedAt":"2026-10-12T19:26:42.093Z"},{"title":"scenarios-yandex-delivery.md","url":"","kind":"import","addedAt":"2026-10-24T17:05:29.467Z"}],"logoUrl":null}