KSeF Kit

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. This page walks through that promotion step by step.

What a test filing proves

TEST is the KSeF sandbox: you file with a real token, you get a real UPO (receipt), but nothing has any effect on the authority's side. It's a safe place to confirm everything is wired up.

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.

In other words: if a test invoice filed, a production invoice will file the same way. That's why TEST comes first. See Connecting KSeF.

The readiness checklist

Readiness is five steps, each with a simple "done?" flag. The whole list turns deadline pressure into a calm, green checklist:

  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 test filing — you filed successfully in the TEST environment.
  5. First production filing — an invoice filed to KSeF for real.

You can do the first four in any order and without rushing — it all happens in the sandbox. The fifth step only follows the deliberate switch to PROD described below. Track your progress under the Readiness tab.

One switch to PROD

Once your test filings work, it's time for production. The promotion is deliberately a "one switch, with confirmation":

  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).
  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. It's a guard against landing on production by accident.

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

KSeF mandatory from 1 January 2027 — you're filing ✓

KSeF is becoming mandatory: for the largest taxpayers from February 2026, for all VAT businesses from April 2026, with penalties starting 1 January 2027. It's worth being ready early.

When all five steps are green, the top of the Readiness tab reads "You're ready — you're filing invoices ✓". From then on KSeF Kit quietly files your invoices to KSeF, and you get back to running the business.