ГЛАВНАЯ СТРАНИЦА

Как настроить подключение к сервису Яндекс.Еда

10.1

История переиздания
30.07.2020
Первое издание
03.07.2023
Добавлено описание настройки для выбора максимального количества элементов модификатора, которые можно выбрать из группы модификатора.

Интеграция с сервисом Яндекс.Еда, далее - интеграция, позволяет получать информацию о заявках на доставку, оставленных пользователями на сайте Яндекс.Еда или в мобильном приложении, а также отправлять сведения о текущих изменениях в прейскуранте.

Интеграция позволяет:

  • Передавать данные об изменениях в прейскуранте.

  • Создавать гостевые счета на основе заявок.

  • Передавать данные стоп-листа из подразделения.

Подключение к сервису Яндекс.Еда

Требуется настроить подключение к сервису Яндекс.Еда.

В примере будет рассмотрена настройка устройства для одного подразделения с одной настройкой продаж.

Предупреждение

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

Прейскурант службы доставки находится в группе прейскуранта «Доставка Яндекс.Еда». Для вывода меню в интерфейсе Яндекс.Еда используются картинки из интернета.

В справочник Подразделения внесено необходимое подразделение, а в справочник Настройки продаж - необходимая настройка продажи.

Как создать тип заметок для ввода ссылок на изображения элементов прейскуранта?

По условиям примера картинки хранятся в интернете и доступны по ссылкам. Чтобы их использовать, нужно создать тип заметок для элементов прейскуранта. После этого для каждого элемента прейскуранта можно будет указать ссылку на файл в интернете.

В справочник Типы заметок добавьте тип заметок.

Введите название типа заметок в поле Название. Выберите значение «Строка» в поле Тип данных. Введите название поля для адреса картинки в поле Заголовок. Название дополнительной панели в карточке Элемент прейскуранта укажите в поле Заголовок панели.

Заметка должна быть уникальной, поэтому в поле Уникальная выберите значение «Да».

Значения остальных полей на панели «Свойства» можно оставить без изменений.

Рисунок 5199. Создание типа заметок

Создание типа заметок

Перейдите на панель «Объекты» и добавьте новый объект.

В поле Объект выберите значение Элемент прейскуранта.

Рисунок 5200. Создание объекта для типа заметок

Создание объекта для типа заметок

Нажмите на кнопку «OK» для добавления объекта в спецификацию.

Рисунок 5201. Результат добавления объекта в спецификацию типа заметок

Результат добавления объекта в спецификацию типа заметок

Нажмите на кнопку «OK» для сохранения нового типа заметок.

Рисунок 5202. Результат создания типа заметок для ввода веса элемента прейскуранта

Результат создания типа заметок для ввода веса элемента прейскуранта

Как создать типы заметок для ввода веса и объема элементов прейскуранта?

По условиям примера вес и объем прейскуранта можно указывать в граммах или в миллилитрах, соответственно. Чтобы получить возможность вводить эти значения, нужно создать типы заметок для веса и для объема элементов прейскуранта. После этого для каждого элемента прейскуранта можно вводить объем и вес.

Внимание

Указание веса блюда в граммах или объема в миллилитрах это обязательное требование сервиса Яндекс.Еда.

Чтобы выполнить эти требования нужно создать дополнительные поля ввода в карточке элемента прейскуранта с помощью типов заметок.

Тип заметок для ввода веса элемента прейскуранта

В справочник Типы заметок добавьте тип заметок.

Введите название типа заметок в поле Название. Выберите значение «Целое» в поле Тип данных. Введите название поля для ввода веса элемента прейскуранта в поле Заголовок. Название дополнительной панели в карточке Элемент прейскуранта укажите в поле Заголовок панели.

Заметка должна быть уникальной, поэтому в поле Уникальная выберите значение «Да».

Значения остальных полей на панели «Свойства» можно оставить без изменений.

Рисунок 5203. Создание типа заметок

Создание типа заметок

Перейдите на панель «Объекты» и добавьте новый объект.

В поле Объект выберите значение Элемент прейскуранта.

Рисунок 5204. Создание объекта для типа заметок

Создание объекта для типа заметок

Нажмите на кнопку «OK» для добавления объекта в спецификацию.

Рисунок 5205. Результат добавления объекта в спецификацию типа заметок

Результат добавления объекта в спецификацию типа заметок

Нажмите на кнопку «OK» для сохранения нового типа заметок.

Рисунок 5206. Результат создания типа заметок

Результат создания типа заметок

Тип заметок для ввода объема элемента прейскуранта

В справочник Типы заметок добавьте тип заметок.

Введите название типа заметок в поле Название. Выберите значение «Целое» в поле Тип данных. Введите название поля для ввода объема элемента прейскуранта в поле Заголовок. Название дополнительной панели в карточке Элемент прейскуранта укажите в поле Заголовок панели.

Заметка должна быть уникальной, поэтому в поле Уникальная выберите значение «Да».

