Samouczek dla nowych użytkowników

Krok 1 - Zdobądź plik

Masz trzy opcje:

• Pobierz własne e-sprawozdanie XML lub XAdES z portalu KRS (ekrs.ms.gov.pl) albo z innego źródła.
• Użyj funkcji Wyszukaj po KRS lub NIP na stronie głównej, aby pobrać najnowszy raport automatycznie.
• Nie masz jeszcze pliku pod ręką? Kliknij „Wypróbuj przykładowy raport” na stronie głównej - aplikacja od razu wgra i odczyta w pełni fikcyjny, przykładowy plik testowy, żebyś zobaczył/zobaczyła wynik, zanim wgrasz coś swojego.

Krok 2 - Wgraj plik

1. Kliknij Wgraj plik (lub „Upload annual report”).
2. Przeciągnij plik do obszaru uploadu albo wybierz go z dysku. Jeśli masz podpis odłączony, wgraj od razu oba pliki (.xml i .xml.xades) razem.
3. Wybierz tryb walidacji: Tolerancyjny (domyślny - pokazuje dane nawet gdy plik nie pasuje w 100% do oficjalnego schematu), Ścisły (traktuje niezgodności ze schematem jako błąd) albo Tylko odczyt (pomija pełne sprawdzanie schematu, najszybszy podgląd).
4. Kliknij przycisk odczytu raportu.

Krok 3 - Zobacz wynik

Po chwili zobaczysz nazwę spółki, okres sprawozdawczy, bilans, rachunek zysków i strat oraz panel wskaźników finansowych (marża brutto, ROE, płynność i inne). Jeśli wgrałeś/wgrałaś plik z podpisem, zakładka podpisu pokaże kto podpisał i kiedy.

Krok 4 - Sprawdź „File check”

Zakładka File check pokazuje wynik sprawdzenia pliku względem oficjalnych schematów Ministerstwa Finansów:

• Zielony / „passed” - plik w pełni zgodny z oficjalnym schematem.
• Żółty / „warning” - dane zostały odczytane, ale plik nie pasuje w 100% do oficjalnego schematu (częste przy nietypowych lub uproszczonych plikach) - w trybie tolerancyjnym to nie blokuje odczytu.
• Czerwony / „failed” - poważny problem, np. brak czytelnego bilansu.

Każdy komunikat opisuje dokładnie, co się nie zgadza - jeśli coś jest niejasne, zobacz sekcję z rozwiązywaniem problemów poniżej.

Krok 5 - Wyeksportuj wynik

Użyj menu Eksport, aby pobrać dane jako JSON, CSV, XLSX, raport walidacji albo oryginalny plik XML.

Rozwiązywanie typowych problemów

Poniżej najczęstsze komunikaty, jakie może pokazać aplikacja, wraz z przyczyną i rozwiązaniem:

• „Unsupported file type” / nieobsługiwany typ pliku” - aplikacja przyjmuje tylko pliki .xml, .xades lub .xml.xades. Sprawdź rozszerzenie pliku.
• „This XML declares a DOCTYPE, which is not allowed” - plik zawiera deklarację DOCTYPE. Ze względów bezpieczeństwa (ochrona przed atakami XXE) aplikacja odrzuca takie pliki. Oficjalne e-sprawozdania MF nigdy nie używają DOCTYPE - jeśli Twój plik go zawiera, prawdopodobnie pochodzi z innego źródła lub został zmodyfikowany; wyeksportuj/pobierz go ponownie z oryginalnego źródła.
• „...is only a digital signature. Please upload the annual report file together with it.” - wgrałeś/wgrałaś sam plik podpisu odłączonego (.xades) bez oryginalnego raportu. Wgraj oba pliki razem, w jednym oknie uploadu.
• „exceeds the 15 MB single-file limit” / „Total upload size exceeds the 30 MB limit” - limity rozmiaru plików. Podziel wgrywanie na mniejsze partie albo skontaktuj się z administratorem, jeśli hostujesz własną instancję (limity da się zmienić zmiennymi środowiskowymi ARR_MAX_FILE_MB / ARR_MAX_TOTAL_MB).
• „Fetching KRS reports requires an RDF account” - automatyczne pobieranie raportu po numerze KRS/NIP korzysta z oficjalnego serwisu rdf.ms.gov.pl i wymaga bezpłatnego konta. Ręczne wgranie pliku XML/XAdES nigdy tego nie wymaga.
• „This feature is available on a paid plan” przy wgrywaniu kilku plików - porównanie kilku różnych sprawozdań (np. za różne lata) to funkcja płatna. Wgranie jednego sprawozdania razem z jego własnym plikiem podpisu (.xml + .xml.xades) zawsze pozostaje bezpłatne - to nie jest traktowane jako porównanie.
• Nieoczekiwany błąd serwera z krótkim kodem w nawiasie, np. „(Error reference: A1B2C3D4)” - rzadki, nieprzewidziany błąd. Kod w nawiasie identyfikuje dokładny wpis w logu serwera - jeśli problem się powtarza, przekaż go razem ze zgłoszeniem na info@lolisoft.eu.

Przykładowe pliki dla programistów

Repozytorium projektu zawiera folder test_reports/ z kilkoma przykładowymi plikami XML i XAdES (podpis kopertowany, kontener XAdES, podpis odłączony oraz celowo błędne pliki) do testowania parsera lokalnie - zobacz test_reports na GitHub.