Multi PRRO Connector — фискализация чеков для OpenCart 2.3, 3.x и 4.x

Multi PRRO Connector для OpenCart — модуль фискализации для OpenCart 2.3, 3.x и 4.x, который подключает магазин к украинским программным РРО и автоматически пробивает фискальный чек, когда заказ переходит в заданный статус (например, «В обработке» после онлайн-оплаты). Чеки, смены кассы, Z-отчёты и уведомления покупателю — всё из админки OpenCart, без ручного копирования данных в кабинет кассы.

Интегрированные кассы

• Вчасно.Каса — чеки продажи, открытие/закрытие кассовой смены с Z-отчётом, проверка ключа.
• Checkbox — чеки продажи и возврата, смены, проверка ключа.

Основная касса + резервная (fallback): если основная недоступна, чек автоматически идёт через запасную — заказ не останется без фискализации из-за сбоя одного сервиса.

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

1. Покупатель оплачивает заказ — картой онлайн или наложенным платежом; модуль сам определяет по списку методов оплаты, что фискализировать как наличные, а что как безнал.
2. Заказ переходит в статус-триггер (например, «В обработке» после callback-а платёжки).
3. Модуль формирует чек — позиции, доставка (по желанию), коды УКТЗЕД, пропуск нулевых позиций — и отправляет его в основную кассу; если она молчит, срабатывает резервная.
4. Фискальный номер возвращается в заказ и пишется в журнал чеков в админке.
5. Покупатель получает чек на email и, опционально, SMS через TurboSMS.
6. При возврате заказа в статус возврата модуль пробивает чек возврата.

Офлайн-продажи с кассы Checkbox → остатки на сайте (Pro)

Магазин, который продаёт и в точке, и на сайте, легко продаёт одну вещь дважды: товар пробили на кассе, а OpenCart всё ещё показывает его в наличии. С версии 1.2.0 Pro убирает этот разрыв: каждый фискализированный чек продажи на кассе Checkbox в магазине уменьшает количество того же товара в OpenCart, а чек возврата добавляет его обратно. Работает во всех трёх сборках — OpenCart 4.x, 3.x и 2.3.

1. Дайте товару в Checkbox тот же код, что и SKU или модель товара на сайте. Если код другой — модуль ищет по штрихкоду среди EAN, UPC, JAN, ISBN, SKU и модели.
2. На странице модуля нажмите «Офлайн-продажи», введите логин и пароль кассира и ключ лицензии кассы магазина (или оставьте поля пустыми, чтобы взять кассу с вкладки Checkbox) и нажмите «Подключить вебхук». Адрес витрины модуль регистрирует в Checkbox сам.
3. После каждого чека Checkbox вызывает сайт. Модуль проверяет подпись ключом, который выдал Checkbox, и меняет количество найденного товара.

Чеки, которые модуль сам пробил для онлайн-заказов, пропускаются — OpenCart уже списал товар при оформлении. Повторная или параллельная доставка того же чека ничего не меняет второй раз. Если код есть у нескольких товаров, позиция пропускается, чтобы не списать не тот остаток; товар, для которого выключено «Вычитать со склада», не трогается. Всё это видно в журнале «Полученные чеки» отдельной строкой по каждой позиции.

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

• API-ключи и пароли шифруются в БД через sodium_crypto_secretbox, а без расширения libsodium (типично для OpenCart 2.3 на PHP 7.0) — HMAC-потоковым шифром; значение, зашифрованное в админке, читается и в catalog-, и в cron-контексте.
• Архитектура адаптеров: общий интерфейс провайдера, реестр касс и цепочка основная → резервная.
• Управление сменой: ручные кнопки, авто-открытие на первой продаже дня и расписание через системный cron — точное время HH:MM, а не «раз в час» от планировщика OpenCart.
• Журналы в админке: отдельно чеки и отдельно смены/Z-отчёты — видно, что и когда пробилось, без входа в кабинет кассы.

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

1. Загрузите prro_connector.ocmod.zip через «Расширения → Инсталлятор». Для OpenCart 3.0.x — сборку prro_connector-oc3.ocmod.zip, для 2.3 — cc_prro-oc2.ocmod.zip.
2. OpenCart 2.3: штатный Инсталлятор той версии копирует файлы только по FTP, поэтому содержимое папки upload/ из архива заливается в корень магазина вручную, а дальше — «Расширения → Модули → Install».
3. Включите модуль в «Расширения → Модули» и откройте его настройки.
4. На вкладке кассы введите API-ключ и фискальный номер ПРРО из кабинета Вчасно или Checkbox, нажмите «Проверить связь».
5. В общих настройках выберите статус-триггер, основную/резервную кассу и методы оплаты, идущие как наличные.
6. Пробейте тестовый чек на копеечном заказе и проверьте журнал чеков — должна появиться строка с фискальным номером.