Значения остальных полей на панели «Свойства» можно оставить без изменений.

Рисунок 5207. Создание типа заметок

Создание типа заметок

Перейдите на панель «Объекты» и добавьте новый объект.

В поле Объект выберите значение Элемент прейскуранта.

Рисунок 5208. Создание объекта для типа заметок

Создание объекта для типа заметок

Нажмите на кнопку «OK» для добавления объекта в спецификацию.

Рисунок 5209. Результат добавления объекта в спецификацию типа заметок

Результат добавления объекта в спецификацию типа заметок

Нажмите на кнопку «OK» для сохранения нового типа заметок.

Рисунок 5210. Результат создания типа заметок

Результат создания типа заметок

Как создать тип заметок для ввода максимального количества элементов модификатора?

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

В справочник Типы заметок добавьте тип заметок.

Введите название типа заметок в поле Название. Выберите значение «Целое» в поле Тип данных. Введите название поля для ввода веса элемента прейскуранта в поле Заголовок. Название дополнительной панели в карточке Элемент прейскуранта укажите в поле Заголовок панели.

Заметка должна быть уникальной, поэтому в поле Уникальная выберите значение «Да».

Значения остальных полей на панели «Свойства» можно оставить без изменений.

Рисунок 5211. Создание типа заметок

Создание типа заметок

Перейдите на панель «Объекты» и добавьте новый объект.

В поле Объект выберите значение Элемент прейскуранта.

Рисунок 5212. Создание объекта для типа заметок

Создание объекта для типа заметок

Нажмите на кнопку «OK» для добавления объекта в спецификацию.

Рисунок 5213. Результат добавления объекта в спецификацию типа заметок

Результат добавления объекта в спецификацию типа заметок

Нажмите на кнопку «OK» для сохранения нового типа заметок.

Рисунок 5214. Результат создания типа заметок

Результат создания типа заметок

Как настроить элементы прейскуранта?

После создания типов заметок для ввода дополнительных атрибутов элементов прейскуранта в карточке появилась вкладка «Яндекс.Еда» с полями для ввода ссылки на картинку элемента прейскуранта, его веса в граммах и объема в миллилитрах.

Откройте карточку элемента прейскуранта и перейдите на вкладку «Яндекс.Еда». Введите адрес ссылки на изображение для блюда в поле Картинка элемента прейскуранта.

Рисунок 5215. Ввод адреса изображения для элемента прейскуранта

Ввод адреса изображения для элемента прейскуранта

Введите вес блюда в поле Вес элемента прейскуранта в граммах.

Рисунок 5216. Ввод веса блюда

Ввод веса блюда

Важно

Независимо от того, какая единица измерения прейскуранта выбрана у блюда, на панели «Настройки прейскуранта» вкладки «Яндекс.Еда» нужно обязательно указать или вес в граммах, или объем в миллилитрах.

Если у блюда указаны и вес, и объем, то будет использован вес блюда, указанный в граммах.

Если ни вес в граммах, ни объем в миллилитрах не указаны, то возникнет ошибка.

Нажмите на кнопку «OK» для сохранения введенных атрибутов элемента прейскуранта.

Повторите эту операцию для остальных элементов прейскуранта из вашего меню.

Как настроить группу модификатора?

После создания типа заметок для ввода максимального количества элементов модификатора, которое можно выбрать в группе модификатора, в карточке группы модификаторов появилась вкладка «Яндекс.Еда» с полем для ввода максимального количества элементов модификатора.

Откройте карточку группы модификатора и перейдите на вкладку «Яндекс.Еда». Введите максимальное количество элементов модификатора, которые можно выбрать в одной группе модификатора.

Рисунок 5217. Ввод максимального количество элементов модификатора для выбора из группы

Ввод максимального количество элементов модификатора для выбора из группы

Нажмите на кнопку «OK» для сохранения введенных атрибутов группы модификатора.

Повторите эту операцию для остальных модификаторов из вашего меню.

Как создать устройство связи с сервисом Яндекс.Еда?

На этом этапе нужно настроить устройство для связи с сервисом Яндекс.Еда. С помощью этого устройства можно будет подключиться к базе данных заведения.

Выберите загрузчик для устройства связи с сервисом Яндекс.Еда и добавьте к нему устройство.

В поле Название введите название устройства.

В поле Программный модуль выберите Модуль связи с сервисом Яндекс.Еда .

Рисунок 5218. Создание устройства связи с сервисом Яндекс.Еда

Создание устройства связи с сервисом Яндекс.Еда

Выберите вкладку «Параметры» и введите значения параметров устройства:

  • Host – сервер базы данных.

  • Port – номер порта, используемого устройством связи с сервисом интеграции.

  • Login – логин пользователя.

  • Password – пароль пользователя.

  • AccessToken – токен авторизации.

Предупреждение

Данные учетной записи: Login и Password, а также AccessToken – предоставляются разработчиком после настройки функциональности.

