Poster POS для OpenCart — заказы на кассу, меню и остатки из Poster

Poster POS для OpenCart 4.x, 3.x и 2.3 передаёт заказы магазина на кассу Poster как онлайн-заказы: кассир видит состав, сумму, телефон и комментарий и принимает или отклоняет заказ прямо на кассе. Модуль работает через официальный API Poster и подходит кофейням, пиццериям, пекарням и магазинам, которые ведут учёт в Poster.

Что нужно от Poster. Аккаунт Poster и токен раздела «Доступ → Интеграции → Личная интеграция». Одного токена хватает для одного магазина.

Что видит покупатель

Ничего нового: витрина и оформление заказа не меняются. Покупатель заказывает как обычно, а на кассе заведение получает онлайн-заказ с пометкой #OC-номер, именем, телефоном в формате +380, способом доставки и оплаты и суммой, которую заплатил покупатель.

Что получает админ

Расширения → Модули → Poster POS: вкладки «Подключение», «Заказы», «Доставка и оплата», «Статус назад», «Меню и остатки», «Расписание» и «Лицензия», а также страницы «Журнал» и «Сопоставление товаров». Вставляете токен, нажимаете «Сохранить и проверить подключение»: модуль показывает название аккаунта и валюту и заполняет список заведений. Токен хранится зашифрованным и обратно в форму не возвращается.

На вкладке «Заказы» выбираете, когда заказ уходит на кассу: сразу после оформления или только на выбранных статусах (например, когда оплачен). Правило сопоставления по умолчанию: артикул товара = код товара в Poster; можно брать модель или ID. Цены — магазинные (скидка по купону раскладывается по позициям, и касса показывает сумму, которую заплатил покупатель) или из Poster. Если товар не сопоставлен, заказ можно отправить с названием этого товара в комментарии или придержать в журнале до сопоставления; заказ, в котором не сопоставлен ни один товар, на кассу не уходит.

Страница «Сопоставление товаров» позволяет указать товар Poster вручную: ввести его ID или выбрать из списка, с поиском по названию, артикулу или модели. Значениям опций соответствует модификатор товара Poster или модификация блюда. В журнале виден каждый заказ, его состояние на кассе, ошибка человеческим языком, фильтры по состоянию, а также кнопки «Повторить», «Удалить» и «Спросить Poster». То же есть панелью на странице заказа: просмотр того, что уйдёт на кассу, «Отправить», «Отправить ещё раз» и «Спросить Poster».

Один заказ магазина — один заказ Poster: перед повторной попыткой модуль ищет пометку #OC-номер на кассе, поэтому после потерянного ответа заказ не дублируется. Сбои Poster не теряют заказ: он остаётся в очереди, а модуль повторяет попытки с нарастающей паузой.

В Pro вкладка «Меню и остатки» переносит меню Poster в каталог: вложенные категории, товары и техкарты с ценами выбранного заведения, модификаторы товаров как опцию «Вариант», наборы модификаций блюд как опции-радио или чекбоксы, по желанию фото. Импорт можно запускать повторно без дублей и поручить расписанию каждые 30 минут; товары, скрытые в заведении, отключаются. Остатки со склада Poster обновляются каждые 10 минут. Вкладка «Статус назад» читает из Poster, принял ли кассир заказ, и выставляет выбранные статусы магазина (по умолчанию «Выполнен» и «Отменён») со строкой в истории и, по желанию, письмом покупателю. Модуль опрашивает Poster раз в несколько минут в течение трёх суток после отправки.

Как это работает, шаг за шагом

1. Устанавливаете архив для своей версии OpenCart и включаете модуль.
2. В Poster копируете токен личной интеграции и вставляете на вкладке «Подключение»; выбираете заведение.
3. Артикулы товаров магазина задаёте равными кодам товаров в Poster или заполняете таблицу соответствий.
4. Оформляете заказ: он появляется на кассе Poster как онлайн-заказ.
5. В Pro импортируете меню, включаете остатки и статус назад; в кроне сервера добавляете адрес с вкладки «Расписание» каждые 5 минут.

Что под капотом

• Официальный API Poster: онлайн-заказы (incomingOrders), меню, склад, заведения; токен хранится зашифрованным.
• Один заказ — одна запись в Poster: уникальная строка очереди, пометка #OC-номер в комментарии и поиск на кассе перед повтором.
• Телефон приводится к формату +380 (код страны настраивается).
• Скидка по купону раскладывается по позициям и округляется до единицы, поэтому сумма кассы может отличаться от суммы магазина на копейки; комментарий всегда содержит сумму магазина.
• Налоги OpenCart, если они не на товарах, добавляются к доставке (или к скидке, когда доставки нет): точно для магазинов без налогов.
• Заказ в валюте, отличной от валюты аккаунта Poster, идёт суммами в основной валюте магазина.
• Импорт меню пишет в таблицы каталога напрямую, не через модель ядра: SEO URL не создаются, макеты и фильтры не меняются.
• Переключатель «отключать скрытое в заведении» включает обратно и товар, который владелец отключил вручную, если Poster его показывает.
• Статусы магазина ставятся на стороне витрины (крон, посещения), поэтому магазин без трафика и без крона получает их с опозданием.
• События OpenCart без правок ядра; при обновлении модуля настройки, журнал и лицензия сохраняются.
• Интерфейс на украинском, русском и английском.

Как установить

1. Расширения → Установка: загрузите архив для своей версии без переименования файла (OpenCart 4 — cc_poster.ocmod.zip, 3.x — cc_poster-oc3.ocmod.zip, 2.3 — cc_poster-oc23.ocmod.zip).
2. Для 3.x и 2.3: Расширения → Модификаторы → Обновить.
3. Расширения → Модули → Poster POS: установите и откройте.
4. Вставьте токен, проверьте подключение и выберите заведение.
5. Для Pro: вставьте ключ или запустите пробный период на вкладке «Лицензия».