KSeF für WooCommerce: Worauf sich polnische Shops vorbereiten müssen

Wenn Sie einen WooCommerce-Shop betreiben, der in Polen verkauft, ist KSeF eine der bedeutendsten anstehenden Änderungen bei der Rechnungsstellung. Die Rechnungsstellung verlagert sich weg von PDFs und E-Mail-Anhängen hin zu strukturierten elektronischen Dokumenten, die über eine zentrale staatliche Plattform ausgestellt werden. Die gute Nachricht: Fast die gesamte sinnvolle Arbeit, die Sie heute schon erledigen können, ist Datenhygiene, und Datenhygiene zahlt sich sofort aus, unabhängig davon, wann Ihre Phase beginnt. Dieser Leitfaden erklärt, was KSeF ist, wen es betrifft, wie saubere Rechnungsdaten tatsächlich aussehen und wie Polski for WooCommerce Ihren Shop vorbereitet, ohne vorzugeben, Ihr Buchhaltungssystem zu sein.

Was KSeF ist und warum es für Ihren Shop wichtig ist

KSeF (Krajowy System e-Faktur, das Nationale System für E-Rechnungen) ist die zentrale Plattform Polens zum Ausstellen und Empfangen von Rechnungen. Anstatt ein PDF zu erstellen und es per E-Mail an einen Kunden zu senden, übermittelt ein Verkäufer eine strukturierte E-Rechnung an KSeF. Das System validiert und registriert sie, weist ihr eine offizielle Kennung zu und stellt sie dem Käufer zur Verfügung. Die Rechnung ist damit kein Dokument mehr, das Sie gestalten, sondern ein Datensatz, den der Staat verwahrt.

Die entscheidende Veränderung besteht darin, dass die Rechnung zu einer festgelegten Datenstruktur wird statt zu einer frei gestaltbaren Datei. Ein PDF kann jedes beliebige Layout enthalten, eine strukturierte Rechnung muss bestimmte Felder in einem bestimmten Format enthalten, damit das System sie automatisch lesen kann. Für ein “das klärt schon die Buchhaltung” ist kein Platz mehr, wenn ein fehlender Firmenname oder eine fehlerhafte Steuernummer bei der Übermittlung zu einer Ablehnung führt.

Für eine WooCommerce-Shop-Betreiberin oder einen WooCommerce-Shop-Betreiber ist dies wichtig, weil Rechnungsdaten nicht mehr lose formatiert sein dürfen. Die Steuernummer des Käufers, der Firmenname, die Anschrift, die Positionen und die Mehrwertsteuersätze müssen alle sauber und konsistent erfasst werden, denn sie fließen direkt in das strukturierte Dokument ein. Alles, was Sie als unordentlichen Freitext an der Kasse erfassen, wird bei der Rechnungsstellung zum Problem.

Wer betroffen ist und die stufenweise Einführung

KSeF wird in Phasen eingeführt und nicht auf einen Schlag. Nach dem aktuellen Zeitplan werden die größten Steuerpflichtigen zuerst einbezogen, weitere Unternehmen folgen in späteren Stufen der stufenweisen Einführung. Ziel ist mit der Zeit eine breite Abdeckung der B2B-Rechnungsstellung für Unternehmen, die in Polen tätig sind.

Da sich regulatorische Zeitpläne verschieben können, sollten Sie jedes konkrete Datum, das Sie lesen, als vorläufig betrachten. Der verlässliche Weg besteht darin, den aktuellen Zeitplan und Ihre eigene Verpflichtung direkt beim Finanzministerium (Ministerstwo Finansow) und gegebenenfalls bei Ihrem Steuerberater zu prüfen. Was sich kaum ändern wird, ist die grundlegende Richtung: Strukturierte E-Rechnungen über ein zentrales System kommen, und die frühzeitige Vorbereitung Ihrer Daten kostet Sie sehr wenig und sorgt zugleich dafür, dass Sie bereit sind, sobald Ihre Phase eintritt. Ob und wann KSeF für Ihr konkretes Unternehmen gilt, ist eine Feststellung, die nur Sie und Ihr Berater treffen können.

