Wysyłka, statusy i UPO
Wysłane to nie to samo co przyjęte. Dowodem jest UPO.
Kontrola nie prosi o XML. Prosi o urzędowe poświadczenie odbioru i o odpowiedź, którego okresu i której spółki dotyczy. Cykl zamyka się dopiero wtedy, gdy przy pliku stoi numer referencyjny, status z bramki i pobrane UPO — dostępne również wtedy, gdy pyta ktoś, kto wysyłki nie robił.
- krok 1
Wygenerowany
Plik zbudowany z danych, które oddał Państwa system.
- krok 2
Zgodny ze schemą
Sprawdzony względem oficjalnego XSD — przed wysyłką.
- krok 3
Wysłany
Bramka przyjęła przesyłkę i zwróciła numer referencyjny.
- krok 4
Przyjęty
UPO pobrane i zarchiwizowane przy pliku, per okres i per spółka.
Krok trzeci i czwarty są osobno, bo to dwa różne zdarzenia. Bramka może przyjąć przesyłkę i zwrócić numer referencyjny, a poświadczenie i tak nie powstanie — o tym decydują również uprawnienia do wysyłki, niezależne od zgodności pliku ze schemą.
Dlaczego dokumentem jest UPO, a nie plik
UPO to urzędowe poświadczenie odbioru — dokument, który system Ministerstwa wystawia po przetworzeniu przesyłki. Warto rozdzielić trzy rzeczy, które w potocznej rozmowie zlewają się w jedno „wysłaliśmy”.
Plik XML dowodzi, że coś powstało. Numer referencyjny dowodzi, że przesyłka trafiła do bramki i została przyjęta do przetworzenia. Dopiero UPO wiąże konkretny plik z datą i z faktem odbioru przez urząd. Za trzy lata, gdy ktoś poprosi o potwierdzenie złożenia za rok 2026, to jest ta jedna rzecz, której będzie szukał — a osoby, która wtedy wysyłała, może już nie być w firmie.
Dlatego pobranie UPO i odłożenie go przy pliku nie jest w tej platformie funkcją dodatkową, tylko warunkiem zamknięcia okresu.
Trzy stany, w których plik może stać
Historia plików pokazuje status, a nie zieloną fajkę „gotowe”. Różnica jest praktyczna: po statusie widać, czego brakuje do zamknięcia, i widać to bez pytania kogokolwiek.
| Status | Co się wydarzyło | Co jest dowodem |
|---|---|---|
| Wygenerowany | Plik istnieje w platformie i można go obejrzeć w podglądzie XML. | Sam plik. Niczego jeszcze nie dowodzi wobec urzędu. |
| Wysłany — oczekuje na UPO | Przesyłka trafiła do bramki i wróciła z numerem referencyjnym. | Numer referencyjny. Dowodzi nadania, nie przyjęcia. |
| Przyjęty (UPO) | Bramka zakończyła przetwarzanie i wystawiła poświadczenie. | UPO pobrane i odłożone przy pliku, przy okresie i przy spółce. |
Wszystkie pliki i ich stany na jednym ekranie
Nie trzeba pamiętać, co poszło, a co nie. Przy każdym pliku stoi jego stan, a przy przyjętych — numer UPO do pobrania. Ostatni wiersz to NBP, gdzie łańcuch celowo się nie domyka: plik powstaje u nas, ale wgrywają go Państwo ręcznie.
| Plik | Rodzaj | Rok | Status | |
|---|---|---|---|---|
| JPK_KR_PD_1234567890_2026.xml | JPK_KR_PD 1-1 | 2026 | Przyjęty (UPO) UPO: 4f2a91c7…e0b6 | PodglądPobierz UPO |
| JPK_ST_KR_1234567890_2026.xml | JPK_ST_KR 1-0 | 2026 | Wysłany — oczekuje na UPO nr ref: 20270712-8C41D2… | PodglądSprawdź status |
| JPK_V7M_1234567890_2026-06.xml | JPK_V7M 3 | 2026 | Wygenerowany | PodglądPrzejrzyj i wyślij |
| NBP-KRH_1234567890_2026Q2.xml | AZ-KRH / PZ-KRH | 2026 | Do wgrania ręcznie portal NBP | Pobierz |
Cały cykl, po kolei
Nic w tej sekwencji nie jest naszym wynalazkiem — tak działa bramka. Wartością jest to, że wszystkie cztery kroki zostawiają ślad w jednym miejscu, przy tym samym pliku.
- Krok 1
Zgodność, potem podpis
Plik jest sprawdzany względem oficjalnej schemy zanim opuści platformę. Wysyłka wymaga następnie podpisu osoby uprawnionej — to warunek odrębny od zgodności ze schemą i rozstrzygany poza plikiem.
- Krok 2
Numer referencyjny
Bramka odpowiada numerem referencyjnym przesyłki. Numer zostaje zapisany przy pliku, a nie w wątku mailowym osoby, która akurat klikała — to on jest kluczem do wszystkiego, co dzieje się dalej.
- Krok 3
Sprawdzanie statusu
Przetworzenie przesyłki nie jest natychmiastowe. Platforma odpytuje bramkę o status po numerze referencyjnym, więc nikt nie musi pamiętać, żeby wrócić i sprawdzić — ani tłumaczyć się później, dlaczego nie wrócił.
- Krok 4
UPO i archiwum
Po wystawieniu poświadczenia UPO jest pobierane i archiwizowane przy pliku — per okres i per spółka. Przełącznik firm przenosi kontekst na wybraną spółkę; historia i archiwum są prowadzone dla każdej z nich osobno.
Próba generalna: pierwsza wysyłka nie musi być pierwszą
Ministerstwo utrzymuje odrębne środowisko testowe bramki. To jest najbardziej niedoceniana rzecz w całym tym obowiązku: cały cykl — wysyłkę, numer referencyjny, odpytanie o status i pobranie UPO — można przejść wcześniej, na danych za zamknięty okres, zanim w grę wchodzi termin.
SimplyTax ma tryb testowy obok produkcyjnego. Ta sama ścieżka, ten sam plik, inne środowisko po drugiej stronie. Dla pierwszego JPK_ST_KR, którego nikt jeszcze nigdy nie składał, to jedyny sposób, żeby dowiedzieć się czegokolwiek przed czasem.
Środowisko testowe bramki JPK działa pod adresem https://test-e-dokumenty.mf.gov.pl i obsługuje wysyłkę wszystkich struktur: JPK_KR_PD(1), JPK_ST_KR(1), JPK_EWP(4), JPK_PKPIR(3) i JPK_ST(1).
Środowisko testowe nie odwzorowuje produkcyjnego w każdym szczególe — część funkcji działa w nim inaczej.
Sprawdzone 6 sierpnia 2026 · Ministerstwo Finansów / CIRF, Specyfikacja interfejsów usług JPK 5.5.1.v2; oraz Q&A JPK_PD (techniczne) pyt. 1
Produkcyjna bramka JPK działa pod adresem https://e-dokumenty.mf.gov.pl, z metodami /api/Storage/InitUploadSigned, /api/Storage/FinishUpload oraz /api/Storage/Status/{referenceNumber}.
Sprawdzone 6 sierpnia 2026 · Ministerstwo Finansów / CIRF, Specyfikacja interfejsów usług JPK 5.5.1.v2, pkt 2.2 Opis interfejsu
Czego próba nie załatwia
Czysty przebieg na środowisku testowym nie przesądza o wyniku na produkcji — część funkcji działa tam inaczej, a uprawnienia do wysyłki są odrębną sprawą. Próba odpowiada na pytanie, czy plik i proces po Państwa stronie są gotowe. Na pytanie, jak zachowa się urząd, nie odpowiada nikt.
Co się dzieje z plikiem po drodze
Sekcja dla osób, które będą to wdrażać po stronie IT. Poniższe liczby opisują mechanikę transportu, a nie dopuszczalną wielkość ksiąg — to rozróżnienie ginie w większości poradników i jest źródłem najczęściej powtarzanego mitu o wielkości plików JPK.
Przy wysyłce przez API bramki JPK obowiązuje limit 200 GB na przesyłany plik – dla struktur JPK_KR_PD(1) i JPK_ST_KR(1) maksymalny całkowity rozmiar dokumentu wynosi 200 GB.
To jest właściwa odpowiedź na powtarzany mit o „limicie 100 MB” — ta liczba dotyczy aplikacji Klient JPK_WEB, a nie wysyłki przez API.
Sprawdzone 6 sierpnia 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
Wygenerowany plik JPK jest kompresowany do formatu ZIP algorytmem DEFLATE, a jeżeli powstały plik ZIP przekracza 60 MB, dzieli się go binarnie na części po 60 MB, przy czym ostatnia część nie może być większa niż 60 MB.
To mechanika transportu, a nie limit wielkości pliku JPK. Powstaje jedno archiwum z jednym dokumentem, dzielone następnie binarnie.
Sprawdzone 6 sierpnia 2026 · Ministerstwo Finansów / CIRF, Specyfikacja interfejsów usług JPK 5.5.1.v2, pkt 1.2.1 Kompresja danych
Komunikacja z bramką JPK odbywa się wyłącznie po TLS 1.2 lub 1.3, z zamkniętą listą dopuszczonych zestawów szyfrów.
Sprawdzone 6 sierpnia 2026 · Ministerstwo Finansów / CIRF, Specyfikacja interfejsów usług JPK 5.5.1.v2, pkt 2.2
Aktualna wersja dokumentu „Specyfikacja interfejsów usług Jednolitego Pliku Kontrolnego” to 5.5.1 (wersja dokumentu 5.5.1.v2), datowana 5 sierpnia 2026 r.
Sprawdzone 6 sierpnia 2026 · Ministerstwo Finansów, Portal podatkowy – Pliki do pobrania JPK_PD
Ostatnia pozycja jest tu z powodu, który warto powiedzieć wprost: specyfikacja interfejsów zmienia się kilka razy w roku. Dlatego numer wersji na tej stronie ma przy sobie datę, w której ktoś otworzył źródło, a nie datę ostatniego wdrożenia.
NBP: tutaj łańcuch się nie domyka
Sprawozdania AZ-KRH i PZ-KRH SimplyTax generuje. Nie wysyła ich. Gotowy plik pobiera użytkownik i wgrywa go samodzielnie na portal sprawozdawczy NBP, logując się certyfikatem wydanym przez NBP.
Nie zaokrąglamy tego w górę do „wysyłamy również do NBP”, bo różnica jest istotna dla osoby, która za to odpowiada: rozporządzenie nie przewiduje dla podmiotów niebankowych ani interfejsu programistycznego, ani odpowiednika UPO. Nie ma numeru referencyjnego i nie ma poświadczenia, które moglibyśmy pobrać. Dowodem wysyłki jest to, co zachowa sam podmiot.
Sprawozdania do NBP przekazuje się za pośrednictwem usługi elektronicznej udostępnionej na portalu sprawozdawczym, a uwierzytelnienie użytkownika następuje przy użyciu certyfikatu wydawanego nieodpłatnie przez NBP.
Rozporządzenie nie przewiduje dla podmiotów niebankowych ani API, ani żadnego odpowiednika UPO.
Sprawdzone 6 sierpnia 2026 · Obwieszczenie MF z 31.10.2024 (Dz.U. 2024 poz. 1746), § 13
Rezydenci, którzy po przekazaniu sprawozdania zmienili zapisy w księgach lub pozyskali dodatkowe dokumenty źródłowe, przekazują NBP poprawione sprawozdania nie później niż w terminie przekazania najbliższego sprawozdania.
NBP nie wystawia potwierdzenia odbioru, więc udokumentowanie tego, co i kiedy wysłano, zostaje po stronie sprawozdającego.
Sprawdzone 6 sierpnia 2026 · Obwieszczenie MF z 31.10.2024 (Dz.U. 2024 poz. 1746), § 14
Zacznijmy od pliku, który już Państwo mają
Najszybszy sposób, żeby sprawdzić, czy ten cykl domknie się u Państwa, to wziąć plik, który Państwa system już wygenerował, przepuścić go przez walidację i przejść wysyłkę na bramce testowej. Trzydzieści minut z osobą, która te pliki składa — bez prezentacji.