Truewheel KSeF for Shopify
EN PL

KSeF for your Shopify store — automatically

Structured FA(3) invoices with correct buyer data, filed to KSeF (the Polish national e-invoicing system) with an official UPO receipt. No manual work.

KSeF becomes mandatory in April 2026.
Penalties start 1 January 2027.

admin.shopify.com › apps › truewheel-ksef

[ screenshot ]
reconciliation dashboard:
orders without a tax ID · KSeF status · UPO

The KSeF mandate calendar

April 2026

Mandatory for all VAT taxpayers

B2B invoices must be issued in the structured format and filed to KSeF.

today

The penalty-free window

Time to clean up buyer data and the process. Later it is the same project — under pressure.

1 January 2027

Penalties up to 100% of the VAT amount

Sanctions for an invoice issued outside KSeF or filed late.

Shopify was not designed for the Polish invoice

Three things that always break in B2B stores — and that need fixing before KSeF, not after.

01

The buyer's tax ID never reaches the invoice

Shopify's standard checkout does not collect a NIP (the Polish company tax ID). It arrives by e-mail, in the order notes, or not at all — while the invoice requires correct buyer data.

02

A spreadsheet and a manual export every month

Someone collects orders into a sheet, fills in the missing data and retypes it into an invoicing tool. Hours of work, and the place where typos are born.

03

The accountant wants invoices in their own system

You look at Shopify, they look at Fakturownia or inFakt (popular Polish invoicing platforms). Without a shared channel every month ends in reconciling who disagrees with whom.

How it works: from order to UPO

One flow, set up once. After that it runs without you.

step 1

An order in Shopify

The app listens for orders in the background — no theme changes.

step 2

Tax ID captured and validated

A checkout field or a post-purchase link. Checksum validation, plus VIES for EU numbers.

step 3

FA(3) invoice

A structured document in the FA(3) schema — line items, rates, buyer data.

step 4

KSeF + UPO

Filed, and the UPO number (the official confirmation of receipt) is stored on the order as proof.

variant

or into Fakturownia / inFakt

If invoices should be created where your accountant works, we send the document to their system and it handles KSeF. Same tax-ID capture, different exit point.

FA(3) invoice · UPO

[ screenshot ]
invoice detail:
buyer data · line items · UPO number

What you get

Tax ID captured at checkout and after purchase

A B2B customer enters the number with the order — and if they forget, they get a link and fill it in themselves. You type nothing by hand.

Validation: checksum and VIES

A wrong number is caught before the invoice is issued, not after KSeF rejects it.

Filing to KSeF with UPO

Every invoice keeps its UPO confirmation on the order — proof the document arrived.

Offline-24 mode when KSeF is down

The invoice reaches the customer as usual; we re-file it to KSeF automatically once the register returns.

Corrections on refunds

A refund or partial refund in Shopify creates a correcting invoice linked to the original document.

Reconciliation dashboard

See every order without a tax ID before it becomes a problem — and the KSeF status for the whole month in one place.

Pricing

14 days free on every paid plan. Start with the free audit — we'll show how many of your B2B orders are missing a tax ID.

Audit Free no filing to KSeF
  • Reconciliation dashboard (read-only)
  • Orders without a valid tax ID
  • KSeF readiness status
  • Filing to KSeF needs a paid plan — collected orders wait and go out in one click
Starter $9 / mo up to 100 documents per month
The full legal cycle:
  • Tax ID capture and validation (checksum + VIES)
  • FA(3) invoices → KSeF with UPO
  • Corrections on refunds
  • Offline-24 mode
  • Invoice e-mailed to the buyer
  • Reconciliation dashboard
Growth · most popular $29 / mo up to 500 documents per month
Everything in Starter, plus:
  • Export to Fakturownia / inFakt — invoices where your accountant works
  • Import of historical orders
  • Custom templates and message branding
Pro $59 / mo no document limit
Everything in Growth, plus:
  • Multiple stores and multiple seller tax IDs
  • API access
  • 8 business-hour SLA (priority queue)
  • 14 days free — full functionality.
  • Above the limit: $0.10/document — we never block invoicing.
  • Overage has its own ceiling: at most $50 (Starter), $30 (Growth) per billing period. Once it is spent we keep filing and stop charging. The Pro plan has no document limit and no overage. At the published ceilings $59 is the most you pay on any plan — more only if you raise your own overage ceiling in Shopify yourself.
  • Support response within one business day on every plan.

