Меркурий-ИИ

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

Яндекс Доставка: типичные проблемы

Если не получается вызвать курьера, Яндекс не принимает адрес или на экране KDS отсутствуют нужные кнопки, проверьте настройки по этой инструкции. Большинство ошибок связано с API-токеном, адресами доставки или выбранным тарифом.

Ошибка авторизации (401)

Если при обращении к Яндекс Доставке появляется ошибка 401 или сообщение о том, что токен не принят, сервис не смог авторизовать запрос.

Что проверить:

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

Получить токен можно в личном кабинете Яндекс Доставки.

Подробнее — «Как получить API-токен».

Ошибки адреса и тарифа

Яндекс не может определить адрес доставки

Такая ошибка возникает, если адрес покупателя указан неполностью или его части перепутаны.

Например, в поле улицы может оказаться сразу весь адрес с номером дома и квартиры.

Что делать:

  1. На карточке заказа в KDS нажмите «Изменить адрес».
  2. Проверьте, что улица, номер дома и квартира указаны в соответствующих полях.
  3. Исправьте адрес и повторите вызов курьера.

Если Яндекс не может определить адрес, оформить доставку не получится, пока ошибка не будет исправлена.

Неправильно указан адрес магазина

Для вызова курьера необходим не только адрес покупателя, но и адрес точки, откуда нужно забрать заказ.

Откройте «Интеграции → Яндекс Доставка» и найдите нужный склад в блоке «Склады — точка забора».

Проверьте поле «Адрес точки забора». В нём должны быть указаны город, улица и номер дома.

Если исправили адрес, нажмите «Сохранить».

Подробнее — «Адреса забора и доставки заказов».

Яндекс не нашёл подходящий тариф

Сообщение «Не найден подходящий тариф» или ошибка suitable_offer_not_found означает, что Яндекс не смог предложить доставку с указанными параметрами.

Возможные причины:

Что делать:

  1. Проверьте адрес магазина и адрес покупателя.
  2. Откройте настройки Яндекс Доставки в Меркурии.
  3. Попробуйте выбрать другой «Класс тарифа», например переключиться между курьерской и экспресс-доставкой.
  4. Если включены опции «Термосумка» или «Автокурьер», попробуйте отключить их, если это допустимо для вашего заказа.
  5. Сохраните настройки и снова нажмите «Прицениться» на KDS.

Если подходящий тариф по-прежнему не находится, возможно, Яндекс Доставка не обслуживает этот маршрут или выбранные условия доставки недоступны.

Нет кнопок Яндекс Доставки на KDS

Не отображается кнопка «Вызвать Яндекс»

Проверьте следующие условия:

  1. В разделе «Интеграции → Яндекс Доставка» установлена галочка «Включить Яндекс Доставку».
  2. API-токен получен и сохранён.
  3. Заказ находится в статусе «Собран».
  4. Вы работаете на станции сборки или выдачи KDS.

После исправления настроек повторно откройте KDS и проверьте карточку заказа.

Вместо «Вызвать Яндекс» отображается «Выдать курьеру»

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

Чтобы переключиться на Яндекс Доставку:

  1. Откройте «Интеграции → Яндекс Доставка».
  2. Включите переключатель «Включить Яндекс Доставку».
  3. Нажмите «Сохранить».
  4. Вернитесь на KDS.

Подробный порядок работы — «Вызов курьера из KDS».