Ein ERP-System Schritt für Schritt an KSeF anbinden

Die Integration eines ERP-Systems mit dem polnischen Nationalen E-Rechnungssystem KSeF (Krajowy System e-Faktur) sollte das ERP-Dokument mit seinem Verarbeitungsergebnis, der KSeF-Nummer und der amtlichen Empfangsbestätigung UPO (Urzędowe Poświadczenie Odbioru) verknüpfen. Ein separater Prozess muss Eingangsrechnungen abrufen und zur Freigabe oder Buchung weiterleiten.

Prüfen Sie vor der Auswahl einer Lösung die genaue ERP-Version, Erweiterungen und Rechnungsarten. Ein Herstellerkonnektor, eine Zwischenschicht und eine selbst entwickelte API-Anbindung können innerhalb einer Architektur zusammenarbeiten.

Mit dem Versand beginnt die Verarbeitung. Erst das endgültige Ergebnis erlaubt es, eine Rechnung als angenommen zu kennzeichnen. Wenn eine Antwort verloren geht, klären Sie zunächst das Ergebnis des vorherigen Vorgangs, statt das Dokument erneut zu versenden.

Nehmen Sie die Integration anhand von Tests zu Fehlerfällen, Wiederherstellung und Vollständigkeit der Eingangsrechnungen ab. Für Offline-Verfahren gelten unterschiedliche Fristen. Ein lokales Internetproblem ist keine offiziell bekannt gegebene KSeF-Störung.

1. Umfang und Verantwortlichkeiten

2. Konnektor, Middleware oder eigene API-Anbindung

3. Zugriff und Umgebungen

4. Datenmapping

5. Ausgangsrechnungen, Status und UPO

6. Empfang von Eingangsrechnungen

7. Fehler und Wiederholungen

8. Offline-Verfahren und Störungen

9. 12 Abnahmetests

10. Produktivstart und Wartung

11. Kosten und Angebotsanfrage

12. Funktionsumfang von KSeFGPT

13. Häufig gestellte Fragen

Beginnen Sie mit einer Liste der Gesellschaften, Steuerpflichtigenkontexte und Stellen, an denen Rechnungen entstehen. Unterscheiden Sie zwischen inländischen B2B-Umsätzen, Verkäufen an Verbraucher, Auslandsgeschäften, Anzahlungen, Rechnungskorrekturen und Gutschriften im Selbstfakturierungsverfahren. Berücksichtigen Sie auch Fälle aus ERP-Erweiterungen und nicht nur das Standardformular für Ausgangsrechnungen.

Die KSeF-Pflicht richtet sich nach dem Steuerpflichtigen und dem Dokument. Eine Umsatzsteuerbefreiung führt nicht automatisch zu einer Ausnahme; Rechnungen an Verbraucher können freiwillig über KSeF ausgestellt werden. Legen Sie die Regeln gemeinsam mit der Buchhaltung fest. Weder eine polnische Steueridentifikationsnummer NIP allein noch die Rechnungswährung entscheidet über die Einordnung. Diese Vorgaben betreffen den polnischen Rechtsrahmen und gelten nicht automatisch für deutsche Unternehmen.

Die Buchhaltung bestätigt die steuerlichen Regeln und Rechnungsdaten. Die ERP-Administration prüft die Datenquellen sowie die Kompatibilität von Version und Erweiterungen. Der Integrator ist für Übertragung, Statusverarbeitung und Wiederherstellung verantwortlich. Benennen Sie außerdem eine Person, die auf Rückstände in der Warteschlange reagiert, und ein Team, das Eingangsrechnungen freigibt.

Das Ergebnis ist eine unterzeichnete Matrix mit Dokumentart, Datenquelle, Ausstellungsverfahren, Empfänger, verantwortlicher Person und Abnahmekriterium. Für den Versand von Ausgangsrechnungen und den Empfang von Eingangsrechnungen gelten separate Anforderungen. Verschieben Sie die Einrichtung des Empfangs nicht bis zur Inbetriebnahme des Versands.

Lassen Sie sich vom Anbieter die Kompatibilität mit der konkreten ERP-Produktfamilie und Version, den Updates, Modulen und individuellen Anpassungen bestätigen. Eine allgemeine Aussage zur KSeF-Unterstützung sagt nichts darüber aus, welche Rechnungskorrekturen unterstützt werden, ob Eingangsrechnungen empfangen werden können oder wie die KSeF-Nummer beim Dokument gespeichert wird.

