Яндекс Еда: подключение и работа с заказами
Пока подключение не активировано, переносите заказы из кабинета площадки вручную по сценарию ниже. Так кухня, выдача и учёт будут видеть заказ в cenaly.ge.
Что нужно для запуска#
Для подготовки интеграции понадобятся:
- Доступ владельца к настройкам точки и тариф Premium или Enterprise.
- Локация со страной Россия, Беларусь, Казахстан, Армения, Кыргызстан или Узбекистан: это страны показа карточки, а не гарантия подключения Яндексом.
- Меню с позициями, привязанными к нужной локации.
- Для будущего живого подключения — ID заведения, полученный от Яндекса, и согласованное подключение точки.
Для ручного переноса интеграция не нужна. Нужны доступ сотрудника к созданию заказов и кассе, настроенная кухня и «Выдача». Владелец или менеджер заранее создаёт свой способ оплаты.
Если точек несколько, проверьте выбранную локацию перед настройкой: у каждой своё подключение и свой справочник способов оплаты.
Подготовить подключение точки#
Задача этого этапа — сохранить параметры и получить адрес для будущего подключения площадки.
- Откройте «Магазин приложений» → «Мои приложения» → «Подключения по локациям».
- Выберите «Яндекс Еда» и нужную точку. Откроется блок «POS-интеграция Яндекс Еды».
- Введите «ID заведения».
- Раскройте «Расширенные настройки», проверьте параметры из таблицы и нажмите «Подключить».
- Скопируйте адрес из строки «Webhook URL для онбординга Яндекс Еды (передайте команде Яндекс Еды):» для передачи команде Яндекса при подключении.
В прежнем расположении магазина настройки были на вкладке «По локациям»; в текущем интерфейсе они находятся в «Моих приложениях».
| Поле | Для чего оно нужно |
|---|---|
| Авто-стоп-лист | Включает передачу изменений доступности распроданных позиций |
| Время приготовления по умолчанию (мин) | Задаёт базовое время приготовления для канала |
| Наценка к ценам, % | Добавляет процент к базовым ценам меню канала |
Результат: карточка хранит параметры выбранной точки. В тестовом режиме она показывает предупреждение об отсутствии активированного доступа Яндекса.
Если карточка не появилась или загрузка завершилась ошибкой, проверьте страну точки и доступ по тарифу. При ошибке загрузки нажмите «Повторить».
Подготовить меню и цены#
Операции ниже сейчас проверяются в тестовом режиме. Успешное сообщение в карточке не доказывает, что меню опубликовано на живой площадке.
- Проверьте блюда, цены, варианты и добавки в меню нужной точки.
- Для общей наценки заполните «Наценка к ценам, %».
- Для отдельных отличий используйте «Оверрайды меню канала»: задайте цену, название, описание или фото позиции; скройте позиции либо категории, которые не хотите передавать.
- Сохраните изменения оверрайдов кнопкой «Сохранить и синхронизировать». Она запускает отправку меню.
- После изменений основного меню нажмите «Отправить меню в Яндекс Еду»: автоматической повторной отправки таких изменений нет.
- Откройте «Журнал синхронизации» и проверьте результат операции.
Пустая цена в оверрайдах означает применение наценки канала. Для остальных пустых полей используется основное меню. Варианты и добавки передаются как опции-модификаторы позиции.
Для обратного направления есть «Импортировать меню из Яндекс Еды». Операция создаёт новые позиции и пропускает дубликаты; перед подтверждением убедитесь, что импортируете в нужную точку.
В блоке «Комиссии каналов» укажите свои договорные значения: процент и фиксированную сумму за заказ. Это параметры внутреннего расчёта комиссии, а не изменение договора с площадкой. Не заменяйте их примерной рыночной ставкой.
Результат: подготовлены состав меню и цены канала, результат попытки отправки виден в журнале. При ошибке смотрите таблицу устранения неполадок ниже.
Проверить обработку заказа и паузу#
Для проверки внутреннего маршрута нажмите «Создать тестовый заказ» в карточке подключения, затем «Перейти к заказам».
- Найдите заказ в «Заказах», проверьте состав и выбранную точку.
- Проверьте поступление на настроенный KDS. Если включён показ источника, карточка отображает «Яндекс Еда».
- После приготовления проверьте заказ на «Выдаче»: там предусмотрен бейдж «Яндекс Еда».
Результат: вы проверили движение тестового заказа внутри cenaly.ge. Это не проверка получения живого заказа из приложения Яндекса.
В «Заказах» у Яндекс Еды нет отдельной панели действий в сторону площадки. Не ищите здесь такие же кнопки, как у Wolt или Glovo. Действия, отправляемые в Яндекс через интеграцию, сейчас доступны только владельцу; обычная отметка готовности не заменяет подтверждение в кабинете площадки.
Для управления нагрузкой на KDS и кассе есть «Пауза приёма заказов»:
- «Занят +N мин» добавляет время приготовления.
- «Пауза 30 мин», «Пауза 60 мин» или «До конца дня» останавливают приём на выбранный срок.
Общий механизм передаёт паузу и дополнительное время также в подключение Яндекс Еды. Сейчас это тестовый обмен: доступность реальной точки контролируйте в кабинете Яндекса.
Заказы агрегатора без интеграции#
Этот сценарий подходит для любой площадки без подключения, в том числе пока ожидается активация Яндекс Еды. Заказ сначала приходит в кабинет площадки, а сотрудник создаёт его копию в cenaly.ge.
Подготовить способ оплаты#
- На кассе откройте «Внешний вид POS», найдите «Свои способы оплаты · Кнопки в окне оплаты» и нажмите «Настроить».
- Нажмите «Добавить способ», в поле «Название» введите «Яндекс Еда».
- В поле «Для кассового чека» выберите согласованный с бухгалтером вид оплаты.
- Убедитесь, что способ включён для показа на кассе, и сохраните изменения.
Результат: при оплате на кассе можно выбрать отдельный способ «Яндекс Еда», а в отчёте смены — различать такие платежи по названию. Если кнопки нет, проверьте точку и включён ли способ для показа.
Заказ забирает курьер площадки#
- Откройте заказ в кабинете агрегатора и убедитесь, что его ещё не перенесли в cenaly.ge.
- В «Заказах» откройте «Новый заказ» и выберите «Самовывоз»: для вашей точки заказ заканчивается передачей курьеру площадки.
- В поле «Имя клиента» укажите «Курьер Яндекс Еды», в поле «Телефон» — актуальный телефон поддержки площадки из вашего кабинета.
- Перенесите позиции, количество, варианты и добавки. Укажите «Ко времени», если время согласовано; пустое поле означает как можно скорее.
- Сверьте состав и сумму с кабинетом площадки и нажмите «Создать заказ».
- На кассе найдите созданный заказ в «Открытых счетах». При оформлении оплаты выберите свой способ «Яндекс Еда», если деньги приняла площадка и такой порядок согласован с бухгалтером.
- Кухня готовит заказ, сотрудник на «Выдаче» проверяет комплектность и передаёт его курьеру.
- Для самовывоза завершите выдачу действием «Выдан клиенту». Для заказа типа «Доставка» предусмотрено «Передан курьеру».
Результат: заказ проходит через кухню и выдачу, а платёж отражается выбранным способом. Статусы в кабинете агрегатора сотрудник меняет отдельно — ручной перенос не отправляет их площадке.
Если заказ отменён или изменён в кабинете площадки, отдельно внесите соответствующие изменения в cenaly.ge. Не создавайте вторую копию вместо исправления первой.
Заказ везёт ваш курьер#
- При создании выберите «Доставка».
- Укажите настоящие имя и телефон гостя, адрес и детали доставки из заказа площадки.
- Добавьте позиции и создайте заказ; назначьте своего курьера по обычному сценарию доставки.
- Если платёж приняла площадка, используйте согласованный способ «Яндекс Еда» на кассе. Если деньги принимает ваш курьер, отражайте фактический способ расчёта с гостем.
- После сборки передайте заказ курьеру и завершите доставку по факту вручения гостю.
Результат: это обычный заказ доставки с вашим курьером. Контроль заказа в кабинете агрегатора остаётся отдельной задачей сотрудника.
Ограничения#
- Интеграция Яндекс Еды пока в тестовом режиме; живые заказы и обмен с площадкой не подтверждены.
- Акции площадки, включая «подарок» и «1+1», в cenaly.ge не настраиваются. Работайте с ними в кабинете Яндекса.
- Интеграции с «Маркет Деливери» (бывший Delivery Club) нет.
- Интеграций с EdaSakhalin, Chibbis и Купером нет; используйте ручной перенос.
- В «Заказах» нет отдельной панели действий для Яндекс Еды; действия в сторону площадки ограничены владельцем.
- Изменения основного меню нужно отправлять вручную. Полная отправка не учитывает отдельный стоп-лист.
- У ручного заказа нельзя выбрать источник «Яндекс Еда». Название гостя и свой способ оплаты не превращают его в заказ канала агрегатора: различайте такие платежи по способу оплаты, а не по каналу в отчёте.
- Свой способ оплаты не отключает кассовый чек. Автоматической связи ручного заказа с кабинетом площадки нет.
Устранение неполадок#
| Симптом | Возможная причина | Что делать |
|---|---|---|
| Карточка Яндекс Еды недоступна | Страна точки или тариф не подходят | Проверьте страну локации и наличие Premium/Enterprise |
| Указано «Подключено», но живых заказов нет | Подключение работает в mock | Проверьте предупреждение карточки; до активации переносите заказы вручную |
| Меню на площадке не изменилось | Основное меню не отправлено повторно либо обмен тестовый | Нажмите «Отправить меню в Яндекс Еду», проверьте журнал и режим подключения |
| После отправки вернулась распроданная позиция | Полная отправка не учитывает стоп-лист | После «Отправить меню» проверьте стоп-лист и восстановите недоступность; живую площадку проверяйте в её кабинете |
| Не видно способа «Яндекс Еда» | Другая точка или способ скрыт | Откройте «Свои способы оплаты» нужной точки и проверьте показ на кассе |
| На KDS нет подписи канала | Скрыт источник или заказ перенесён вручную | Проверьте показ источника; ручному заказу канал агрегатора не присваивается |
| Нет кнопок подтверждения Яндекс Еды в «Заказах» | Такой панели пока нет | Работайте с живым заказом в кабинете площадки; не считайте внутренний статус ответом Яндексу |
Частые вопросы#
Нужно ли вводить Client ID и Client Secret?#
Нет. В форме точки вводится «ID заведения». Полей OAuth-секретов для пользователя здесь нет; это не означает, что партнёрский доступ уже оформлен.
Можно ли передавать только часть меню?#
Да, в «Оверрайдах меню канала» можно скрыть отдельные позиции или целые категории. Сохранение запускает синхронизацию; в текущем режиме она тестовая.
Один способ оплаты подключает агрегатор?#
Нет. Он помогает учитывать платёж по названию площадки. Заказ, его изменения и статусы сотрудник переносит вручную.
Можно ли работать с несколькими площадками?#
Для ручного учёта заведите отдельные способы оплаты, чтобы не смешивать платежи. Настройки интеграций каждой площадки и каждой точки независимы; наличие карточки не гарантирует живой обмен.