Настройка интеграции с Яндекс.Едой
15 мин
Продолжительность урока
Интеграция с Яндекс.Едой помогает нам сэкономить время. Она позволяет соединить данные между разными сервисами и платформами, а также улучшить передачу информации. В этой статье мы с вами рассмотрим интеграцию с Яндекс.
Как настроить интеграцию с Яндекс.Едой в качестве агрегатора заказов?
Есть два типа интеграции с Яндексом как с агрегатором:
Какой именно тип интеграции мы хотим использовать – мы договариваемся на юридическом уровне уже с Яндексом. Способ доставки затем определяется на стороне Яндекса.
Важно! На стороне Гуляша данный момент никак не регулируется.
Если мы хотим использовать Яндекс как агрегатор для приема заказов, нам необходимо ознакомиться с инструкцией Как настроить интеграцию заказов Яндекс Еды и Маркет Деливери с вашей ресторанной системой
Также необходимо ознакомиться с договором-офертой на оказание услуг "Яндекс Еда".
- Гость заказывает через Яндекс.Еда – везут курьеры Яндекса.
- Гость заказывает через Яндекс.Еда – везут ваши курьеры.
Какой именно тип интеграции мы хотим использовать – мы договариваемся на юридическом уровне уже с Яндексом. Способ доставки затем определяется на стороне Яндекса.
Важно! На стороне Гуляша данный момент никак не регулируется.
- Если тип заказа в системе Гуляш указан Агрегатор, то заказ повезут курьеры Яндекса, адрес не будет отображаться в системе Гуляш.
- Если тип заказа указан Доставка - 0%, то доставка будет своими силами, то есть курьерами вашего ресторана, и будет виден адрес.
Если мы хотим использовать Яндекс как агрегатор для приема заказов, нам необходимо ознакомиться с инструкцией Как настроить интеграцию заказов Яндекс Еды и Маркет Деливери с вашей ресторанной системой
Также необходимо ознакомиться с договором-офертой на оказание услуг "Яндекс Еда".
Итак, для того, чтобы подключить интеграцию с агрегатором Яндекс нам нужно выполнить следующие действия:
Первые три пункта одинаковые для всех клиентов Гуляша, вне зависимости от бренда ресторана и подразделения, то есть для каждой точки каждого ресторана они будут одинаковые. Отличается лишь id ресторана.
Для того, чтобы получить id магазина, нам необходимо перейти в раздел Справочники и выбрать подраздел Подразделения, который находится в разделе Города, подразделения, компании и бренды.
В сводной таблице мы находим необходимое нам подразделение и кликаем на карандаш справа от подразделения.
Открыв нужное подразделение, пролистываем вниз, id подразделения будет находиться там.
- Во-первых нам необходимо оставить заявку на подключение по ссылке.
- После того, как мы оставили заявку на подключение, поддержка Яндекса запустит процесс интеграции вашей системы Гуляш с Яндексом.
- После этого нам необходимо отправить в поддержку Яндекса информацию для интеграции от Гуляша:
- login/client_id: 23
- password/client_secret: 3e0cdd6acd7earhWR346REGDFG5547DFGSR5**Q
- host - https://agg-intergation.goulash.tech/yx/
- id ресторана - берем из настроек подразделения (в самом низу ID магазина для интеграций)
Первые три пункта одинаковые для всех клиентов Гуляша, вне зависимости от бренда ресторана и подразделения, то есть для каждой точки каждого ресторана они будут одинаковые. Отличается лишь id ресторана.
Для того, чтобы получить id магазина, нам необходимо перейти в раздел Справочники и выбрать подраздел Подразделения, который находится в разделе Города, подразделения, компании и бренды.
В сводной таблице мы находим необходимое нам подразделение и кликаем на карандаш справа от подразделения.
Открыв нужное подразделение, пролистываем вниз, id подразделения будет находиться там.
После добавления еще одного бренда в Гуляше, чтобы в настройке подразделения появился ID магазина нового бренда, нужно нажать Обновить.
Если нет id магазина, нам нужно найти кнопку ID магазина для интеграций и Создать. Нажимаем на Создать, появится id магазина.
Если id магазина не получается создать, то нам нужно проверить, что в настройках подразделения обязательно был выбран нужный Бренд/Бренды.
Важно! Любые вопросы, проблемы, возникающие при работе с Яндексом в первую очередь решаются через поддержку Яндекса. Если проблема на стороне Гуляша, то Яндекс отправит вам информацию (например, логи), которую нужно будет передать в поддержку Гуляша, чтобы она завела задачу на разработку.
Какие ещё настройки для Яндекса есть в Гуляше?
- Исключения блюд для агрегатора. Это настройка исключения категории блюд для Яндекса и/или исключения конкретных блюд. Например, если мы хотим, чтобы какие-то блюда были на сайте и в мобильном приложении, но гости не видели их в Яндексе, мы можем воспользоваться этой функцией.
Какие особенности работы с заказами от Яндекса?
- Требования к оформлению блюд от Яндекс.Еды:
- Требования к фотографиям. Можно ознакомиться по ссылке
- Блюда с настроенным расписанием продажи не передаются в агрегатор с учётом этого расписания. Поэтому даже если в системе блюдо временно недоступно, в агрегаторе его всё равно могут заказать. При этом в чеке оно не отобразится и повар его не увидит, поэтому рекомендуем добавлять такие позиции в Исключения блюд для агрегатора.
- В Яндекс КБЖУ блюда не передаются!
- Новые блюда появляются в Яндексе не сразу. Яндекс считывает обновления новых блюд раз в сутки (ночью). При этом можно оставить заявку на парсинг (запрос на считывание меню из вашей системы). Стоп-лист учитывается в момент получения обновленного меню, при этом отправляются только замещающие модификаторы (только два модификатора). Дополняющие модификаторы и дополнительная продукция не отправляются. С дополняющими модификаторами Яндекс не работает.
- Блюдо для экспорта должно находиться только в одной категории. Если оно добавлено сразу к две, в Яндексе появятся две категории, и одна из них будет пустой. Например, «Сет Новогодний» добавлен в категории «Сеты» и «Новогодний». В Яндексе создадутся обе категории: в «Сетах» будет блюдо, а «Новогодний» окажется пустым.
- Яндекс обновляет информацию об уже добавленных блюдах раз в несколько минут. Например, если мы поставили блюдо в стоп-лист, необходимо подождать какое-то время, пока Яндекс учтет изменения в работе системы.
- Яндекс не получает информацию о ограниченном времени показа блюд из Гуляша. Эта настройка осуществляется отдельно в Яндексе. Для получения подробной информации, пожалуйста, обратитесь в службу поддержки Яндекса.
- При оформлении заказа через Яндекс.Еду не учитывается бланк загрузки, т.е. Яндекс не смотрит, свободна в данный момент кухня или нет (нет проверки на наличие красных секций или перерывов). Это правило самого Яндекса. Время доставки определяется на стороне Яндекса (устанавливается время у зоны доставки, об этом расскажем далее в статье), а время приготовления определяется по логике: время доставки рассчитанное в Яндексе минус время доставки по умолчанию для зоны, в которой находится адрес в карте районов доставки. Но есть исключение: Если время приготовления получается меньше чем 15 минут от времени оформления, то Гуляш автоматически на приготовление даст 15минут, этим уменьшив время на доставку заказа. Советуем избегать завышения набивки на кухню, поскольку возможны дополнительные заказы из Яндекс, которые могут поступить одновременно с собственными заказами.
- Если у ресторана большая нагрузка, в Яндексе можно увеличить время приёма заказов из агрегатора или временно отключить подразделение.
- У Яндекса есть правило - гость может добавить к заказу бесплатные приборы. Когда гость в Яндексе указывает количество приборов, то эта информация не подгружается на планшеты, но видны в комментарии к заказу, который подтягивается из Яндекса. Мы взяли отображение количества персон на планшетах в работу, пока такой реализации нет, учитывайте этот нюанс в работе своего ресторана!
- Яндекс не учитывает позиции с нулевой ценой и нулевым весом из Гуляша. Если у вас есть блюдо, например, палочки, которые опубликованы с нулевой ценой, то эта позиция не будет отображаться в Яндексе.
- Дополнительные комментарии, которые гость оставляет в Яндексе, не будут отображаться на планшетах, но их можно увидеть в комментариях к заказу, который поступает из Яндекса. Это особенность работы Гуляша — поле для свободных комментариев не может быть перенесено на планшет.
- Акции и промокоды не действуют при заказе через агрегатор.
- Заказ из Яндекс.Еды нельзя редактировать, его можно только отменить. Если заказ был отредактирован в Яндекс.Еде, то в Гуляш изменения не дойдут.
- Типы оплаты
- Если везут курьеры ресторана - либо наличные, либо предоплата, если оплата не наличными.
- Типы доставки: самовывоз, доставка курьерами агрегатора, доставка курьерами ресторана.
- Комментарий к заказу:
- ID заказа в системе агрегатора;
- Количество приборов;
- Дополнительный комментарий от гостя (если есть);
- Адрес доставки (если есть).
- Если доставка производится курьерами ресторана, то будет Телефон для связи с клиентом.
Важно! (если есть) – это значит, что доставка осуществляется курьерами ресторана, в ином случае агрегатор не предоставляет эти данные.
- Могут возникнуть проблемы с отображением блюд. Важно убедиться, что у блюда указаны цена и вес. Ждем сутки, чтобы Яндекс обновил информацию.
- Яндекс сам конвертирует единицу измерения товара в г, кг, мл и л. Вес необходимо указывать в граммах, а объем в литрах.
Если доставка осуществляется курьерами вашего ресторана.
- В системе Гуляш неправильно отображается название адреса в столбике "Адрес доставки", однако при нажатии на адрес в системе Гуляш он будет отображаться корректно. В приложении курьера точный адрес можно увидеть в комментарии.
В том числе в приложении у курьера. Однако курьер увидит информацию в большом комментарии.
- Чтобы найти заказы в модуле Заказы мы используем фильтры:
Оператор - API Яндекс.Еда/API YANDEX_FOOD
- Подробная информация выгружается в комментарий.
Если доставка осуществляется курьерами Яндекса.
- В системе Гуляш не отображается информация о времени рейса курьера. Мы увидим время доставки до клиента, но система не укажет, когда курьер фактически будет на месте.
- Адрес доставки не отображается в системе Гуляш.
Имя гостя будет отображаться как Яндекс Еда. Все заказы будут сохраняться под этим именем в Справочнике гостей.
- Чтобы найти заказы в модуле Заказы используем фильтры:
Оператор - API Яндекс.Еда/API YANDEX_FOOD
Тип оплаты будет соответствовать тому, которым воспользовался гость.
- Заказы выдаются курьерам Яндекса, как и всех агрегаторов, которые доставляют курьерами сервиса, так же как и заказы на самовывоз, через Дашборд или Зал.
- Зона доставки настраивается в личном кабинете Яндекса, а не в системе Гуляш.
Чтобы настроить зону доставки, заходим в личный кабинет Яндекса, открываем вкладку Рестораны и кликаем на Зоны доставки.
Чтобы добавить новую зону доставки кликаем на Добавить зону.
Далее вносим необходимые параметры.
- Название. Придумываем и вписываем название для зоны доставки.
- Тип курьера. Выбираем тип курьеры Пеший, Вело или Авто-курьер.
- Время доставки до дальней точки зоны. Если выбираем Своё время, нужно будет указать в поле ниже количество минут, которые будут затрачены для доставки в самую дальнюю точку зоны доставки.
- Условия доставки. Указываем условия для доставки, например, минимальную сумму заказа или стоимость самой доставки. Можем добавить новые условия, кликнув на кнопку Добавить условия.
- ТурбоВот и все настроили, ждем заказы!
Понравился материал?