Catcode PRRO Connector

Опис

Українські продавці зобовʼязані видавати фіскальний чек через програмний РРО (ПРРО) на кожне оплачене замовлення. Цей плагін робить це автоматично: щойно замовлення отримує обраний вами статус, чек надсилається у ваш сервіс ПРРО, фіскальний номер зберігається в замовленні, а покупцю можна надіслати посилання на чек листом або SMS.

Підтримуються два сервіси ПРРО. Один працює як основна каса, інший — як резервна, тож тимчасовий збій одного сервісу не залишить замовлення без чека.

Що вміє плагін

  • Автоматично пробиває фіскальний чек, коли замовлення отримує налаштований статус (зазвичай «В обробці» після успішної оплати).
  • Перемикається на другий сервіс ПРРО, коли основний не відповідає.
  • Відкриває й закриває зміну каси за розкладом, а на закритті формує підсумковий фіскальний звіт.
  • Відкриває зміну на льоту, якщо чек пробивається тоді, коли зміна виявилась закритою.
  • Зберігає фіскальний номер і посилання на чек у замовленні та показує їх у метабоксі на сторінці замовлення.
  • Веде журнал чеків зі статусами, текстом помилок і експортом у CSV.
  • За бажанням надсилає покупцю посилання на чек листом, в оформленні решти листів вашого магазину.
  • За бажанням надсилає посилання на чек по SMS через TurboSMS.
  • За бажанням підтягує замовлення з акаунта KeyCRM і фіскалізує їх теж — зручно, коли частина продажів відбувається поза магазином.
  • Працює з High-Performance Order Storage (HPOS) у WooCommerce.

Підтримувані сервіси ПРРО

  • Вчасно.Каса — реалізовано повністю та перевірено на живому акаунті.
  • Checkbox — реалізовано за його публічною документацією API; перед бойовим використанням перевірте вбудованою кнопкою «Зберегти й перевірити з’єднання».

Вчасно.Каса, Checkbox, TurboSMS і KeyCRM — продукти третіх сторін. Цей плагін є незалежною інтеграцією, не афілійований з ними, не схвалений і не спонсорований жодним із них. Усі торгові марки належать їхнім власникам.

Потрібні дані доступу

Для Вчасно.Каси: API-ключ з кабінету (розділ «Ключі») та фіскальний номер каси. Для Checkbox: логін і пароль касира, ліцензійний ключ Checkbox і фіскальний номер ПРРО. Дані доступу зберігаються в базі сайту в зашифрованому вигляді.

Free and Pro

Everything the plugin did before stays free. A Pro licence from catcode.com.ua adds the parts a shop needs once refunds start happening:

  • Refund receipts for partial refunds — one receipt per WooCommerce refund, with the lines and amount that actually went back.
  • Return receipts through the Vchasno.Kasa API, instead of issuing them by hand in the provider cabinet.
  • Retrying receipts from the log: one row, or every failed row at once.
  • Shift reconciliation: each Z-report against the receipts this plugin issued, with the difference flagged.

A 7-day trial can be started from the Licence screen; no card, nothing renews on its own.

Зовнішні сервіси

Цей плагін звʼязується з наведеними нижче зовнішніми сервісами. Нічого не надсилається, доки ви не увімкнете відповідний сервіс і не введете дані доступу до нього.

Вчасно.Каса (kasa.vchasno.ua)
Використовується для реєстрації фіскальних чеків і відкриття або закриття зміни каси. При пробитті чека плагін надсилає номер замовлення, рядки чека (назва товару, артикул, кількість, ціна, податкова група), суму та форму оплати (готівка або картка). Команди зміни не надсилають даних замовлення. Це відбувається, коли замовлення отримує налаштований статус, коли ви натискаєте кнопки вручну або коли спрацьовує розклад зміни.
Умови використання: https://help.vchasno.com.ua/zagalni-polozhennya/ — Політика конфіденційності: https://help.vchasno.com.ua/privacypolicy/

