Кухня · бар · касса · склад
Каждая позиция —
на своё рабочее место
Как настроить несколько принтеров, проверить маршруты и подготовить локальную печать.
Подключить принтер без JSON и копирования ключа
Доступно всем сотрудникам POS с доступом к этой кассе и компании. Нужны помощник Windows 1.0.3 и модуль печати 20.0.3.1.3. Для первой настройки нужен интернет. Помощник и WEB-касса должны работать на одном компьютере; телефоны подключаются по инструкции ниже.
- Один раз установите помощник Windows 1.0.3. Установщик содержит Python. Быстрое подключение запускается из кассы. Вручную открытый помощник также принимает ссылку из кассы — скачивать JSON для этого не нужно.
- Откройте в кассе ☰ → Настроить принтеры. Выберите существующий принтер либо «Добавить принтер по IP».
- Для нового принтера введите название и его локальный IP, выберите бумагу 58/80 мм и назначение. Для кухни или бара отметьте категории товаров. Автоматического поиска принтеров в сети в этом выпуске нет.
- Нажмите «Подготовить подключение» → «Открыть помощник». Разрешите браузеру открыть приложение ELPOS.
- В окне Windows проверьте адрес сайта и базу. Нажмите «Подключить и доверять сертификату». Это разрешает установку личного сертификата только для текущего пользователя Windows.
- Вернитесь в ту же вкладку кассы и нажмите «Завершить подключение». Ключ передаётся автоматически; корзина и вкладка не перезагружаются. Чековый принтер выбирается для этой кассы.
- Нажмите «Напечатать тест» и проверьте бумагу. Настройка не печатает чек сама.
Если окно помощника не открылось
- Нажмите «Проверить подключение». Проверка показывает, принял ли помощник ссылку и завершена ли настройка на стороне помощника; она не печатает чек и не подтверждает наличие бумаги.
- Нажмите «Копировать ссылку». Если браузер не разрешил копирование, выделите показанную ссылку и скопируйте вручную. Не отправляйте её посторонним: она содержит временный код.
- Откройте «Настроить печать ELPOS» из меню «Пуск». Вставьте ссылку в поле «Ссылка из кассы» и нажмите «Открыть подключение». JSON не нужен.
- Проверьте сайт и базу, подтвердите настройку и вернитесь в кассу к кнопке «Завершить подключение». Если прошло пять минут, создайте новую ссылку.
Надпись о готовности помощника ещё не означает, что касса подключена или бумага напечатана. Завершите подключение, затем выполните отдельный тест печати. Для этих действий нужен помощник версии 1.0.3 или новее; прежняя установленная программа сама не обновляется.
При повторном подключении сохраняются локальный ключ, журнал и адрес работающего локального помощника. Для ранее настроенного сетевого режима используйте «Дополнительно». Общая демобаза сбрасывается ежедневно: постоянную настройку оборудования выполняйте в собственной клиентской базе.
К началу ↑Как распределять позиции
Назначайте принтер рабочему месту: «Горячий цех», «Холодный цех», «Бар — зал», «Бар — терраса», «Сборка — склад». Названия и количество выбираете вы.
Категории определяют, кто готовит или собирает товар. Зал уточняет, какой из одинаковых баров обслуживает заказ. Складская локация Odoo отвечает за остатки; её не нужно создавать для каждого кухонного принтера.
На телефоне широкую таблицу можно сдвинуть вбок.
| Рабочее место | Категории POS | Залы | Что получает |
|---|---|---|---|
| Горячий цех | Супы, горячие блюда | Все | Основное задание |
| Холодный цех | Салаты, холодные закуски | Все | Основное задание |
| Бар — зал | Напитки | Основной зал | Напитки этого зала |
| Бар — терраса | Напитки | Терраса | Напитки террасы |
| Сборка — склад | Товары для выдачи | Все | Задание собрать товары |
| Контроль — раздача | Супы, горячие блюда, салаты | Все | Дополнительная копия |
| Касса — чек | Не фильтруются | Не ограничивают чек | Полный чек покупателя |
Если в одном зале два бара, разделите ассортимент: например, «Кофе» и «Коктейли». Если оба бара делают одинаковые напитки одного зала, не назначайте обоим одинаковый основной маршрут: оба получат задание. Автоматический выбор «менее занятого бара» здесь не реализован.
Пустой список залов означает все залы. Пустой список категорий не означает «печатать всё»: назначьте нужные категории явно. Учитываются категории POS и их родители. Категория бухгалтерского или складского справочника не заменяет категорию POS.
Настроить принтеры и категории
- Руководитель открывает настройки нужной кассы и её принтеры. Для каждого физического устройства создаёт отдельную запись с понятным названием.
- Для кухонных заданий выбирает назначение «Подготовка». Для полного чека покупателя — принтер чеков. В переводах штатного интерфейса этот тип может называться «Поступления».
- Для сетевого ESC/POS выбирает «ESC/POS LAN — бесплатный помощник», вводит IP принтера, его порт и реальную ширину бумаги 58 или 80 мм. Обычно порт — 9100; проверьте настройки устройства.
- У рабочего места выбирает категории POS, при необходимости — залы. Для контрольного экземпляра включает дополнительную копию.
- В карточках товаров проверяет категории POS. Если блюдо относится к нескольким основным маршрутам, каждая подходящая станция получит свою позицию.
- Сохраняет настройки и обновляет данные кассы, пока интернет доступен. На каждом устройстве проверяет актуальный список принтеров.
Для одного горячего цеха и двух баров не нужны три кассы. Они могут быть тремя принтерами одной кассы. Один физический принтер лучше представлять одной записью: дубли записей с одинаковым IP способны дать два задания.
Открыть полный снимок ↗В demo откройте меню кассы → «Настроить принтеры»: скачивание помощника и «Инструкция по установке» находятся внутри. Отдельная плитка установки убрана; в ещё не обновлённых базах она может сохраняться. На снимках предыдущего выпуска они объединены под названием «Принтеры: чеки, кухня, бар».
Проверить маршрут без печати
- В веб-кассе откройте меню → «Настроить принтеры».
- Раскройте «Куда пойдёт товар?», выберите зал и найдите товар по названию.
- Проверьте список основных рабочих мест и дополнительных копий.
- Если основного маршрута нет, исправьте категории или зал. Если основных маршрутов несколько, проверьте, действительно ли все должны готовить этот товар.
- Повторите проверку для супа, салата, напитка каждого зала и товара для выдачи. Этот просмотр не создаёт заказ и не печатает билет.
Для заказа без выбранного зала подходят только маршруты без ограничения по залам. Проверка маршрута использует текущие данные этой кассы; после изменения настроек загрузите их заново.
К началу ↑Выбрать чековый принтер
Маршрутизация блюд и полный чек покупателя решают разные задачи. В чеке покупателя остаётся весь заказ; категории его не разделяют.
- В меню «Настроить принтеры» выберите чековый ESC/POS-принтер с назначением для чеков. Для других типов используйте штатный выбор принтера кассы.
- Нажмите «Использовать для чеков покупателя».
- Проверьте бумагу, соединение и пробную печать на этом устройстве.
- Если нужна автоматическая печать после оплаты, включите штатную настройку кассы.
Выбор сохраняется для этой кассы в браузере. На другом компьютере или в другом браузерном профиле проверьте его отдельно. Текущие задания сохраняют исходный принтер: смена выбора не перенаправляет уже начатую печать.
Повторный экземпляр ранее отправленного чека оформляйте как явную копию. Если результат первой попытки неизвестен, сначала проверьте бумагу.
К началу ↑Выбрать способ подключения
| Откуда печатаете | Путь к принтеру | Что должно работать без интернета |
|---|---|---|
| Браузер на компьютере | Браузер → локальный HTTPS-помощник → ESC/POS | Компьютер с помощником, сеть, принтер |
| Приложение Elpos на телефоне | Приложение → сетевой ESC/POS напрямую | Телефон, локальная сеть, принтер; главный компьютер для этого пути не нужен |
| Браузер на телефоне | Браузер → компьютер с помощником → принтер | Помощник, доверенный сертификат и разрешение локальной сети на телефоне |
| Обычный офисный принтер | PDF/A4 → системная печать | Драйвер или служба печати ОС и доступ к принтеру |
Отсутствие внешнего интернета не должно отключать роутер или локальную Wi-Fi-сеть. Гостевая сеть с изоляцией устройств для такой печати не подходит. Закрепите адреса принтеров и компьютера в роутере.
Помощник поставляется для Windows, macOS и Linux. На SUNMI с Android используется приложение и поддерживаемый путь печати; Windows-помощник на SUNMI не устанавливается. Наличие SUNMI само по себе не превращает его в сервер печати для браузеров других устройств.
Установить локального помощника
Windows: установка без команд
Скачать помощник для Windows 10/11, 64 бит
Версия 1.0.3. Python входит в комплект. Установка для текущего пользователя Windows. Контрольная сумма файла.
Для браузера на этом компьютере используйте быстрое подключение кнопкой из кассы. Скачивать JSON и копировать ключ для него не нужно.
Дополнительно: ручная настройка через JSON или облачная печать
- Запустите установщик. По завершении откроется мастер; позднее его можно открыть через «Пуск» → «ELPOS» → «Настроить печать ELPOS».
- В Odoo откройте настройки кассы и карточку нужного принтера. Укажите IP и порт принтера. Нажмите «Подключить помощник» и скачайте JSON-файл.
- В мастере нажмите «Выбрать JSON принтера…». Проверьте адрес Odoo, базу и IP принтера.
- Для печати через интернет выберите «Через Odoo». Для браузера этого компьютера при обрыве интернета выберите «Локально на этом компьютере» и подтвердите доверие личному сертификату ELPOS.
- Нажмите «Подключить и включить автозапуск». Помощник запускается сразу, затем при входе этого пользователя в Windows. Компьютер должен оставаться включённым, без сна во время работы кассы.
- Для локальной печати откройте в кассе «Настроить принтеры». Выберите тот же принтер, импортируйте локальный файл из папки настройки помощника либо введите адрес и локальный ключ. Нажмите «Подключить» и «Проверить связь».
- Нажмите «Напечатать тест» и проверьте бумагу. Для кухни назначьте категории товаров и зал; для чеков выберите чековый принтер.
«Проверить без печати» проверяет файл и доступность сайта Odoo, но не выход бумаги. Подключение запускает помощник и продолжает сохранённую очередь.
WEB-касса с телефона через компьютер
Если помощник уже установлен в режиме «Локально на этом компьютере», установите версию 1.0.3 поверх неё. Повторно откройте мастер, выберите тот же JSON принтера и режим «Локально с телефонов в сети магазина». Укажите IP компьютера, а не принтера: в приведённом примере компьютер 192.168.0.41, принтер 192.168.0.23:9100. Отметьте доступ из частной сети, доверие CA и сверку старой очереди. Нажмите «Подключить и включить автозапуск». Старый журнал, ключ и CA сохраняются; новый сертификат содержит IP компьютера.
Экспортируйте публичный CA из мастера и установите доверие на каждом телефоне; на iPhone дополнительно включите полное доверие сертификату в настройках. Компьютер и телефон должны видеть друг друга в сети магазина; для Windows разрешите входящий TCP-порт помощника 18443 только в частной сети. В браузере телефона откройте demo-кассу при наличии интернета, затем в меню кассы «Настроить принтеры» укажите адрес вида https://192.168.0.41:18443 и локальный ключ из мастера. Нажмите «Подключить», «Проверить связь», затем «Напечатать тест» и сверьте бумагу. После переноса снова подключите по этому же LAN-адресу и WEB-кассу на компьютере. Кнопка «Тест» в серверной карточке принтера проверяет облачный путь и не заменяет локальный тест в кассе.
Несколько принтеров и телефоны
Повторите подключение для каждого принтера. Для локальной печати используйте разные HTTPS-порты: 18443, 18444 и далее. Для браузеров телефонов выберите режим локальной сети, укажите закреплённый IP компьютера и разрешите доступ из частной сети. Экспортируйте публичный сертификат кнопкой мастера и настройте доверие на телефонах. Входящий порт разрешается только для сети сотрудников; мастер не меняет брандмауэр. Приложение ELPOS может печатать прямо на совместимый сетевой принтер без помощника.
Обновление и удаление
Обновляйте поверх прежней установки под тем же пользователем Windows. Настройки, локальные ключи и журнал заданий сохраняются. Удаление программы сохраняет журнал и настройки. Не удаляйте их вручную, пока есть неразобранные задания.
Установщик пока без цифровой подписи издателя. Если политика компьютера блокирует неподписанные программы, обратитесь к администратору. Загружайте файл только с этого сайта.
Для специалиста: установка из исходников и команды
Распакуйте архив в постоянную папку, например C:\ElposPrint. В Проводнике откройте эту папку, в адресной строке введите powershell и нажмите Enter. Команды ниже выполняйте по одной. Они не требуют отключения защиты Windows или изменения политики выполнения PowerShell.
1. Проверить Python
py -3 --versionНужна версия 3.10 или новее. Если команда не найдена, установите Python с официального сайта вместе с Python Launcher. Затем заново откройте PowerShell.
2. Подготовить локальную печать, работающую без интернета
Этот шаг требует подготовленного доверенного сертификата. Сначала руководитель скачивает файл принтера через «Подключить помощник». В примере ниже замените имя этого файла, название базы, IP компьютера, адрес сайта кассы и пути к сертификату и ключу. Не вставляйте пример без замены значений. IP после --bind принадлежит компьютеру с помощником; IP самого принтера уже записан в скачанном файле.
py -3 setup_local_bridge.py "C:\ElposPrint\printer-12.json" --output "C:\ElposPrint\printer-12-local.json" --database "restaurant" --bind 192.168.10.20 --allow-lan --port 18443 --origin "https://pos.example.com" --certificate "C:\ElposPrint\bridge.pem" --private-key "C:\ElposPrint\bridge-key.pem"Сертификат должен содержать IP компьютера и быть доверенным на каждом устройстве. Команда не создаёт доверие к сертификату и не настраивает брандмауэр. Доступ к порту разрешается только из сети сотрудников. Для следующего принтера используйте другой выходной файл и порт, например 18444. Уже существующий выходной файл команда не перезаписывает.
3. Установить и запустить помощник
py -3 install.pyОткроется выбор файла. Для локальной печати выберите подготовленный printer-12-local.json. Для печати только через интернет можно выбрать обычный файл printer-12.json из Odoo, пропустив шаг 2: при недоступном сервере такой режим не печатает. Двойной щелчок по Install.bat выполняет ту же установку.
После установки помощник запускается сразу и при входе пользователя Windows. Откройте в кассе «Настроить принтеры», импортируйте локальный файл или введите адрес и локальный ключ, затем нажмите «Подключить», «Проверить связь» и «Напечатать тест». Установщик не назначает категории кухни и не выбирает чековый принтер за вас.
Открыть полный снимок ↗macOS и Linux
Используйте архив исходников и README внутри; нужен Python 3.10+. В macOS запустите Install.command, в Linux используйте команду из README. Для локальной печати специалист готовит доверенный HTTPS-сертификат и отдельный порт каждого принтера.
Для локальной кухни подключите к помощнику все основные принтеры и принтеры копий, действующие в выбранном зале. Смешанный набор локальных и облачных кухонных маршрутов блокируется, чтобы часть заказа не осталась без задания.
Локальный ключ отличается от облачного ключа. Импорт файла читает настройку на устройстве; файл содержит секреты и должен оставаться закрытым. Для телефона в нативном приложении при прямой сетевой печати файл помощника не нужен.
Если браузер запрашивает доступ к локальной сети, разрешите его для кассового сайта. Ошибку сертификата необходимо исправить настройкой доверия, а не отключением проверки HTTPS.
Помощник не хранит общие заказы ресторана и не раздаёт сайт кассы. После очистки браузера нельзя рассчитывать на первый запуск веб-кассы без интернета.
К началу ↑Проверить каждый принтер
- Выберите нужное устройство по имени. Проверьте назначение, IP, бумагу и маршрут.
- «Проверить связь» проверяет помощника и соответствие его настройки. Это ещё не доказательство выхода бумаги.
- «Напечатать тест» создаёт отдельный пробный отпечаток. Проверьте, из какого устройства он вышел, кириллицу, поля, ширину и отрезку.
- «Проверить очередь» уточняет состояние прежних заданий. Уже переданные задания заново не печатаются.
- Повторите для каждого цеха, бара, склада и чекового принтера.
Открыть полный снимок ↗Успешная передача означает приём байтов сетевым соединением принтера. Закончилась бумага, открыта крышка или неисправен нож — это проверяется на устройстве.
| Результат | Действие |
|---|---|
| Ожидает отправки / подтверждения | Восстановите соединение и проверьте ту же очередь. Не создавайте новый заказ. |
| Передано | Уточните бумажный результат. Повтор — только явно обозначенная копия. |
| Результат неизвестен | Спросите кухню или проверьте бумагу. Автоматический повтор заблокирован, поскольку первое задание могло дойти. |
| Помощник или принтер заменён | Сначала разберите старые задания. Не удаляйте журнал ради повторного подключения. |
Работать при обрыве интернета
Новый режим рассчитан на сохранение заказа на том устройстве, где его ведёт сотрудник. Браузер сохраняет данные в IndexedDB, приложение — в локальной базе. Это не общая база для нескольких устройств в локальной сети. В нативном приложении локальный заказ оформляется отдельно и не занимает общий серверный стол.
- Заранее откройте кассу онлайн, загрузите каталог и настройки, подтвердите сотрудника. Подключите принтеры и проверьте готовность офлайн-запуска.
- При обрыве связи продолжайте только поддерживаемые операции на исходном устройстве. В приложении используйте отдельный локальный заказ; изменение общего серверного заказа требует связи.
- Отправляйте позиции на локальные принтеры. Дополнения и отмены проверяйте по их отдельным билетам, а не повторной отправкой полного заказа.
- После перезапуска используйте тот же профиль браузера или ту же установку приложения. Снова подтвердите сотрудника. Не очищайте данные, не переустанавливайте приложение и не переключайте клиентскую базу до разбора очереди.
- После возвращения интернета дождитесь синхронизации исходных заказов и кухонных событий. Ранее переданные локальные билеты не должны печататься снова.
- Если появилась ошибка прав, закрытая смена, конфликт или расхождение суммы, передайте исходную операцию руководителю. Не оформляйте повторную оплату вместо её проверки.
Если результат печати неизвестен, сначала проверьте бумагу и уточните у станции получение задания. В меню принтеров нажмите «Отметить проверку бумаги» и подтвердите проверку. Эта отметка сохраняет исходный неизвестный результат и разрешает заменить помощник; она не печатает чек заново. Ожидающие задания сначала нужно разобрать. Если требуется повтор, используйте отдельную явную копию.
После первой локальной отправки сохраняйте зал, категории и маршруты этого заказа. Если программа сообщает об изменении маршрута, верните исходную настройку и разберите заказ. Уже отправленное блюдо нельзя молча передать другому бару сменой фильтра.
Без общего локального сервера телефон и компьютер не получают мгновенно изменения друг друга при недоступном Odoo. Один офлайн-заказ ведёт одно устройство. Возможность телефона печатать напрямую не означает совместное редактирование стола без интернета.
Сложные сценарии — подачи и курсы, поштучное разбиение кухонных билетов в нативном офлайн-режиме, партии и серийные номера, комбо, возвраты, CRM-заказы, бонусы, чаевые, объединение общих столов — не следует считать доступными офлайн. Программа должна явно остановить неподдерживаемую операцию. Успешная локальная печать также не подтверждает фискализацию или банковскую оплату.
Склад: сборка и перемещение
У принтера «Склад» могут быть две задачи. Название принтера не определяет документ автоматически.
| Документ | Для чего | Влияние на учёт |
|---|---|---|
| Задание на сборку | Показывает товары, которые нужно подготовить для заказа. Маршрут по категориям может направлять такие позиции на складское рабочее место. | Сама печать не проводит продажу и не списывает остатки. |
| Документ перемещения | Печатает данные существующей операции Odoo: источник, назначение, позиции, количества и состояние. | Статус и движение определяет исходный документ Odoo. Печать не подтверждает отправку или приёмку. |
Для частичной отправки сверяйте запрошенное, отправленное и оставшееся количество. Выбирайте конкретную существующую складскую операцию, а не перепечатывайте весь запрос как будто он полностью отправлен. Новую складскую операцию без сервера этот режим печати не создаёт.
Распечатать существующую заявку или перемещение
- При доступном сервере откройте колокольчик и нужную заявку или отправку.
- Нажмите «Печать документов».
- Выберите «Лист сборки» или конкретное складское перемещение по номеру и состоянию.
- Выберите подключённый принтер 58/80 мм либо «A4 · системный диалог печати».
- Сверьте дату снимка, количества и состояние. При повторе прежнего снимка на том же устройстве используйте явную копию; при неизвестном результате сначала проверьте бумагу.
Для получения свежего снимка документа требуется сервер. Форматы 58 мм, 80 мм и A4 проверены программно на учебных данных; бумажная проверка ещё не проводилась. Действия входят в новый выпуск, до его установки используйте штатную печать Odoo.
К началу ↑Проверка перед началом работы
- Составьте таблицу всех рабочих мест, IP, категорий, залов и ролей копий. У каждого принтера должен быть ответственный.
- Проверьте маршруты: суп — только горячему цеху, салат — холодному, напиток каждого зала — своему бару. Контрольная копия должна быть помечена.
- На учебном заказе проверьте отправку, добавление одной позиции, отмену и копию. Сверьте фактическое количество билетов и блюд.
- Отключите только внешнее интернет-соединение, сохранив локальную сеть. Проверьте чек и кухню с компьютера и телефона.
- Перезапустите браузер, приложение и компьютер помощника. Убедитесь, что исходный заказ и очередь сохранились.
- Восстановите интернет. В Odoo проверьте один заказ и его оплаты; на кухне не должно быть повторной автоматической печати.
- Проверьте неопределённый результат: сотрудник должен сначала сверить бумагу, затем при необходимости выбрать копию.
Запишите версии, дату, модели устройств и результат. Пробные операции проводите в учебной базе или по согласованному регламенту точки.
К началу ↑