# Мастер: интернет-магазин

**Раздел:** **Настройка** (nastrojka.md)

Мастер интернет-магазина помогает последовательно подготовить Меркурий к приёму и обработке заказов через интернет. Вместо того чтобы самостоятельно искать все необходимые настройки в разных разделах программы, вы проходите несколько шагов: выбираете профиль магазина, проверяете основные данные, подготавливаете каталог, подключаете Telegram и MAX, настраиваете витрину, кухню и онлайн-оплату.

## Как устроен мастер
Откройте вкладку **«Настройка → Мастер: интернет-магазин»**. Экран разделён на две основные части.

- **Слева — список шагов.** Здесь перечислены этапы подготовки магазина. У каждого пункта отображается состояние готовности, чтобы вы могли ориентироваться в ходе настройки.
- **Справа — содержимое выбранного шага.** Здесь находятся пояснения, ссылки на соответствующие разделы, поля и кнопки, необходимые для выполнения текущего этапа.

В нижней части экрана расположены кнопки **«← Назад»** и **«Далее →»**. С их помощью можно последовательно переходить между шагами.

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

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

## Шаг 1. Профиль магазина
Первый шаг — выбор профиля. Он нужен, чтобы мастер предложил подходящий набор дальнейших настроек. У разных типов магазинов отличаются процессы приготовления, сборки и выдачи заказов, поэтому нет необходимости проходить все этапы, если часть из них вам не нужна.

Доступны три варианта.

### «Готовая еда / сборка»
Этот профиль предназначен для магазина, в котором заказы нужно собрать и подготовить к выдаче, но нет необходимости распределять приготовление по нескольким кухонным постам.

Используется одна станция KDS. Станции непосредственно на товарах указывать не требуется.

Выбирайте этот вариант, если основная задача — видеть поступившие заказы на экране сборки и отмечать их готовность.

### «Кухня с постами»
Этот профиль подходит для кухни, где разные сотрудники или участки отвечают за приготовление разных блюд и компонентов заказа.

Предусмотрена работа поваров по станциям и отдельная выдача. Для распределения блюд по рабочим участкам используются станции, указанные в технологических технико-калькуляционных картах (ТТК).

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

### «Только сайт и бот»
Этот профиль предназначен для приёма заказов через интернет-витрину и мессенджеры без использования кухонного планшета.

Заказы поступают в журнал **«Расходы → Заявки покупателей»**, где сотрудники могут просматривать их и продолжать обработку.

Выбирайте этот вариант, если вам нужен интернет-магазин, но не требуется организация работы кухни через KDS.

### Можно ли изменить профиль позже?
Да. Выбор профиля не является окончательным: его можно изменить позднее. При этом профиль влияет на набор шагов, которые мастер показывает для настройки магазина.

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

## Шаг 2. База магазина
На этом этапе проверяются основные данные, без которых интернет-магазин не сможет работать как полноценная торговая точка: юридическое лицо, склад, адрес и другие параметры.

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

Используйте эту подсказку, чтобы понять, что ещё требуется проверить или заполнить.

### Кнопка «Открыть интернет-витрину»
Открывает раздел настройки интернет-витрины. Здесь можно указать основные сведения о магазине:

- юридическое лицо с ИНН;
- склад, из которого будут использоваться цены и остатки;
- адрес магазина.

Эти сведения относятся к настройкам самой витрины. Если они ещё не заполнены, перейдите в этот раздел и внесите необходимые данные.

### Кнопка «Наши юрлица»
Открывает справочник юридических лиц. Здесь можно перейти к данным организации, которую нужно использовать для работы магазина.

Если нужного юридического лица ещё нет или его данные требуют проверки, сначала разберитесь с этим в справочнике, а затем вернитесь к настройке витрины.

Подробное описание параметров интернет-магазина приведено в статье **«Настройка и публикация интернет-витрины»** (vitrina-setup.md).

## Шаг 3. Каталог на витрину
После подготовки основных данных нужно определить, какие товары будут доступны покупателям в интернет-магазине.

Каталог витрины формируется на основе обычного ассортимента Меркурия. Отдельно заводить товары для сайта не требуется. Для публикации нужных позиций используется настройка в карточке товара.

### Кнопка «Открыть ассортимент»
Открывает справочник ассортимента. Здесь нужно отметить товары, которые должны отображаться в интернет-магазине.

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

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

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

Подробности: **«Товары на витрине»** (vitrina-assort.md).

## Шаг 4. Боты Telegram и MAX
На этом этапе настраивается возможность открывать интернет-магазин через мессенджеры. Покупатель сможет перейти к витрине из Telegram или MAX, не открывая отдельную вкладку браузера.

### WebApp для Telegram
В этом поле отображается адрес мини-приложения для Telegram. Поле доступно только для чтения, рядом находится кнопка **«Копировать»**.

Скопируйте адрес и используйте его при настройке WebApp через @BotFather.

### WebApp для MAX
Здесь отображается адрес мини-приложения для MAX. Его также можно скопировать и вставить в соответствующее поле настроек MAX.

### Галочка «Домен / URL мини-приложения проставил снаружи»
Это отметка подтверждения. Она означает, что вы самостоятельно выполнили настройку адреса WebApp во внешнем сервисе: в @BotFather для Telegram или в кабинете MAX.

