Name: Croatia Fiscal Receipts (Fiskalizacija računa) for CS-Cart and Multi-Vendor
Brand: Kavio Labs
SKU: KV-CROATIA_FISCALIZATION
Price: 99 USD
Availability: InStock

What it does

Croatian web shops that sell to consumers must fiscalize every receipt whatever the payment method. This add-on numbers the receipt per business premises, computes the ZKI, signs the request with your FINA application certificate, sends it to the Porezna uprava system and stores the JIR. It covers consumer receipts only, not B2B eRačun. For CS-Cart, Ultimate and Multi-Vendor.

How it works

Upload your certificate once (the password is never stored), enter OIB, premises mark and device number, run the connection test in test mode, then switch to live. When an order reaches one of the statuses you chose the receipt is numbered, signed and sent. The customer gets a printable receipt with operator mark, VAT, ZKI, JIR and QR code, also in the invoice and order e-mails. Storno receipts by button or status.

Features

Gap-free receipt numbers per premises or device, test and live numbered apart
Printable receipt with lines, VAT groups, operator mark, ZKI, JIR and QR code, linked from the order page and the invoice
Signed requests (RSA-SHA256), Croatian local time, UTF-8 safe XML
Retry with the same data, late delivery flag, two-working-day term shown, 30-day limit
Storno receipts, buyer OIB for B2B sales, payment code mapping
FINA certificate stored sealed, password never kept
Receipts and numbers kept on uninstall
Multi-Vendor: one owner OIB or one OIB and certificate per vendor

What you get

Package	kv_croatia_fiscalization-1.0.0.zip, installed through Add-ons → Manage add-ons
Updates & support	12 months included. Download new versions from your account and install them in Add-ons → Manage add-ons or the Upgrade Center.
License	1 production installation. Staging, dev and localhost are free and unlimited. The add-on keeps working after the update period ends. How licensing works

Compatibility

We list only the builds we install and test on. “Tested” means the full test plan was run on that build; “Supported” means the build is inside the supported range and uses the same hooks.

CS-Cart version and edition compatibility
CS-Cart version	CS-Cart	CS-Cart Ultimate	Multi-Vendor	Multi-Vendor Ultimate
4.22 and later	Testing next	Testing next	Testing next	Testing next
4.21.2	Supported	Supported	Supported	Supported
4.20.x	Supported	Supported	Supported	Supported
4.19.x	Supported	Supported	Supported	Supported
4.18.x	Supported	Supported	Supported	Supported
4.17.2	Supported	Supported	Tested	Supported
Before 4.17.2	Not supported	Not supported	Not supported	Not supported

Last tested build: Multi-Vendor 4.17.2, Nov 9, 2026Tested on: Multi-Vendor 4.17.2

Requirements

PHP	CS-Cart or Multi-Vendor 4.17.2 or later (any edition), PHP 7.4 to 8.3 with `openssl`, `curl`, `dom`, `mbstring`
Requirement	Euro amounts: either EUR is the primary currency, or the EUR currency exists in Administration > Currencies (receipts are delivered in euros)
Requirement	Your fiscal data: OIB, the business premises mark you registered with the tax administration (ePorezna), a device number, and the application certificate (`.p12` / `.pfx`, issued by FINA or another trust service provider, containing your OIB). For tests: a DEMO certificate with its OIB
Requirement	Outgoing HTTPS to port 8449 (`cistest.apis-it.hr`, `cis.porezna-uprava.hr`) and TLS 1.2 or newer. A cron job (step 6)
Core changes	None. Hooks and template overrides only

1.0.0

Nov 9, 2026

Latest

Added 11

Initial release: fiscalization of consumer receipts with the Porezna uprava fiscalization system (specification v2.7): signed RacunZahtjev (XMLDSig, RSA-SHA256, exclusive c14n), Echo connection test, ZKI protective code, JIR, QR verification link.
Gap-free receipt numbers per business premises or device (counter and receipt in one transaction), test and live sequences apart; receipt, ZKI and data stored before sending, every retry sends the same data.
Late delivery: NakDost from the second attempt, two-working-day term shown, 30-day limit (error 176), retries for about 30 days with back-off; answers s001 - s006 and s013 handled, account paused on s002 - s005.
Storno receipts (negative amounts) by button or order status; buyer OIB for B2B sales; payment code mapping G / K / T / O; VAT groups from both CS-Cart tax calculation methods; euro conversion.
FINA certificate upload (.p12 / .pfx / PEM) stored sealed, password never stored; Croatian local time for all legal times; UTF-8 safe XML.
Order tab, receipt view, customer order page with ZKI, JIR and QR, order list column, jobs and log pages, license client, Upgrade Synchronizer.
Multi-Vendor owner mode or one account per vendor; receipts, counters, connection and log are kept on uninstall (setting to delete them).
Printable receipt for the customer and the admin from the data stored at issue (seller and address, OIB, lines, VAT groups with base, payment way in words, operator mark, ZKI, JIR, QR, cancelled receipt of a storno); fiscal block or "OVO NIJE FISKALIZIRANI RAČUN" in the invoice and order e-mails.
Several fiscal statuses (default Processed and Complete); a paid status without receipt is logged; storno as a waiting job (storno:<order>); new receipt after a storno; live receipts wait instead of being rejected on a mode switch; receipts are only sent under the OIB they were issued with; ZKI algorithm stored per receipt; replaced certificates kept sealed; SOAPAction from the WSDL v1.7; answer signer checked (fiskalcis / fiskalcistest), on by default.
The receipt is issued before CS-Cart sends the status e-mail, so the e-mail at the fiscal status carries ZKI, JIR, QR and the signed link (also for orders set to Complete directly); the block is limited to the invoice and order summary (not packing slips, supplier orders or RMA documents); indented answers of the tax administration verify; a storno that waited for the JIR restarts when the JIR arrives.
Not included: B2B eRačun (Fiskalizacija 2.0 e-invoices) through an information intermediary, e-reporting, tips, several premises, partial refunds.

Tested on Multi-Vendor 4.17.2. First release.

Does it work with CS-Cart, Ultimate and Multi-Vendor?

Yes, all four editions, 4.17.2 to 4.21.x. In Multi-Vendor the owner can fiscalize everything with one OIB or let each vendor use their own.

Do I need FINA?

You need an application certificate with your OIB from a trust service provider (FINA is the usual one) and your business premises registered with the Porezna uprava. The add-on does not issue certificates or register premises.

Is the certificate password stored?

No. It opens the uploaded file once; only the key, sealed with AES-256-GCM, is kept. Nothing shows it again.

Does it do B2B eRačun (Fiskalizacija 2.0)?

Not in 1.0. Receipts for B2B sales paid in cash or by card are covered (with the buyer OIB). Structured e-invoices need an information intermediary and are not included; see Developer notes.

Which time zone is used?

Croatian local time (Europe/Zagreb) for every legal time, whatever your shop time zone is.

What if the system is down?

The receipt is numbered and stored, given to the customer with the ZKI, and retried with the same data (late delivery). The law gives two working days after an outage; the add-on shows that term and retries for up to 30 days.

Does it send data to Kavio Labs?

Receipt data goes only to the tax administration. The license check sends your domain name to the Kavio Labs license server once a day.

What happens on uninstall?

Legal records stay (receipts, numbers, messages, connection, settings) unless you switch on "Permanently delete all fiscal data on uninstall". Reinstalling continues the numbering.

Is it endorsed by the tax administration?

No. It is independent software that follows the public technical specification v2.7. Test it with the DEMO certificate before going live.