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. Пробийте тестовий чек на копійчаному замовленні й перевірте журнал чеків — має з’явитися рядок з фіскальним номером.