Само по себе включение этой галочки не настраивает домен и не вставляет URL в мессенджер. Сначала нужно выполнить настройку во внешнем сервисе, а затем отметить её завершение в мастере.

### Кнопка «Открыть дисконт / боты»
Открывает вкладку настройки ботов в дисконтной программе. Здесь указываются токены Telegram- и MAX-ботов и выполняется их подключение к Меркурию.

Не путайте адрес WebApp с токеном бота:

- **URL WebApp** — адрес магазина или приложения, которое открывается у покупателя.
- **Токен** — ключ для подключения самого бота к Меркурию.

Для полноценной работы нужно выполнить обе части настройки: подключить бота в Меркурии и указать адрес WebApp в настройках мессенджера.

Подробные инструкции:

- **Магазин в Telegram и MAX** (vitrina-bot.md).
- **Токен Telegram-бота** (loyalty-bot-telegram.md).
- **Токен MAX** (loyalty-bot-max.md).

## Шаг 5. Интернет-витрина
На этом этапе можно посмотреть адрес интернет-магазина и перейти к его основным настройкам.

### Ссылка витрины
В поле отображается адрес опубликованной интернет-витрины. Поле доступно только для чтения, рядом находится кнопка **«Копировать»**.

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

### Кнопка «Открыть витрину»
Открывает настройки интернет-магазина. Здесь можно изменить название, параметры доставки и другие настройки, а также включить публикацию витрины.

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

Подробная инструкция: **«Настройка и публикация»** (vitrina-setup.md).

## Шаг 6. Кухня и сборка (KDS)
Этот шаг зависит от выбранного профиля магазина. Если вы выбрали работу только через сайт и бот, кухонная настройка вам не требуется. Для профилей сборки и кухни мастер предлагает соответствующие инструменты.

### Профиль «Готовая еда / сборка»
Для этого профиля предусмотрена одна станция сборки.

Здесь выбирается рабочий центр, который будет использоваться для сборки заказов. Рабочие центры относятся к производственному учёту MES.

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

Применяет режим работы KDS для сборки. Это действие позволяет включить соответствующий вариант работы одной кнопкой, не переходя вручную по всем связанным настройкам.

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

Открывает диалог со ссылками для KDS. Эти ссылки используются для доступа к экрану кухни или сборки с планшета.

### Профиль «Кухня с постами»
Для этого профиля используется полноценная настройка KDS с распределением работы по кухонным постам.

Открывает раздел настроек KDS. Здесь выполняется настройка рабочего процесса кухни.

Открывает диалог со ссылками для доступа к KDS с планшета.

Если вы выбрали профиль «Только сайт и бот», этот этап не нужен: заказы будут обрабатываться в журнале заявок покупателей.

Подробнее о работе кухонного экрана: **«KDS»** (kds.md).

## Шаг 7. Онлайн-оплата
На этом этапе настраивается приём платежей от покупателей через интернет-магазин. Для подключения платёжной системы используются параметры, которые необходимо получить и указать в настройках оплаты.

### URL уведомлений (webhook)
В этом поле отображается адрес для уведомлений платёжной системы. Поле доступно только для чтения, рядом находится кнопка **«Копировать»**.

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

### Кнопка «Открыть оплаты витрины»
Открывает вкладку **«Оплаты»** в настройках интернет-витрины. Здесь выполняется настройка платёжных параметров.

### Галочка «Пропустить оплату»
Позволяет отметить этот шаг пройденным без ввода банковских ключей.

Используйте её, если на данном этапе вы не планируете подключать онлайн-оплату. Это не подключает платёжную систему и не означает, что покупатели смогут оплачивать заказы через интернет.

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

Подробнее: **«Онлайн-оплата интернет-витрины»** (vitrina-oplata.md).

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

### Список статусов
Здесь отображаются результаты проверки настроек магазина. По ним можно понять, какие части системы уже подготовлены, а какие ещё требуют внимания.

Это не просто список пунктов, которые вы отметили вручную: состояния формируются по данным текущей конфигурации Меркурия.

### Кнопка «Обновить статусы»
Повторно запрашивает состояние настроек и обновляет список результатов. Используйте её после того, как внесли изменения в других разделах программы.

Например, вы подключили бота, включили публикацию витрины или настроили оплату. Вернитесь к проверке и нажмите «Обновить статусы», чтобы увидеть актуальное состояние.

### Кнопка «Заявки покупателей»
Открывает журнал заявок покупателей. Это удобный переход к рабочему разделу, в котором будут находиться заказы, поступающие через интернет-витрину.

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

Подробно о работе с заказами: **«Заявки покупателей»** (vitrina-orders.md).

## Переходы между шагами
Мастер позволяет перемещаться по этапам как последовательно, так и напрямую.

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

### Кнопки «← Назад» и «Далее →»
Кнопка «← Назад» возвращает к предыдущему шагу, а «Далее →» переводит к следующему этапу в последовательности, предусмотренной выбранным профилем.

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

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

Мастер объединяет основные этапы запуска интернет-магазина, но сами настройки остаются в соответствующих разделах Меркурия. При необходимости используйте подробные инструкции:

- **Интернет-витрина** (vitrina.md) — общая схема работы магазина.
- **Дисконтная программа и боты** (loyalty.md) — подключение мессенджеров.
- **KDS** (kds.md) — работа кухни и сборки.
- **Онлайн-оплата** (vitrina-oplata.md) — настройка приёма платежей.