Catcode PRRO Connector

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