Official Ministry of Finance KSeF API 2.0

Issue KSeF structured e-invoices straight from WooCommerce

Generate, validate and submit FA(3) e-invoices directly to Poland's official KSeF API — no intermediaries, no per-invoice fees, no separate accounting system.

  • 100% KSeF Compliant
  • FA(3) XML Standard
  • WooCommerce HPOS Ready
Official Ministry of Finance API No intermediary, no per-invoice fee HPOS & Checkout Block ready Encrypted token storage
How it works

Four steps, every B2B order

Orders with a buyer NIP always go to KSeF; consumer orders only when you switch consumer invoices on.

NIP detected at checkout

A checksum-validated NIP field in classic and block checkout flags the order as B2B automatically.

FA(3) generated

One click turns the order into a structured e-invoice, validated against the Ministry's schema.

Sent to KSeF

Submitted straight to test, demo, or production via the official API 2.0 — status tracked on the order.

UPO downloaded

The official proof of receipt is fetched and attached to the order automatically.

What's free

No limits, no fees

FakturFlow is a standalone plugin. It talks directly to the official Ministry of Finance KSeF API — no intermediary, no per-invoice fees, no separate accounting system required.

FA(3)

FA(3) invoice generation

Generate a structured FA(3) e-invoice from any WooCommerce order in one click.

Schema

Official schema validation

Every invoice is validated against the Ministry of Finance schema before it's sent.

API 2.0

Direct KSeF submission

Submit to KSeF's test, demo, or production environment via the official API 2.0 — track status and download the UPO (official proof of receipt) from the order screen.

KOD I

KOD I verification QR code

Every invoice includes a KOD I verification QR code generated per the Ministry of Finance specification.

NIP

NIP field at checkout

A checksum-validated NIP field in both classic and block checkout — orders with a NIP are detected as B2B automatically.

PDF

Invoice PDF for the buyer

A PDF built from the invoice exactly as KSeF holds it, with the KOD I code — attached to the order emails and downloadable from My Account.

B2C

Consumer invoices, if you want them

Off, on request with an "I want an invoice" checkbox at checkout, or for every order — consumer invoices go to KSeF without a tax ID.

MPP

Payment terms and split payment

Paid or due date, payment method and your bank account on the invoice; annex 15 goods above 15 000 zł are marked "mechanizm podzielonej płatności" automatically.

KOR

Correction invoices from refunds

Every refund gets its own correction (KOR) document referencing the original invoice by KSeF number — generate, send, and download its UPO from the order screen.

Also included: encrypted KSeF token storage (never logged), full compatibility with WooCommerce HPOS and the checkout block, and a complete Polish (pl_PL) translation.

Why FakturFlow

Three ways to do KSeF in WooCommerce — compared

Honest comparison of the typical options. No brand-bashing, just the trade-offs.

Accounting SaaS
subscription + connector
Invoicing plugin
+ paid KSeF add-on
FakturFlow
Where invoice data goes Vendor's cloud, then KSeF Depends on vendor Straight to the Ministry of Finance API — no third party
Cost of the core KSeF flow ~100–400 zł/year, invoice limits on cheap tiers Paid base plugin + paid add-on Free — no invoice limits, no per-invoice fees
KSeF depth Module bolted onto accounting Add-on bolted onto invoicing Built around KSeF: FA(3) + XSD validation, UPO, KOD I QR, corrections
KSeF outage plan Varies Rarely covered offline24 mode with statutory-deadline alerts (Pro)
Full automation Monthly subscription forever Stacked licenses 249 zł/year flat (Pro), manual flow stays free
Free vs Pro

Pro is here — automation on top of the free core

No free feature is ever removed to push the paid tier.

Free $0 forever
  • Manual generate / validate / send
  • Correction invoices + UPO download
  • NIP field & KOD I QR code
  • No invoice limits, no per-invoice fees
Get FakturFlow — Free
Pro 249 zł / year (€59 · $69)
  • Automatic submission on payment, with retries
  • Automatic corrections on refund
  • offline24 mode with deadline alerts when KSeF is down
  • Compliance dashboard, audit log & CSV export
Buy FakturFlow Pro

