Создать облако
Создать облако
🎬 Обучающие видео 📰 Новости

Обзор возможностей Архитектура системы Быстрый старт Гостевые заказы и ассистент

Консоль управления Гена из Kitchen Drive Общие настройки Финансы Технология Закупки и остатки Маркетинг Госорганы HR Управление Брони и предоплаты Кассовые смены Настройка техники

Кассовый терминал Работа с онлайн-заказами Брони и предзаказы Работа с кассой Ведение складского учета Работа с алкоголем Управление персоналом Менеджерский блок Настройки Прочее

Начало работы и доступ Касса, связь и оборудование Меню, техкарты и наличие Склад, закупки и списания Продажи и деньги Гостевые сервисы и лояльность Уведомления и помощь
🎬 Обучающие видео 📰 Новости

Обзор возможностей Архитектура системы Быстрый старт Гостевые заказы и ассистент

Консоль управления Гена из Kitchen Drive Общие настройки Финансы Технология Закупки и остатки Маркетинг Госорганы HR Управление Брони и предоплаты Кассовые смены Настройка техники

Кассовый терминал Работа с онлайн-заказами Брони и предзаказы Работа с кассой Ведение складского учета Работа с алкоголем Управление персоналом Менеджерский блок Настройки Прочее

Начало работы и доступ Касса, связь и оборудование Меню, техкарты и наличие Склад, закупки и списания Продажи и деньги Гостевые сервисы и лояльность Уведомления и помощь
Облако и структура данных
Компоненты
Консоль управления и гостевые каналы
Терминал
MagicBox
Устройство
Телевизор
Киоск и дисплей покупателя
Как проходят настройки и операции
Обнаружение компонентов
Работа без интернета
Пример конфигурации
  1. Документация
  2. Обзор возможностей
  3. Архитектура системы

Архитектура системы

Kitchen Drive объединяет облачные сервисы и рабочие места в заведении. Через браузер настраивают меню, персонал и учёт, приложение используют для ежедневной работы, а MagicBox связывает терминалы и оборудование внутри локальной сети.

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

Облако и структура данных

Облако — пространство вашей компании в Kitchen Drive с индивидуальным префиксом, например https://<префикс>.kitchendrive.online/. В одном облаке могут работать несколько заведений.

Объект За что отвечает
Облако Общие данные компании, каталог, сотрудники, настройки подключений и биллинг.
Заведение Конкретная точка: адрес, часы работы, часовой пояс, заказы и настройки обслуживания.
Юрлицо Реквизиты продавца и настройки фискализации. В заведении может использоваться несколько юрлиц.
Цех Место приготовления, например «Кухня» или «Бар», для маршрутизации блюд и печати.
Склад Остатки и движения ингредиентов и полуфабрикатов. Одному заведению можно назначить несколько складов.

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

Компоненты

Консоль управления и гостевые каналы

Консоль управления работает в браузере и обращается к облаку через интернет. В ней настраивают заведения, каталог, права, документы, отчёты и интеграции. Для входа используются номер телефона сотрудника и код из SMS; необходим Доступ в консоль управления.

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

Терминал

Терминал — рабочее место кассира, официанта, повара или другого сотрудника с установленным приложением Kitchen Drive. Поддерживаются планшеты и телефоны на Android и iOS, а также компьютеры с macOS и Windows.

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

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

Терминал хранит рабочие данные локально и обменивается операциями с облаком либо с настроенным MagicBox. Количество зарегистрированных терминалов учитывается в биллинге облака.

MagicBox

MagicBox — локальный сервер Kitchen Drive в заведении. Его можно разместить на отдельном компьютере с Ubuntu или на компьютере с Windows, в том числе вместе с кассовым приложением. Он используется для обмена данными нескольких терминалов, подключения оборудования через сервер и работы поддерживаемых интеграций.

