Skip to content

Check a KSeF FA(3) file against the schema

Beta This tool is in beta. It is tested on sample files, and details may still change. Review the result before relying on it.

Check a Polish KSeF FA(3) XML file against the official FA(3) schema and see each error with its line. Schema only, in beta. Free within the daily limit.

No file to hand? Try a sample invoice

In short

Check an invoice against its applicable EN 16931 and national rule set. Read each finding and guidance on what to correct. Free, 10 a day without an account.

What the check covers

Klarbon checks the XML against the official schema and the business rules of the rule set for its format and version, listed below, and checks a PDF for PDF/A-3 conformance and the invoice metadata Factur-X and ZUGFeRD require. It does not verify digital signatures, and a pass does not show that the tax treatment is right or that the recipient or a platform will accept the file.

Rule sets and versions

Klarbon chooses the rule set from what the file declares.

Specification Version Covers
KSeF FA(3) 1-0E Official schema only

Klarbon checks a Polish KSeF FA(3) invoice file against the official FA(3) schema from the Ministry of Finance and shows each error with its line and column. It is a schema check only, in beta: it does not run KSeF's own checks on receipt and sends nothing to KSeF. Free for ten checks a day, fifty with a free account.

What does the check cover?

The file's structure, as the official schema defines it: which elements must be there, in what order, how often, and what each value may look like (dates, amounts, NIP formats, code lists such as VAT rates). The FA(3) schema is published in the Central Repository of Electronic Document Templates (FA(3) schema), and FA(3) has been the invoice structure for KSeF since 1 February 2026 (Ministry of Finance, in Polish). Klarbon fetches the schema and the files it imports from their official addresses, pins each by its checksum and uses them unchanged.

Checked Not checked
Required elements, their order and how often they occur whether the NIP numbers exist or are registered
Value formats and code lists defined in the schema whether totals and VAT add up
The limit of 10,000 invoice lines KSeF's checks on receipt, such as who sends the invoice

How do I check a KSeF file?

  1. Upload the FA(3) XML file. Klarbon recognises FA(3) from its content, whatever the file is called.
  2. Read the result. It names the schema and its version and lists each error with the line and the column, a plain explanation of the common errors, and the validator's own message under the technical details.
  3. Correct the file in your invoicing software and check it again.

A missing invoice number (P_2), for example, is reported as an element the schema expected and did not find, with the line where FA(3) needs it.

Does a valid file mean KSeF will accept the invoice?

No. A valid result means the file matches the FA(3) structure. KSeF decides whether it accepts the invoice and assigns a KSeF number only then (Ministry of Finance, in Polish). It also checks things the file cannot show. Klarbon does not log in to KSeF, does not submit invoices and does not assign numbers.

What happens to my file?

It is sent to Klarbon's servers, checked in memory and deleted after the request. Klarbon keeps no copy and does not log the invoice's content. See what happens to my files. To read the invoice without uploading it, open the KSeF invoice in your browser.

What does it cost?

Checking is free: ten a day without an account, fifty with a free account, up to 2000 a day with Pro and Accountant. See prices.

See also

Frequently asked questions

What does the KSeF validator check?

It checks the XML file against the official FA(3) schema published by the Polish Ministry of Finance, and the schemas it imports. Each error comes with its line and column. It is a schema check only. It does not run any further checks KSeF makes when it receives an invoice, and it does not send anything to KSeF.

If the file passes, will KSeF accept the invoice?

Not necessarily. Passing means the file matches the FA(3) structure. KSeF decides whether it accepts the invoice and also checks things a file cannot show, such as who is sending it.

Can it check FA(2) files?

No. FA(3) has replaced FA(2), and Klarbon checks FA(3) only. An FA(2) file is refused, is not counted against your daily checks and costs nothing.

Are the errors explained in plain words?

The common ones are, in your language. A missing or misplaced element, a value in the wrong form, an empty field, a value that is not on the allowed list or too many lines each get a plain explanation and a fix. It names the element and, for the best-known FA(3) fields such as P_2, what the field holds. Rarer schema errors appear as the validator writes them, in English. The validator's own message is always kept under the technical details.

How many files can I check for free?

Ten a day without an account and fifty with a free account. Pro and Accountant allow up to 2000 checks a day.

Sources

Updated 21 November 2026