One KSeF penalty costs more than a year of subscription.

KSeF for Shopify stores — what to do before 2027

A short guide written for the store owner. Plain language, no statute quotes: what changes in your store, and in what order to sort it out.

Who KSeF applies to

KSeF (Krajowy System e-Faktur, Poland's national e-invoicing system) covers taxpayers registered in Poland who invoice other businesses. If you sell B2B — wholesale, against a tax ID, on deferred payment — it applies to you directly, wherever you personally happen to live.

Consumer sales (B2C) are out of scope: receipts and invoices for private individuals stay outside the system. In practice Shopify stores are mixed, so the problem is not "whether" but splitting one order stream into two — and making sure an order with a tax ID never lands in the wrong one.

The dates that matter

April 2026 — issuing structured invoices becomes mandatory for all VAT taxpayers. The largest sellers (over 200 m zł of sales in 2024) have been issuing through KSeF since 1 February 2026 — and from that date every business receives its purchase invoices in the system. 1 January 2027 — the sanctions in art. 106ni of the VAT act take effect: up to 100% of the VAT on an invoice issued outside KSeF. No financial penalties are imposed between 1 February and 31 December 2026 — but tax-penal liability applies throughout. Until the end of 2026 a taxpayer whose gross sales in a given month stay under 10,000 zł may issue paper or electronic invoices outside KSeF.

The practical conclusion: 2026 exists so you can clean up buyer data with a clear head. The same project done in December is the same project — only with penalties in the background.

What FA(3) and UPO are

FA(3) is the current version of the structured-invoice schema — an XML file with strictly defined fields. "Structured" means PDFs and scans stop being an invoice as far as the system is concerned: what counts is a document in the schema, accepted by KSeF.

UPO (Urzędowe Poświadczenie Odbioru, the official confirmation of receipt) proves KSeF accepted the document, together with the number identifying the invoice. It is your proof of filing — worth keeping on the order, not in a separate folder.

How to issue a KSeF token

For any tool to file invoices on your behalf it needs authorisation in KSeF. The short version: you authenticate in the Ministry of Finance application — with a qualified electronic signature (podpis kwalifikowany), a company seal (pieczęć firmowa), or the Trusted Profile (Profil Zaufany) of an authorised person — grant the invoicing permission, generate a token and paste it into the app's configuration. The token is a secret: treat it like online-banking credentials and never send it by e-mail.

We will publish the full step-by-step instructions, with screenshots, as a separate guide before the app launches.

Direct filing or via Fakturownia

There are two sensible routes. Direct: the invoice is built from the Shopify order and goes straight to KSeF — fewest moving parts, the shortest path from order to UPO, the whole history in one place. Through an accounting system (Fakturownia, inFakt): the document is created where your accountant works and their software handles KSeF — convenient when accounting already issues some invoices by hand.

The choice comes down to one thing: who in your company owns the invoicing process. If it is the store — file directly. If it is accounting — integrate with their system. Both need the same foundation: a complete, valid tax ID on every B2B order.

Frequently asked questions

Do I need Shopify Plus?

No. The app works on every Shopify plan. On plans without checkout extensions we replace the checkout tax-ID field with post-purchase capture.

What about B2C orders?

KSeF does not cover B2C invoices. You see those orders separately in the dashboard, and they can become B2B once the customer supplies a tax ID — the document is then created as usual.

What if KSeF is down?

Offline-24 mode kicks in: the invoice reaches the customer without delay, and we retry the filing automatically and store the UPO once the system returns.

What happens to invoices issued earlier?

Historical documents stay where they are. The app handles orders from the moment of installation, and the audit shows which older ones are missing buyer data.

Do I have to change my store theme?

No. Installation does not modify theme code. The tax-ID field and the completion link are added as app elements.

Where do you keep the data?

In the European Union. Data is encrypted in transit and at rest, and backups stay in the EU as well. The KSeF token is held in a separate secret store.

What if my accountant works in Fakturownia?

We route documents into their system instead of filing directly. Tax-ID capture and validation work identically either way.

Is this tax advice?

We automate the paperwork. Tax and legal decisions stay with you and your accountant.

Start with a free order audit

We'll show how many of your B2B orders lack a valid tax ID — while fixing it is still cheaper than a rejected filing.