Übermittlung, Status und UPO
Übermittelt ist nicht dasselbe wie angenommen. Der Nachweis ist das UPO.
Eine Prüfung fragt nicht nach dem XML. Sie fragt nach der amtlichen Empfangsbestätigung und nach der Antwort, welchen Zeitraum und welche Gesellschaft sie betrifft. Der Zyklus schließt sich erst, wenn bei der Datei die Referenznummer, der Status der Schnittstelle und das heruntergeladene UPO stehen — auch abrufbar, wenn jemand fragt, der die Übermittlung nicht gemacht hat.
- schritt 1
Erzeugt
Die Datei, gebaut aus den Daten, die Ihr System übergeben hat.
- schritt 2
Schemakonform
Gegen das offizielle XSD geprüft — vor dem Versand.
- schritt 3
Übermittelt
Die Schnittstelle hat die Sendung angenommen und eine Referenznummer zurückgegeben.
- schritt 4
Angenommen
Das UPO heruntergeladen und bei der Datei archiviert, je Zeitraum und je Gesellschaft.
Schritt drei und vier stehen getrennt, weil es zwei verschiedene Ereignisse sind. Die Schnittstelle kann die Sendung annehmen und eine Referenznummer zurückgeben, und die Bestätigung entsteht dennoch nicht — darüber entscheidet auch die Berechtigung zur Übermittlung, unabhängig von der Schemakonformität der Datei.
Warum das Dokument das UPO ist und nicht die Datei
Das UPO ist die amtliche Empfangsbestätigung — das Dokument, das das System des Ministeriums nach der Verarbeitung der Sendung ausstellt. Es lohnt, drei Dinge zu trennen, die im Alltagsgespräch zu einem „wir haben übermittelt“ verschmelzen.
Die XML-Datei belegt, dass Sie etwas gebaut haben. Die Referenznummer belegt, dass die Sendung bei der Schnittstelle angekommen und zur Verarbeitung angenommen wurde. Erst das UPO verbindet eine konkrete Datei mit einem Datum und mit der Tatsache des Empfangs durch die Behörde. In drei Jahren, wenn jemand die Bestätigung der Einreichung für 2026 verlangt, ist das die eine Sache, die er sucht — und die Person, die damals übermittelt hat, ist vielleicht nicht mehr in der Firma.
Deshalb ist das Herunterladen des UPO und sein Ablegen bei der Datei in dieser Plattform keine Zusatzfunktion, sondern die Bedingung, um den Zeitraum abzuschließen.
Drei Zustände, in denen eine Datei stehen kann
Die Dateihistorie zeigt einen Status, kein grünes Häkchen „fertig“. Der Unterschied ist praktisch: am Status sieht man, was bis zum Abschluss fehlt, und man sieht es, ohne jemanden zu fragen.
| Status | Was geschehen ist | Was der Nachweis ist |
|---|---|---|
| Erzeugt | Die Datei existiert in der Plattform und lässt sich in der XML-Vorschau ansehen. | Die Datei selbst. Sie belegt gegenüber der Behörde noch nichts. |
| Übermittelt — UPO ausstehend | Die Sendung ist bei der Schnittstelle angekommen und mit einer Referenznummer zurückgekehrt. | Die Referenznummer. Sie belegt die Absendung, nicht die Annahme. |
| Angenommen (UPO) | Die Schnittstelle hat die Verarbeitung abgeschlossen und eine Bestätigung ausgestellt. | Das UPO, heruntergeladen und bei der Datei, dem Zeitraum und der Gesellschaft abgelegt. |
Alle Dateien und ihre Zustände auf einem Bildschirm
Man muss nicht im Kopf behalten, was raus ist und was nicht. Bei jeder Datei steht ihr Zustand, und bei den angenommenen die UPO-Nummer zum Herunterladen. Die letzte Zeile ist NBP, wo sich die Kette bewusst nicht schließt: die Datei entsteht bei uns, aber Sie laden sie von Hand hoch.
| Datei | Art | Jahr | Status | |
|---|---|---|---|---|
| JPK_KR_PD_1234567890_2026.xml | JPK_KR_PD 1-1 | 2026 | Angenommen (UPO) UPO: 4f2a91c7…e0b6 | VorschauUPO herunterladen |
| JPK_ST_KR_1234567890_2026.xml | JPK_ST_KR 1-0 | 2026 | Übermittelt — UPO ausstehend Ref.-Nr.: 20270712-8C41D2… | VorschauStatus abfragen |
| JPK_V7M_1234567890_2026-06.xml | JPK_V7M 3 | 2026 | Erzeugt | VorschauPrüfen und übermitteln |
| NBP-KRH_1234567890_2026Q2.xml | AZ-KRH / PZ-KRH | 2026 | Manuell hochzuladen NBP-Portal | Herunterladen |
Der ganze Zyklus, der Reihe nach
Nichts in dieser Abfolge ist unsere Erfindung — so funktioniert die Schnittstelle. Der Wert liegt darin, dass alle vier Schritte an einem Ort eine Spur hinterlassen, bei derselben Datei.
- Schritt 1
Konformität, dann Signatur
Die Datei wird gegen das offizielle Schema geprüft, bevor sie die Plattform verlässt. Die Übermittlung verlangt danach die Signatur einer berechtigten Person — eine Bedingung, getrennt von der Schemakonformität und außerhalb der Datei entschieden.
- Schritt 2
Referenznummer
Die Schnittstelle antwortet mit einer Referenznummer der Sendung. Die Nummer wird bei der Datei gespeichert, nicht im Mail-Verlauf der Person, die gerade geklickt hat — sie ist der Schlüssel zu allem, was danach passiert.
- Schritt 3
Statusabfrage
Die Verarbeitung der Sendung ist nicht sofortig. Die Plattform fragt die Schnittstelle anhand der Referenznummer nach dem Status ab, sodass niemand daran denken muss, zurückzukommen und nachzusehen — noch sich später erklären muss, warum er es nicht tat.
- Schritt 4
UPO und Archiv
Nach Ausstellung der Bestätigung wird das UPO heruntergeladen und bei der Datei archiviert — je Zeitraum und je Gesellschaft. Der Gesellschaftswechsler verlegt den Kontext auf die gewählte Gesellschaft; Historie und Archiv werden für jede getrennt geführt.
Wer signieren und übermitteln darf — UPL-1 und Berechtigungen →
Generalprobe: die erste Übermittlung muss nicht die erste sein
Das Ministerium betreibt eine gesonderte Testumgebung der Schnittstelle. Das ist die am meisten unterschätzte Sache in dieser ganzen Pflicht: den ganzen Zyklus — Übermittlung, Referenznummer, Statusabfrage und Download des UPO — kann man vorab durchlaufen, mit Daten für einen abgeschlossenen Zeitraum, bevor eine Frist ins Spiel kommt.
SimplyTax hat einen Testmodus neben dem Produktivmodus. Derselbe Weg, dieselbe Datei, eine andere Umgebung auf der Gegenseite. Für das erste JPK_ST_KR, das noch nie jemand eingereicht hat, ist das die einzige Möglichkeit, vorab überhaupt etwas zu erfahren.
Die Testumgebung des JPK-Gateways läuft unter der Adresse https://test-e-dokumenty.mf.gov.pl und unterstützt die Übermittlung aller Strukturen: JPK_KR_PD(1), JPK_ST_KR(1), JPK_EWP(4), JPK_PKPIR(3) und JPK_ST(1).
Die Testumgebung bildet die Produktion nicht in jedem Detail ab — ein Teil der Funktionen verhält sich dort anders.
Geprüft am 6. August 2026 · Ministerstwo Finansów / CIRF, Specyfikacja interfejsów usług JPK 5.5.1.v2; oraz Q&A JPK_PD (techniczne) pyt. 1
Maßgeblich ist der polnische Text der verlinkten Quelle.
Das produktive JPK-Gateway läuft unter der Adresse https://e-dokumenty.mf.gov.pl, mit den Methoden /api/Storage/InitUploadSigned, /api/Storage/FinishUpload und /api/Storage/Status/{referenceNumber}.
Geprüft am 6. August 2026 · Ministerstwo Finansów / CIRF, Specyfikacja interfejsów usług JPK 5.5.1.v2, pkt 2.2 Opis interfejsu
Maßgeblich ist der polnische Text der verlinkten Quelle.
Was die Probe nicht erledigt
Ein sauberer Durchlauf auf der Testumgebung entscheidet nicht über das Ergebnis in der Produktion — ein Teil der Funktionen verhält sich dort anders, und die Berechtigung zur Übermittlung ist eine eigene Sache. Die Probe beantwortet die Frage, ob die Datei und der Prozess auf Ihrer Seite bereit sind. Die Frage, wie sich die Behörde verhält, beantwortet niemand.
Was mit der Datei unterwegs passiert
Ein Abschnitt für die, die das auf der IT-Seite einführen. Die Zahlen unten beschreiben die Transportmechanik, nicht die zulässige Größe der Bücher — diese Unterscheidung geht in den meisten Ratgebern verloren und ist die Quelle des am häufigsten wiederholten Mythos über die Größe von JPK-Dateien.
Bei der Übermittlung über die API des JPK-Gateways gilt ein Limit von 200 GB je übermittelte Datei — für die Strukturen JPK_KR_PD(1) und JPK_ST_KR(1) beträgt die maximale Gesamtgröße des Dokuments 200 GB.
Das ist die richtige Antwort auf den wiederholten Mythos vom „Limit von 100 MB“ — diese Zahl betrifft die Anwendung Klient JPK_WEB und nicht die Übermittlung über die API.
Geprüft am 6. August 2026 · Ministerstwo Finansów / Centrum Informatyki Resortu Finansów, Specyfikacja interfejsów usług Jednolitego Pliku Kontrolnego, wersja 5.5.1, dokument 5.5.1.v2 z 5.08.2026
Maßgeblich ist der polnische Text der verlinkten Quelle.
Die erzeugte JPK-Datei wird mit dem Algorithmus DEFLATE in das ZIP-Format komprimiert; überschreitet die entstandene ZIP-Datei 60 MB, wird sie binär in Teile zu je 60 MB zerlegt, wobei der letzte Teil nicht größer als 60 MB sein darf.
Das ist Transportmechanik und kein Limit für die Größe der JPK-Datei. Es entsteht ein Archiv mit einem Dokument; das Archiv wird anschließend binär geteilt.
Geprüft am 6. August 2026 · Ministerstwo Finansów / CIRF, Specyfikacja interfejsów usług JPK 5.5.1.v2, pkt 1.2.1 Kompresja danych
Maßgeblich ist der polnische Text der verlinkten Quelle.
Die Kommunikation mit dem JPK-Gateway erfolgt ausschließlich über TLS 1.2 oder 1.3, mit einer geschlossenen Liste zugelassener Cipher Suites.
Geprüft am 6. August 2026 · Ministerstwo Finansów / CIRF, Specyfikacja interfejsów usług JPK 5.5.1.v2, pkt 2.2
Maßgeblich ist der polnische Text der verlinkten Quelle.
Die aktuelle Version des Dokuments „Specyfikacja interfejsów usług Jednolitego Pliku Kontrolnego“ ist 5.5.1 (Dokumentversion 5.5.1.v2), datiert auf den 5. August 2026.
Geprüft am 6. August 2026 · Ministerstwo Finansów, Portal podatkowy – Pliki do pobrania JPK_PD
Maßgeblich ist der polnische Text der verlinkten Quelle.
Die letzte Position steht hier aus einem Grund, den man offen sagen sollte: die Schnittstellenspezifikation ändert sich mehrmals im Jahr. Deshalb trägt die Versionsnummer auf dieser Seite ein Datum, an dem jemand die Quelle geöffnet hat, und nicht das Datum der letzten Einführung.
NBP: hier schließt sich die Kette nicht
Die Meldungen AZ-KRH und PZ-KRH erzeugt SimplyTax. Es übermittelt sie nicht. Die fertige Datei lädt der Nutzer herunter und stellt sie selbst in das Meldeportal der NBP ein, wobei er sich mit einem von der NBP ausgestellten Zertifikat anmeldet.
Wir runden das nicht auf zu „wir übermitteln auch an die NBP“, denn der Unterschied ist für die verantwortliche Person wesentlich: die Verordnung sieht für Nichtbanken weder eine Programmierschnittstelle noch ein Gegenstück zum UPO vor. Es gibt keine Referenznummer und keine Bestätigung, die wir herunterladen könnten. Der Nachweis der Übermittlung ist das, was die Einheit selbst aufbewahrt.
Die Meldungen an die NBP werden über einen im Meldeportal bereitgestellten elektronischen Dienst übermittelt, und die Authentifizierung des Nutzers erfolgt mit einem von der NBP unentgeltlich ausgestellten Zertifikat.
Die Verordnung sieht für Nichtbanken weder eine Programmierschnittstelle noch ein Gegenstück zum UPO vor.
Geprüft am 6. August 2026 · Obwieszczenie MF z 31.10.2024 (Dz.U. 2024 poz. 1746), § 13
Maßgeblich ist der polnische Text der verlinkten Quelle.
Gebietsansässige, die nach der Übermittlung einer Meldung Buchungen in den Büchern geändert oder zusätzliche Ursprungsbelege erhalten haben, übermitteln der NBP berichtigte Meldungen spätestens bis zum Termin für die Übermittlung der nächsten Meldung.
Die NBP stellt keine Empfangsbestätigung aus, sodass die Dokumentation dessen, was wann übermittelt wurde, bei der meldenden Einheit verbleibt.
Geprüft am 6. August 2026 · Obwieszczenie MF z 31.10.2024 (Dz.U. 2024 poz. 1746), § 14
Maßgeblich ist der polnische Text der verlinkten Quelle.
Beginnen wir mit der Datei, die Sie schon haben
Der schnellste Weg zu prüfen, ob sich dieser Zyklus bei Ihnen schließen lässt, ist eine bereits von Ihrem System erzeugte Datei zu nehmen, sie durch die Prüfung zu schicken und die Übermittlung auf der Testumgebung zu durchlaufen. Dreißig Minuten mit der Person, die diese Dateien einreicht — keine Präsentation.