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.