Как подключить интернет-магазин

Предварительные настройки

Получаем ключ авторизации в личном кабинете YTimes, запрашиваем GUID торговой точки, которую будете подключать к сайту (метод shop/list). GUID постоянный и не меняется со временем. Его необходимо использовать при запросе меню и создании заказов, относящихся к данной торговой точке.

Сопоставление меню

Запрещается обращаться к API при каждом просмотре каталога товаров пользователем вашего сайта. На стороне интернет-магазина должен быть свой каталог позиций. С ценами/картинками/описанием. Это может быть как полностью закешированный каталог из YTimes, так и своя структура.

Необходимо запросить меню подключаемой торговой точки (метод menu/item/list) и запомнить сопоставление позиций интернет магазина с позициями YTimes через guid каждого блюда/порции. Далее использовать эти guid при заказах.

Если в YTimes меню изменилось, информация об этом поступит через настроенный webhook. В этом случае следует еще раз запросить информацию по меню из YTimes. Так можно синхронизировать актуальную информацию по тем или иным позициям, их цены.

Создание заказов

Как только клиент делает заказ, отправляем его в YTimes методом order/save, указывая идентификаторы позиций, используемых в YTimes. При этом в ответ возвратится guid созданного заказа и его статус. Далее через подключенный webhook можно получить информацию об изменении статуса заказа (например, если кассир принял или отклонил заказ).