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

Как это устроено

• Форма: Интеграции → Яндекс Доставка.
• Если интеграция включена, на экране выдачи KDS вместо «Выдать курьеру» (свои курьеры) появляется «Вызвать Яндекс».
• Один заказ = одна заявка (claim) в Яндекс Доставке.
• Точка А — адрес склада из формы; точка Б — адрес из заявки покупателя (витрина / бот).
• Доставку оплачивает магазин по договору с Яндексом; цена доставки для покупателя на витрине не меняется.
• Координаты вручную вводить не нужно: в API уходит текстовый адрес (fullname), геокодирование делает Яндекс.

Отличие от Яндекс Еды

Подробнее про Еду: справка «Яндекс Еда».

API-токен: как получить

Для Express B2B нужен Bearer-токен из личного кабинета Яндекс Доставки. Его вставляете в поле API-токен (Bearer) в форме Меркурия.

Шаги

1. Заключите договор с Яндекс Доставкой и получите доступ в личный кабинет (логин и пароль выдаёт менеджер Яндекса).
2. Откройте личный кабинет и войдите.
3. Перейдите на вкладку Интеграции.
4. В блоке «Активируйте интеграцию» нажмите Получить токен.
5. Скопируйте строку токена и вставьте в Меркурий: Интеграции → Яндекс Доставка → API-токен (Bearer) → Сохранить.

Токен также может отображаться в кабинете: Профиль компании → Токен для API (формулировка в интерфейсе Яндекса может отличаться).

Срок действия

Токен бессрочный — регулярно обновлять его не нужно. Яндекс деактивирует его, если:

• вы сменили пароль от личного кабинета dostavka.yandex.ru;
• перевыпустили или удалили токен в разделе «Интеграции»;
• токен скомпрометирован — тогда получите новый и обновите в ERP.

После смены пароля кабинета получите токен заново и сохраните в форме.

Официальная документация Яндекса

• Быстрый старт Express API
• Доступ к API (Bearer-токен)

В запросах токен передаётся так: Authorization: Bearer <ваш_токен>. Хост API: https://b2b.taxi.yandex.net.

Поля формы в ERP

Включить Яндекс Доставку

Главный рубильник. Пока выключено — на KDS работает обычная схема «Выдать курьеру» (свои курьеры).

API-токен (Bearer)

Токен из кабинета Яндекс Доставки. См. как получить. Поле типа password: при сохранении без изменения можно оставить пустым — сохранится прежнее значение.

Класс тарифа

courier, express или cargo — как в договоре и доступных тарифах вашего кабинета. Обычно для доставки еды из магазина подходит courier или express.

Термосумка / Автокурьер

Дополнительные опции заявки (cargo_options в API), если нужны по ассортименту и договору.

Адрес склада (точка забора)

Для каждого склада укажите обычный почтовый адрес магазина — улица, дом, город. Это точка А (source) в заявке Яндексу.

• Формат: «г. Город, ул. Улица, дом» — полный и однозначный адрес.
• Координаты вводить не нужно: Яндекс определит их по строке адреса.
• Название магазина из карточки склада подставляется в адрес для более точного геокодирования (как в проверенных интеграциях).

Адрес доставки клиента берётся из заявки покупателя (витрина / бот). Если в заказе только «ул. Ленина, 1» без города — система может дополнить город из адреса склада.

Вызов курьера из KDS

На станции выдачи / сборки после статуса «Собран»:

1. Нажмите «Вызвать Яндекс» — сначала приценка, затем создание заявки.
2. Следите за статусом кнопкой «Обновить».
3. При необходимости — «Отменить» до завершения доставки.
4. Доступен стикер с номером заказа и адресом для курьера.

Уведомления в бот (Telegram / MAX) при ключевых статусах заявки — если настроена дисконтная программа с ботом.

Общая настройка KDS: справка KDS.

Пошаговое включение

1. Обновите БД (миграция фирмы, см. ниже).
2. Получите Bearer-токен в кабинете Яндекс Доставки (инструкция).
3. Откройте Интеграции → Яндекс Доставка, включите интеграцию, вставьте токен, выберите тариф.
4. Укажите адрес для каждого склада-точки забора и нажмите Сохранить.
5. На KDS (выдача) откройте собранный заказ с адресом доставки и нажмите «Вызвать Яндекс».

Миграции БД

Скрипт фирмы 00169__yandex_delivery.sql (таблицы настроек и заявок, поля адреса склада). Обновление: Настройка → Состояние скриптов БД.