Интеграция сайта с Яндекс Доставкой

Что можно подключить

• Расчёт стоимости доставки до оформления заказа
• Создание заявки на доставку из заказа на сайте
• Экспресс-доставку курьером по городу
• Доставку по России до двери, ПВЗ или постамата
• Выбор пункта выдачи на карте через официальный виджет
• Получение статусов доставки в вашу систему
• Отмену заявки по правилам Яндекс Доставки
• Ссылку на отслеживание курьера для покупателя (экспресс)
• Ярлыки и акты передачи (доставка по России)

Какие задачи бизнеса решает

• Показывать покупателю стоимость доставки до оплаты
• Перестать вручную переносить заказы в кабинет Яндекс Доставки
• Видеть статус доставки в своей системе, а не в отдельном кабинете

Два разных API

У Яндекс Доставки два направления с разными API, и важно сразу понять, какое нужно вам. Экспресс-доставка — курьер по городу «сейчас» или к назначенному времени. Через API считаются варианты и цена, создаётся заявка, которую нужно подтвердить; можно получить положение курьера и ссылку для отслеживания. Доставка по России — забор со склада или самостоятельная сдача, доставка до двери, ПВЗ, постамата или отделения. Через API считается стоимость, создаётся и подтверждается заказ, запрашиваются пункты выдачи, ярлыки и акты передачи.

Статусы доставки

Для экспресс-доставки можно указать адрес для уведомлений, но по документации доставка уведомлений не гарантируется — актуальный статус всё равно нужно запрашивать через API. Для доставки по России в документации уведомлений нет, статусы получаются запросами к API. Поэтому делаю регулярную сверку статусов, а не полагаюсь только на уведомления.

Оплата при получении

Оплата при получении зависит от направления. В доставке по России документирована оплата картой или через СБП при получении. В экспресс-доставке документирована оплата картой; оплата наличными в API на момент проверки документации недоступна. Подходит ли это вашей схеме — проверяем до начала работ.

Выбор ПВЗ на сайте

Для выбора пункта выдачи у Яндекс Доставки есть официальный виджет с картой и поиском по адресу: выбранный пункт возвращается на сайт и передаётся в заказ. Если виджет не подходит, можно сделать свой выбор на данных из API пунктов выдачи.

Готовый модуль или своя интеграция

У Яндекс Доставки есть готовые модули для популярных платформ — если модуля хватает, лучше взять его. Своя интеграция нужна для самописных сайтов, внутренних систем и нестандартной логики: несколько складов, своя корзина, связка с CRM.

Что нужно от вас

1. Бизнес-аккаунт Яндекс Доставки и токен для API из кабинета — подключение и договорённости с Яндекс Доставкой оформляете вы. 2. Какое направление нужно: экспресс, доставка по России или оба. 3. Адрес склада или точки отправки, вес и габариты товаров. 4. Доступ к коду сайта или системы.

Примеры функционала

• Запросы к API идут с сервера — токен не попадает в браузер
• Отладка в тестовой среде перед запуском
• Сверка статусов через API, а не только по уведомлениям
• Понятная оценка объёма до старта

Как проходит разработка

1. 1.Разбираю схему доставки: экспресс по городу, доставка по России или обе
2. 2.Проверяю доступ к кабинету Яндекс Доставки и токен для API
3. 3.Подключаю расчёт, создание заявок и получение статусов
4. 4.Тестирую в тестовой среде и переключаю на рабочий аккаунт

Используемые технологии

FAQ