Ein Konnektor ist ein fertiges Anbindungsmodul, das üblicherweise vom Hersteller oder einem Partner gewartet wird. Middleware bildet eine Zwischenschicht zwischen Systemen und kann Warteschlangen und Datenmapping verwalten. Eine eigene Integration erfordert ein Team, das den gesamten API-Kommunikationszyklus betreut. Die Zwischenschicht kann einen Konnektor nutzen; die Lösungen schließen sich daher nicht zwingend gegenseitig aus.

Das Ergebnis ist ein Datenflussdiagramm mit einer Vereinbarung über die Verantwortlichkeiten. Halten Sie für jeden Übergang fest, wo Daten dauerhaft gespeichert werden, wer Fehler behebt und wie die Daten ins ERP zurückgelangen. Verlangen Sie vor dem Kauf eine Demonstration anhand eigener anonymisierter Szenarien.

Die Authentifizierung bestätigt die Identität. Berechtigungen legen fest, welche Vorgänge im jeweiligen Kontext zulässig sind. Testen Sie das Ausstellen und Lesen von Rechnungen getrennt, auch nach dem Entzug einer Berechtigung. Eine erfolgreiche Anmeldung reicht für die Abnahme dieses Schritts nicht aus.

Ein KSeF-Zertifikat des Typs 1 dient der Authentifizierung. Typ 2 bestätigt den Rechnungsaussteller in den entsprechenden Offline-Verfahren. Ein Zertifikat verleiht keine Berechtigungen. Ein KSeF-Token ist ein anderes Authentifizierungsmittel als der kurzlebige Zugriffstoken, der bei der API-Kommunikation ausgegeben wird.

Das polnische Finanzministerium (MF) teilt mit, dass KSeF-Token unbefristet beibehalten werden. Prüfen Sie bei der Wahl der Zugriffsmethode die aktuellen Durchführungsvorschriften und die API-Dokumentation. Benennen Sie für die verwendete Methode eine verantwortliche Person für Erneuerung, Widerruf und sichere Aufbewahrung der Authentifizierungsmittel. Geheimnisse und vollständige Rechnungsdaten gehören nicht in gewöhnliche Diagnoseprotokolle.

TEST, DEMO und PROD müssen getrennte Konfigurationen, Warteschlangen, Archive und Synchronisationspunkte haben. Verwenden Sie in TEST anonymisierte Daten. DEMO nutzt echte Authentifizierungsmittel und Berechtigungen, die Rechnungen entfalten jedoch keine Rechtswirkung. PROD ist für echte Dokumente bestimmt, nicht für fiktive Testrechnungen.

Das Ergebnis ist ein bestätigter Zugriff in jedem benötigten Kontext sowie ein Test des Zugriffsverlusts und der Wiederherstellung. Vergleichen Sie vor dem Start den tatsächlich geltenden API-Vertrag der Produktionsumgebung mit dem Vertrag, den Sie in den Tests verwendet haben. Geplante Bereitstellungstermine im Changelog ersetzen diese Prüfung nicht.

FA(3) ist seit dem 1. Februar 2026 die Struktur der standardmäßigen strukturierten Rechnung in Polen. KSeF empfängt XML-Dateien, keine PDF-Dateien oder Tabellenblätter. Erstellen Sie für jede unterstützte Rechnungsart ein eigenes Datenmapping und ein Beispiel. Eine korrekte Zuordnung für eine gewöhnliche Ausgangsrechnung bestätigt noch nicht die Unterstützung von Anzahlungsrechnungen oder Rechnungskorrekturen.

Dokumentieren Sie im Mapping das ERP-Quellfeld, das Strukturelement, die Transformationsregel, die Bedingung für die Befüllung und die freigebende Person. Berücksichtigen Sie die Daten der beteiligten Parteien, Datumsangaben, Rechnungsnummer, Währung, Positionen, Steuersätze, Beträge, Zahlungen und Verknüpfungen mit früheren Rechnungen. Legen Sie fest, wie bei fehlenden Daten vorzugehen ist.

Die XSD-Validierung prüft die Übereinstimmung mit dem Schema. Prüfen Sie Geschäfts- und Steuerregeln separat: die Übereinstimmung der Summen, Rundungen, die Einordnung der Transaktion und die Richtigkeit einer Rechnungskorrektur. Unterscheiden Sie zwischen Pflichtfeldern des Schemas, alternativen Varianten und Feldern, die nur in bestimmten Fällen erforderlich sind.

