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

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

Модуль полностью бесплатный. Скачать с официального OpenCart marketplace: opencart.com/…/extension_id=48662.

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

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

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

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

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

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

Что входит в бесплатную версию, а что в Pro

Сама фискализация бесплатна и остаётся такой: автоматический чек по статусу заказа, две кассы с резервным переключением, смены по расписанию и Z-отчёт, журнал чеков, письмо покупателю, УКТЗЕД по товарам. Это то, что уже лежит в каталоге OpenCart, и оно никуда не переезжает.

Pro-лицензия добавляет то, что нужно магазину, когда начинаются возвраты:

• Чек возврата на часть заказа. В OpenCart нет отдельной сущности возврата, поэтому сумма задаётся прямо в журнале: вернули одну позицию, доставку или произвольную сумму — модуль пробивает отдельный чек и привязывает его к чеку продажи. Несколько частичных возвратов одного заказа — несколько документов.
• Возврат через API Вчасно.Каса. Без Pro такой чек приходится пробивать руками в кабинете сервиса.
• Повтор чека из журнала. Касса была недоступна или смена закрылась — одна кнопка на строке. Чек, который уже прошёл, повторно в ПРРО не пойдёт.
• Сверка смен. Каждый Z-отчёт против суммы чеков журнала (продажи минус возвраты) с подсвеченным расхождением — именно там видно чек, пробитый мимо магазина.

Сколько стоит

2 490 грн — разовая покупка. Лицензия бессрочная: платите один раз, обновления и техническая поддержка входят в цену. Один ключ — один домен и его поддомены.

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

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

• API-ключи и пароли шифруются в БД через sodium_crypto_secretbox; значение, зашифрованное в админке, читается и в 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. Пробейте тестовый чек на копеечном заказе и проверьте журнал чеков — должна появиться строка с фискальным номером.

История версий

1.1.0 — август 2026

Появился Pro-уровень; бесплатная часть не изменилась. Pro: чек возврата на часть заказа прямо из журнала, возврат через API Вчасно.Каса вместо ручного чека в кабинете, повтор неудачного чека и сверка смен с Z-отчётом. Повторная фискализация стала идемпотентной: документ, который уже прошёл, второй раз в кассу не отправляется, а возврат всегда идёт через ту кассу, что пробила продажу.

1.0.0 — 5 августа 2026

Код УКТЗЕД теперь задаётся в карточке товара (раньше работал только код по умолчанию). Исправлена совместимость с PHP 7.4 — из-за типа mixed в обработчике события фискализация на 7.4 не срабатывала вообще. Исправлено авто-управление сменой: OpenCart выполняет все просроченные cron-задачи в одном проходе, из-за чего смена открывалась и сразу закрывалась Z-отчётом. Добавлен cron-токен для эндпоинтов смены, проверка прав на страницах и кнопке «Проверить связь», человеческие названия касс и статусов в журналах.

1.0.1 — 10 августа 2026 (OpenCart 4.x и 2.3)

Исправлен перевод сумм чека в гривну: ветка пересчёта не выполнялась вообще из-за ошибки в условии, поэтому магазин с негривневой базовой валютой пробивал чек на число базовой валюты. Проверено на стенде: заказ на 180 USD теперь идёт чеком на 7 470 грн.

1.0.0 — 10 августа 2026 (OpenCart 3.x)

Сборка для OpenCart 3.0.x подтянута до уровня версий 4.x и 2.3. Код УКТЗЕД теперь задаётся в карточке товара: таблица для него была, чек её читал, но записать код было нечем — работал только код по умолчанию. Суммы чека переводятся в гривну по курсу заказа — раньше ветка пересчёта не выполнялась вообще из-за ошибки в условии, поэтому магазин с негривневой базовой валютой пробивал чек на число базовой валюты. Значения из формы (токен кассы, пароль, cron-токен) больше не сохраняются экранированными, поэтому символы «&» и кавычки в ключах работают. Cron-эндпоинты смены получили токен, проверку времени и защиту от повторного вызова за сутки. Заметки в истории заказа и письмо покупателю теперь переводятся на язык магазина.

1.0.0 — 9 августа 2026 (OpenCart 2.3)

Отдельная сборка под OpenCart 2.3.0.0 – 2.3.0.2 с тем же функционалом. Суммы чека теперь переводятся в гривну по курсу заказа — магазин с негривневой базовой валютой пробивал чек на число базовой. Системный cron для смены кассы, защита cron-эндпоинтов токеном.

0.4.1 — июль 2026

Первый публичный релиз для OpenCart: автофискализация при смене статуса заказа, кассы Вчасно.Каса и Checkbox с fallback, чеки возврата, управление сменой (ручное, по расписанию, авто-открытие на первой продаже), журналы чеков и Z-отчётов, шифрование ключей в БД, УКТЗЕД-коды, email/SMS-чек покупателю. Сборки под OpenCart 4.0.2 – 4.1.x и 3.0.2 – 3.0.5.0.