KSeF e-Invoicing for Poland changelog

All notable changes to KSeF e-Invoicing for Poland (kv_ksef) are documented here. The format follows Keep a Changelog and the project uses Semantic Versioning.

[Unreleased]

[1.0.0] - 2026-11-05

Added

FA(3) structured invoices (schema FA (3) 1-0E) built from orders: buyer NIP / EU VAT ID / other tax ID, VAT rates 23, 22, 8, 7, 5, 4, 3 and 0 %, zw, oo, np I, np II, 0 WDT, 0 EX and OSS, gross or net method, discounts, shipping and payment surcharge lines, paid or due date, bank account, order reference, KRS / REGON / BDO footer, VAT in PLN for other currencies.
Validation of every file against the official FA(3) XSD (shipped with the add-on) and business checks before sending.
KSeF API 2.0 client: KSeF token login (RSA-OAEP SHA-256) and certificate login (XAdES-BES), cached access and refresh tokens, encrypted interactive sessions, status polling, UPO download, invoice download, metadata query; Test, Demo and Production environments.
KSeF numbers (CRC-checked), UPO receipts and KOD I verification links with QR codes stored per document.
Correction invoices (KOR) with lines before and after, full or partial, manual or at order statuses; they wait for the KSeF number of their invoice.
Split payment mark (MPP) for Annex 15 goods on B2B invoices of PLN 15,000 or more; GTU codes and units per product.
Offline queue with Polish business-day send deadlines, retries with back-off and offline mode sending; adoption of the original KSeF number after a lost answer (duplicate).
Admin pages: KSeF invoices list with status tiles and connection cards, document page, KSeF connection, tax and payment mapping, incoming invoices, correction form, KSeF tab on the order page, bulk creation from the orders list, printable view.
Customer order page: KSeF number, QR code, printable view and XML download.
Multi-Vendor: vendors connect their own NIP and KSeF token and issue their own invoices with their own numbering, or the marketplace issues all invoices.
Gapless own numbering or the numbers of Invoices & Credit Notes; buyer tax ID field shared with EU VAT Number Validation and EU e-Invoicing.
Cron command and cron URL for the send queue; license client and self-healing upgrades.