Das Ergebnis ist ein freigegebenes Mapping mit einem Satz von Testdokumenten für alle zugesagten Szenarien. Bei jedem abgelehnten Dokument sollte der Nutzer die Ursache und die Stelle erkennen können, an der eine Korrektur erforderlich ist. Die Grundlagen des Formats erläutert der Leitfaden zu XML und FA(3).

Der Ablauf für Ausgangsrechnungen umfasst die Erstellung und Validierung der XML-Datei, das Öffnen einer Sitzung und die Verschlüsselung, den Versand, die Prüfung des Ergebnisses jeder Rechnung sowie die Speicherung von KSeF-Nummer und UPO. Die Annahme einer Anfrage zur Verarbeitung bedeutet noch nicht, dass die Rechnung angenommen wurde. In einer Sitzung mit mehreren Dokumenten können einige angenommen und andere abgelehnt werden.

Bewahren Sie exakt die versandte XML-Datei und ihren Hashwert auf. Ein dauerhaftes Vorgangsregister sollte die ERP-Rechnung mit dem Versandversuch, den Referenzen und dem Ergebnis verknüpfen. Die eigene Rechnungsnummer, technische Referenzen und die KSeF-Nummer sind unterschiedliche Identifikatoren.

Unterscheiden Sie die Zustände: vorbereitet, versandt und in Verarbeitung, Ergebnis unbekannt, abgelehnt, angenommen sowie UPO archiviert. Bei einer angenommenen Rechnung mit fehlender UPO muss die Bestätigung abgerufen werden; die Rechnung darf nicht erneut versandt werden. Die UPO bestätigt den Empfang durch KSeF. Sie bestätigt weder die Abnahme der Lieferung noch die Buchung oder Zahlung.

Das Ergebnis ist die Möglichkeit, den Verlauf einer einzelnen Rechnung nachzuvollziehen, ohne wahllos Protokolle durchsuchen zu müssen. Nach der Annahme erfordert eine Datenänderung das vorgesehene Verfahren für Rechnungskorrekturen. Die angenommene XML-Datei darf nicht überschrieben werden.

Eingangsrechnungen werden für den richtigen Kontext und die jeweiligen Rollen des Unternehmens aus KSeF abgerufen. Eine über das System empfangene Eingangsrechnung sendet der Käufer nicht erneut als eigene Ausgangsrechnung. Bewahren Sie nach dem Abruf XML und Metadaten auf, identifizieren Sie den Geschäftspartner und die Verknüpfungen von Rechnungskorrekturen und leiten Sie das Dokument anschließend in den passenden ERP-Workflow weiter.

Beim Empfang über KSeF gilt grundsätzlich der Tag der Vergabe der KSeF-Nummer als Empfangsdatum, nicht der Tag des späteren Imports. Für Notfallverfahren und die Übermittlung an bestimmte Empfänger außerhalb des Systems gelten eigene Regeln. Der Abruf einer Rechnung bedeutet weder die Freigabe des Aufwands noch eine Berechtigung zum Vorsteuerabzug.

Ein inkrementeller Abruf benötigt eine verlässliche Vollständigkeitsgrenze. Die MF-Dokumentation beschreibt das Datum der dauerhaften Speicherung, PermanentStorage, und den HWM-Marker, der den Bereich verfügbarer Dokumente abgrenzt. Ersetzen Sie ihn weder durch die Uhrzeit Ihrer lokalen Systemuhr noch durch das Ausstellungsdatum der Rechnung.

Verarbeiten Sie sämtliche Ergebnisseiten, Exportteile und abgeschnittenen Bereiche. Dokumente an den Bereichsgrenzen können erneut erscheinen. Entfernen Sie deshalb Dubletten anhand der KSeF-Nummer innerhalb der richtigen Umgebung und des richtigen Kontexts. Verschieben Sie den Synchronisationspunkt erst, nachdem der gesamte verarbeitete Bereich dauerhaft gespeichert wurde.

Das Ergebnis ist ein abgeglichener Bestand an Eingangsrechnungen, der auch nach verzögerter Speicherung, erneutem Abruf und einem Importfehler vollständig bleibt. Eine Rechnung, die in mehreren Rollen sichtbar ist, darf nicht mehrere Zahlungsverbindlichkeiten erzeugen.

Ein Beispiel: Das ERP hat den Versand beauftragt und KSeF die Verarbeitung begonnen, aber die Verbindung bricht vor dem Empfang der Antwort ab. Speichern Sie den Zustand Ergebnis unbekannt. Wenn Sie die Rechnungsreferenz haben, fragen Sie den Status ab. Liegt nur die Sitzungsreferenz vor, gleichen Sie die Dokumente der Sitzung ab. Erzeugen Sie keine geänderte XML-Datei allein deshalb, um die Übertragung zu wiederholen.

