Name: Fakturownia Invoicing for CS-Cart
Brand: Kavio Labs
SKU: KV-FAKTUROWNIA
Price: 59 USD
Availability: InStock

What it does

Fakturownia Invoicing sends the orders of your store to Fakturownia, the Polish online invoicing service. You connect your own Fakturownia account with its subdomain and API token, so order data goes straight from your store to your account. It is made for shops that sell to Polish buyers and need a VAT invoice for a company with a NIP and a receipt for everybody else, and for owners who now type these documents by hand.

How it works

Enter the subdomain and API token of a test account, press Save and test, then switch to your live account. Pick the department, a payment type for each payment method and a tax value for each tax. When an order reaches the status you choose, a VAT invoice or receipt is created; at the payment status it is marked paid; a refund creates a correction. Cron runs the queue. E-mailing the document happens in Fakturownia, only when an administrator presses the button.

Features

Credentials stored encrypted, separate test and live mode, one-click connection test
Job queue with automatic retries and a log with filters and CSV export
Works with cron (command line or secret address), no long requests during checkout
Multi-Vendor: one marketplace account or one account per vendor
VAT invoice when the buyer gives a NIP, receipt otherwise, both switchable in the settings
Marked as paid at the payment status, correction with before and after values for refunds and completed returns
Document number, PDF download and a send by e-mail button on the order, invoice PDF in the customer account
Department, payment type per payment method and tax value per tax, documents in the currency of the order
Optional submission to KSeF done by Fakturownia, with the status it reports shown on the order
Safe to retry: invoices and corrections carry a unique object id; after a timeout the add-on checks Fakturownia before it creates anything again. Past orders can be queued from a start date

What you get

Package	kv_fakturownia-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
For developers	Uses 5 CS-Cart PHP hooks. No core files are changed.

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 7, 2026Tested on: Multi-Vendor 4.17.2

Requirements

Platform	CS-Cart and Multi-Vendor 4.17.2 or later
Requirement	Administrator access to the store's admin panel
Requirement	A Fakturownia account and its API authorization code: in Fakturownia open Settings > Account settings > Integration and copy the API authorization code. Fakturownia's API documentation describes no separate sandbox: for the Test account in the add-on use a second (trial) Fakturownia account
Requirement	A cron job on your server (see step 6)
Core changes	None. Hooks and template overrides only

1.0.0

Nov 7, 2026

Latest

Added 17

Initial release.
Connection page: Fakturownia subdomain and API token stored encrypted, test and live account, connection test.
VAT invoice when the buyer gives a NIP (profile field setting), receipt otherwise; lines add up to the order total; one document per order (oid_unique).
Retry-safe: every document (invoice and correction) carries a unique object id that is written down BEFORE the request. After a timeout, a server error or a crash the next try looks the document up at Fakturownia and adopts it instead of creating another one; an unconfirmed document is shown as Pending and retried.
Corrections remember what earlier corrections took away, so a refund after a return (or the reverse) never credits more than the invoice. A correction of a document that was sent to KSeF is sent to KSeF too. Receipts are not corrected automatically (logged).
Dates (issue, sale, payment due) are Polish calendar days (Europe/Warsaw), never UTC.
KSeF-ready buyers: company without a tax id (buyer_tax_no_kind: empty), private persons with first and last name, nip_ue / other for foreign numbers, exemption basis for zw and np on the Mapping page. A rejected document shows the Fakturownia message with a hint.
Cancelled, declined, failed and refunded orders get no document; "Issue now" works for paid orders only.
Multi-Vendor: backfill, "Run now" and "Issue now" are for the store owner only; a vendor e-mails or retries only the own company's records and only with an own account (owner mode off); job counts are per vendor.
Texts are cut by characters, never by bytes (Polish letters).
Document marked paid at the payment status; correction with before and after attributes for refunded orders and completed returns (RMA).
Order tab with number, PDF download and a send by e-mail button (the store never sends the document itself); invoice PDF in the customer account.
Mapping page: department, payment type per payment method, tax value per tax.
Optional KSeF submission done by Fakturownia, status read back.
Multi-Vendor: one account for the marketplace owner or one account per vendor in the vendor panel.
Job queue with retries and back-off, cron (command line and secret address), log viewer with CSV export, queue of past orders from a start date.
Upgrade Synchronizer and domain-bound licence client.

Tested on Multi-Vendor 4.17.2. First release.

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

Yes. The add-on supports CS-Cart and Multi-Vendor. In Multi-Vendor the marketplace owner can use one Fakturownia account for everyone or let each vendor connect their own.

Which CS-Cart versions are supported?

4.17.2 to 4.21.x.

Where are my credentials stored?

In your own database, encrypted. The key is derived from your store's secret in config.php, so a database dump alone does not reveal them. They are never shown again after saving.

Does it send data to Kavio Labs?

No. The add-on talks to Fakturownia only. The license check sends your domain name to the Kavio Labs license server once a day (Kavio Labs downloads).

What happens when Fakturownia is down?

Jobs fail, wait and are retried automatically (5 minutes up to 12 hours). Every document has a unique object id that is stored before the request is sent. If the answer is lost (timeout, server error), the next try asks Fakturownia whether the document exists and adopts it, so no second invoice or correction is created. A document that could not be confirmed is shown as Pending and retried. If Fakturownia stays unreachable for longer than the retries, press Retry on the job.

What happens when the license expires?

New work stops (no new documents, rates, syncs or payments). Work already under way is still finished.

How do I get updates?

Install the new package over the old one. See Installation.

How do I get support?

Contact us through https://cs-cart.kaviolabs.com.

Does it work with KSeF?

Fakturownia can send invoices to KSeF on its side. The add-on has one optional setting that asks Fakturownia to send VAT invoices for companies when it creates them, and a button that reads back the KSeF status Fakturownia reports. Whether and how an invoice reaches KSeF is decided and done by Fakturownia and your account settings there; see the KSeF guide in Fakturownia's API documentation. If you want KSeF invoices issued from CS-Cart itself, see our separate KSeF add-on.

Does the store send e-mails to my customers?

No. The only e-mail path is the administrator's Send by e-mail through Fakturownia button on an order, which asks Fakturownia to send the document.

Is there a sandbox?

Fakturownia's API documentation describes none. Use a second (trial) Fakturownia account as the test account.

Which currency is used?

The store's primary currency, sent as the document's currency. Set it to PLN for Polish documents.

Does it support InvoiceOcean?

The account field also accepts an invoiceocean.com subdomain, because the product shares the software. The API documentation we follow is Fakturownia's; test with your own account first.