Warnung: Betrachten Sie jedes konkrete KSeF-Datum, das Sie lesen, als vorläufig und bestätigen Sie den aktuellen Zeitplan, und ob er für Ihr Unternehmen gilt, beim Finanzministerium und bei Ihrem Steuerberater.

Welche Rechnungs- und Kundendaten korrekt sein müssen

Das von KSeF verwendete strukturierte Format (häufig als FA_VAT-Schema bezeichnet) setzt vollständige und wohlgeformte Daten voraus. In der Praxis lohnt es sich, folgende Bereiche in Ihrem Shop zu schärfen:

• NIP bei Geschäftskunden. Wenn ein Kunde als Unternehmen einkauft, benötigen Sie dessen polnische Steueridentifikationsnummer, an der Kasse erfasst und zur Bestellung gespeichert. Eine NIP mit der falschen Ziffernanzahl oder einer fehlgeschlagenen Prüfsumme fängt man besser am Point of Sale ab als bei der Übermittlung.
• Vollständige Käuferangaben. Firmenname, vollständige Anschrift und Postleitzahl müssen vorhanden und konsistent sein, nicht nur teilweise ausgefüllt oder auf unvorhersehbare Weise frei eingegeben.
• Korrekte Mehrwertsteuersätze. Jede Position muss den richtigen Mehrwertsteuersatz tragen. Uneinheitliche oder fehlende Sätze sind eine häufige Ursache für Rechnungsfehler.
• Ein klares Signal “ist dies eine Geschäftsbestellung”. Sie müssen pro Bestellung wissen, ob überhaupt eine Rechnung erwartet wird, damit Geschäftsbestellungen nicht wie anonyme Privatkäufe behandelt werden.
• Insgesamt saubere, strukturierte Daten. Da das Dokument maschinell gelesen wird, werden kleine Lücken, die ein Mensch verzeihen würde (ein fehlendes Feld, ein ungewöhnliches Zeichen, ein leerer Firmenname), zu echten Problemen.

Diese Grundlagen richtig zu erfassen, kommt Ihrer Buchhaltung schon heute zugute, unabhängig davon, in welche KSeF-Phase Sie fallen.

Tipp: Fast die gesamte nützliche Vorbereitung, die Sie heute leisten können, ist Datenhygiene, und sie zahlt sich für Ihre Buchhaltung sofort aus, unabhängig davon, wann Ihre Phase beginnt.

Was eine gute Vorbereitungsebene leisten muss

Ein WooCommerce-Shop braucht kein vollständiges KSeF-Gateway, das in jedes Plugin eingebaut ist. Er braucht eine Vorbereitungsebene, die einige wenige Dinge gut erledigt und dem Rechnungswerkzeug, das die Übermittlung am Ende vornimmt, nicht im Weg steht. Nutzen Sie das als Checkliste:

• Die NIP sauber an der Kasse erfassen, mit Validierung, damit fehlerhafte Nummern nie in eine Bestellung gelangen.
• An der klassischen und an der Block-Kasse funktionieren, denn Shops betreiben beide, und die Daten müssen in jedem Fall an derselben Stelle landen.
• Erkennen, welche Bestellungen eine Rechnung benötigen, damit Sie nicht jede Bestellung mit dem Auge prüfen müssen.
• Diesen Status dort sichtbar machen, wo Sie arbeiten, in der Bestellliste, nicht versteckt in einer Meta-Box.
• Hooks bereitstellen, damit eine dedizierte Rechnungs- oder Buchhaltungsintegration auf eine Bestellung reagieren kann, sobald sie bereit ist, ohne dass Sie etwas von Hand zusammenstecken.

Beachten Sie, was nicht auf dieser Liste steht: das tatsächliche Senden der Rechnungen an KSeF. Eine Vorbereitungsebene, die heimlich versuchte, ein Buchhaltungssystem zu sein, würde sich übernehmen. Die Aufgabe besteht darin, die Daten korrekt und den Bestellzustand lesbar zu machen, die Übermittlung bleibt einem Werkzeug überlassen, das dafür gebaut ist.