Steuern Sie Wiederholungen aus dem dauerhaften Vorgangsregister heraus und lassen Sie pro Dokument nur eine aktive Verarbeitungsinstanz zu. Der Duplikatstatus mit dem Code 440 ist ein Verarbeitungsstatus der Rechnung und kein HTTP-Statuscode. Nutzen Sie die zurückgegebene Verknüpfung zum ursprünglichen Dokument. Eine lokale Prüfung bleibt erforderlich: Dieselbe Rechnung kann aus geschäftlicher Sicht unterschiedliche technische Daten aufweisen.

Beachten Sie bei HTTP 429 die durch Retry-After vorgegebene Wartezeit und begrenzen Sie den Verkehr der betreffenden Anfragegruppe. Ein XML-Fehler erfordert eine Datenkorrektur. Fehlende Berechtigungen erfordern einen Eingriff der Administration. Vorübergehende Lesefehler können mit zunehmenden Warteintervallen erneut versucht werden. Jeder Versuch muss Referenzen und Fortschritt bewahren.

Das Ergebnis ist eine kontrollierte Warteschlange für Eingriffe und ein Abgleich zwischen ERP, Register und KSeF. Nach einem Prozessneustart sollte je nach gespeichertem Zustand der Versand, die Statusabfrage oder der Abruf fortgesetzt werden. Nach der Wiederherstellung einer älteren Datenbanksicherung müssen die Dokumente abgeglichen werden, die nach Erstellung dieser Sicherung bereits angenommen wurden.

Das Verfahren richtet sich nach der Ursache und der offiziellen Mitteilung. Offline24 kann auch auf Entscheidung des Steuerpflichtigen oder bei einem Internetproblem eingesetzt werden. Eine lokale ERP-Störung berechtigt nicht automatisch zur Nutzung der Frist für eine offiziell bekannt gegebene KSeF-Störung.

Die folgenden Fristen entsprechen den am 15. Oktober 2026 geprüften Informationen des polnischen Finanzministeriums. Offline24 bedeutet nicht 24 Zeitstunden. Die Warteschlange muss Arbeitstage zählen, Mitteilungen verfolgen und vor Fristablauf alarmieren. Wird zwischenzeitlich eine weitere Störung bekannt gegeben, müssen die passenden Übergangsregeln zwischen den Verfahren angewendet werden.

Bei offline24, Nichtverfügbarkeit und im Notfallmodus gilt das im Feld P_1 angegebene Datum als Ausstellungsdatum. Das Empfangsdatum hängt vom Verfahren und der Empfängerkategorie ab. Bei inländischem Empfang in KSeF unter offline24 und bei Nichtverfügbarkeit ist dies grundsätzlich die Vergabe der KSeF-Nummer. Im Notfallmodus ist es grundsätzlich das frühere Datum des tatsächlichen Empfangs oder der Nummernvergabe.

Bei einer Übermittlung vor der Nachreichung an KSeF an die in Art. 106gb Abs. 4 des polnischen Umsatzsteuergesetzes genannten Empfänger sind die entsprechenden Kennzeichnungen OFFLINE und CERTYFIKAT mit einem Zertifikat des Typs 2 erforderlich. Für einen inländischen Käufer mit NIP beschreibt das MF eine Transaktionsbestätigung, die keine Rechnung ist. Nach der Annahme trägt eine außerhalb von KSeF übermittelte Visualisierung einen QR-Code mit der KSeF-Nummer. Bei einem Totalausfall sind weder ein KSeF-QR-Code noch die Nachreichung der Rechnung erforderlich.

Das Ergebnis ist eine Arbeitsanweisung: wie das Verfahren ausgewählt wird, was dem Empfänger auszuhändigen ist, wann das Dokument nachzureichen ist und wer die Frist kontrolliert. Die bloße Speicherung der XML-Datei in der Warteschlange schließt diesen Schritt nicht ab.

Dokumentieren Sie für jeden Test die Eingabe, das erwartete Ergebnis, den Ausführungsnachweis und die für die Freigabe verantwortliche Person. Verwenden Sie anonymisierte Beispiele, die alle zugesagten Rechnungsarten abdecken. Die folgenden Kriterien sind Empfehlungen für die Abnahme einer Integration, kein amtliches Konformitätszertifikat.