В конфигурации с MagicBox кассовые операции передаются с терминала на локальный сервер. Другие терминалы получают изменения внутри сети заведения, а данные передаются в облако при наличии интернет-соединения. Если MagicBox не настроен, терминалы отправляют операции непосредственно в облако.

Дополнительно через MagicBox подключают:

  • фискальный регистратор по USB;
  • оборудование, для которого выбран серверный способ связи;
  • токен и компоненты, необходимые для используемых интеграций ЕГАИС и «Честного Знака».

Наличие MagicBox позволяет терминалам обмениваться рабочими данными без интернета внутри исправной локальной сети. Для облачных настроек, онлайн-заказов и внешних сервисов сохраняются их требования к связи.

MagicBox на Windows

Кассовое приложение и MagicBox устанавливаются отдельно. Установка приложения Kitchen Drive сама по себе не запускает локальный сервер. Для MagicBox на Windows используются Docker Desktop с WSL 2 и включённая аппаратная виртуализация. Подготовку сервера, передачу USB-устройств и автозапуск согласуйте с поддержкой: mail@support.kitchendrive.online.

MagicBox можно установить на тот же Windows-компьютер, где работает касса, или на отдельный компьютер в локальной сети. Фискальный регистратор подключается к MagicBox; USB-устройства, переданные ему, в это время недоступны другим программам Windows.

После перезагрузки компьютера войдите в ту же учётную запись Windows, под которой настроены Docker Desktop и автозапуск MagicBox. Блокировать экран можно; выход из учётной записи и переход компьютера в сон прерывают работу локального сервера. Отключите автоматический сон при питании от сети. Перед началом работы проверьте связь терминалов с MagicBox и оборудованием.

Устройство

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

Устройства подключают в приложении через → Устройства. Их список и привязки также доступны в консоли: Настройка техники → Устройства.

Подключение фискальных регистраторов возможно к роутеру по Ethernet или Wi-Fi, к MagicBox по USB или к Android-терминалу по Bluetooth, если модель поддерживается. Сетевые принтеры и банковские терминалы подключаются через роутер по Ethernet или Wi-Fi. USB-подключение банковского оборудования используется в отдельной интеграции киоска; это не прямое USB-подключение к планшету.

Способ работы Как выполняются операции
Напрямую из приложения Поддерживаемое сетевое оборудование доступно приложению по выбранному драйверу или протоколу. Возможности зависят от платформы и модели устройства.
Через MagicBox Запрос к оборудованию выполняет локальный сервер. Этот способ используется, в частности, для фискального регистратора по USB.
Фискальный регистратор в списке устройств: привязанные терминалы и отметка «Связь через Magic Box»
Фискальный регистратор в списке устройств: привязанные терминалы и отметка «Связь через Magic Box»

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

Прямое подключение фискального регистратора на Android или iOS требует поддерживаемого драйвера и способа связи. Bluetooth-поиск фискальных регистраторов доступен на Android; для iOS проверяйте сетевое подключение. На Windows фискальный регистратор подключают через MagicBox. Подробности — в инструкции по устройствам.

Телевизор

TV — отдельный тип учётной записи терминала. На телевизоре можно показывать меню, изображения и видео, настроенные в ТВ-трансляциях.

Для показа электронной очереди с готовящимися и готовыми заказами настраивается связь с локальным MagicBox. Удалённые трансляции используют интернет; выбранный режим подключения проверяют при настройке TV.

Киоск и дисплей покупателя

Киоск самообслуживания позволяет гостю собрать и оплатить заказ. Для него создают отдельную учётную запись и используют API ключ киоска. Меню, цены и доступность настраивают в облаке.

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

