Содержание
Интеграционный модуль взаимодействия с сервисом доставки еды Яндекс.Еда позволяет организовать прием и обработку доставок получаемых через сервис, настроить выгрузку меню и организовать стоп лист товаров, отображаемых на сервисе.
Перед началом работы с модулем, необходимо убедиться в наличии лицензии на продукт «Расширенный функционал личного кабинета», а также наличием лицензии «Интеграция с Яндекс.Еда» для вашей организации, т.к. работа модуля интеграции не возможна без дополнительных возможностей личного кабинета. Для того чтобы проверить наличие действующих лицензий, на веб-ресурсе личного кабинета, выберите организацию у которой необходимо проверить наличие лицензий, а затем перейдите в пункт меню «Лицензии». Будет открыта страница, представленная на рисунке 1, на которой вы можете ознакомиться о наличии лицензий, а также периоде их работы.

Рисунок 1 – Страница лицензий выбранной организации
После того как будет проверены условия наличия и действия лицензий, можно приступать к настройке интеграции.
Процесс интеграции с сервисом доставки еды Яндекс.Еда можно разделить на несколько этапов:
- 1) Настройка справочников категорий, товаров;
- 2) Настройка типов оплат для оплаты наличными, картой и номенклатуры доставки (для услуги доставки Яндекс.Еда);
- 3) Передача информации о подключении в техническую поддержку Яндекс.Еда и проведение тестирования;
Рассмотрим каждый их этапов процесса интеграции.
Внимание для работы с модулем интеграции Яндекс.Еда, у пользователя личного кабинета Interpos должно быть наличие права «Работа с Яндекс.Еда».
Настройка справочников категорий и товаров
Прежде чем приступить к добавлению товаров, необходимо настроить перечень категорий, в которых они будут находиться.
Для того чтобы создать добавить категорию, перейдите в пункт меню «Яндекс.Еда» → «Категории». Будет открыта страница, представленная на рисунке 2.

Рисунок 2 – Форма списка категорий меню Яндекс.Еда организации
Для добавления новой категории нажмите на кнопку «Создать категорию». Будет открыта форма создания и редактирования категории, представленная на рисунке 3.

Рисунок 3 – Форма создания и редактирования категории Яндекс.Еда организации
В открывшейся форме заполните поля, отмеченные символом «*». Для того чтобы из новой категории сделать подкатегорию, задайте значение параметра «Родительская категория». Если вы хотите чтобы категория имела верхний уровень, оставьте значение данного параметра пустым. После заполнения всех полей, нажмите на кнопку «Сохранить». Будет открыта страница списка категорий организации, представленная на рисунке 4.

Рисунок 4 – Форма перечня категорий Яндекс.Еда организации с созданной категорией
Для того чтоб отредактировать категорию, в колонке «Действия» таблицы категорий, нажмите на кнопку «Редактировать». После этого будет открыта страница редактирования категорий.
Для быстрого добавления подкатегории в категорию, в колонке «Действия» таблицы категорий, нажмите на кнопку «Добавить подкатегорию» напротив интересующей категории. После этого будет открыта страница создания подкатегории с уже заполненным значением параметра «Родительская категория».
Для того чтобы добавить товар в выбранную категорию, в колонке «Действия» таблицы категорий, нажмите на кнопку «Добавить позицию». После этого будет открыта форма создания нового товара с уже заполненным значением параметра «Категория». Процесс создания нового товара, будет рассмотрен далее.
Для удаления выбранной категории из перечня, в колонке «Действия» таблицы категорий, нажмите на кнопку «Удалить». Будет открыта форма подтверждения операции. В случае успешного подтверждения операция, выбранная категория, а также все подкатегории и товары, которые в них входят, будут удалены. Удаление выбранной категории, представлено на рисунке 5.

Рисунок 5 – Удаление выбранной категории
Для добавления нового товара, перейдите в пункт меню «Яндекс.Еда» → «Товары». Будет открыта страница, представленная на рисунке 6.

Рисунок 6 – Форма списка товаров меню Яндекс.Еда организации
Для добавления нового товара нажмите на кнопку «Создать товар». Будет открыта форма создания и редактирования товара, представленная на рисунке 7.