Остальные параметры можно оставить без изменений.

Рисунок 5219. Настройка параметров для устройства связи с сервисом Яндекс.Еда

Настройка параметров для устройства связи с сервисом Яндекс.Еда

Выбор настройки продаж для веб-сервиса доставки

Перейдите на вкладку «Настройки». На панели «Настройка продаж» выберите настройку продаж для службы доставки.

Рисунок 5220. Выбор настройки продаж

Выбор настройки продаж

Внимание

Элементы прейскуранта, которые можно будет выбрать на POS-терминале при приеме заявки клиентов, относятся к сервисам прейскуранта из настройки продаж.

Настройка оплат для веб-сервиса доставки

Заполните поля на панели «Способы оплаты заказов».

В поле Оплата картой выберите тип оплаты для оплаты заказов банковскими картами.

Выберите тип оплаты для наличных средств в поле Оплата наличными.

Рисунок 5221. Настройка типов оплаты

Настройка типов оплаты

Выбор клиента для заявок с самостоятельным получением заказов (самовывоза)

На панели «Самовывоз» выберите постоянного клиента для заявок на доставку с самовывозом.

Рисунок 5222. Выбор постоянного клиентов для заказов с самовывозом

Выбор постоянного клиентов для заказов с самовывозом

Выбор настроек для прейскуранта

Перейдите на вкладку «Настройки» и на ней переместитесь на панель «Настройки прейскуранта». В поле Корневая группа прейскуранта выберите группу прейскуранта, из которой сервис Яндекс.Еда будет получать меню доставки.

В поле Картинка элемента прейскуранта выберите тип заметок (Картинка прейскуранта для сервиса Яндекс.Еда), с помощью которого можно будет выбрать URL-адрес для картинки, иллюстрирующей элемент прейскуранта.

В полях Вес элемента прейскуранта в граммах и Объем элемента прейскуранта в миллилитрах выберите типы заметок (Вес элемента прейскуранта для сервиса Яндекс.Еда) и (Объем элемента прейскуранта для сервиса Яндекс.Еда), с помощью которого можно будет выбрать единицы измерения для веса и объема элемента прейскуранта.

В поле Максимальное количество модификаторов выберите тип заметок (Максимальное количество модификаторов для выбора из группы), с помощью которого можно будет указать, сколько всего модификаторов можно выбрать из одной группы модификатора.

Рисунок 5223. Настройки для элементов прейскуранта

Настройки для элементов прейскуранта

Выбор настроек для доставки

На панели «Настройки доставки» выберите группу постоянных клиентов, в которую будут заноситься данные новых клиентов сервиса Яндекс.Еда, и элемент прейскуранта для оплаты стоимости доставки.

В поле Подразделение выберите подразделение, к которому относится служба доставки.

Если в заведении используются концепции, в поле Концепция выберите концепцию для службы доставки.

Если нужно сохранять номер счета, назначенный веб-сервисом Яндекс.Еда, выберите значение «Да» в поле Сохранять номер счета Яндекс.Еда.

Внесите в поле Общий номер телефона для клиентов, номер телефона, который будет указан в гостевых счетах.

Рисунок 5224. Выбор настроек для доставки

Выбор настроек для доставки

Все необходимые данные для создания устройства связи с сервисом Яндекс.Еда введены. Нажмите на кнопку «OK» для внесения устройства связи с сервисом Яндекс.Еда в справочник Устройства .

Рисунок 5225. Результат создания устройства связи с сервисом Яндекс.Еда

Результат создания устройства связи с сервисом Яндекс.Еда

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

Как создать дочернее устройство?

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

Рисунок 5226. Устройства для одного подразделения и для нескольких подразделений

Устройства для одного подразделения и для нескольких подразделений

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

Откройте справочник Устройства , выберите устройство связи с сервисом Яндекс.Еда и добавьте к нему новое устройство.

В поле Название введите название устройства.

В поле Программный модуль выберите Модуль связи с сервисом Яндекс.Еда, дочернее устройство .

Рисунок 5227. Создание дочернего устройства

Создание дочернего устройства

Выбор настройки продаж для веб-сервиса доставки

Перейдите на вкладку «Настройки».

На панели «Настройка продаж» выберите в поле настройку продаж для доставки.

Рисунок 5228. Выбор настройки продаж

Выбор настройки продаж

Выбор подразделения

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

Рисунок 5229. Выбор подразделения и концепции

Выбор подразделения и концепции

В поле Концепция выберите, если нужно, концепцию для гостевых счетов этого устройства.

Все необходимые данные для создания дочернего устройства связи с сервисом Яндекс.Еда введены. Нажмите на кнопку «OK» для внесения дочернего устройства связи с сервисом Яндекс.Еда в справочник Устройства .

Рисунок 5230. Результат создания дочернего устройства связи с сервисом Яндекс.Еда

Результат создания дочернего устройства связи с сервисом Яндекс.Еда