Hinweis: Das kostenlose Plugin ist eine Vorbereitungsebene, keine Rechnungs-Engine. Es erfasst die NIP, markiert Bestellungen und stellt Hooks bereit, doch das Erzeugen der Rechnung und das Übermitteln des KSeF-XML ist eine separate Aufgabe, die von PRO oder einem dedizierten Rechnungswerkzeug übernommen wird.

Wie Polski das löst

Polski for WooCommerce ist ein kostenloses, modulares Plugin für polnische Shops, und seine KSeF-Unterstützung ist bewusst als Vorbereitungsebene konzipiert, nicht als Rechnungs-Engine. Zwei Module erledigen die Arbeit: die B2B-Kassenfelder, die die Daten erfassen, und das KSeF-fähige Modul, das sie markiert und bereitstellt.

Die Daten an der Kasse erfassen

Das B2B-Kassenmodul ergänzt die Felder, die eine polnische Geschäftsbestellung benötigt. Es gibt einen optionalen Schalter “Kauf als Unternehmen”, ein NIP-Feld sowie optionale REGON- und IBAN-Felder, jeweils ein- oder ausgeschaltet, je nachdem, was Ihr Shop tatsächlich erheben möchte. Die NIP wird mit einer korrekten Prüfsumme validiert, sodass eine vertauschte Ziffer oder eine Nummer, die schlicht keine gültige NIP ist, an der Kasse mit einem klaren Hinweis abgelehnt statt unverändert gespeichert wird. REGON wird auf die korrekte Länge von 9 oder 14 Ziffern geprüft, und IBAN wird durchgängig validiert, einschließlich der Modulo-97-Prüfziffer nach ISO 13616, sodass eine falsch getippte Bankverbindung nicht durchrutscht.

Entscheidend ist, dass die Felder sowohl an der klassischen als auch an der Block-Kasse funktionieren. Auf modernem WooCommerce (8.6 und neuer) registriert Polski sie über die einheitliche Additional-Fields-API von WooCommerce, sodass sie nativ in der Block-Kasse erscheinen, und spiegelt die Werte zurück in die Standard-Bestell-Metadaten _billing_nip, _billing_regon und _billing_iban. Dieses Spiegeln ist wichtig: Es bedeutet, dass das KSeF-Modul, ein Rechnungswerkzeug oder ein Buchhaltungsexport alle dieselben vorhersehbaren Schlüssel lesen, ganz gleich, welche Kasse die Daten erfasst hat.

Bestellungen für KSeF markieren

Mit aktiviertem KSeF-fähigem Modul prüft Polski jede Bestellung bei der Aufgabe und entscheidet anhand des Vorhandenseins einer NIP, ob sie eine KSeF-Rechnung zu benötigen scheint. Es schreibt diese Entscheidung in die Bestellung und stellt eine KSeF-Spalte in der WooCommerce-Bestellliste bereit, die sowohl bei klassischer Speicherung als auch bei HPOS (High-Performance Order Storage) funktioniert. Eine Bestellung, die eine Rechnung benötigt, zeigt einen farbigen Statusmarker, eine, die keine benötigt, zeigt einen neutralen Strich. Auch der Bestelldetailbildschirm im Admin zeigt den KSeF-Status im Rechnungsbereich an. So sehen Sie auf einen Blick über einen ganzen Bildschirm voller Bestellungen, welche davon Geschäftsrechnungen sind, die noch bearbeitet werden müssen.

Die Hooks, in die sich eine Integration einklinkt

Hier verdient sich die Vorbereitungsebene ihren Namen. Die Entscheidung “ist dies erforderlich” läuft durch den Filter polski/ksef/is_required, sodass eine Integration oder Ihr eigener Code die Regel überschreiben kann (zum Beispiel, um auch Bestellungen ohne NIP zu markieren, die ein Häkchen “Rechnung erforderlich” tragen). Wenn festgestellt wird, dass eine Bestellung eine Rechnung benötigt, löst Polski die Aktion polski/ksef/invoice_ready aus und übergibt die Bestellung. Ein Rechnungs-Plugin, ein Buchhaltungsabgleich oder ein eigenes Skript kann auf diesen einzelnen Hook lauschen und seinen eigenen Prozess in dem Moment starten, in dem eine Bestellung bereit ist, mit bereits validierten und unter bekannten Meta-Schlüsseln gespeicherten NIP- und Rechnungsdaten. Sie erhalten die Verdrahtung, ohne den Klebstoff selbst zu schreiben.

