Fakturownia and WooCommerce: integration and automatic invoices step by step
Fakturownia with WooCommerce, automatic invoices in your store: integration in the Fakturownia panel or the WP Desk plugin, order statuses, KSeF 2026 and typical errors.
The integration of Fakturownia (a Polish online invoicing tool) with WooCommerce issues sales documents based on orders from the store. You set the type of document, the right order status and the way it is sent to the customer, and the system does the rest.
You have two official routes to choose from. The first is configured in the Fakturownia panel through the WooCommerce REST API and webhooks. The second uses the paid Fakturownia WooCommerce plugin from WP Desk, which you manage in WordPress. The result is similar: the order data lands on the invoice automatically, with no manual retyping of products, amounts and buyer details.
How the Fakturownia WooCommerce integration works
AI-generated image
The Fakturownia integration with WooCommerce reacts to a change of order status and issues the chosen document. It can be a VAT invoice, an invoice without VAT, a pro forma or a receipt.
- Say a customer places an order and pays by card or instant bank transfer, for example through a Przelewy24 integration (a Polish payment gateway) set up earlier.
- The payment operator confirms the transaction, and WooCommerce changes the order status to “Processing”.
- This status can trigger the invoice. The company details, address, products, VAT rates and amounts are taken straight from the order.
- The finished document goes to Fakturownia. If you switch on automatic sending, the customer also gets it by email. With the right configuration they can download the invoice from their account in the store.
Automatic WooCommerce invoices save the most time in stores that handle many similar orders every day. Retyping data, checking order numbers and sending PDF files by hand all disappear. It is also easier to keep one predictable process for the whole team.
KSeF in 2026: new duties for stores
AI-generated image
The national e-invoicing system is now mandatory. The largest taxpayers have used it since 1 February 2026, and on 1 April 2026 the next stage began, covering the remaining companies.
| Date | Who it applies to |
|---|---|
| 1 February 2026 | The largest taxpayers issue invoices; all businesses receive them through KSeF |
| 1 April 2026 | The remaining taxpayers issue invoices in KSeF |
| 1 January 2027 | Businesses up to PLN 10,000 gross a month, after a transition period until the end of 2026 |
| until 31 December 2026 | No penalties for errors related to KSeF |
You will find the current dates and legal basis on the official KSeF website.
Until 31 December 2026 no penalties are applied for errors related to KSeF. You can use this time to check the configuration, train the people who handle orders and sort out the exceptions, such as returns, corrections or sales abroad.
Fakturownia supports KSeF, so connecting it to the store lets you put two processes in order in one go. The order passes from WooCommerce to the invoicing program, and the invoice can be registered in the state system according to the account configuration.
Before you start: the account and access details
You need an active Fakturownia account and administrator access to the WooCommerce store. The specific access details depend on the integration route you choose.
| Route | What you need |
|---|---|
| Route 1: configuration in the Fakturownia panel | An active Fakturownia account, a WooCommerce administrator, the store address, REST API keys |
| Route 2: the WP Desk plugin | The plugin ZIP file, a WP Desk licence key, the API token and the domain of the Fakturownia account |
For the configuration done in the Fakturownia panel, have the store address and the WooCommerce REST API keys ready.
- You will find them in the WordPress admin under WooCommerce → Settings → Advanced → REST API.
- There you create a new key with the permissions needed to read orders and run the integration.
- WooCommerce generates a consumer key and a consumer secret. Copy them straight away and store them like login details.
The WP Desk plugin needs a Fakturownia API token. In the Fakturownia panel go to Settings, then Account settings, Integration and the section with the API authorisation code. You will also need the account domain. It is the first part of the address where you log in to the program, for example the name in name.fakturownia.pl.
Check the account plan too. The basic integration works on most Fakturownia plans, but warehouse support needs the Standard plan or higher. The price list and the scope of the plans can change, so look at them before you switch on stock synchronisation.
Route 1. Integration in the Fakturownia panel (no plugin)
You configure this integration on the Fakturownia side, without adding another plugin to WordPress. It is a simple choice for a store that mainly needs documents issued and sent automatically.
Add the store and connect the API
Log in to Fakturownia and go to the WooCommerce integration settings. Enter the full store address, then paste the consumer key and consumer secret generated earlier in the REST API. A detailed description of each field is in the Fakturownia integration documentation.
After the settings are saved, Fakturownia creates webhooks. These are automatic notifications sent by the store when a particular event happens, for example after an order status changes. Thanks to them the program knows when to fetch the data and prepare the document.
Choose the department and the document type
Point to the company department from which invoices should be issued. It matters when you run several brands, points of sale or branches with separate details on one account.
Then choose the type of document. VAT invoices, invoices without VAT, pro formas and receipts are among the options. The type should match the way you sell and your company’s tax settings.
Set the trigger status
Decide at which order status the document should be created. WooCommerce can trigger it for an order awaiting payment, one that is processing or one already completed.
For online payments the “Processing” status, set after the payment is confirmed, often works well. For a traditional bank transfer and cash on delivery, think through separate scenarios. Issuing the invoice too early will also generate documents for orders that were never paid in the end.
Configure sending and run a test
Switch on automatic sending of the document to the customer’s address if the invoice should reach them without the store staff being involved. With KSeF support the message can wait until the invoice is registered or marked as offline mode. The customer then gets a document with the required system data added.
You can also skip orders with a zero value and hide their numbers on documents. At the end place a test order, pay for it and check the whole flow: the status change, the creation of the document, its registration in Fakturownia and the message to the customer.
The advantage of this route is the small number of parts on the store side. There is no extra plugin to install, license and update.
Route 2. The Fakturownia WooCommerce plugin from WP Desk
The WP Desk plugin gives you more settings directly in the WordPress admin. The subscription for one site costs PLN 229 net a year. Plugin licences are a fixed item in a store’s budget. You will find a full breakdown of costs in the article on how much an online store costs.
You will not find the plugin in the public WordPress directory. After buying it on the WP Desk website you download a ZIP file.
- In the store admin go to Plugins, choose “Add New”, then “Upload Plugin”.
- Upload the package, activate the add-on and activate the subscription with the licence key you received.
- In the integration settings enter the API token and the domain of the Fakturownia account. After saving the details, check the connection.
An authorisation error usually means a typo in the domain, the wrong token or missing permissions.
The plugin lets you issue documents by hand from the order or automatically at the statuses you indicate. It supports VAT invoices, corrections, pro formas, receipts, bills (rachunki) and invoices without VAT. The documents are stored in Fakturownia, so they take up no space on the store’s server.
The customer can get the document by email or download it from their account. The plugin also supports a NIP (Polish tax identification number) field and its validation in the checkout form, the OSS scheme for sales to other European Union countries, and GTU codes (Polish VAT codes for groups of goods and services) assigned to products.
Two-way stock synchronisation is an advanced feature. A change in stock can pass between WooCommerce and Fakturownia, as long as the products are linked correctly, most often by SKU. A configuration like this has to be tested carefully, especially when stock is also updated by a warehouse system, an order integrator or a marketplace.
Which route to choose
The integration on the Fakturownia side is enough for most small stores that want documents issued automatically after an order status changes. The WP Desk plugin suits a store with an extended company form, stock synchronisation, OSS and GTU codes.
| Criterion | Route 1: Fakturownia panel | Route 2: WP Desk plugin |
|---|---|---|
| cost | Included in the account plan; no separate fee | PLN 229 net a year for one site |
| where you configure it | You manage the whole configuration in Fakturownia | More settings directly in the WordPress admin |
| extra code in the store | No extra code in the store | A plugin that you install, license and update |
| who it is for | Most small stores | Extended company form, stock, OSS and GTU codes |
Run one method of issuing documents. The panel integration and an active plugin running at the same time can create two invoices for the same order.
If you sell through the store and Allegro (Poland’s largest marketplace), consider invoicing at the level of an order integrator. One tool can then handle all the channels, which makes it easier to control numbering, corrections and stock levels. I describe how to join both channels into one process in the guide to integrating Allegro with WooCommerce.
Typical integration errors and how to fix them
The most common problems come from order statuses, double configuration, VAT rates and missing company details. A full trial order lets you catch most of them before the automation goes live.
| Problem | Cause | What to do |
|---|---|---|
| the invoice is created before payment | The wrong trigger status | Set the moment of confirmation separately for card, instant transfer, traditional transfer and cash on delivery |
| duplicate documents | Two active integrations | Switch off the method you do not need; also check the order integrator and the person running the store |
| VAT rates do not match | The rates for products and delivery in WooCommerce do not match the rates in Fakturownia | Align the rates; test coupons, VAT-exempt products and sales abroad |
| no NIP on the invoice | The checkout form did not collect it | The WP Desk plugin adds and validates a NIP field; with the panel integration prepare the field separately |
The last error is skipping the tests. Place a trial order, make the payment, change the status, check the document in Fakturownia and receive the message at the customer’s address. Repeat the trial for a company invoice, a receipt, a cancellation and a correction.
FAQ
Is the Fakturownia integration with WooCommerce free?
The integration configured in the Fakturownia panel needs no separate fee beyond the account plan you chose. The WP Desk plugin costs PLN 229 net a year for one site. Warehouse features may need a higher Fakturownia plan.
When is the invoice issued after an order?
The invoice is created at the status set in the configuration. It is safest to choose the status given after the payment is confirmed and to test each payment method separately.
Will the customer get the invoice by email automatically?
Yes, if you switch on automatic sending. The plugin can also make the document available for download in the customer’s account in the store.
Does the integration support receipts and pro formas?
Yes. Both routes let you issue different documents, including VAT invoices, invoices without VAT, pro formas and receipts. Match the exact choice to the sales rules in your store.
Does Fakturownia support KSeF?
Yes, Fakturownia supports KSeF. Since 1 April 2026 the duty to issue invoices in the system has covered most of the remaining businesses, and companies within the monthly limit of PLN 10,000 gross have a transition period until the end of 2026.