Wyzwanie
Zastrzeżenie: RAN-SIGMA to firma, którą zarządzam. Ten automat powstał na jej potrzeby i pierwszy raport wydał 30 października 2026 — tak samo testuję każde rozwiązanie, zanim zaproponuję podobne klientowi.
Sprawozdania finansowe spółek z KRS są jawne i bezpłatne, ale rozproszone. Każde trzeba pobrać osobno, przychodzą w kilku opakowaniach (goły XML, plik podpisany elektronicznie, archiwum ZIP), w różnych wersjach schematu, a grupy kapitałowe i spółki zagraniczne publikują je inaczej niż pojedyncze spółki. Ręczne zestawienie konkurencji na tle własnych wyników łatwo zrobić niekonsekwentnie: inna kolumna, inny kurs waluty, zero wpisane tam, gdzie danych po prostu nie było.
Wcześniej analizę konkurencji prowadził moduł w CRM firmy. Po uruchomieniu automatu jego dane wyeksportowano do archiwum, a moduł wyłączono.
Jak działa automat
Zasada: liczby i zdania raportu powstają z reguł, model językowy tylko wskazuje i streszcza cytaty. Ten sam wzorzec — dane bez przepisywania, kontrola przed liczeniem, raport i mail z podsumowaniem — stoi za automatem wyników finansowych i raportem spalania floty tej samej firmy.
Roczny kalendarz sprawozdań
1 lipca przychodzi prośba o przegląd listy spółek z podpowiedziami z rejestru. Od 30 lipca automat co poniedziałek, aż do skutku, pyta API KRS, kto już złożył sprawozdanie, i wysyła listę „do pobrania” z linkami. 30 września ma wyjść pierwsze wydanie raportu za poprzedni rok, a każde późniejsze sprawozdanie albo korekta daje nową wersję z tabelą zmian.
Człowiek pobiera, automat sprawdza
Repozytorium Dokumentów Finansowych nie ma API i chroni się przed robotami, więc pliki pobiera człowiek i wrzuca do folderu na Dysku. Automat rozpoznaje plik po treści, nie po nazwie, pomija duplikaty (także ten sam dokument w innym opakowaniu podpisu) i odkłada go do archiwum spółki i roku.
Plik z zewnątrz jest niezaufany
XML czyta bezpieczny parser bez definicji DTD i zewnętrznych encji. Rozmiar, zagnieżdżenie archiwów i stopień kompresji ZIP są sprawdzane przed rozpakowaniem, a nic z archiwum nie trafia na dysk serwera. Plik odrzucony zostaje w folderze, a automat wysyła jeden mail z kodem powodu.
Każda liczba z przypisem
Pozycje sprawozdania są mapowane po nazwach sekcji, kwoty liczone dokładnie, bez zaokrągleń w trakcie. Brak danych to „n/d”, nigdy zero. Bilans, który się nie bilansuje, jest odrzucany, a osobliwości źródła, np. wydatki inwestycyjne wpisane ze znakiem minus, są poprawiane jawnie, z flagą w danych. W raporcie każda liczba ma przypis do sprawozdania albo do obliczenia automatu, a aneks zawiera rejestr źródeł.
Grupy, spółki i zagranica
Porównanie ma dwa poziomy: grupa kapitałowa według sprawozdania skonsolidowanego i każda spółka osobno, a skład grupy zatwierdza człowiek. Rejestr zagraniczny z otwartym API (XBRL) automat czyta sam, pozostałe sprawozdania zagraniczne trafiają do wpisów ręcznych ze stroną źródła. Waluty przelicza jeden kurs NBP z dnia bilansowego, z przypisem w raporcie.
Ranking z własną firmą jako punktem odniesienia
Wskaźniki porównuje się w jednym, ustalonym zbiorze firm, a kierunek „lepiej” jest ustalony z góry (np. przy zadłużeniu niżej znaczy lepiej). Remis pokazuje wszystkie jednostki, nigdy jedną wybraną. Na wykresach własna firma jest w zieleni, reszta na szaro, mediana konkurencji to kreska, a luka w danych to przerwa w linii.
Cytaty z zarządów sprawdzane w źródle
Claude czyta sprawozdania z działalności i wskazuje dosłowne fragmenty o inwestycjach, planach, mocach, zatrudnieniu i ryzykach, każdy z numerem strony. Fragment trafia do raportu tylko wtedy, gdy automat znajdzie go na tej stronie. Przed wysłaniem tekstu do API imiona i nazwiska są zamieniane na funkcje. Krótkie streszczenia oznaczone „AI” powstają wyłącznie z przepuszczonych cytatów, a streszczenie z liczbą spoza nich jest odrzucane.
Wersje zamiast nadpisywania
Raportu nikt nie nadpisuje: korekta sprawozdania daje kolejną wersję (v2, v3…) z tabelą zmian wskaźników, a poprzednia zostaje. Dwa uruchomienia na tych samych danych dają bajtowo ten sam PDF i nie wysyłają drugiego maila. Mail wydania ma trzy kafle z wynikami własnej firmy i przyciski do dokumentów na Dysku, szczegóły są w załącznikach.
Co rozstrzyga automat, a co człowiek
Automat: kontrola, arytmetyka, forma
Automat sprawdza statusy w KRS, przyjmuje i waliduje pliki, liczy wskaźniki, układa ranking i wykresy, składa zdania raportu z szablonów i pilnuje wersji. Ramka „Wnioski (reguły)” porównuje własną firmę z medianą konkurencji według ustalonych kierunków. To zestawienie, nie ocena strategii.
Człowiek: lista, składy grup, interpretacja
Zarząd decyduje, kto jest konkurentem, a kto odbiorcą, zatwierdza skład grup kapitałowych, pobiera pliki z repozytorium i wpisuje liczby ze sprawozdań zagranicznych, których nie da się odczytać automatycznie. Odbiorcy mają osobny dokument „Radar Odbiorców”, więc nie mieszają się z rankingiem konkurencji. Wnioski z raportu wyciąga zarząd.
Gdzie pracuje AI, a gdzie nie
Model językowy robi tu dwie rzeczy: wskazuje w sprawozdaniach zarządów dosłowne fragmenty ze stroną, a ze sprawdzonych fragmentów pisze krótkie streszczenia oznaczone „AI”. Liczby, ranking i pozostałe zdania raportu powstają bez niego, a wyłącznik daje raport w pełni deterministyczny z adnotacją „bez analizy tekstu”. Przed włączeniem cytatów prezes zarządu spółki zatwierdził test równowagi interesów z RODO (29.10.2026). Rdzeń ma 189 testów automatycznych (stan na 4.11.2026). Wśród nich jest porównanie odczytu własnego sprawozdania z jego wizualizacją z portalu e-sprawozdań co do grosza oraz celowo zepsute kopie sprawozdań, które automat musi odrzucić albo oflagować. Obliczenia przypominają te z paneli analitycznych, ale wynikiem jest dokument dla zarządu, nie ekran.
Jak wygląda wynik
Prawdziwych raportów spółki nie publikujemy. Poniżej są strony raportu wygenerowane tym samym kodem na fikcyjnych danych testowych: firmy i liczby są zmyślone, a układ, obliczenia, przypisy i reguły pochodzą z działającego automatu.