Die Einrichtung

Die Vorbereitungsebene aktiv zu schalten, dauert nur ein paar Minuten:

1. Installieren Sie Polski for WooCommerce über Plugins > Installieren und aktivieren Sie es. WooCommerce muss installiert und aktiv sein.
2. Öffnen Sie das Menü Polski und gehen Sie zu Module.
3. Aktivieren Sie die B2B-Kassenfelder, damit die NIP (und, falls gewünscht, REGON und IBAN) an der Kasse erhoben wird. Wählen Sie, welche Felder angezeigt werden.
4. Aktivieren Sie das KSeF-fähige Modul, damit Bestellungen markiert werden und die KSeF-Spalte in der Bestellliste erscheint.
5. Stellen Sie sicher, dass Ihre WooCommerce-Mehrwertsteuersätze korrekt sind, da die positionsbezogene Mehrwertsteuer Teil jeder strukturierten Rechnung ist.
6. Geben Sie eine Testbestellung mit einer Firmen-NIP auf und prüfen Sie, ob sie in der Bestellliste markiert ist und auf dem Bestellbildschirm einen KSeF-Status zeigt.

Da Polski HPOS-kompatibel ist und sowohl den klassischen als auch den Block-Warenkorb und die Block-Kasse unterstützt, fügt es sich sauber in eine moderne WooCommerce-Installation ein. Die Module sind unabhängig, sodass Sie nur die KSeF- und B2B-Bausteine betreiben und den Rest des Plugins ausgeschaltet lassen können.

Praktische Tipps, um jetzt bereit zu werden

Ein Plugin liefert den Mechanismus, die Disziplin liegt bei Ihnen. Einige praktische Hinweise:

• Schalten Sie die NIP-Validierung ein, bevor Sie sie brauchen. Eine fehlerhafte Steuernummer an der Kasse abzufangen, ist weit günstiger, als sie zu entdecken, wenn eine Rechnung abgelehnt wird. Die Validierung ist bereits vorhanden, sobald das Feld aktiviert ist.
• Gleichen Sie bestehende Kundendatensätze ab. Überprüfen Sie Geschäftskonten und ergänzen Sie jetzt fehlende Steuernummern und Anschriften, solange es Routine ist und nicht dringend.
• Standardisieren Sie die Erfassung von Firmendaten. Ein einziges, validiertes NIP-Feld ist besser, als Kunden ihre Steuernummer in das Bemerkungsfeld einfügen zu lassen, wo kein Werkzeug sie zuverlässig lesen kann.
• Entscheiden Sie sich früh für Ihr Rechnungswerkzeug. Die kostenlose Vorbereitungsebene markiert und stellt Bestellungen bereit, etwas muss das Dokument erzeugen und übermitteln. Zu wissen, ob das eine Buchhaltungsintegration oder ein dediziertes Rechnungs-Plugin ist, bestimmt, wie Sie die Hooks nutzen.
• Behandeln Sie Daten als vorläufig. Bauen Sie die Datendisziplin jetzt auf, damit die spätere Umstellung ein Konfigurationsschritt ist und keine Hauruckaktion.

KSeF-Bereitschaft im Vergleich zum Standard-WooCommerce

WooCommerce kann eine Bestellung entgegennehmen und erstatten, aber es kennt kein Konzept einer NIP, weiß nicht, welche Bestellungen Geschäftsrechnungen sind, und bietet keinen Hook, in den sich ein Rechnungssystem einklinken könnte. Hier der Unterschied speziell für die KSeF-Bereitschaft:

