Settings
Open Add-ons > Manage add-ons > Fakturownia Invoicing for CS-Cart > Settings.
General
Section titled “General”| Setting | Default | Description |
|---|---|---|
| Enable | On | When off, no new work is started. Jobs of work that is already under way are still processed. |
| Marketplace owner mode | On | On: every order is processed with the marketplace owner’s account and vendors have no connection page. Off: each vendor connects their own account. |
| Debug log | Off | Also stores every HTTP call with masked request and response. The API token is never stored. |
| Log retention (days) | 90 | Older log entries are removed by the cron run. |
| Issue the document when the order status becomes | Processed | The receipt or VAT invoice is created once the order reaches this status. A document is issued once per order. |
| Mark the document as paid when the order status becomes | Processed | Sets the Fakturownia status to paid. |
| Issue a correction when the order status becomes | Canceled | A correction for the whole document. Empty turns it off. |
| Document for buyers with a NIP | VAT invoice | VAT invoice or proforma invoice. |
| Document for buyers without a NIP | Receipt | Receipt or VAT invoice. |
| Profile field with the NIP | Detect automatically | The customer profile field that holds the NIP or EU VAT number. A number is accepted as a NIP only when its checksum is valid; PL prefix, spaces and dashes are ignored; other EU numbers are sent as EU VAT numbers. |
| Default payment type | Bank transfer | Written on the document when the payment method has no mapping. |
| Create client cards | Off | Registered customers get a client card in Fakturownia and the documents point to it. Off: the buyer data is written on each document and Fakturownia matches existing clients itself. |
| Send VAT invoices to KSeF through Fakturownia | Off | Asks Fakturownia to send VAT invoices for companies to KSeF when it creates them (gov_save_and_send). Needs KSeF enabled in your Fakturownia account; the transmission happens at Fakturownia. |
| Correction for completed returns | On | When a return of the RMA add-on is completed as a refund, a correction for the returned items is issued. |
| Order reference prefix | WEB- | Written as the order number (oid) of the document, for example WEB-1042. |
| Days until payment is due | 0 | Due date = issue date plus these days. |
| Do not sync orders before | empty | Keeps old orders out of the books. |
Connection
Section titled “Connection”Credentials are not ordinary settings: they are entered on the Connection page and stored encrypted (AES-256-GCM, key derived from your store’s own secret). The token is never shown again; leave the field empty to keep the saved value.
| Field | Description |
|---|---|
| Mode | Test account or Live account. Fakturownia describes no sandbox in its API documentation: use a second (trial) account as the test account. |
| Account subdomain | mycompany or mycompany.fakturownia.pl. Only your own subdomain on fakturownia.pl (or invoiceocean.com) is accepted. |
| API token | Fakturownia: Settings > Account settings > Integration > API authorization code. |
Mapping
Section titled “Mapping”| Field | Description |
|---|---|
| Department ID | The Fakturownia department (company) that issues the documents. Load the list with one click; empty = the account default. |
| Payment type per payment method | transfer, card, cash, cash_on_delivery, payu, paypal, off, or any text. |
| Default tax | Used for lines without tax data, for shipping, the order discount and fees (default 23). |
| Tax per CS-Cart tax | The Fakturownia tax value: a rate (23, 8, 5, 0), zw (exempt) or np (not subject). Empty = the percentage of the CS-Cart tax. |
Amounts are sent in the store’s primary currency (the document’s currency). Requirement: set the store’s primary currency to PLN for Polish VAT documents. The add-on sends no exchange rate or PLN tax amount (the documentation lists no such fields), so a VAT invoice in another currency may be refused by Fakturownia or KSeF.
The queue runs from cron. Use either the command line or the secret web address shown in the Cron section of the settings:
php /path/to/store/admin.php --dispatch=kv_fakturownia.cronhttps://your-store.example/index.php?dispatch=kv_fakturownia.cron&key=<secret>
Log and jobs
Section titled “Log and jobs”- Log lists every call and job with filters (level, action, text, dates) and a CSV export.
- Jobs lists the queue. A job that fails is retried after 5 minutes, 15 minutes, 1 hour, 3 hours and 12 hours, then marked “Gave up”; use Retry to queue it again.
Multi-Vendor
Section titled “Multi-Vendor”In the vendor panel a vendor sees only their own records. With the marketplace owner mode off the vendor also gets the Connection and Mapping tabs for their own account.