
Invoice Sync with KLARA for WooCommerce — KLARA invoices from orders, Swiss QR bill
A KLARA invoice from every WooCommerce order: customer, lines, VAT and the Swiss QR bill; Pro adds automatic invoices, payments from KLARA, credit invoices, stock, PDF and delivery.
- Compatibility
- WordPress 6.2+ · WooCommerce 7.0+ (HPOS, block checkout) · PHP 7.4+ · currency CHF · languages: English, Deutsch, français, italiano (in Pro)
- Licence
- a site + a staging copy, annual
- Trial
- 7 days, no card, one per site
- Updated
- 12.11.2026
What Free has,
and what Pro adds
The free version works with no time limit. Pro adds the rest of the features in the table.
Key points
What happens to an order
A “KLARA” box appears in the order.
Settings
WooCommerce → KLARA: paste the API key, save and press “Check connection”: the module reads the company number, the VAT registration, the VAT codes and the receivables bank account.
What Pro adds
Automatic invoices. The invoice is created in the background when an order becomes “On hold”, “Processing” or “Completed” (your choice), once per order, with two retries when KLARA is busy or out of reach.

The trial starts when you ask
A fresh install is the free version, nothing switches on by itself. The “Try Pro for 7 days” button → e-mail → the key right in the window and by e-mail.

One key — a site and a staging copy
Moving the site? Unlink the licence on the old domain and activate it on the new one yourself. A staging copy (staging., dev.) works with the same key and does not take a site slot. For studios — keys for 5 or 25 sites, or unlimited.
Technical requirements
WordPress 6.2+, WooCommerce 7.0+ (HPOS, block checkout), PHP 7.4+.
A KLARA account with the invoicing subscription and an API key with the role “Kundenbeziehungen”.
Shop currency: Swiss franc (CHF).
Version history
Connection with an API key, an invoice from the order with the KLARA customer, lines, VAT codes and the QR bill, drafts or booked invoices, HPOS.
Frequently bought with Invoice Sync with KLARA


Abandoned Cart Recovery for WooCommerce

Smallinvoice Accounting Sync for WooCommerce — orders into Smallinvoice invoices