Funktion	Standard-WooCommerce	Polski for WooCommerce
NIP-Feld an der Kasse	Nicht eingebaut	Validiertes NIP-Feld, klassische und Block-Kasse
REGON- / IBAN-Erfassung	Keine	Optional, mit Längen- und Modulo-97-Validierung
NIP-Prüfziffernvalidierung	Keine	Ja, bei Ungültigkeit an der Kasse abgelehnt
Signal “Geschäftsbestellung”	Keines	Schalter “Kauf als Unternehmen” und Markierung pro Bestellung
Welche Bestellungen eine KSeF-Rechnung benötigen	Manuelles Raten	Automatisch bei Bestellaufgabe markiert
KSeF-Status in der Bestellliste	Keiner	Spalte bei klassischer und HPOS-Bestellliste
Integrations-Hooks	Keine	Filter is_required, Aktion invoice_ready
Erzeugen der Rechnung / des KSeF-XML	Keines	Manuell / extern (PRO ergänzt es)
Kosten	Kostenlos (keine KSeF-Kenntnis)	Kostenlos; PRO ergänzt Rechnungen und KSeF-XML

Kostenlos im Vergleich zu PRO

Die kostenlose Edition ist eine echte Vorbereitungsebene und kein Häppchen zum Anfüttern: validierte Erfassung von NIP, REGON und IBAN an der klassischen und der Block-Kasse, automatisches Markieren von Bestellungen, die eine KSeF-Rechnung benötigen, eine KSeF-Statusspalte in der Bestellliste sowie der Filter und die Aktion, in die sich eine Integration einklinkt. Für die meisten Shops, die sich vor ihrer Phase vorbereiten, ist das genau die Arbeit, die jetzt zu erledigen ist.

Polski PRO baut die Rechnungs-Engine obendrauf. Es ergänzt PDF-Rechnungen (Faktura VAT) mit Autonummerierung und KSeF-XML-Export, vollständige NIP-Validierung mit der GUS/REGON-API samt einer Kassen-Schaltfläche “Daten aus GUS abrufen”, die Firmennamen, Anschrift und REGON automatisch aus dem offiziellen Register ausfüllt, eine Steuerregel-Engine, die GTU- und JPK_V7-Codes zuweist, sowie einen Buchhaltungsabgleich mit wFirma, Fakturownia und iFirma. Es gibt außerdem einen Rechnungs-Markdown-Endpunkt, sodass Buchhaltungs- und Kundenservice-Werkzeuge Rechnungsdaten lesen können, einschließlich der KSeF-Referenz und des Status, ohne ein PDF zu parsen. Die kostenlose Ebene erfasst und markiert, PRO erzeugt und übermittelt.

Ein durchgehender Vorbehalt gilt für all dies: Polski stellt technische Module bereit, keine Rechtsberatung, und kein Plugin kann Konformität garantieren. Die Bestätigung, ob Ihr Shop die KSeF-Anforderungen erfüllt, bleibt Ihre Verantwortung, idealerweise mit Ihrem Steuerberater und auf Grundlage der offiziellen Vorgaben des Finanzministeriums.

Die Kurzfassung

KSeF verwandelt die Rechnung von einem PDF, das Sie gestalten, in einen strukturierten Datensatz, den der Staat validiert, was bedeutet, dass Ihre Rechnungsdaten sauber, vollständig und maschinenlesbar sein müssen, bevor Ihre Phase eintrifft. Standard-WooCommerce hat von all dem keine Kenntnis. Das kostenlose Polski for WooCommerce schließt die Vorbereitungslücke: Es erfasst eine validierte NIP (plus optional REGON und IBAN) an der klassischen und der Block-Kasse, markiert, welche Bestellungen eine KSeF-Rechnung benötigen, zeigt diesen Status in der Bestellliste an und stellt Hooks bereit, auf die ein Rechnungswerkzeug reagieren kann. PRO ergänzt die Engine, die Faktura-VAT-PDFs erzeugt, KSeF-XML exportiert, gegen GUS validiert und mit Ihrem Buchhaltungssystem abgleicht, wenn Sie bereit sind, den Rest zu automatisieren.