# Яндекс Доставка

Курьер Яндекс Доставки из чата: цена, заявка и трекинг

Курьерская доставка: расчёт цены, заявки на курьера сегодня, доставка по России, ПВЗ, трекинг

## Как агент работает с Яндекс Доставка

Агент работает с API Яндекс Доставки по токену из личного кабинета dostavka.yandex.ru. Экспресс-доставка идёт через заявки: агент считает варианты доставки по координатам точек, весу и габаритам, создаёт заявку, читает её оценку и ведёт её по статусам до вручения. Для доставки в другой день он ищет пункты выдачи, считает стоимость и интервалы и читает заказы логистической платформы.

Создание заявки у Яндекса ещё не вызов курьера. Сначала сервис оценивает заявку и называет цену, которая держится около десяти минут, и только подтверждение запускает поиск исполнителя и списание. Поэтому агент создаёт заявку, дожидается статуса готовности к подтверждению и показывает вам итог целиком: откуда, куда, тариф, цену и срок. Подтверждает он только после вашего явного да, а если цена успела устареть, пересчитывает её и спрашивает снова.

Отмену агент тоже начинает с вопроса к сервису: до прибытия курьера она бесплатна, после прибытия платная, а после передачи груза возможна только через поддержку. Условие отмены вы видите до того, как агент её выполнит. Каждой новой заявке агент даёт свой ключ идемпотентности и повторяет его только при сбое сервера, чтобы за одним заказом не приехали два курьера.

Координаты точек агент передаёт в порядке долгота, широта, габариты в метрах, вес в килограммах, телефоны в формате +7: иначе заявка не пройдёт оценку. Частота запросов держится в пределах пяти в секунду.

## Сценарии интеграции

### Цена до вызова курьера
Агент посчитает варианты доставки по адресам, весу и габаритам и покажет цену, окно забора и время доставки ещё до создания заявки.

### Курьер на сегодня
Агент создаст заявку, дождётся оценки и покажет итоговую цену, адреса и срок, а подтвердит её только после вашего согласия.

### Где сейчас курьер
Агент поднимет статус заявки, прогноз прибытия на каждую точку и ссылку для отслеживания, которую можно отправить получателю.

### Доставка по России
Агент подберёт пункт выдачи рядом с получателем, рассчитает стоимость и срок и оформит заказ со склада после вашего подтверждения.

### Отмена без сюрпризов
Агент сначала узнает, бесплатна ли отмена прямо сейчас, и скажет об этом до того, как отменять заявку.

### Сводка по заявкам
Агент соберёт заявки за период с их статусами и ценой и покажет, какие зависли на поиске курьера или вернулись отправителю.

## Как подключить

**Перед подключением**

- Договор с Яндекс Доставкой и доступ к личному кабинету
- Ваше подтверждение на каждую платную заявку и отмену

### Войдите в личный кабинет
Откройте dostavka.yandex.ru и войдите с логином и паролем, которые выдал менеджер Яндекс Доставки.

### Получите токен
На вкладке «Интеграция» в разделе «Активируйте интеграцию» нажмите «Получить токен» и скопируйте его.

### Вставьте токен
Вставьте токен в поле подключения. После смены пароля кабинета токен перестанет работать, его нужно получить заново.

## Частые вопросы

### Как подключить Яндекс Доставку?
Токеном из личного кабинета dostavka.yandex.ru: вкладка «Интеграция», раздел «Активируйте интеграцию», кнопка «Получить токен». Токен бессрочный, но перестаёт работать после смены пароля кабинета.

### Что агент видит в Яндекс Доставке?
Заявки на экспресс-доставку с их статусами, ценой и маршрутом, положение курьера и ссылки для отслеживания, а также заказы доставки по России, пункты выдачи и расчёт стоимости.

### Может ли агент сам заказать курьера?
Агент создаёт заявку и показывает цену, адреса и срок, а подтверждает её, то есть запускает курьера и оплату, только после вашего согласия. Платную отмену он тоже согласует с вами.

### Заявка уйдёт реальному курьеру?
Да, коннектор работает с боевым кабинетом: подтверждённая заявка зовёт настоящего курьера и списывает деньги. Поэтому агент называет цену с НДС, адреса и срок и подтверждает заявку только после вашего согласия.

[Открыть Яндекс Доставка](https://dostavka.yandex.ru)