Рисунок 7 – Форма создания и редактирования товара Яндекс.Еда организации
В открывшейся форме заполните поля, отмеченные символом «*». Для того чтобы товар поместить в категорию, задайте значение параметра «Категория». При добавлении нового товара, необходимо заполнить поле «Номенклатура». Данное поле ставит в соответствие номенклатуру системы Interpos и товар в Яндекс.Еда. После выбора значения поля «Номенклатура», значения некоторых полей будет заполнено автоматически (например стоимость товара, калорийность, описание, исходя из их соответствующих значений в карточке номенклатуры Interpos. Кроме того, при заполнении данных вы можете указать, находится ли товар в стоп листе.
В случаях если товар имеет модификаторы, заполните таблицу с группами модификаторов. Для добавления новой группы модификаторов, нажмите на кнопку «Добавить». Будет добавлена новая строка с группой модификатора. Заполните значение «Название» для нового модификатора, минимальное и максимальное количество для товара. Также заполните таблицу «Модификаторы» для каждой группы модификаторов. Для добавления новой позиции в модификатор, нажмите на кнопку «Добавить». После этого будет добавлена новая строка с позицией. Выберите из списка соответствующий модификатора. Если вы случайно добавили лишний модификатор, нажмите на кнопку «Удалить». При добавлении модификатора, вы также можете указать, находится ли он в стоп листе.
Для того чтобы задать изображение товара, заполните таблицу «Изображения». Обращаем ваше внимание, что в системе Яндекс.Еда существуют определенные стандарты оформления изображений товаров. Подробнее об оформлении товаров, вы можете ознакомиться по следующей ссылке https://yandex.ru/project/photo/rules.
После заполнения всех полей, нажмите на кнопку «Сохранить». Будет открыта страница списка товаров организации, представленная на рисунке 8.

Рисунок 8 – Форма списка товаров Яндекс.Еда организации с созданным товаром
Для того чтоб отредактировать товар, в колонке «Действия» таблицы товаров, нажмите на кнопку «Редактировать». После этого будет открыта страница редактирования выбранного товара.
Для удаления выбранного товара из перечня, в колонке «Действия» таблицы товаров, нажмите на кнопку «Удалить». Будет открыта форма подтверждения операции. В случае успешного подтверждения операция, выбранный товар будет удален. Удаление выбранного товара, представлено на рисунке 9.

Рисунок 9 – Удаление выбранного товара
После того как необходимые категории и товары будут добавлены, можно приступить к следующему этапу.
Настройка типов оплат и номенклатуры доставки
Существует несколько способов доставки через систему Яндекс.Еда:
- • Доставка курьерами Яндекс.Еда;
- • Доставка курьерами ресторана/кафе
- • Самовывоз из ресторана/кафе
При этом за доставку курьерами Яндекс.Еда может взиматься комиссия за оплату доставки. Для того чтобы учитывать стоимость доставки при расчете с клиентом, необходимо создать номенклатуру, которая будет автоматически добавляться в заказ в случаях если требуется внести оплату за доставку. Для этого создайте новую номенклатуру с названием «Доставка Яндекс.Еда». Укажите у данной номенклатуры нулевую стоимость и признак свободной цены. Также укажите вид номенклатуры равный «услуга». После того как номенклатура будет создана и настроена, дождитесь её синхронизации с личным кабинетом (перед тем как создать новую номенклатуру, убедитесь что у вас включена синхронизация данных с личным кабинетом).
Далее в личном кабинете перейдите в раздел «Яндекс.Еда» → «Настройка интеграции» и задайте значение параметра «Номенклатура (услуга) для доставки» созданной номенклатурой. После этого, если в доставке от Яндекс.Еда будет присутствовать сумма оплаты доставки, в систему Interpos она будет оформлена как указанная номенклатура со стоимостью.
Также существует несколько способов оплаты заказа:
- Оплата онлайн в системе Яндекс.Еда;
- Оплата наличными курьеру ресторана;
- Оплата картой курьеру ресторана;
При оплате заказа наличными или картой курьеру ресторана, не происходит передача оплаты в систему Interpos. Вместо этого в систему попадает информация о стоимости заказа, способе оплаты которым хотел бы оплатить клиент, а также сумма, с которой необходимо получить сдачу. В данном случае оплата заказа производится тем же принципом, что и оплата обычных доставок в системе Interpos.
В случаях, если оплата заказа производится средствами системы Яндекс.Еда, необходимо задать тип оплаты, которым необходимо оплачивать такие заказы при попадании их в систему Interpos, как наличным, так и без наличным способом оплаты. Вы можете выбрать один из существующих типов оплат, но мы рекомендуем использовать новый тип оплаты, для того чтобы разграничить информацию о платежах. Создайте новый тип оплаты в системе Interpos c названием «Оплата Яндекс.Еда». Укажите для нового типа оплаты, что значение параметров «Активность», «Может приниматься извне» и «Видимость» равно «Да», а значение параметра «Ввод вручную» равно «Нет». После создания нового типа оплаты, дождитесь её синхронизации с личным кабинетом (перед тем как создать новый тип оплаты, убедитесь, что у вас включена синхронизация данных с личным кабинетом).
Далее в личном кабинете перейдите в раздел «Яндекс.Еда» → «Настройка интеграции» и задайте значение параметра «Тип оплаты для CARD оплаты Яндекс.Еда» созданным типом оплаты. После этого, если доставка была оплачена онлайн в сервисе Яндекс.Еда, в системе Interpos она будет оплачена как указанный тип оплаты. Также заполните значение «Тип оплаты для CASH оплаты Яндекс.Еда» значением «Наличные», я корректного приёма платежей наличными через систему Яндекс.Еда.
Настройка параметров «Номенклатура (услуга) для доставки», «Тип оплаты для CASH оплаты Яндекс.Еда» и «Тип оплаты для CARD оплаты Яндекс.Еда» представлено на рисунке 10.

Рисунок 10 – Настройка параметров для получения данных от системы Яндекс.Еда
По умолчанию цены, товаров выгружаемые в Яндекс.Еда автоматически не обновляются данными системы Interpos. Для того чтобы автоматически изменить стоимости у данных элементов, установите значение параметра «Обновлять стоимость товаров при синхронизации» в значение «Да». Настройка данного параметра представлено на рисунке 10.
Кроме ручного создания категорий и товаров, вы можете автоматически создавать их на основе данных системы Interpos. Обращаем ваше внимание, что при переносе данных существуют определенные требования, а именно:
- Вложенность категорий не должна превышать 2 уровня;
- Номенклатура или группа не должна относиться к следующим видам номенклатуры – «Услуга», «Модификатор», «Алкоголь маркированный», «Алкоголь не маркированный»;
- Номенклатура или группа не должны относиться к маркированной продукции;
Для переноса данных используются номенклатуры или группы, значения параметров «В корзине» равно «Нет» и «Отображать в кассе» равно «Да» соответственно.
Для автоматического создания категорий, ингредиентов и товаров, перейдите в раздел «Яндекс.Еда» → «Настройка интеграции» и нажмите на кнопку «Заполнить данными из Interpos». После этого будет открыто окно выбора категории для переноса. После выбора категории нажмите на кнопку «Выполнить» и дождитесь окончания выполнения операции. В случае успешного выполнения операции, информация о категориях, товарах и ингредиентах будет добавлена в соответствующие разделы блока «Яндекс.Еда». Заполнение данных выбранной группой товаров, представлено на рисунке 11.

Рисунок 11 – Автоматическое создание данных в разделе Яндекс.Еда на основе данных Interpos
Передача информации о подключении в техническую поддержку
После того как данные о категориях и товарах будут заполнены, необходимо передать сведения о методах обратного вызова для сервиса Яндекс.Еда. Для этого в разделе «Яндекс.Еда» → «Настройка интеграции» представлена информация о методах обратного вызова и значения параметра restaurantId, которые необходимо отправить в техническую поддержку.
Как только сведения будут переведены, можно провести тестовые испытания по обработке и получению доставок. Следуйте указаниям и рекомендациям специалистов технической поддержки Яндекс.Еда.
После успешного проведения тестирований, обмен данными с Яндекс.Еда будет завершен, можно приступать к работе.
Обработка доставки на терминале
Перед прочтением данного раздела, ознакомьтесь с общими принципами работы с доставками в разделе «Interpos.Delivery» → «Доставки».
Принцип обработки доставок полученных через систему Яндекс.Еда принципиально не отличается от работы с обычными доставками, за исключением некоторых моментов, а именно:
- • Доставка на терминал попадает в статусе «Не подтвержден»;
- • Редактирование параметров доставки, полученных из системы Яндекс.Еда, запрещено при любом статусе доставки;
- • При доставке курьером Яндекс.Еда отсутствует возможность назначения курьера;
- • При оплате доставки онлайн средствами Яндекс.Еда, отсутствует возможность отмены оплаты;