Checkbox (api.checkbox.in.ua)
Альтернативний сервіс ПРРО, використовується так само: вхід касира, далі реєстрація чеків і команди зміни. На вході надсилає логін і пароль касира та ліцензійний ключ, а при пробитті чека — ті самі дані чека, що й вище.
Умови використання: https://checkbox.ua/oferta/ — Політика конфіденційності: https://checkbox.ua/policy/

TurboSMS (api.turbosms.ua)
Використовується лише тоді, коли увімкнено надсилання SMS. Одразу після пробиття чека надсилає номер телефону покупця із замовлення й текст повідомлення (номер замовлення та посилання на чек), щоб доставити посилання на чек по SMS.
Умови використання й політика конфіденційності: https://turbosms.ua/privacy.html

CatCode licence server (catcode.com.ua)
Used only for the optional Pro licence. When you start the trial or activate a key, the plugin sends that key (or the e-mail you typed for the trial) and your site address to https://catcode.com.ua/wp-json/catcode/v1/license and …/trial, and once a day re-checks that the key is still valid. Nothing is sent while the plugin runs in its free form.
Terms of use: https://catcode.com.ua/terms/ — Privacy policy: https://catcode.com.ua/privacy/

KeyCRM (openapi.keycrm.app)
Використовується лише тоді, коли увімкнено джерело замовлень KeyCRM. Плагін за розкладом читає замовлення та їхні статуси з вашого акаунта KeyCRM, щоб фіскалізувати замовлення, створені поза магазином, і — якщо ви увімкнете цю опцію — записує посилання на чек назад у коментар до замовлення. З кожним запитом надсилається ваш API-ключ KeyCRM.
Умови використання: https://keycrm.app/terms-of-use — Політика конфіденційності: https://keycrm.app/privacy-policy

Опис українською

Плагін виписує фіскальний чек через пРРО на кожне оплачене замовлення WooCommerce автоматично. Коли замовлення переходить у вибраний статус, чек реєструється в сервісі пРРО, фіскальний номер зберігається в замовленні, а покупцю можна надіслати посилання на касовий чек листом або SMS.

Підтримано два сервіси — Вчасно.Каса і Checkbox. Один працює як основна каса, другий як резервна, тож тимчасовий збій одного сервісу не залишить замовлення без чека.

  • Автоматичний фіскальний чек при переході замовлення у потрібний статус.
  • Резервна каса, якщо основна не відповідає.
  • Відкриття і закриття зміни за розкладом, з Z-звітом на закритті.
  • Журнал чеків зі статусами, помилками та експортом у CSV.
  • Фіскальний номер і посилання на чек прямо в картці замовлення.
  • Надсилання посилання на чек листом або SMS через TurboSMS.
  • Фіскалізація замовлень із KeyCRM, якщо частина продажів іде повз сайт.
  • Сумісність з HPOS (High-Performance Order Storage).

Плагін підходить для ФОП на спрощеній системі та для платників ПДВ — ставка податку береться з налаштувань каси. Вчасно.Каса, Checkbox, TurboSMS і KeyCRM — сторонні сервіси; цей плагін є незалежною інтеграцією і не афілійований з ними.

Інші плагіни CatCode для українських магазинів

Скріншоти

Встановлення

  1. Встановіть і активуйте плагін (має бути активним WooCommerce 8.0 або новіший).
  2. Перейдіть у Каса – Налаштування.
  3. На вкладці Вчасно.Каса (або Checkbox) задайте роль «Основна каса», введіть дані доступу й натисніть Зберегти й перевірити з’єднання.
  4. На вкладці Чеки увімкніть Автоматичні чеки та оберіть статус замовлення, який їх запускає.
  5. За бажанням: на вкладці Зміна увімкніть відкриття й закриття за розкладом, на вкладці Сповіщення — надсилання на email або SMS.
  6. Пробийте тестовий чек для наявного замовлення на вкладці Тест і перевірте результат на вкладці Чеки.

