Description
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.
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
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
Installation
- 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.
FAQ
-
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.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Catcode PRRO Connector” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Catcode PRRO Connector” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
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.