Multi PRRO Connector for OpenCart 3.x & 4.x

Multi PRRO Connector для OpenCart — модуль фіскалізації для OpenCart 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. При поверненні замовлення у статус повернення модуль пробиває чек повернення.

Скільки коштує

Безкоштовно. Без ліцензій і платних версій — завантажуйте з OpenCart marketplace і користуйтесь на будь-якій кількості магазинів.

Технічні вимоги

• OpenCart 4.0.2 – 4.1.x (нативна збірка) або окрема збірка під OpenCart 3.0.2 – 3.0.5.0
• PHP 8.0+, MySQL 5.7+ / MariaDB 10.3+
• Обліковий запис Вчасно.Каса або Checkbox з доступом до API і зареєстрованим у податковій ПРРО
• Для зміни каси за розкладом — системний cron на сервері

Що під капотом

• 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. На вкладці каси введіть API-ключ і фіскальний номер ПРРО з кабінету Вчасно або Checkbox, натисніть «Перевірити зв’язок».
4. У загальних налаштуваннях оберіть статус-тригер, основну/резервну касу та методи оплати, що йдуть як готівка.
5. Пробийте тестовий чек на копійчаному замовленні й перевірте журнал чеків — має з’явитися рядок з фіскальним номером.

Історія версій

0.4.1 — липень 2026

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