1 site · yearly · 14-day money-back guarantee. Secure checkout by Freemius.

One brand, one plan

FakturFlow: e-invoicing for WooCommerce, country by country

Every EU market is getting its own e-invoicing mandate. FakturFlow ships one focused plugin per country — same engine, local compliance.

Live

Poland — KSeF

FA(3) structured e-invoices straight from WooCommerce orders. Free on WordPress.org, Pro automation available.

2027

Belgium — Peppol

UBL / BIS 3.0 invoices over the Peppol network for the 2026+ B2B mandate.

Planned

France — Factur-X / PDP

E-invoicing through registered platforms for the French reform.

Planned

Germany — XRechnung

Structured B2B e-invoices for the German mandate.

FAQ

Frequently asked questions

Is the free version really free — no limits?

Yes. Manual generate/validate/send, corrections, UPO download, the NIP field, the KOD I QR code, the invoice PDF for the buyer and consumer (B2C) invoices are free with no invoice limits and no per-invoice fees — this plugin will always cover that core flow, even after the Pro add-on ships.

Does it work with WooCommerce HPOS and the checkout block?

Yes. FakturFlow is fully compatible with High-Performance Order Storage (custom order tables) and the Checkout block — the NIP field is registered through the Additional Checkout Fields API and behaves identically in both checkout variants.

What about consumer (B2C) orders?

By default only orders with a buyer NIP (tax ID) go to KSeF — consumer orders keep the regular checkout flow, since KSeF is optional for them. If you want to invoice consumers through KSeF too, switch it on: on request (the buyer ticks "I want an invoice" at checkout) or for every order. The consumer then receives the invoice PDF with its verification code.

Where does the buyer get the invoice?

Once KSeF accepts the invoice, the PDF — with the KOD I verification code — is attached to the "Completed order" and "Order details" emails, and the email carries a download link valid for 30 days (guest orders too). Logged-in customers can download it any time from My Account. The PDF is generated on your server from the invoice exactly as KSeF holds it — nothing goes to a third party.

Does it handle split payment (MPP)?

Yes. Flag the products listed in annex 15 to the VAT Act; a B2B invoice above 15 000 zł that includes them is marked "mechanizm podzielonej płatności" and carries your bank account.

Does the plugin send my data to any third party?

No. Invoice data is sent only to the official Ministry of Finance KSeF API (test, demo, or production — your choice). The only exception is the verification link encoded in the KOD I QR code, which points to the Ministry's public invoice-verification lookup when scanned. The free plugin sends no telemetry; the Pro add-on's beta diagnostics are strictly opt-in (details).

What does FakturFlow Pro add?

Pro is a separate add-on covering automatic submission on payment with retries, automatic corrections when an order is refunded, offline24 mode with statutory-deadline alerts, and a compliance dashboard with a full audit log. It costs 249 zł per year for one site (buy here). No functionality is ever removed from the free plugin to push the paid tier.

Where do I get a KSeF token?

Log into the KSeF web application with your Trusted Profile (Profil Zaufany) or qualified certificate, go to permissions management, and generate a token with InvoiceWrite and InvoiceRead permissions. Paste it into the plugin settings — it's stored encrypted.

How much does it cost?

The free plugin costs nothing — no invoice limits, no per-invoice fees, no subscription. FakturFlow Pro (automation) is 249 zł / €59 / $69 per year for one site, with a 14-day money-back guarantee (buy here).

How is it different from WP Desk, ByteWave, inFakt or wFirma?

Accounting services such as inFakt or wFirma send invoices to KSeF from their own cloud and charge a monthly or yearly subscription; their WooCommerce integrations pass your orders to that service. WordPress options such as the WP Desk KSeF add-on extend a separate invoicing plugin. FakturFlow is a standalone plugin built around KSeF: your store talks directly to the Ministry of Finance API, the core flow is free, and Pro is one flat yearly price — see the comparison.

Do I still need an accountant?

Yes. FakturFlow issues your sales invoices and delivers them to KSeF. Bookkeeping, VAT returns (JPK_V7) and purchase invoices stay with your accountant or accounting software — they can read every invoice you issued directly in KSeF.