CatCode PRRO Connector – Fiscal Receipts via Vchasno Kasa & Checkbox for WooCommerce

By CatCode

0+ active installationsVersion 1.2.1

PRRO fiscal receipts for WooCommerce orders through Vchasno Kasa or Checkbox: fallback register, shift schedule, receipt link by email or SMS.

Description

Ukrainian online stores have 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 registered in Vchasno.Kasa or Checkbox, the fiscal number is stored on the order, and the customer gets a link to the receipt by email or SMS.

Connect both services and one works as the primary register, the other as a fallback, so a short outage of one service does not leave an order without a receipt.

What it does

  • Fiscal receipt issued automatically when an order reaches the chosen status (usually “Processing” after payment), or by hand from the order screen.
  • Fallback to the second PRRO service when the primary one does not answer.
  • Shift opened and closed on a schedule, with the closing (Z) report; the shift is also opened on the fly if a receipt hits a closed shift.
  • Fiscal number and PDF link in a box on the order screen.
  • Receipt log with service and status filters, error text, PDF links and CSV export.
  • Refund receipt when an order is moved to the refund status (Checkbox).
  • Cash or card payment form on the receipt, based on the payment method; shipping and zero-priced items as receipt lines or not.
  • UKTZED code per product.
  • Receipt link to the customer by email (in the style of your store emails) or by SMS through TurboSMS.
  • Optional KeyCRM source: paid orders from KeyCRM are fiscalized too, for sales that happen outside the store.
  • Compatible with WooCommerce HPOS. Nothing is added to the storefront or the checkout.

Credentials you need

Vchasno.Kasa: the API key from the account and the fiscal number of the register. Checkbox: cashier login and password, the license key and the PRRO fiscal number. Credentials are stored encrypted. The “Save and test connection” button checks them right away.

Pro edition

The Pro edition on catcode.com.ua adds refund receipts for partial refunds, refunds through the Vchasno.Kasa API, retrying failed receipts from the log, shift reconciliation against the Z-report and offline Checkbox sales that reduce stock on the site. This free plugin works on its own and has no time limit.

Vchasno.Kasa, Checkbox, TurboSMS and KeyCRM are third-party services. This plugin is an independent integration and is not affiliated with, endorsed by, or sponsored by any of them.

External services

Nothing is sent until you enable a service and enter its credentials.

Vchasno.Kasa (kasa.vchasno.ua) — registers fiscal receipts and opens or closes the shift. A receipt sends the order number, receipt lines (item name, SKU, quantity, price, tax group, UKTZED code), the total and the payment form. Shift commands send no order data. Sent when an order reaches the configured status, when you press a manual button, or when the shift schedule fires.
Terms: https://help.vchasno.com.ua/zagalni-polozhennya/ — Privacy: https://help.vchasno.com.ua/privacypolicy/

Checkbox (api.checkbox.in.ua) — the same use: cashier sign-in (login, password, license key), then receipts and shift commands with the same receipt data.
Terms: https://checkbox.ua/oferta/ — Privacy: https://checkbox.ua/policy/

TurboSMS (api.turbosms.ua) — only when SMS delivery is on: the customer phone number and the message text (order number and receipt link), right after a receipt is issued.
Terms and privacy: https://turbosms.ua/privacy.html

KeyCRM (openapi.keycrm.app) — only when the KeyCRM source is on: orders and statuses are read on a schedule and, if enabled, the receipt link is written back into the order comment. Your KeyCRM API key is sent with each request.
Terms: https://keycrm.app/terms-of-use — Privacy: https://keycrm.app/privacy-policy

ПРРО для WooCommerce — опис українською

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

  • Автоматичний фіскальний чек після оплати або вручну з картки замовлення.
  • Основна і резервна каса: якщо Вчасно.Каса не відповідає, чек іде через Checkbox, і навпаки.
  • Відкриття і закриття зміни за розкладом, Z-звіт на закритті, автоматичне відкриття зміни при першому продажу.
  • Журнал чеків зі статусами, помилками, PDF і експортом у CSV.
  • Чек повернення при переході замовлення в статус повернення (Checkbox).
  • Форма оплати готівка/картка за способом оплати, доставка окремим рядком чека, код УКТЗЕД для товару.
  • Посилання на чек листом або SMS через TurboSMS.
  • Фіскалізація замовлень з KeyCRM, якщо частина продажів іде повз сайт.

Підходить для ФОП без ПДВ і для платників ПДВ: податкова група береться з налаштувань каси. У Pro-версії на catcode.com.ua є чеки часткових повернень, повернення через API Вчасно.Каса, повтор чека з журналу, звірка змін із Z-звітом і офлайн-продажі з каси Checkbox, що списують залишки на сайті.

Вчасно.Каса, Checkbox, TurboSMS і KeyCRM — сторонні сервіси; плагін є незалежною інтеграцією і не афілійований з ними.

Installation

  1. Install and activate the plugin (WooCommerce must be active).
  2. Go to Cash register → Settings.
  3. On the Vchasno.Kasa or Checkbox tab set the role to “Primary register”, enter the credentials and press Save and test connection.
  4. On the Receipts tab turn on automatic receipts and pick the order status that triggers them.
  5. Optional: on the Shift tab enable the schedule; on the Notifications tab enable email or SMS.
  6. Issue a test receipt on the Test screen and check it under Receipts.

FAQ

Where do I get the Vchasno.Kasa API key?

In the Vchasno.Kasa account, in the Keys section or on the register card under “Trade points and registers”. You also need the fiscal number of the register as registered with the tax authority.

What do I need for Checkbox?

The cashier login and password, the license key of the register and its PRRO fiscal number, all from the Checkbox account.

Do I need an open shift?

The PRRO service rejects receipts while the shift is closed. The plugin can open and close the shift on a schedule and also opens it by itself if a receipt is issued during a closed shift.

Can I issue refund receipts?

With Checkbox, yes: moving an order to the refund status issues a refund receipt linked to the sale receipt. With Vchasno.Kasa the refund is done by hand in its account, and the order gets a reminder note.

Which tax rate ends up on the receipt?

The tax group is set in the plugin settings; the rates themselves live in your PRRO account (no VAT for a sole trader on the simplified system, or 20% for VAT payers). A UKTZED code can be set per product in the product editor.

Does it change my checkout or theme?

No. It works in the admin area and on order hooks only.

What happens if I delete the plugin?

WooCommerce orders stay as they are, and the receipts live in your PRRO account. The plugin’s own tables and options are removed.

Screenshots

Changelog

1.2.1

  • Fix: with the plugin active, the “Update” button on the order screen did not save the order. The “Issue receipt” button is now a plain link (HPOS and classic storage).
  • Fix: Checkbox refund receipts were never issued; a refund now goes to the receipt method with every item marked as a return and linked to the sale.

1.2.0

  • The wordpress.org build is the free edition only: the licence screen, the trial and the licence-based features are removed, and the plugin no longer contacts the CatCode licence server. Everything free before 1.1.0 works as before.

1.1.0

  • Licence-based features added; since 1.2.0 they live only in the Pro edition. The free part did not change.

1.0.2

  • Upgrades from pre-1.0.0 builds carry the receipt journal, shift log and KeyCRM order map over to the renamed tables, so an order is not fiscalized twice.
  • Uninstall removes the plugin’s own tables.

1.0.1

  • Ukrainian translation refreshed; shift statuses are translatable.

1.0.0

  • First public release: automatic receipts through Vchasno.Kasa or Checkbox with fallback, shift schedule, receipt log, order box, email and SMS delivery, KeyCRM source.