API Яндекс Доставки связывает заказ с курьером, а агенты проверяют создание и смену статусов
Как заказать доставку из своего сервиса заказов и принять связку по проверкам.
API Яндекс Доставки позволяет создать заявку из заказа магазина, а поиск курьера начинается после подтверждения условий.
ИИ-агенты могут написать эту связку и её проверки. Своего клиентского кейса этой интеграции у нас нет; опыт ниже взят из работы машины на vibecoding.ru.
Не хотите разбираться сами? Внедряем ИИ в ваш бизнес: задачи без лимита, одна цена в месяц, отмена в любой момент.
1. Курьера начинают искать после подтверждения заявки.
Что произойдёт после нажатия «Заказать доставку»? Магазин передаёт адреса и груз, получает и подтверждает условия. Ход доставки возвращается в карточку заказа.
Для экспресс-доставки в РФ claims/create создаёт заявку, а claims/accept подтверждает её. Ответ на создание ещё не означает, что заказ взят в работу.
Сотрудник должен увидеть стоимость и подтвердить её. Если интерфейс пишет «курьер едет» сразу после получения номера заявки, связка вводит магазин в заблуждение.
До поиска курьера программа получает и подтверждает условия.
Яндекс Доставка, quickstart и методы API; проверено 08.10.2026. Схема для заказа разработки, не результат нашей интеграции.
Предложение действует 10 минут, по документации Яндекса на 8 октября 2026. При позднем подтверждении программа должна получить новые условия.
2. Повтор после сбоя должен продолжать ту же операцию.
Что делать, если ответ на создание не пришёл? Таймаут не показывает, появилась ли заявка. Повтор с новым номером операции способен вызвать лишнего курьера.
Яндекс предусматривает request_id, номер операции создания. После таймаута или серверной ошибки повторяют запрос с тем же значением. Для новой заявки нужен новый номер.
Магазин сохраняет номер до отправки запроса. После второго нажатия или перезапуска обе попытки должны находить ту же операцию. Отключения кнопки недостаточно.
Проверки должны показать повтор без дубля.
Яндекс Доставка, claims/create, проверено 08.10.2026. Сценарии одновременного нажатия и перезапуска добавлены редакцией как требования к коду магазина.
Эти проверки входят в задачу для ИИ-агента до написания кода. Скриншот успешного ответа показывает только один проход; потерю ответа проверяют отдельным сценарием.
3. Статусы возвращаются в заказ, а уведомление дополняется сверкой.
Как сотрудник узнает, что товар передан и доставка закончилась? Программа связывает ID заявки с заказом магазина и переводит ответы Яндекса в понятные подписи.
При нескольких получателях delivered подтверждает доставку в точке, delivered_finish завершает весь заказ. Возврат и отмена требуют своих действий.
Уведомление ускоряет обновление. Яндекс требует также получать сведения через claims/info: попытки доставки уведомления прекращаются после неуспехов.
Сотрудник видит доставку, возврат и проблему раздельно.
Яндекс Доставка, статусная модель и claims/info, проверено 08.10.2026. Подписи магазина предлагаются редакцией; таблица не перечисляет все статусы API.
Ответ claims/info бывает старее уже полученного состояния. Проверяют updated_ts: запоздалый ответ не должен вернуть карточку заказа назад.
4. Доступ и обновление статусов проверяют после запуска.
Кто заметит, если доставка перестанет обновляться? Программа показывает ошибку доступа и время последней удачной сверки, сотрудник знает, кому передать проблему.
Токен Яндекс Доставки бессрочный по quickstart. Проверяют возможность обращения к API и результат обновления заявок; у такого токена нет даты планового истечения.
Урок «Руль, окно и сторож» курса об агентной разработке связывает правила, экран состояния и сигнал о сбое. Наша машина получила эти проверки после поломок.
Поломки нашей машины стали правилами наблюдения.
23.07
Писатель новостей остановился, а отметка обработанного продолжала двигаться. Теперь ошибка сохраняется, отметка при неуспехе не продвигается.
29.07
Вход агента протух, а проверка «выполнен вход» выглядела исправной. Ввели проверку срока токена; доступ восстанавливает владелец.
30.07
Первый автоматический запуск сторожа упал из-за окружения процесса. Исправили окружение запуска: наличие проверки в коде не доказывает, что она исполняется.
Это поломки машины vibecoding.ru, не Яндекс Доставки. Первичные записи 23, 29 и 30.07.2026 перечитаны 08.10.2026; публичное описание метода на /open и в программе курса.
Отказ доступа должен быть виден. Круг закрывается, когда ответственный получил сигнал, доступ восстановлен и статусы снова сверены.
5. Агенты сдают код и проверки в репозиторий магазина.
Что получает владелец от работы агентов? Инженер ведёт машину агентов: задаёт границы, получает код и принимает его по сценариям. Доставку выполняет сервис.
На открытом счётчике машины: 7 107 коммитов за 99 дней с 1 июля 2026, срез 8 октября. Это работа на своём сайте, не замер скорости интеграции.
Что и как мы проверяли
| Факт | Что известно | Проверено |
|---|---|---|
| Создание и подтверждение | Официальные quickstart, claims/create и claims/accept Яндекс Доставки. Предложение действует 10 минут; срок повторно сверен со статусной моделью. Проверяли документацию, вызова курьера на аккаунте магазина не было. | 2026-10-08 |
| Повтор и статусы | Официальные claims/create, claims/info и статусная модель. Проверены правила request_id, сверки после уведомления и updated_ts. Таблицы приёмки составлены редакцией на основе контракта API. | 2026-10-08 |
| Доступ | Токен Доставки по quickstart бессрочный. Истории 23, 29 и 30 июля относятся к нашей машине, не к Яндексу. Перечитаны первичные записи и действующее правило проверки доступа агента. | 2026-10-08 |
| Наша работа | Живой HTML /open, срез 8 октября 2026, 01:31 МСК: 7 107 коммитов за 99 дней с 1 июля. Это коммиты основной ветки своего сайта, не число клиентских задач. Своего клиентского кейса этой интеграции нет. | 2026-10-08 |
| Оплата разработки | Живой /services: «Один проект», 250 000 ₽/мес, один поток, пауза в любой месяц, код в репозитории клиента. Сторонние сервисы и работа продукта оплачиваются отдельно. Цена месяца не является ценой одной интеграции. | 2026-10-08 |
Приёмку согласуют до работы. Агенту не нужны реальные адреса и телефоны покупателей для написания проверок; работу с данными клиентов разбираем отдельно.
На подготовленных ответах агент проверяет потерянное уведомление и повтор операции. Это позволяет проверить сбой без вызова лишнего курьера.
В журнале операции достаточно номера заказа, ID заявки, состояния и причины неуспеха. Токен доступа не должен попадать в этот журнал или интерфейс сотрудника.
Результат работы остаётся у магазина вместе с проверками.
Условия передачи кода на /services, проверено 08.10.2026; критерии приёмки редакции по документации Яндекса. Таблица описывает будущую работу.
Вызов курьера на живом аккаунте согласуют отдельно от проверок. Права на запуск и приёмка описаны в статье об ответственности за ошибки агентов.
6. Подписка оплачивает разработку, а доставки считаются отдельно.
В разработке по подписке тариф «Один проект» стоит 250 000 ₽/мес. Условия на 8 октября 2026: один продукт, одна задача в работе под управлением инженера.
Пишем создание заявки из заказа и получение статусов, проверяем доступы и повтор в коде клиента. Объём зависит от кода; фикс за месяц не является ценой одной интеграции.
Подписку можно поставить на паузу в любой месяц. Следующие правки магазина ведут той же очередью; плату за сервисы и перевозку считают отдельно.
Разработка и перевозка оплачиваются раздельно.
/services и quickstart Яндекс Доставки, проверено 08.10.2026. Стоимость перевозки не оценивалась.
Для следующего шага можно обсудить связку заказа с доставкой. Подготовьте пример заказа без данных покупателя и список действий сотрудника.
7. Частые вопросы
Это API Яндекс Маркета или Доставки?+
Здесь речь об API экспресс-доставки Яндекс Доставки в РФ. Для Маркета и межгородской доставки нужно выбрать их документацию и отдельно проверить контракт.
ИИ будет решать, кому отправлять курьера?+
Агенты здесь пишут код и проверки. Рабочая программа обращается к API по согласованным правилам магазина; подтверждение стоимости и права сотрудника задаёт компания.
Нужна ли разработка, если есть готовый модуль?+
Сначала проверьте модуль для вашей платформы. Если он уже закрывает создание, повторы и статусы, разработка своей связки нужна только для оставшихся требований.
Можно ли принять работу только по автоматическим проверкам?+
Подготовленные ответы проверяют логику повтора и статусов. Доступ аккаунта, параметры конкретного магазина и согласованный вызов курьера подтверждают отдельно перед запуском.
Источники
- Яндекс Доставка: начало работы (проверено 08.10.2026) — официальная документация
- Создание заявки, claims/create (проверено 08.10.2026) — официальная документация
- Подтверждение заявки, claims/accept (проверено 08.10.2026) — официальная документация
- Статусная модель (проверено 08.10.2026) — официальная документация
- Информация по заявке, claims/info (проверено 08.10.2026) — официальная документация
- Машина vibecoding.ru, /open (срез 08.10.2026) — публичный счётчик и описание метода
- Условия разработки по подписке (проверено 08.10.2026) — собственный оффер
- Курс «Агентная разработка» (проверено 08.10.2026) — публичная программа курса
Запомнить
- Заказывайте создание, подтверждение и получение статусов одним путём из заказа.
- Проверяйте потерю ответа: повтор той же операции сохраняет request_id.
- Принимайте завершение по нужному статусу; возврат и отмена требуют отдельного действия.
- Назначьте получателя сигнала об отказе доступа и остановке обновлений.
- Получайте код и проверки в свой репозиторий; считайте разработку и доставку отдельно.