getreadystack/ksef-fa3-invoice-lint repository overview

⁠KSeF FA(3) Invoice Lint

Finds the lines KSeF will reject in a Polish structured invoice XML, before you send it

⁠Run

docker run --rm -v "$PWD":/work getreadystack/ksef-fa3-invoice-lint /work/file

The same 18 rules as the VS Code extension, in a container. Mount a folder on /work.

⁠Free

• Lints the invoice XML open in your editor or pasted into the free web page against 18 FA(3) rules and names every field KSeF rejects with the exact value it wants: the 2025/06/25/13775 namespace, kodSystemowy "FA (3)", WariantFormularza 3, 10-digit NIP, dot decimals, P_16-P_18A flags. Our dirty sample invoice returns 23 findings, 22 of them blocking. One file, no key, no account.
• --rules lists every rule

⁠With a licence ($29 once)

• Sweeps every invoice XML in the workspace in one run - a whole export batch, not one file - and writes a dated REPORT.md you keep: file, line, rule, found value, wanted value. That written record is your own audit evidence for the 2027-01-01 penalty regime, where a KSeF failure carries up to 100% of the invoice VAT (18.7% of gross on VAT-exempt invoices).

docker run --rm -e READYSTACK_LICENSE=<key> -v "$PWD":/work getreadystack/ksef-fa3-invoice-lint --dir /work --ci

A mid-size KSeF ERP integration project in Poland costs PLN 10,000 to PLN 50,000 and runs 2 to 4 months (ELTE-S, 2026)

⁠Use from an AI agent (MCP)

Claude Code · Cursor · Windsurf · any MCP client - add to your MCP config:

{ "mcpServers": { "ksef-fa3-invoice-lint": { "command": "npx", "args": ["-y", "@readystack/ksef-fa3-invoice-lint", "--mcp"] } } }

Tools: check_text and check_file (free) · check_dir (licence). The agent gets every finding with the line number.

⁠Use in CI

- name: KSeF FA(3) Invoice Lint
  run: npx -y @readystack/ksef-fa3-invoice-lint --dir . --ci

(container: docker run --rm -v "$PWD:/work" getreadystack/ksef-fa3-invoice-lint --dir /work --ci)

The folder sweep, reports and CI mode need one licence — one payment, no subscription. Set READYSTACK_LICENSE=<key> or run --license <key> once.

Get a licence⁠