Porównywarka struktur CSV — zmiany wzorca danych cen mieszkań 2026

Dlaczego warto porównywać struktury plików cen mieszkań?

Przy zmianie przepisów lub oprogramowania sprzedażowego deweloper może otrzymać nowy dokument wzorcowy z innymi nagłówkami. Sama informacja, że plik „ma 57 kolumn”, nie wystarcza, by ocenić zakres prac. Znaczenie mają kolejność, nazwy, definicje i formaty pól. Zmiana położenia kolumny może spowodować, że wcześniejsze mapowanie CRM zacznie zapisywać wartość w niewłaściwym miejscu. Nowa kolumna może wymagać danych, których system sprzedażowy wcześniej nie przechowywał. Dlatego aktualizację dobrze zacząć od porównania poprzedniego i nowego wzorca, zanim zastąpi się mapowanie używane w firmie.

W odniesieniu do planowanej zmiany art. 19b ustawy deweloperskiej ważne jest rozróżnienie ogłoszonej nowelizacji i projektu rozporządzenia. Ustawę z 17 lipca 2026 r. ogłoszono w Dz.U. 2026 poz. 1077, natomiast Ministerstwo Cyfryzacji opublikowało projekt szczegółowej struktury danych we wrześniu 2026 r. Projekt przewiduje 57 pól, ale nie należy przyjmować, że jest to bez dodatkowej weryfikacji ostatecznie obowiązujący układ. Przed produkcyjnym raportowaniem trzeba sprawdzić aktualne rozporządzenie oraz wzorcowe dokumenty we właściwym systemie urzędowym.

Jak przygotować dwa pliki do analizy?

W pierwszym kroku zachowaj kopię wcześniejszego dokumentu zawierającego nagłówki, którego rzeczywiście używał zespół. W drugim pobierz aktualny dokument ze sprawdzonego źródła. Najlepiej, aby oba pliki miały oddzielne, jednoznaczne nazwy i daty. Porównywarka odczytuje pierwszy wiersz każdego CSV i identyfikuje nazwy pól. Pliki mogą mieć wyłącznie nagłówki lub zawierać przykładowe rekordy, jednak do testów nie powinny trafiać dane osobowe klientów ani inne poufne informacje bez uzasadnionej potrzeby.

Program dopuszcza popularne separatory CSV, czyli średnik, przecinek i tabulator, a także obsługuje pola ujęte w cudzysłowy. Jeżeli plik zawiera powtórzone nagłówki, pustą nazwę kolumny albo niespójną liczbę komórek w wierszach, analiza może zostać wstrzymana. To zamierzone zachowanie: dane wejściowe muszą być na tyle jednoznaczne, żeby raport różnic nie wprowadzał użytkownika w błąd. Przy bardziej złożonych formatach elektronicznych trzeba korzystać z narzędzi i specyfikacji odpowiednich dla tych formatów.

Jak interpretować wynik porównania?

Raport rozdziela pola bez zmian od kolumn, których pozycja została przesunięta. Osobno pokazuje nagłówki nowo dodane i usunięte. Różnica w samym zapisie nazwy, na przykład w wielkości liter, jest oznaczana jako wymagająca sprawdzenia. Takiej różnicy nie można automatycznie uznać za zmianę merytoryczną ani za pewne dopasowanie. Z kolei dwa różne nagłówki mogą odnosić się do podobnych pojęć, lecz ich równoważność musi zostać potwierdzona przez właściwą dokumentację.

Jeżeli wynik pokazuje nowe pole, ustal, w jakim systemie znajduje się odpowiadająca mu informacja. Gdy kolumnę usunięto, nie kasuj od razu historycznych danych z CRM. Najpierw sprawdź wymagania archiwizacyjne, zależności integracyjne i potrzebę zachowania historii poprzedniego wzorca. Jeśli kolumna zmieniła miejsce, sprawdź proces eksportu, zwłaszcza gdy wcześniej opierał się on na numerach kolumn zamiast ich nazwach i definicjach.

Do czego służą sumy kontrolne SHA-256?

Porównywarka może obliczyć w przeglądarce skrót SHA-256 każdego wczytanego pliku. Taki skrót pomaga jednoznacznie rozpoznać wersję analizowanego dokumentu. Jeśli nawet jeden znak w pliku zostanie zmieniony, zwykle zmieni się także jego skrót. Sumy można dołączyć do wewnętrznego rejestru dokumentacji, aby łatwiej ustalić, na podstawie jakich wersji pracował zespół. Skrót nie potwierdza jednak prawidłowości cen, autentyczności urzędowego źródła ani zgodności z prawem.

Wynik porównania można pobrać do CSV albo JSON. CSV nadaje się do czytelnego przeglądu zmian w arkuszu, a JSON może służyć jako techniczny ślad wersji, zawierający wykaz różnic oraz nazwy plików i ich sumy kontrolne. Dane wejściowe i historia porównań nie są automatycznie zapisywane na serwerze e-DEWELOPERSKI. Jeśli firma potrzebuje wspólnego repozytorium albo cyklicznych kontroli, to osobny etap wdrożenia wymagający odpowiednich uprawnień i zasad bezpieczeństwa.

Co zrobić po porównaniu struktur?

Po przejrzeniu raportu przygotuj tabelę zadaniową z trzema grupami pozycji: pola, które można mapować bez zmian; pola wymagające ręcznego potwierdzenia definicji; oraz nowe dane, które trzeba pozyskać z systemu sprzedażowego lub innego wiarygodnego źródła. Zespół powinien wskazać osobę odpowiedzialną za każdą pozycję i datę zakończenia weryfikacji. Dopiero wtedy można zaktualizować mapowanie danych CRM i przygotować próbny eksport.

Kolejny etap to sprawdzenie próbki w walidatorze CSV, porównanie jej wartości z CRM oraz wykonanie kontroli organizacyjnej opisanej w checkliście dewelopera. Warto też sprawdzić porównywarką kolejnych raportów, czy zmianie wzorca nie towarzyszyły przypadkowe zmiany identyfikatorów lub cen. Żaden z tych etapów nie jest automatycznym przekazaniem dokumentu do dane.gov.pl.

Najczęstsze pytania

Czy podobne nazwy oznaczają to samo pole?

Nie zawsze. Podobieństwo językowe może być wskazówką, ale właściwe znaczenie określa aktualna dokumentacja. Porównywarka nie dokonuje samodzielnej interpretacji prawnej.

Czy program sam pobierze urzędowy wzorzec?

Nie. Wczytujesz dwa pliki, których źródło i aktualność kontrolujesz samodzielnie. To chroni przed automatycznym korzystaniem z niezweryfikowanych wersji dokumentu.

Czy można przygotować porównanie bez abonamentu?

Tak. Narzędzie jest bezpłatne i działa lokalnie. Plany abonamentowe PRO, Studio i Enterprise są rozwijane jako osobna oferta, której aktywacja wymaga ukończenia testów PayPal i regulaminu.

Czy wynik oznacza zgodność z nowelizacją?

Nie. Jest to porównanie technicznych nagłówków, a nie potwierdzenie wszystkich wymagań semantycznych, formalnych i organizacyjnych wynikających z prawa.

Źródła i data aktualizacji

Źródło ustawowe: Dz.U. 2026 poz. 1077. Projektowa dokumentacja techniczna: Ministerstwo Cyfryzacji, WPL MC 52. Przed przekazaniem danych sprawdź również oficjalny portal danych. Stan informacji: 1 listopada 2026 r. Materiał edukacyjny, bez gwarancji zgodności z ostatecznym rozporządzeniem.