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: вставте ключ або запустіть пробний період на вкладці «Ліцензія».