Nehmen Sie zunächst die Tests in den nichtproduktiven Umgebungen ab. Beginnen Sie in der Produktion mit einem begrenzten Pilotbetrieb anhand echter, korrekt vorbereiteter Dokumente und legen Sie fest, wer die Ergebnisse prüft. Testen Sie die Rückkehr zum alten System nicht durch erneutes Ausstellen bereits in KSeF angenommener Dokumente.

Das Monitoring sollte das Alter der ältesten Rechnung in der Warteschlange, unbekannte Ergebnisse, Ablehnungen, angenommene Rechnungen ohne UPO, Verzögerungen beim Empfang von Eingangsrechnungen, abgeschnittene Exporte und Zugriffsfehler anzeigen. Ordnen Sie jedem Alarm einen Empfänger und eine Reaktionszeit zu. Stimmen Sie die Schwellenwerte auf das Volumen und die Fristen Ihres Unternehmens ab.

Die Wartung umfasst ERP- und API-Updates, Schlüsselrotation, Erneuerung der Authentifizierungsmittel, Sicherungen und Wiederherstellungstests. Eine Mapping-Änderung sollte Tests für alle betroffenen Rechnungsarten auslösen. Gleichen Sie regelmäßig die Anzahl und Identifikatoren der Dokumente zwischen ERP, Integrationsarchiv und KSeF ab.

Das Ergebnis ist ein Abnahmeprotokoll mit einer Anweisung für Störfälle und einer benannten verantwortlichen Person für die Wartung. Der Anbieter sollte außerdem erläutern, wie XML-Dateien, UPO, Vorgangshistorie und Konfiguration bei Beendigung der Zusammenarbeit übergeben werden.

Vergleichen Sie Angebote mit identischem Leistungsumfang. Die Kosten hängen von der Anzahl der Gesellschaften und Systeme, der Verfügbarkeit eines fertigen Konnektors, ERP-Anpassungen, Rechnungsarten, Datenqualität, Volumen, dem Empfang von Eingangsrechnungen und dem erforderlichen Wartungsniveau ab. Der Lizenzpreis allein deckt Analyse, Tests und Störfallbearbeitung nicht automatisch ab.

Geben Sie in Ihrer Angebotsanfrage ERP-Version, Erweiterungen, Prozessliste, Volumen und Spitzenzeiten an. Verlangen Sie getrennte Preise für Einführung, Lizenzen, Infrastruktur, Wartung und Änderungen. Fügen Sie die Mapping-Matrix und die Abnahmekriterien bei, damit Sie tatsächlich vergleichbare Angebote bewerten können.

Legen Sie fest, wer Quelldaten korrigiert, Offline-Fristen überwacht und unbekannte Ergebnisse abgleicht. Fragen Sie nach Updates bei API-Änderungen, Reaktionszeiten, Verantwortungsumfang und Datenzugriff nach einem Anbieterwechsel. Ohne diese Vereinbarungen kann das günstigste Angebot lediglich die XML-Übertragung umfassen.

KSeFGPT bietet eine fertige Anbindung an Fakturownia.pl: Konfiguration über Subdomain und API-Token, Vorschau, Einzel- oder Sammelversand sowie Ergebnisprüfung. Ausgewählte Rechnungen aus KSeF können auch nach Fakturownia exportiert werden. Den Umfang beschreibt das Modul Integrationen.

Der Dateiimport ist ein anderer Weg als eine direkte ERP-Anbindung. PDF-Dateien erfordern OCR-Erkennung und Datenprüfung; CSV-, XLS- oder XLSX-Dateien müssen eingelesen und ihre Spalten zugeordnet werden. An KSeF wird die vorbereitete XML-Datei im FA(3)-Format übermittelt. Ob ein konkretes ERP Daten exportieren kann, muss anhand seiner Konfiguration bestätigt werden.

KSeFGPT hat derzeit keine direkte SAP-Integration. Das automatische Auslesen aus SAP und die Rückspeicherung der KSeF-Nummer in SAP sind weiterhin geplante Funktionen ohne angekündigten Termin. Übertragen Sie den Umfang der fertigen Fakturownia-Anbindung nicht auf beliebige ERP-Systeme. Werkzeuge für Rechnungsstellung und Datenaustausch ersetzen weder ein vollständiges Buchhaltungssystem noch die steuerliche Beurteilung.

Antworten auf Fragen zu Funktionsumfang, Bestätigungen und Abnahme der Integration.