Как проходят настройки и операции

  1. Владелец или управляющий сохраняет настройки в консоли. Они попадают в облако; приложение загружает их через интернет и сохраняет в локальном кеше.
  2. Сотрудник выполняет кассовую операцию в приложении. Она сохраняется на устройстве и передаётся на настроенный MagicBox либо напрямую в облако.
  3. В конфигурации с MagicBox локальный сервер обменивается изменениями с терминалами и передаёт данные в облако при наличии связи.
  4. Облачные документы и отчёты обновляются после приёма и обработки операций. При задержке синхронизации или расчёта данные на экранах могут отличаться по времени обновления.

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

Обнаружение компонентов

Терминалы, MagicBox и сетевое оборудование должны быть доступны друг другу в локальной сети заведения. Используйте рабочую сеть без изоляции клиентов; гостевая Wi-Fi-сеть с изоляцией для этого не подходит.

  • Подключайте рабочие устройства к роутеру заведения по Ethernet или Wi-Fi. Сотовая связь и VPN не должны перенаправлять обращения к локальному оборудованию.
  • Если точек Wi-Fi несколько, проверьте доступность устройств между ними и переход терминала между точками.
  • По возможности закрепите IP-адреса всех рабочих сетевых устройств, включая оборудование, MagicBox и кассовые планшеты или смартфоны, чтобы адреса сохранялись после перезапуска. Используйте резервирование DHCP в роутере либо согласованные статические адреса.
  • Если адрес изменился или устройство недоступно, проверьте питание и сеть, затем запустите автопочинку.

Если связи с оборудованием нет, проверьте, включён ли Wi-Fi на терминале, какую сеть он использует и совпадает ли его подсеть с подсетью оборудования. Пример для адресов 192.168.0.xxx и 192.168.1.xxx с маской 255.255.255.0 приведён в проверке локальной сети.

Работа без интернета

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

Сценарий Что происходит без интернета
Работа на уже настроенном кассовом терминале Используются данные из кеша; новые операции сохраняются локально до отправки. Доступность конкретного действия зависит от его связи с оборудованием и внешними сервисами.
Обмен между терминалами через MagicBox Продолжается внутри работающей локальной сети, если MagicBox включён и доступен.
Терминалы без MagicBox Операции накапливаются локально; для обмена через облако нужно восстановить интернет.
Консоль, сайт-витрина и гостевое приложение Не получают новые данные из отключённого заведения. Остатки и состояние операций могут быть устаревшими.
Изменения меню, прав и настроек из консоли Появятся на терминале после обновления кеша при восстановлении связи.
Банковская оплата и внешние интеграции Зависит от связи самого устройства и соответствующего сервиса. MagicBox не заменяет соединение банковского терминала с банком.

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

Для уже запущенной TV-трансляции возможно продолжение показа без интернета. После перезагрузки телевизора для повторного запуска трансляции требуется интернет; см. телевизионную рекламу.

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

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

Пример конфигурации

Для кафе с кассой, кухней и обслуживанием по столам можно использовать:

Рабочее место Как используется
Касса Планшет или компьютер Windows с приложением Kitchen Drive, банковский терминал, фискальный регистратор и нужные принтеры.
Кухня Планшет повара с раздачей и принтер заказов для кухонного цеха.
Официант Телефон или планшет с отдельной учётной записью терминала для заказов у столика.
MagicBox Локальная синхронизация этих рабочих мест и подключение поддерживаемого оборудования через сервер.
TV Меню и объявления либо электронная очередь в зависимости от выбранного режима.

Состав рабочих мест и оборудования подбирается под формат заведения. Создание учётных записей описано в Терминалах, порядок запуска — в Быстром старте.

Мы всегда на связи!
Вы можете обратиться к нам по любым вопросам, используя чат на нашем сайте.
Горячая линия
8 (800) 600-41-63
mail@support.kitchendrive.online
© 2025-2026 ООО «СИСТЕМЫ КИТЧЕН ДРАЙВ»
ОГРН 1242200017641, ИНН/КПП 2225234996/222501001
ЛИЦЕНЗИОННЫЙ ДОГОВОР ПОЛИТИКА КОНФИДЕНЦИАЛЬНОСТИ