Historia wdrożenia: 28 października – 4 listopada 2026
- 28.10.2026: kontrakt techniczny i dane wzorcowe, odczyt sprawozdań XML, walidacja, wskaźniki, połączenia z KRS, NBP i rejestrem zagranicznym, wpisy ręczne.
- 29.10.2026: liczby z XBRL, raport roczny, dokument o odbiorcach, maile i arkusz sterujący.
- 30.10.2026: cytaty ze sprawozdań zarządów ze strażnikiem i redakcją danych osobowych, automat na serwerze firmy i pierwsze wydanie raportu za 2025 rok.
- 31.10.2026: dane modułu analizy konkurencji w CRM wyeksportowane do archiwum, moduł wyłączony.
- 1–4.11.2026: streszczenia AI, układ „narracja z przypisami”, tabela zmian w wersjach, rozdział o organizacjach odzysku olejów i więcej wykresów.
Wynik od października 2026
Raport za 2025 rok wyszedł 30.10.2026 w wersji pierwszej. Ponowne uruchomienie na tych samych danych dało wynik „bez zmian”: bez nowej wersji i bez drugiego maila. Zarząd dostaje jeden dokument o konkurencji i jeden o odbiorcach, a każde zdanie z liczbą da się sprawdzić w przypisie.
Co daje automat
- Pilnowanie, kto już złożył sprawozdanie — automat sprawdza KRS co poniedziałek do skutku i wysyła listę z linkami
- Liczby z przypisami — każda liczba w raporcie prowadzi do sprawozdania albo do obliczenia
- Fragmenty sprawozdań zarządów — z numerem strony, sprawdzone w źródle
- Jedno miejsce zamiast modułu w CRM — dane starego modułu wyeksportowane do archiwum, moduł wyłączony
Co dziś zrobiłbym inaczej
Od początku dałbym modelowi kolejność tematów dla każdej roli spółki. Pierwsze cytaty ze sprawozdania jednego z odbiorców dotyczyły jego innych linii produkcji, a nie przerobu olejów przepracowanych. Pomógł dopiero dopisek w poleceniu dla odbiorców: najpierw fragmenty o olejach, inne obszary tylko wtedy, gdy takich fragmentów brak.
Kiedy takie rozwiązanie nie ma sensu
Gdy konkurentów jest kilku i wszyscy składają proste sprawozdania w KRS, wystarczy raz w roku przejrzeć je ręcznie albo skorzystać z płatnej bazy danych finansowych. Radar nie powie też nic o bieżącym kwartale: sprawozdania roczne trafiają do KRS kilka miesięcy po końcu roku. Podmioty, które nie składają sprawozdań w KRS, np. jednoosobowe działalności gospodarcze, są dla automatu niewidoczne.
Czego tu nie ma
Na tej stronie nie ma prawdziwych nazw konkurentów i odbiorców, liczb z raportów spółki ani ocen. Pokazujemy mechanizm, bo to on jest przenośny między firmami. Raporty Radaru zostają w folderze zarządu RAN-SIGMA.
Pytania o ten projekt
Skąd automat bierze sprawozdania?
Z KRS: API rejestru mówi, czy spółka złożyła sprawozdanie, a same pliki pobiera człowiek z Repozytorium Dokumentów Finansowych, które nie ma API, i wrzuca je do folderu na Dysku. Sprawozdania z rejestru zagranicznego z otwartym API automat pobiera sam, pozostałe zagraniczne trafiają do wpisów ręcznych ze stroną źródła.
Czy można ufać liczbom w raporcie?
Każda liczba ma przypis do sprawozdania albo do obliczenia automatu, a brak danych jest oznaczony „n/d”, nigdy zerem. Bilans, który się nie bilansuje, jest odrzucany. Odczyt sprawdzają testy na prawdziwych sprawozdaniach w różnych schematach i na celowo zepsutych kopiach, a dwa uruchomienia na tych samych danych dają identyczny PDF.
Co w tym projekcie robi AI?
Dwie ograniczone rzeczy: Claude wskazuje w sprawozdaniach zarządów dosłowne fragmenty o inwestycjach, planach, mocach, zatrudnieniu i ryzykach, ze stroną, a z fragmentów, które przeszły kontrolę, pisze krótkie streszczenia oznaczone „AI”. Automat sprawdza, czy każdy fragment naprawdę jest na tej stronie. Liczb, rankingu ani pozostałych zdań raportu model nie tworzy.
Co z danymi osobowymi z KRS?
Odpisy z KRS zawierają imiona, nazwiska i daty urodzenia członków organów. Automat odrzuca je w chwili odczytu i zostawia tylko funkcje, np. prezes zarządu. Przed wysłaniem tekstu sprawozdania do API imiona i nazwiska są zamieniane na funkcje, a logi zawierają nazwę pliku, skrót i kod błędu, nigdy treść.
Co się dzieje, gdy spółka złoży korektę sprawozdania?
Powstaje nowa wersja raportu z tabelą zmian wskaźników, a poprzednia zostaje bez zmian. Mail o nowej wersji wymienia, co się zmieniło. Raportu nigdy się nie nadpisuje.
Gdzie działa automat i kto widzi raporty?
Na serwerze firmy, na osobnym koncie systemowym, w rocznym cyklu: przegląd listy w lipcu, sprawdzanie KRS od końca lipca do skutku i codzienne skanowanie folderu od lipca do października. Raporty trafiają wyłącznie do folderu zarządu na Dysku firmy. Przed zapisem automat sprawdza uprawnienia folderu i nie zapisze raportu, jeśli folder jest udostępniony przez link albo całej domenie.
Konkurencję śledzisz z wydruków sprawozdań?
Na pierwszej rozmowie sprawdzamy, które firmy z Waszej listy składają sprawozdania w KRS, w jakiej formie i co z nich da się uczciwie porównać z Waszymi wynikami.
Szczegóły projektu
Technologie
Python · defusedxml · openpyxl · reportlab · matplotlib · API KRS · Claude API · Google Drive API · systemd