Descrição
Ukrainian merchants are required to issue a fiscal receipt through a software cash register (PRRO) for every paid order. This plugin does it automatically: when an order reaches the status you choose, the receipt is sent to your PRRO service, the fiscal number is stored on the order, and the customer can be emailed or texted a link to the receipt.
Two PRRO services are supported. One acts as the primary register, the other as a fallback, so a temporary outage on one service does not leave an order without a receipt.
What it does
- Issues a fiscal receipt automatically when an order reaches the configured status (usually “Processing” after a successful payment).
- Falls back to the second PRRO service when the primary one does not answer.
- Opens and closes the register shift on a schedule, and produces the summary fiscal report on close.
- Opens the shift on the fly if a receipt is attempted while the shift happens to be closed.
- Stores the fiscal number and receipt link on the order, and shows them in a meta box on the order screen.
- Keeps a receipt log with statuses, error text and CSV export.
- Optionally emails the receipt link to the customer, in the style of your other store emails.
- Optionally sends the receipt link by SMS through TurboSMS.
- Optionally pulls orders from a KeyCRM account and fiscalizes them too — useful when part of your sales happen outside the store.
- Works with WooCommerce High-Performance Order Storage (HPOS).
Supported PRRO services
- Vchasno.Kasa — fully implemented and verified against a live account.
- Checkbox — implemented per its public API documentation; test it with the built-in “Save and test connection” button before relying on it.
Vchasno.Kasa, Checkbox, TurboSMS and KeyCRM are third-party products. This plugin is an independent integration and is not affiliated with, endorsed by, or sponsored by any of them. All trademarks belong to their respective owners.
Credentials you need
For Vchasno.Kasa: the API key from the account (Keys section) and the fiscal number of the register. For Checkbox: cashier login and password, the Checkbox license key, and the PRRO fiscal number. The credentials are stored encrypted in the site database.
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.
External services
This plugin communicates with the following external services. Nothing is sent until you enable the corresponding service and enter its credentials.
Vchasno.Kasa (kasa.vchasno.ua)
Used to register fiscal receipts and to open or close the register shift. When a receipt is issued the plugin sends the order number, the receipt lines (item name, SKU, quantity, price, tax group), the total and the payment form (cash or card). Shift commands send no order data. This happens when an order reaches the configured status, when you press the manual buttons, or when the shift schedule fires.
Terms of use: https://help.vchasno.com.ua/zagalni-polozhennya/ — Privacy policy: https://help.vchasno.com.ua/privacypolicy/
Checkbox (api.checkbox.in.ua)
An alternative PRRO service, used the same way as above: cashier sign-in, then receipt registration and shift commands. Sends the cashier login and password and the license key on sign-in, and the same receipt data as above when a receipt is issued.
Terms of use: https://checkbox.ua/oferta/ — Privacy policy: https://checkbox.ua/policy/
TurboSMS (api.turbosms.ua)
Used only when SMS delivery is enabled. Sends the customer phone number from the order and the message text (order number and the receipt link) so the receipt link can be delivered by SMS, right after a receipt has been issued.
Terms of use and privacy policy: 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)
Used only when the KeyCRM order source is enabled. The plugin reads orders and order statuses from your KeyCRM account on a schedule so that orders created outside the store can be fiscalized, and — if you turn that option on — writes the receipt link back into the order comment. Sends your KeyCRM API key with each request.
Terms of use: https://keycrm.app/terms-of-use — Privacy policy: https://keycrm.app/privacy-policy
Опис українською
Плагін виписує фіскальний чек через пРРО на кожне оплачене замовлення WooCommerce автоматично. Коли замовлення переходить у вибраний статус, чек реєструється в сервісі пРРО, фіскальний номер зберігається в замовленні, а покупцю можна надіслати посилання на касовий чек листом або SMS.
Підтримано два сервіси — Вчасно.Каса і Checkbox. Один працює як основна каса, другий як резервна, тож тимчасовий збій одного сервісу не залишить замовлення без чека.
- Автоматичний фіскальний чек при переході замовлення у потрібний статус.
- Резервна каса, якщо основна не відповідає.
- Відкриття і закриття зміни за розкладом, з Z-звітом на закритті.
- Журнал чеків зі статусами, помилками та експортом у CSV.
- Фіскальний номер і посилання на чек прямо в картці замовлення.
- Надсилання посилання на чек листом або SMS через TurboSMS.
- Фіскалізація замовлень із KeyCRM, якщо частина продажів іде повз сайт.
- Сумісність з HPOS (High-Performance Order Storage).
Плагін підходить для ФОП на спрощеній системі та для платників ПДВ — ставка податку береться з налаштувань каси. Вчасно.Каса, Checkbox, TurboSMS і KeyCRM — сторонні сервіси; цей плагін є незалежною інтеграцією і не афілійований з ними.
Інші плагіни CatCode для українських магазинів
- Нова Пошта для WooCommerce — вибір відділення й поштомата прямо в кошику, тарифи та ТТН (експрес-накладна) з кабінету НП.
- Оплата карткою через LiqPay — еквайринг ЛікПей і Приват24: платіжний модуль з Apple Pay, Google Pay і звіркою статусів.
- Сповіщення про замовлення в Телеграм — бот Телеграм пише про нові замовлення, зміну статусу й невдалі оплати.
- Синхронізація замовлень з KeyCRM — автоматичний експорт замовлень у СРМ одразу після оформлення, з повторами і журналом.
- IBAN Smart Invoice — рахунок на оплату з QR-кодом і реквізитами ФОП, кнопки Монобанк і Приват24, автопошук платежу.
Capturas de tela
Instalação
- Install and activate the plugin (WooCommerce 8.0 or newer must be active).
- Go to Cash register – Settings.
- On the Vchasno.Kasa tab (or Checkbox), set the role to “Primary register”, enter the credentials and press Save and test connection.
- On the Receipts tab, turn on Automatic receipts and pick the order status that triggers them.
- Optional: on the Shift tab enable scheduled opening and closing; on the Notifications tab enable email or SMS delivery.
- Issue a test receipt for an existing order on the Test screen and check the result on the Receipts screen.
Perguntas frequentes
-
What do I need in Vchasno.Kasa before I start?
-
Register the PRRO with the tax authority through the Vchasno account, set the tax rate (no VAT for a sole trader on the simplified system, or 20% if you are VAT-registered), and open a shift — without an open shift the API returns an error. The plugin can also open the shift itself, on a schedule or on the first sale.
-
Does the plugin change my checkout or theme?
-
No. It works in the admin area and on order hooks only. Nothing is added to the storefront or the checkout.
-
Can I issue refund receipts?
-
For Checkbox, refund receipts are supported. For Vchasno.Kasa, refunds are still done by hand in its account; an order moved to the refund status gets a reminder note instead.
-
Which tax rate ends up on the receipt?
-
For Vchasno.Kasa the tax group is set in the plugin settings and the rates themselves live in the Vchasno account. For Checkbox you can additionally set a UKTZED code per product in the product editor.
-
Is the amount on the receipt the full order total?
-
Yes — the full amount the customer paid, as required by Ukrainian law on cash registers. You can choose whether shipping and zero-priced items are added as separate receipt lines.
-
What happens if I delete the plugin?
-
WooCommerce orders are left untouched: fiscal numbers stay in the order notes, and the receipts themselves live in your PRRO account. The plugin’s own tables and options are removed.
Avaliações
Não há avaliações para este plugin.
Colaboradores e desenvolvedores
“Catcode PRRO Connector” é um programa de código aberto. As seguintes pessoas contribuíram para este plugin.
Colaboradores
Catcode PRRO Connector” foi traduzido para 1 localidade. Agradecemos aos tradutores por suas contribuições.
Traduzir o “Catcode PRRO Connector” para seu idioma.
Interessado no desenvolvimento?
Navegue pelo código, consulte o repositório SVN ou assine o registro de desenvolvimento por RSS.
Registro de alterações
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
- First public release.
- Automatic fiscal receipts through Vchasno.Kasa or Checkbox, with primary/fallback routing.
- Scheduled shift opening and closing, plus on-the-fly opening when a receipt hits a closed shift.
- Receipt log with CSV export, order meta box, email and SMS delivery of the receipt link.
- Optional KeyCRM order source.