Часті питання

Що потрібно налаштувати у Вчасно.Касі перед стартом?

Зареєструйте ПРРО в податковій через кабінет Вчасно, задайте ставку податку (без ПДВ для ФОП на спрощеній системі або 20%, якщо ви платник ПДВ) і відкрийте зміну — без відкритої зміни API повертає помилку. Плагін також може відкривати зміну сам: за розкладом або на першому продажу.

Чи змінює плагін оформлення замовлення або тему?

Ні. Плагін працює лише в адмінці та на хуках замовлень. На вітрину чи сторінку оформлення замовлення нічого не додається.

Чи можна пробивати чеки повернення?

Для Checkbox чеки повернення підтримуються. Для Вчасно.Каси повернення поки що оформлюються вручну в кабінеті; замовлення, переведене в статус повернення, натомість отримує нотатку-нагадування.

Яка ставка податку потрапляє в чек?

Для Вчасно.Каси податкова група задається в налаштуваннях плагіна, а самі ставки живуть у кабінеті Вчасно. Для Checkbox можна додатково вказати код УКТЗЕД для кожного товару в редакторі товару.

Чи дорівнює сума в чеку повній сумі замовлення?

Так — уся сума, яку сплатив покупець, як того вимагає законодавство України про РРО. Ви можете обрати, чи додавати доставку та позиції з нульовою ціною окремими рядками чека.

Що станеться, якщо видалити плагін?

Замовлення WooCommerce залишаються недоторканими: фіскальні номери лишаються в нотатках замовлення, а самі чеки — у кабінеті вашого ПРРО. Власні таблиці й налаштування плагіна видаляються.

Відгуки

Для цього плагіна немає відгуків.

Учасники та розробники

“Catcode PRRO Connector” — проект з відкритим вихідним кодом. В розвиток плагіну внесли свій вклад наступні учасники:

Учасники

“Catcode PRRO Connector” було перекладено на 1 локалізацію. Дякуємо перекладачам за їх роботу.

Перекладіть “Catcode PRRO Connector” на вашу мову.

Цікавитесь розробкою?

Перегляньте код, перегляньте сховище SVN або підпишіться на журнал розробки за допомогою RSS.

Журнал змін

1.1.0

  • Refund receipts for partial refunds: every WooCommerce refund gets its own return receipt with the lines that actually went back (Pro).
  • Return receipts through the Vchasno.Kasa API instead of issuing them by hand in the cabinet (Pro).
  • Retry a failed receipt — one row or every failed row — straight from the receipts log (Pro).
  • Shift reconciliation screen: each Z-report against the receipts this plugin issued, with the difference highlighted (Pro).
  • Refunds of an order and their fiscal state are shown in the order meta box.
  • Licence screen with a 7-day trial for the Pro features. Everything that was free stays free.

1.0.2

  • Upgrades from the pre-1.0.0 builds now carry the receipt journal, shift log and KeyCRM order map over to the renamed tables. Without it those screens looked empty after the update and an order that already had a receipt could be fiscalized twice.
  • Uninstall now removes the plugin’s own tables (they kept their old names in the uninstall handler and stayed in the database forever).
  • The internal version constant was left at 1.0.0, so the upgrade routine never ran on update.

1.0.1

  • Ukrainian translation refreshed; shift statuses on the Shifts screen are now translatable.
  • readme: Ukrainian description and keywords.

1.0.0

  • Перший публічний реліз.
  • Автоматичні фіскальні чеки через Вчасно.Касу або Checkbox з маршрутизацією основна/резервна каса.
  • Відкриття й закриття зміни за розкладом, а також відкриття на льоту, коли чек потрапляє на закриту зміну.
  • Журнал чеків з експортом у CSV, метабокс у замовленні, надсилання посилання на чек листом і SMS.
  • Необовʼязкове джерело замовлень KeyCRM.