Going live (TEST → PRODUCTION)

You file in the TEST environment first (the KSeF sandbox) — with no consequences. Once that works, one deliberate switch moves you to PRODUCTION, where invoices go to KSeF for real.

What a test filing proves

TEST is the KSeF sandbox: you get a real UPO (receipt), but nothing has any effect on the authority's side.

A successful test filing proves three things at once:

• The connection works — your token authenticates in the chosen environment.
• The data is complete — the invoice passes FA(3) schema validation: NIP, name, address, amounts and rates are all in place.
• The whole path is clear — from a Stripe invoice, through a KSeF session, to the UPO and the write-back of the number.

If a test invoice filed, a production invoice will file the same way. See Connecting KSeF.

The readiness checklist

The readiness checklist has five steps:

1. Stripe connected — we can see your finalized invoices.
2. NIP verified — your NIP passes validation.
3. KSeF connected — the token authenticates you with the authority.
4. First filing accepted (test or live) — a filing was accepted, in the test or the production environment. (If you connected straight to production, there's no practice mode — this ticks with your first real filing.)
5. First production filing — an invoice filed to KSeF for real.

The fifth step only follows the switch to PROD described below. Track your progress under the Readiness tab.

One switch to PROD

Once your test filings work, move to production:

1. In Connecting KSeF, connect the PROD environment — paste a production token generated in the KSeF taxpayer app for your NIP. A TEST token won't work on PROD (and vice versa). Your NIP stays the same; only the token is new.
2. Switch the active environment to PROD. This switch requires an explicit confirmation — from that moment invoices go to KSeF for real, with effects on the authority's side.
3. You can't switch to PROD without a connected production token — if one is missing, we ask you to connect it first.

After the switch, your first successful production invoice completes the fifth step of the readiness checklist.

Important — we never file a synthetic sample into production. A fictitious document in the national registry would breach the law (art. 108 VAT). So a fresh production account with nothing to file shows a "You're live" state, not a test filing. Your first real Stripe invoice files automatically. To rehearse, use TEST.

KSeF is already mandatory, and you're filing ✓

From 1 February 2026 KSeF applies to businesses whose 2024 sales exceeded 200 million zł, and from 1 April 2026 to all other VAT taxpayers, VAT-exempt ones included. If your KSeF-obligated sales are at most 10,000 zł a month, you may wait until 1 January 2027. Penalties also apply from that date, unless a government bill moving them to 1 January 2028 becomes law.

When all five steps are done, the top of the Readiness tab reads "You're ready — you're filing invoices ✓".