Product bundles and gift with purchase for WooCommerce
Full module description
Invoice Sync with KLARA for WooCommerce writes an invoice in KLARA for every order. The buyer becomes a KLARA customer, the order lines, VAT and the Swiss QR bill go on the invoice, and the order keeps a link to it. The module uses the official KLARA Public API (api.klara.ch) and is meant for Swiss shops that keep their books in the KLARA business software.
What you need in KLARA. Your own KLARA account with the invoicing (Order Management) subscription and an API key with the role “Kundenbeziehungen” (Benutzer → Public API Key Management): that role covers customers, invoices and the bank account. KLARA has no test environment, so every invoice that is created is real; start with drafts. The module works in Swiss francs (CHF) only: an order in another currency gets a clear message instead of an invoice.
What happens to an order
A “KLARA” box appears in the order. The “Create the invoice in KLARA” button creates the invoice once: before writing, the module searches KLARA for the invoice code (prefix + order number), so a second click or a retry after a timeout links the existing invoice instead of creating another one.
The buyer is searched in KLARA by the billing e-mail and created only when nothing matches. A buyer with a company name and a Swiss address becomes a company, everyone else a person. The lines go with the prices the buyer paid: VAT included, coupons applied, shipping and fees as their own lines. The VAT rate of each line (8.1 %, 2.6 %, 3.8 %) is matched to the VAT code of your KLARA company valid on the invoice date; a company that is not registered for VAT gets invoices without VAT. The invoice total equals the order total.
An invoice can be a draft that you check and book in KLARA, or booked at once: then the accounting tag of the lines and the VAT case are set. The QR bill is built from the receivables bank account (or QR-IBAN) of the company. A KLARA error goes into the order note as plain text with its error id.
Settings
WooCommerce → KLARA: paste the API key, save and press “Check connection”: the module reads the company number, the VAT registration, the VAT codes and the receivables bank account. The key is stored encrypted and never reaches the browser.
Then choose whether invoices are created as drafts or booked, the invoice code prefix (for example WC-), the payment term in days, the QR bill, the VAT rate to use when WooCommerce taxes are off, the salutation of private buyers and the language of new customers. “Disconnect” removes the saved key.
What Pro adds
Automatic invoices. The invoice is created in the background when an order becomes “On hold”, “Processing” or “Completed” (your choice), once per order, with two retries when KLARA is busy or out of reach. The bulk action “Create KLARA invoices” in the order list does the same for the orders you pick.
Payments in the shop. Every hour the module asks KLARA which invoices of the shop are paid, notes it on the order and, if you want, moves an order that waits for payment (bank transfer, QR bill) to “Processing” or “Completed”. KLARA has no webhooks, so the module asks for itself; the “Check status and payment” button checks one order at once. A partly paid or cancelled invoice is noted.
Credit invoices for refunds. Every refund of an invoiced order becomes a credit invoice in KLARA, as a draft: with negative lines for the refunded items or one amount line at the main VAT rate of the order.
Export invoices. Deliveries outside Switzerland and Liechtenstein at 0 % VAT are marked as KLARA export invoices; Liechtenstein is in the Swiss VAT area and is invoiced like Switzerland.
Articles and stock. Order lines are linked to the KLARA article whose number equals the SKU, with its accounting tags, so KLARA books the sale and the stock movement like its own. The stock of products with a SKU and stock management is taken from KLARA every hour, every 6 hours or once a day; KLARA is the stock master.
PDF and delivery. The invoice PDF is downloaded from the order screen, and booked invoices are delivered through KLARA smart delivery (eBill, ePost, e-mail or post) with the “Deliver through KLARA” button or right after booking. KLARA allows this only for a logged-in KLARA user, not for an API key, so a separate user is entered (the password is stored encrypted). A delivery is real and is never repeated automatically.
Journal. Up to 500 entries: every invoice, credit invoice, payment check, delivery and stock read with the answer of KLARA, a “Failed only” filter and “Try again” for invoices that were not created.
Languages and updates. Interface: English, Deutsch (Schweiz), français (Suisse), italiano (Svizzera); updates from catcode.com.ua.
Limits
- CHF only: an order in another currency is not invoiced and gets a message in its note.
- One API key is one KLARA company.
- KLARA articles are not created from WooCommerce products: the module only links by SKU and reads the stock.
- Numbering: KLARA reserves the invoice and order number itself; a failed write leaves a gap in the numbering (that is how KLARA works).
- Stock from KLARA overwrites WooCommerce stock: KLARA is the stock master.
- The module gives no tax advice: which VAT code and VAT case apply is for you and your fiduciary to decide.
How it works, step by step
- Install the plugin and activate it (WooCommerce must be active).
- In KLARA create an API key with the role “Kundenbeziehungen”, paste it into WooCommerce → KLARA and press “Check connection”.
- Choose drafts or booked invoices, the code prefix, the payment term and the QR bill.
- Open an order and press “Create the invoice in KLARA”.
- In Pro switch on automatic invoices, payments from KLARA, credit invoices and the rest.
Under the hood
- The KLARA Public API (api.klara.ch, documentation at developer.klara.ch): requests go from your server, only after you save a key and only for the actions you start or switch on.
- KLARA receives what an invoice needs: the buyer name, company, address, e-mail and phone, the order lines with price and VAT code.
- The API key (and the KLARA user password for PDF and delivery) is encrypted in the database and never printed to the browser.
- Automatic invoices and payment checks run in the background through Action Scheduler.
How to install
- Plugins → Add New → Upload Plugin: choose the zip and activate it.
- WooCommerce → KLARA: paste the API key, save and press “Check connection”.
- Choose the invoice mode and save the settings.
- For Pro: paste your licence key or start the trial in the “Licence” section of the same page.
Questions
about the module
Didn't find the answer? Message us on Telegram and we'll reply within a business day.
Is this an official KLARA plugin?
No, it is an independent integration by CatCode. KLARA is a trademark of ePost Service AG; the module is not affiliated with KLARA or ePost and not endorsed by them.
Which role does the API key need?
The role "Kundenbeziehungen" (customer relations): it covers customers, invoices and the bank account. The role "Buchhalter" cannot write invoices.
Does KLARA have a test environment?
No, KLARA has one live environment and every invoice that is created is real. Start in draft mode and with a company you control.
Can an invoice be created twice?
No. Before writing, the module searches KLARA for the invoice code (prefix + order number): a second click or a retry after a timeout links the existing invoice.
Does it work with other currencies?
No, CHF only. An order in another currency gets a message in its note.
How does the module learn about a payment?
KLARA has no webhooks, so Pro asks it every hour about the open invoices of the shop (up to 50 per run, of the last 120 days); the button in the order checks one order at once.
Does the module deliver invoices to buyers?
In Pro: by a button or automatically after booking, through KLARA smart delivery (eBill, ePost, e-mail or post). A delivery is real and is never repeated automatically.
What happens after the trial?
Pro switches off and the free part keeps working: the connection, the box in the order, invoice creation, customers, VAT and the QR bill.
How many sites does one key cover?
One key works on two sites: the shop and its test copy.
No reviews yet. Be the first.
No questions yet. Ask one — we answer within 24 hours.
Not quite what you are looking for?
We build custom modules for WordPress, WooCommerce, OpenCart and Shopify. Tell us about the task and we'll prepare an estimate.
Order a custom module
Buying the module
—
Charged in UAH; your bank converts it to your currency. EUR price is approximate.




















