> For the complete documentation index, see [llms.txt](https://ytimes-2.gitbook.io/ytimes-kafe/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ytimes-2.gitbook.io/ytimes-kafe/integracii/vneshnii-api/kak-podklyuchit-internet-magazin.md).

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

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

Получаем ключ авторизации в личном кабинете YTimes, запрашиваем GUID торговой точки, которую будете подключать к сайту (метод [shop/list](/ytimes-kafe/integracii/vneshnii-api/torgovye-tochki.md#shop-list)). GUID постоянный и не меняется со временем. Его необходимо использовать при запросе меню и создании заказов, относящихся к данной торговой точке.

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

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

Необходимо запросить меню подключаемой торговой точки (метод [menu/item/list](/ytimes-kafe/integracii/vneshnii-api/menyu-torgovoi-tochki.md#menu-item-list)) и запомнить сопоставление позиций интернет магазина с позициями YTimes через guid каждого блюда/порции. Далее использовать эти guid при заказах.

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

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

Как только клиент делает заказ, отправляем его в YTimes методом [order/save](/ytimes-kafe/integracii/vneshnii-api/sozdanie-zakaza.md#order-save), указывая идентификаторы позиций, используемых в YTimes. При этом в ответ возвратится guid созданного заказа и его статус. Далее через подключенный webhook можно получить информацию об изменении статуса заказа (например, если кассир принял или отклонил заказ).
